Skip to content

feat(framework): delivery artefacts declare their type #650

Open

Description

@blafourcade

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

Activity

  1. added this to the milestone on Aug 14, 2026
  2. added theissue type on Aug 14, 2026
  3. removed this from the milestone on Sep 3, 2026
  4. moved this from Ideation to Todo in AIDD Roadmapon Sep 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    Fields

    Priority

    Medium

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions