Spec

Turn the supplied source into approved planning artifacts. This skill owns discovery and planning only; after approval, report the artifact directory and stop.

Artifact contract

Every completed run writes:

docs/specs/<slug>/
├── spec.md
├── plan.md
└── approval.md

Choose a stable, kebab-case slug from the accepted problem. Add supporting Markdown only when the work needs it, such as research.md, decisions.md, data-model.md, migration.md, or files under contracts/.

spec.md is authoritative for requirements and technical design. plan.md is authoritative for execution. approval.md certifies the exact approved versions of both. HTML may supplement review when visualization materially helps, but it never replaces the Markdown.