Lucas WintherandClaude Opus 5.5
0ece4b3a2a
Root AGENTS.md is now the single source of truth for coding agents; CLAUDE.md, GEMINI.md and docs/CLAUDE.md are pointers. The product spec moves from docs/CLAUDE.md to PRODUCT.md, DESIGN.md records the shipped visual system, and docs/PERMISSIONS.md defines agent permission tiers rendered to .claude/, .codex/ and .gemini/. Adds docs/specs/ and docs/plans/, logs issues noticed (not fixed) in WorkBreakdown.md. Co-Authored-By: Claude Opus 5.5 <[email protected]>
12 lines
547 B
Markdown
12 lines
547 B
Markdown
# Specs
|
|
|
|
Approved specifications from the superpowers brainstorming workflow. Nothing non-trivial gets
|
|
implemented without one.
|
|
|
|
- Naming: `NNN-short-slug.md`, zero-padded, sequential.
|
|
- A spec states **what** and **why**, plus acceptance criteria. Not **how**.
|
|
- Front matter: `status: draft | approved | implemented | superseded`. No link to a plan — plans are
|
|
removed before merge.
|
|
- Never delete an implemented spec; it is the record of intent.
|
|
- A spec that makes an architectural choice also gets a `D-###` entry in `docs/Decisions.md`.
|