What problem does it solve? Finished projects leave behind sprawling directories of spikes, plans, decisions, and notes that clutter the docs workspace. This Skill condenses a completed project into one archived README while preserving important decisions and follow-up work in top-level locations, all as a single recoverable git commit. ## Core Features & Use Cases - Decision promotion: Walks each project decision with the captain and promotes cross-cutting ones to top-level docs/decisions/ with preserved slugs and frontmatter. - Follow-up relocation: Moves open notes and unchecked tasks into docs/notes/ or drops them with per-item captain approval. - Cross-reference rewriting: Rewrites Markdown links and frontmatter source fields across all of docs/ according to the promotion mapping, surfacing orphans for captain decision. - Safe deletion: Validates the condensed README via a single-pass /validate-doc loop and requires explicit captain confirmation before any source content is deleted, then lands everything in one atomic git commit recoverable via git revert. - Use Case: After finishing project x003-auth-redesign, run the archive flow to promote two reusable decisions to docs/decisions/, move one open note, rewrite inbound links, and commit a single condensed README. ## Quick Start Ask the agent to archive project x003-auth-redesign using the archive-project skill and confirm each decision promotion when prompted.
