docs(phase-08): create Nyquist validation track phase plan (8 plans, sequential)

2026-04-13 15:45:52 +02:00
parent 442b7d680a
commit 7b37bdbb4a
9 changed files with 856 additions and 1 deletions
@@ -0,0 +1,91 @@
+---
+phase: 08-nyquist-validation-track
+plan: 02
+type: execute
+wave: 2
+depends_on: [08-01]
+files_modified:
+  - .planning/phases/02-driver-management/02-VALIDATION.md
+autonomous: true
+requirements: [NYQ-01]
+must_haves:
+  truths:
+    - "Phase 2 VALIDATION.md contains a Nyquist Record with exactly one observable check per Phase 2 success criterion"
+    - "Every Phase 2 Nyquist Record row cites evidence (test + file:line, commit SHA + file:line, artifact path, or dated VERIFICATION.md link)"
+    - "POST /drivers/upload 500 gap is recorded as fail-fix-v1.1 linked to Phase 9 / UX-01"
+    - "Phase 2 frontmatter has nyquist_audited + nyquist_auditor"
+  artifacts:
+    - path: ".planning/phases/02-driver-management/02-VALIDATION.md"
+      provides: "Phase 2 Nyquist Record table + updated frontmatter"
+      contains: "## Nyquist Record"
+  key_links:
+    - from: ".planning/phases/02-driver-management/02-VALIDATION.md gap row"
+      to: ".planning/phases/09-ux-tech-debt-closure"
+      via: "fail-fix-v1.1 link for POST /drivers/upload 500"
+      pattern: "fail-fix-v1.1.*UX-01|Phase 9"
+---
+
+<objective>
+Audit Phase 2 (Driver Management, DRV-01..05) against Nyquist rules. Upgrade `02-VALIDATION.md` in place with a `## Nyquist Record` section and updated frontmatter. Must record the pre-surfaced `POST /drivers/upload` 500 gap as `fail-fix-v1.1` → Phase 9 / UX-01 (per CONTEXT.md deferred-ideas block).
+
+Purpose: Second of 7 per-phase audits feeding the milestone index.
+Output: Upgraded `.planning/phases/02-driver-management/02-VALIDATION.md`.
+</objective>
+
+<execution_context>
+@C:/Users/SebastienQUEROL/.claude/get-shit-done/workflows/execute-plan.md
+@C:/Users/SebastienQUEROL/.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/ROADMAP.md
+@.planning/STATE.md
+@.planning/REQUIREMENTS.md
+@.planning/phases/08-nyquist-validation-track/08-CONTEXT.md
+@.planning/phases/08-nyquist-validation-track/08-01-SUMMARY.md
+@.planning/milestones/v1.0-ROADMAP.md
+@.planning/phases/02-driver-management/02-VALIDATION.md
+@.planning/phases/02-driver-management/02-VERIFICATION.md
+@.planning/phases/02-driver-management/02-01-SUMMARY.md
+@.planning/phases/02-driver-management/02-02-SUMMARY.md
+</context>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Build Phase 2 Nyquist Record and upgrade 02-VALIDATION.md</name>
+  <files>.planning/phases/02-driver-management/02-VALIDATION.md</files>
+  <action>
+    Follow the exact methodology established in 08-01 (see 08-01-SUMMARY.md for the evidence-lookup pattern used):
+    1. Extract Phase 2 success criteria from `.planning/milestones/v1.0-ROADMAP.md` (DRV-01..05 scope).
+    2. Derive one observable check per criterion.
+    3. Locate evidence (test > commit > artifact > manual), preserving the priority order from CONTEXT.md.
+    4. Preserve all existing sections of 02-VALIDATION.md verbatim.
+    5. Append `## Nyquist Record` with rows `| # | Success Criterion | Observable Check | Evidence | Status | Notes |`.
+    6. **MANDATORY:** Add a `fail-fix-v1.1` row for `POST /drivers/upload` HTTP 500 (reported 2026-04-13 during Phase 8 kickoff — see CONTEXT.md deferred-ideas). Link to Phase 9 / UX-01. This is non-negotiable per the locked decision in CONTEXT.md. Even if UX-01 is now marked Complete in REQUIREMENTS.md, the historical gap against Phase 2 must be recorded; if UX-01 is complete, cite the fixing commit and flip status accordingly (e.g. `pass` with a Notes pointer: "fixed in Phase 9 commit <SHA>").
+    7. Update frontmatter: `nyquist_audited: <date>`, `nyquist_auditor: <name>`. Set `nyquist_compliant: true` only if all rows resolve.
+  </action>
+  <verify>
+    <automated>grep -q "^## Nyquist Record" .planning/phases/02-driver-management/02-VALIDATION.md && grep -qi "drivers/upload" .planning/phases/02-driver-management/02-VALIDATION.md && grep -q "nyquist_audited:" .planning/phases/02-driver-management/02-VALIDATION.md</automated>
+  </verify>
+  <done>
+    02-VALIDATION.md has a complete Nyquist Record, the POST /drivers/upload 500 gap is recorded with a link to Phase 9 / UX-01, and frontmatter is updated.
+  </done>
+</task>
+
+</tasks>
+
+<verification>
+- `## Nyquist Record` section exists in 02-VALIDATION.md
+- Row count matches Phase 2 success criteria from milestones/v1.0-ROADMAP.md
+- A row referencing `POST /drivers/upload` and Phase 9 / UX-01 exists
+- Frontmatter has nyquist_audited + nyquist_auditor keys
+</verification>
+
+<success_criteria>
+Phase 2 Nyquist audit complete with the driver-upload 500 gap formally tracked.
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/08-nyquist-validation-track/08-02-SUMMARY.md`
+</output>