Execution Plans#

Status: active Last reviewed: 2026-04-09 Owner: theMackabu

Use this directory for durable, versioned plans when work spans multiple decisions, checkpoints, or follow-up changes.

Layout#

• Active plans: active/README.md
• Completed plans: completed/README.md
• Technical debt tracker: tech-debt.md

When To Create A Plan#

• The task spans multiple subsystems.
• The work will happen across multiple commits or pull requests.
• Validation has meaningful risk, tradeoffs, or deferred follow-ups.
• Future contributors will need the reasoning, not just the final diff.

Plan Expectations#

• State the problem, constraints, and intended outcome up front.
• Keep a short decision log as the work evolves.
• Record validation status and unresolved risks.
• Move finished plans into completed/ once the work is done.

todo/ can still hold scratch notes, but durable execution history belongs in this directory.