Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

feat(framework): delivery artefacts declare their type

Aberta
  • Algo errado?
#650 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
3/5
Tempo estimado
1-2 dias
Facilidade para iniciantes
72/100
Tipo de issue
Funcionalidade
Clareza
Razoavelmente clara
Status de atividade
Pouca atividade
Stack de tecnologia
markdown
Domínio
documentation, tooling

Direção de pesquisa

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.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

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
Linguagem predominante
TypeScript
Estrelas
481
Forks
45
Merge médio
17h 6min
PRs com merge (30d)
68

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de ai-driven-dev/framework

Todas as issues de ai-driven-dev/framework

Issues semelhantes

Mais issues de TypeScript

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.