Artifacts Reference

Every artefact generated by the AI SDLC Kit — who creates it, who reads it, and when.

Discovery artefacts (Flow A)

Artefact	Location	Created by	Read by	When
`idea.md`	`doc-specs/idea.md`	🧭 Discovery (`/discovery-refine`)	🗂️ PM	After `idea.txt` is ready
`non-technical-spec.md`	`doc-specs/non-technical-spec.md`	🗂️ PM (`/discovery-spec`)	🧑‍💼 Tech Lead	After `idea.md` approved
`PRD.md` (project)	`doc-specs/PRD.md`	🧑‍💼 Tech Lead (`/discovery-prd`)	🏗️ Architect	After functional spec approved
`technical-spec.md`	`doc-specs/technical-spec.md`	🏗️ Architect (`/discovery-tech-spec`)	🏗️ Architect (epic init)	After PRD approved
`epics.md`	`doc-specs/epics.md`	🏗️ Architect (`/discovery-epics`)	🏗️ Architect (epic init)	After technical spec approved
`CONTEXT.md` (initial)	`doc-specs/CONTEXT.md`	🏗️ Architect (`/discovery-tech-spec`)	All agents	Created once, updated after each epic

Per-epic artefacts (Flow A)

Created in doc-specs/<N>-epic/ for each epic N.

Artefact	Location	Created by	Read by	When
`epic-N.md`	`doc-specs/<N>-epic/epic-N.md`	🏗️ Architect (`/epic-init`)	🏗️ Architect, human	Start of epic Spec phase
`PRD.md` (per-epic)	`doc-specs/<N>-epic/PRD.md`	🏗️ Architect (`/epic-init`)	🛠️ Implementer, 🔎 Reviewer	After `epic-N.md` approved
`spec-epic-N.md`	`doc-specs/<N>-epic/spec-epic-N.md`	🏗️ Architect (`/epic-init`)	🛠️ Implementer, 🧪 QA, 🔎 Reviewer	Gate before Epic phase
`decisions-log.md`	`doc-specs/<N>-epic/decisions-log.md`	🏗️ Architect (empty, via `/epic-init`)	🔎 Reviewer, 🏗️ Architect, 🚀 Ops	Created empty; filled by 🛠️ Implementer
`ops-epic-N.md`	`doc-specs/<N>-epic/ops-epic-N.md`	🚀 Ops (`/epic-close`)	Human, 🏗️ Architect	After review approved; before deploy
`incident-log.md`	`doc-specs/<N>-epic/incident-log.md`	🚀 Ops (`/ops-triage`)	🚀 Ops	Created on first incident; appended on each triage

Flow B artefacts

Artefact	Location	Created by	Read by	When
`tarefa.md`	`doc-specs/tarefa.md`	📥 Intake (`/task-init`)	📐 Planner	After `tarefa.txt` is ready
`PRD.md`	`doc-specs/PRD.md`	📐 Planner (`/task-prd`)	📐 Planner, 🛠️ Implementer	After `tarefa.md` approved
`spec.md`	`doc-specs/spec.md`	📐 Planner (`/task-spec`)	🛠️ Implementer, 🧪 QA, 🔎 Reviewer	Gate before implementation

Project-level artefacts

Artefact	Location	Created by	Read by	When
`CONTEXT.md`	`doc-specs/CONTEXT.md`	🏗️ Architect	All agents (before each epic)	Created once; updated after each epic via `/context-sync`
`AGENTS.md`	Project root	📐 Planner (`/agents-init`)	GitHub Copilot (all interactions)	Once per project

Artefact flow diagram

idea.txt
   ↓ /discovery-refine
idea.md
   ↓ /discovery-spec
non-technical-spec.md
   ↓ /discovery-prd
PRD.md
   ↓ /discovery-tech-spec
technical-spec.md + CONTEXT.md
   ↓ /discovery-epics
epics.md
   ↓ /epic-init <N>  (repeats per epic)
doc-specs/<N>-epic/
   ├── epic-N.md
   ├── PRD.md
   ├── spec-epic-N.md    ← implementation gate
   └── decisions-log.md
   ↓ /task-implement
   (code + filled checklist + decisions-log.md entries)
   ↓ /task-tests
   (test report)
   ↓ /task-review
   (review report)
   ↓ /epic-close <N>
doc-specs/<N>-epic/ops-epic-N.md
   ↓ /context-sync <N>
CONTEXT.md (updated)

Retention and versioning

All artefacts should be committed to version control. They serve as the audit trail for every decision made during the lifecycle of the project.

Never delete entries from decisions-log.md
CONTEXT.md is append-only for completed epics and ADR sections
Superseded specs should be versioned or kept alongside their epic folder, not deleted