# Artifact Format (shared)

Authoritative canonical-format rule, referenced by the planning, PRD,
architecture, and implementation-plan skills.

- **JSON/JSONL is canonical** for planning and state artifacts. The canonical
  artifact lives at
  `.prd_plugin/state/artifacts/{artifact_type}/{artifact_id}.json` and holds the
  IDs, summaries, source links, traceability, stale follow-ups, and evidence
  expectations.
- **Markdown is export-only.** Generate it only on explicit human request, under
  `docs/exports/...`. Never edit a Markdown export as if it were canonical truth.
- JSON memory and indexes are operational aids, not replacements for PRDs,
  architecture docs, implementation plans, or evidence.