No skill writes an entity into a GitHub issue body or an Azure DevOps work item

Aperta
  • Qualcosa non va?
#117 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
20/100
Tipo di issue
Funzionalità
Chiarezza
Da chiarire
Stato di attività
Attiva
Stack tecnologico
markdown, python
Ambito
documentation, tooling

Direzione di ricerca

Start with the three living-doc-create-* skills under agentic/.claude/skills/*/SKILL.md and the draft format they emit into validate_entity.py and catalog.json, then compare with living-doc-scenario-creator and living-doc-pageobject-scan, which already write canonical headers for .feature files. The first step is a design decision: whether the layer renders ## Parent Feature and ## Acceptance Criteria issue bodies itself or relies on a per-project Storage Profile template. Done means that decision is recorded and a rendering skill or step exists with an eval.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

type:tech-debt
Description of Technical Debt

The three living-doc-create-* skills emit a JSON draft, the input to validate_entity.py and catalog.json. Canon
text is written only for .feature files: living-doc-scenario-creator writes the User Story and Functionality
headers, and living-doc-pageobject-scan the UI Feature header. For a project documented in GitHub Issues or Azure
DevOps, turning the draft into the canonical issue-body layout (## Parent Feature, ## Acceptance Criteria,
## Feature Dependencies …) is left to the agent's generic "store per the Storage Profile" rule. That matters most for
API Features: only an issue-backed project can document one, so no skill can author a feature_dependencies target.

Impact of Technical Debt
  • An issues- or Azure DevOps-documented project gets no help writing its entities in the canonical layout.
Category

Architecture / Design

Priority

Low - Nice to have

Proposed Solution

Decide first: does the layer render issue bodies itself, or rely on a per-project Storage Profile template? Then a skill (or a create-skill step) renders the canonical layout from the draft, with an eval. The Azure DevOps layout waits for that epic's spike.

Effort Estimate

2-3 days

Dependencies / Related

The Azure DevOps epic.

Additional Context

Measured 2026-11-12 at living-doc 2df73dc. Re-check:

grep -rliE "issue body|## Parent Feature|work item" agentic/.claude/skills/*/SKILL.md finds only incidental mentions.

Lingua principale
Python
Stelle
0
Fork
0
Merge medio
6h 14m
PR unite (30g)
27

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di AbsaOSS/living-doc

Tutte le issue di AbsaOSS/living-doc

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.