docs(plan): MVP implementation plan and Design & Contracts prompt #2

Merged

geekiot merged 4 commits from feat/planning into main

2026-08-08 22:57:58 +05:00

geekiot commented

2026-08-08 22:57:04 +05:00

Owner

Summary

Completes the Planning stage of the AI-PDLC: full decomposition of the MVP
into epics and agent-executable tasks, plus the system prompt for the next
stage (Design & Contracts).

Changes

Plan (`docs/plan/`) — new

roadmap.md — 7 epics (E1…E7), Mermaid dependency graph, critical path
(E1 → E2 → E3 → E7), blocker registry, Design/Contracts readiness audit
e1-infrastructure.md … e7-pilot.md — 57 tasks (TASK-1…57), each with:
dependencies, traceability to FR/RULE/D-n, scope boundaries, and testable
DoD derived from spec acceptance criteria

Specification (point updates, per spec process)

OPEN-11 registered: event payload JSON Schemas are not defined
(OPEN_QUESTIONS.md)
D-104 registered: dev environment via root flake.nix (uv2nix
working-devshells + Node.js from nixpkgs) — registry.md, constraints.md
CHANGELOG.md entry (2026-08-08)

Prompts (`docs/prompts/`)

design-contracts-agent.md — CO-STAR system prompt for the Lead Contract
Designer (event JSON Schemas, package interfaces, DDL, OpenAPI contracts)

Verification

Traceability audit: all FR (001…060), NFR (001…050), RULE (004…132) are
covered by tasks; gaps found during the audit were fixed (TASK-26 night
rules, TASK-56 Docker images, TASK-57 prompt templates)
Open blockers are explicit: OPEN-4, OPEN-7, OPEN-8, OPEN-10, OPEN-11 —
affected tasks are marked, none hidden
No code changes; spec normative sections untouched except registered
D-104/OPEN-11 additions

Next stage

Design & Contracts (agent prompt included): produces machine-readable
contracts — event JSON Schemas (closes OPEN-11 via owner approval),
packages/domain/packages/config interfaces, DB DDL, OpenAPI for
viewer/admin API.

## Summary Completes the **Planning** stage of the AI-PDLC: full decomposition of the MVP into epics and agent-executable tasks, plus the system prompt for the next stage (Design & Contracts). ## Changes ### Plan (`docs/plan/`) — new - `roadmap.md` — 7 epics (E1…E7), Mermaid dependency graph, critical path (E1 → E2 → E3 → E7), blocker registry, Design/Contracts readiness audit - `e1-infrastructure.md` … `e7-pilot.md` — 57 tasks (TASK-1…57), each with: dependencies, traceability to FR/RULE/D-n, scope boundaries, and testable DoD derived from spec acceptance criteria ### Specification (point updates, per spec process) - **OPEN-11** registered: event payload JSON Schemas are not defined (`OPEN_QUESTIONS.md`) - **D-104** registered: dev environment via root `flake.nix` (uv2nix `working-devshells` + Node.js from nixpkgs) — `registry.md`, `constraints.md` - `CHANGELOG.md` entry (2026-08-08) ### Prompts (`docs/prompts/`) - `design-contracts-agent.md` — CO-STAR system prompt for the Lead Contract Designer (event JSON Schemas, package interfaces, DDL, OpenAPI contracts) ## Verification - Traceability audit: all FR (001…060), NFR (001…050), RULE (004…132) are covered by tasks; gaps found during the audit were fixed (TASK-26 night rules, TASK-56 Docker images, TASK-57 prompt templates) - Open blockers are explicit: OPEN-4, OPEN-7, OPEN-8, OPEN-10, OPEN-11 — affected tasks are marked, none hidden - No code changes; spec normative sections untouched except registered D-104/OPEN-11 additions ## Next stage Design & Contracts (agent prompt included): produces machine-readable contracts — event JSON Schemas (closes OPEN-11 via owner approval), `packages/domain`/`packages/config` interfaces, DB DDL, OpenAPI for viewer/admin API.

geekiot added 4 commits

2026-08-08 22:57:04 +05:00

docs(plan): define the first epic and roadmap 77f54fc385

docs(plan): define task breakdowns for epics E2–E7 86e25d7cec

docs(plan): add TASK-56/57 and Design/Contracts readiness audit abb8005da7

docs(prompts): add design & contracts agent prompt (CO-STAR) 06fc39ac2a