Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

feat(framework): delivery artefacts declare their type

Aperta
  • Qualcosa non va?
#650 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à
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
72/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
markdown
Ambito
documentation, tooling

Direzione di ricerca

Start with the templates under plugins/aidd-pm/skills/*/assets/ and plugins/aidd-dev/skills/01-plan/assets/, then read plan-status.md for the allowed status vocabulary. Generate a fresh task folder and verify the board lists every artefact with its type; also confirm a pre-existing document parses and is reported as untyped.

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

Descrizione

Outcome

Every delivery artefact declares what it is, so a reader can filter on it.

Scope

Measured on this repository. Backlog artefacts are complete; delivery artefacts are mute.

File Frontmatter today To add
backlog/{epics,stories,tasks,spikes,defects}/*.md type, status, relations nothing
plan.md objective, status type: plan
phase-N.md status type: phase
spec.md none type: spec, status
review.md none type: review, status
brainstorm document none type: brainstorm, status
PRD none type: prd, status

One new field per file. No task_id is repeated anywhere: the folder name already is the identifier.

  • Includes: the templates under plugins/aidd-pm/skills/*/assets/ and plugins/aidd-dev/skills/01-plan/assets/.
  • Includes: the status vocabulary these files may use, aligned with plan-status.md rather than invented alongside it.
  • Excludes: migrating documents already written.
  • Excludes: any change to backlog artefacts, which are already correct.
Why this is not cosmetic

The kanban's own product brief records the consequence of the gap: "--type cannot work against this framework's own documents", because "the plan template defines objective and status only". A project whose documents carry no frontmatter reads as empty. The board cannot show what the documents do not declare.

Done When

  • Each template above emits its type on creation.
  • Filtering by type on a freshly generated task folder returns every artefact in it.
  • No status vocabulary is introduced that plan-status.md does not already define.
  • A document generated before this change still parses, and is reported as untyped rather than failing.

Completion Evidence

A generated task folder whose every artefact is listed, typed, by the board.

Relations

Field Value
related the task identity file
Lingua principale
TypeScript
Stelle
481
Fork
45
Merge medio
15h 13m
PR unite (30g)
64

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 ai-driven-dev/framework

Tutte le issue di ai-driven-dev/framework

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.