add todo to phased

todo-to-phased/assets/phase-template.md

@@ -0,0 +1,27 @@
+# Phase {{NN}} — {{Short Title}}
+
+**Source:** `{{TODO file}} L{{range(s) the phase's tasks cover, e.g. 34–38, 41}} — "{{capability / section title}}"`
+**Story:** `{{.agent/user_stories/<story>.md or "n/a"}}`
+**Context:** `{{PLAN.md sections / files this phase builds on}}`
+
+## Objective
+{{1–3 sentences: what this phase delivers}}
+
+## Dependencies
+- `{{NN_name}}` ({{complete|todo}}) — {{what is needed from it}}
+{{or "— (none)"}}
+
+## Tasks
+1. `01_{{short_name}}.md` — {{one-line summary}}
+2. `02_{{short_name}}.md` — {{one-line summary}}
+
+## Testing & Quality
+- Unit/integration: {{tests required for all new logic — name the behaviors to cover}}
+- Coverage: **>90%** on new/modified code
+{{project additions, e.g. a dedicated Playwright E2E suite run in isolation by this phase's final pass}}
+
+## Completion Criteria
+- [ ] {{observable check: command to run / endpoint to hit / artifact to exist}}
+- [ ] test suite green, coverage >90%
+- [ ] no behavior change in completed phases
+{{project additions, e.g. a commit command per AGENTS.md conventions}}

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

@@ -0,0 +1,32 @@
+# {{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}}` | {{...}} |

todo-to-phased/assets/task-template.md

@@ -0,0 +1,21 @@
+# Task {{NN}} — {{Short Title}}
+
+**Phase:** `{{NN_phase}}` · **Source:** `{{TODO file}}:{{line(s), e.g. 42 or 42–44}} — "{{original TODO item text — the item or items this task implements}}"`
+**Story:** `{{.agent/user_stories/<story>.md or "n/a"}}`
+
+## Objective
+{{1–2 sentences: what this task delivers}}
+
+## Work
+1. `{{path/to/file}}` — {{specific change, file-level detail}}
+2. `{{path/to/file}}` — {{specific change}}
+{{for every decision the TODO item left open: "- ASSUMPTION: {{what was left open and the choice made}}"}}
+
+## Testing & Quality
+- Unit/integration: {{tests required for this task's logic}}
+- Coverage: **>90%** on this task's new/modified code
+
+## Completion Criteria
+- [ ] {{observable check: command to run / endpoint to hit / artifact to exist}}
+- [ ] full test suite green
+- [ ] no behavior change in completed work