Manage structured changes — propose, spec, design, implement, verify, archive. Use when the user wants to start a new feature, plan a refactor, or track a non-trivial piece of work with full context preservation.
Manage non-trivial work as a self-contained change with proposal, specs, design, and tasks. Each change is a folder. When done, archive it — the decision history is preserved forever.
Don't use for: Quick bug fixes, one-line changes, or tasks that fit in a single TASKS.md entry.
changes/
add-dark-mode/
PROPOSAL.md <- WHY (always required, even for small changes)
SPECS.md <- WHAT changes (optional, delta format)
DESIGN.md <- HOW (optional, technical decisions)
TASKS.md <- Implementation checklist (mxit format)
fix-auth-timeout/
PROPOSAL.md <- Small change, just proposal + tasks
TASKS.md
archive/
2026-03-26-add-websockets/
PROPOSAL.md <- Full context preserved
SPECS.md
DESIGN.md
TASKS.md <- With [done: ...] results on every task
If requirements are unclear, use fold:mxit:brainstorm first. When insights crystallize, promote to a change.
IMPORTANT: During exploration, do NOT write code. Think, investigate, diagram. Code comes later.
mkdir -p changes/<kebab-case-name>
Write PROPOSAL.md:
---