plan-mode-docs
Document plan-mode work as markdown in docs/plans/. Use when a body of work must be recorded, when the docs tree needs review, or when artifacts must be reconciled with reality.
SKILL.mdskills/plan-mode/docs/SKILL.md
GitHubDocs
Make plan-mode thinking durable. The skills think; the docs tree records what they decided.
- Read the doc system for the artifact types, structure, and conventions.
- Determine which artifacts the current work requires. Not every skill produces a durable artifact — read-only skills like
traceorclarifyrecord only when their findings would be lost otherwise. - Write each artifact and update the index. Delegate the write to a subagent when one is available; otherwise write it directly.
- Review the docs tree for gaps and contradictions. Reconcile artifacts that disagree.
- Report what was recorded and what remains undocumented.
Documentation is a record, not a substitute for thinking. If the work is not done, the docs are not final.