Artifact Conventions

SAM artifact naming, file layout, and cross-referencing. Artifacts are the only communication channel between stages.

tools-only Updated 7 repo stars

File contents

Artifact Conventions

SAM artifact naming, file layout, and cross-referencing. Artifacts are the only communication channel between stages.


Token Pattern

Format: ARTIFACT:{TYPE}({SCOPE_OR_ID})

Types:

  • DISCOVERY, PLAN, CONTEXT, TASK, EXECUTION, REVIEW, VERIFICATION

File Layout

All artifacts in .planning/harness/:

.planning/harness/
  discovery-{feature-slug}.md
  plan-{feature-slug}.md
  context-{feature-slug}.md
  task-{task-id}-{task-slug}.md
  execution-{task-id}-{task-slug}.md
  review-{feature-slug}.md
  verification-{feature-slug}.md

Coexistence

  • .planning/gsd/ — GSD planning
  • .planning/backlog/ — Backlog items
  • .planning/ root — Shared planning docs

Source

tools-only/X-Skills/tree/main/daily-assistant/2527-artifact-conventions_34a836fd commit ec814dab6f

Frequently asked questions

npx skillmds@latest add tools-only/artifact-conventions-2