skills/todo-to-phased/assets/plan-template.md

{{Project Name}} — Master Plan

Master design document for a phased-execution project. The phase roadmap below was derived from {{TODO file}} on {{date}}; each phase overview and task file cites its source lines in that file. The LOCKED DECISIONS below are binding: no phase may introduce technology outside them without explicit user permission.

Assumptions & Design Principles

• {{...}}

Architectural Anchors

COMPONENT	DECISION	RATIONALE	STATUS
{{component}}	{{decision — inherited from the existing codebase}}	{{why}}	LOCKED
{{component}}	{{decision awaiting ratification}}	{{why}}	PROPOSED

High-Level Architecture

{{Component breakdown and data flow, mirroring the actual code.}}

Data Model

{{Existing schemas, state transitions, and persistence details.}}

Validation / Verification Workflow

{{Multi-step logic ensuring high-confidence outputs (unit → integration → contract/E2E → coverage floor).}}

Phase Roadmap

#	Phase	TODO source	Objective (one line)
01	{{NN_name}}	—	foundation: adapt validate.sh, green test baseline (where applicable)
02	{{NN_name}}	{{TODO file}} L{{a}}–L{{b}}	{{...}}