Files
SubMiner/docs/workflow/planning.md
sudacode cc5d270b8e docs: add stats dashboard design docs, plans, and knowledge base
- Stats dashboard redesign design and implementation plans
- Episode detail and Anki card link design
- Internal knowledge base restructure
- Backlog tasks for testing, verification, and occurrence tracking
2026-03-17 20:01:23 -07:00

1.0 KiB

Planning

Status: active
Last verified: 2026-03-13
Owner: Kyle Yasuda
Read when: the task spans multiple files, subsystems, or verification lanes

Plan Types

  • Lightweight plan: small change, a few reversible steps, minimal coordination
  • Execution plan: nontrivial feature/refactor/debugging effort with multiple phases or important decisions

Use a Lightweight Plan When

  • one subsystem
  • obvious change shape
  • low risk
  • easy to verify

Use an Execution Plan When

  • multiple subsystems or runtimes
  • architectural tradeoffs matter
  • staged verification is needed
  • the work should be resumable by another agent or human

Plan Location

  • active design and implementation docs live in docs/plans/
  • keep names date-prefixed and task-specific
  • remove or archive old plans deliberately; do not leave mystery artifacts

Plan Contents

  • problem / goal
  • non-goals
  • file ownership or edit scope
  • verification plan
  • decisions made during execution