33 lines
1.3 KiB
Markdown
33 lines
1.3 KiB
Markdown
# {{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}}` | {{...}} |
|