opencastle 0.32.8 → 0.32.10

package/src/dashboard/dist/data/convoys/demo-auth-revamp.json

@@ -42,28 +42,28 @@
       "name": "libs/auth/src/jwt-middleware.ts",
       "type": "file",
       "task_id": "auth-t2",
-      "created_at": "2026-03-18T01:38:47.255Z"
+      "created_at": "2026-03-18T16:27:21.681Z"
     },
     {
       "id": "artifact-demo-auth-revamp-libs-auth-src-rls-policies-sql",
       "name": "libs/auth/src/rls-policies.sql",
       "type": "file",
       "task_id": "auth-t3",
-      "created_at": "2026-03-18T01:38:47.255Z"
+      "created_at": "2026-03-18T16:27:21.681Z"
     },
     {
       "id": "artifact-demo-auth-revamp-reports-auth-review-summary-md",
       "name": "reports/auth-review-summary.md",
       "type": "summary",
       "task_id": "auth-t5",
-      "created_at": "2026-03-18T01:38:47.255Z"
+      "created_at": "2026-03-18T16:27:21.681Z"
     },
     {
       "id": "artifact-demo-auth-revamp-tests-auth-integration-test-ts",
       "name": "tests/auth/integration.test.ts",
       "type": "file",
       "task_id": "auth-t4",
-      "created_at": "2026-03-18T01:38:47.255Z"
+      "created_at": "2026-03-18T16:27:21.681Z"
     }
   ],
   "has_more_events": false,

package/src/dashboard/dist/data/convoys/demo-dashboard-ui.json

@@ -46,47 +46,47 @@
   ],
   "artifact_count": 6,
   "artifacts": [
+    {
+      "id": "artifact-demo-dashboard-ui-reports-panel-review-dashboard-md",
+      "name": "reports/panel-review-dashboard.md",
+      "type": "summary",
+      "task_id": "ui-t7",
+      "created_at": "2026-03-18T16:27:21.681Z"
+    },
+    {
+      "id": "artifact-demo-dashboard-ui-reports-visual-regression-json",
+      "name": "reports/visual-regression.json",
+      "type": "json",
+      "task_id": "ui-t6",
+      "created_at": "2026-03-18T16:27:21.681Z"
+    },
     {
       "id": "artifact-demo-dashboard-ui-src-components-DonutChart-tsx",
       "name": "src/components/DonutChart.tsx",
       "type": "file",
       "task_id": "ui-t3",
-      "created_at": "2026-03-18T01:38:47.255Z"
+      "created_at": "2026-03-18T16:27:21.681Z"
     },
     {
       "id": "artifact-demo-dashboard-ui-src-components-KpiCard-tsx",
       "name": "src/components/KpiCard.tsx",
       "type": "file",
       "task_id": "ui-t2",
-      "created_at": "2026-03-18T01:38:47.255Z"
+      "created_at": "2026-03-18T16:27:21.681Z"
     },
     {
       "id": "artifact-demo-dashboard-ui-src-components-design-tokens-ts",
       "name": "src/components/design-tokens.ts",
       "type": "file",
       "task_id": "ui-t1",
-      "created_at": "2026-03-18T01:38:47.255Z"
-    },
-    {
-      "id": "artifact-demo-dashboard-ui-reports-panel-review-dashboard-md",
-      "name": "reports/panel-review-dashboard.md",
-      "type": "summary",
-      "task_id": "ui-t7",
-      "created_at": "2026-03-18T01:38:47.256Z"
-    },
-    {
-      "id": "artifact-demo-dashboard-ui-reports-visual-regression-json",
-      "name": "reports/visual-regression.json",
-      "type": "json",
-      "task_id": "ui-t6",
-      "created_at": "2026-03-18T01:38:47.256Z"
+      "created_at": "2026-03-18T16:27:21.681Z"
     },
     {
       "id": "artifact-demo-dashboard-ui-src-styles-animations-css",
       "name": "src/styles/animations.css",
       "type": "file",
       "task_id": "ui-t4",
-      "created_at": "2026-03-18T01:38:47.256Z"
+      "created_at": "2026-03-18T16:27:21.681Z"
     }
   ],
   "has_more_events": false,

package/src/dashboard/dist/data/convoys/demo-data-pipeline.json

@@ -37,26 +37,26 @@
   "dlq_entries": [],
   "artifact_count": 3,
   "artifacts": [
-    {
-      "id": "artifact-demo-data-pipeline-src-etl-schema-ts",
-      "name": "src/etl/schema.ts",
-      "type": "file",
-      "task_id": "etl-t1",
-      "created_at": "2026-03-18T01:38:47.256Z"
-    },
     {
       "id": "artifact-demo-data-pipeline-src-etl-pipeline-ts",
       "name": "src/etl/pipeline.ts",
       "type": "file",
       "task_id": "etl-t2",
-      "created_at": "2026-03-18T01:38:47.257Z"
+      "created_at": "2026-03-18T16:27:21.682Z"
+    },
+    {
+      "id": "artifact-demo-data-pipeline-src-etl-schema-ts",
+      "name": "src/etl/schema.ts",
+      "type": "file",
+      "task_id": "etl-t1",
+      "created_at": "2026-03-18T16:27:21.682Z"
     },
     {
       "id": "artifact-demo-data-pipeline-tests-etl-pipeline-test-ts",
       "name": "tests/etl/pipeline.test.ts",
       "type": "file",
       "task_id": "etl-t3",
-      "created_at": "2026-03-18T01:38:47.257Z"
+      "created_at": "2026-03-18T16:27:21.682Z"
     }
   ],
   "has_more_events": false,

package/src/dashboard/dist/data/convoys/demo-deploy-ci.json

@@ -51,7 +51,7 @@
       "name": ".github/workflows/ci.yml",
       "type": "file",
       "task_id": "ci-t1",
-      "created_at": "2026-03-18T01:38:47.257Z"
+      "created_at": "2026-03-18T16:27:21.683Z"
     }
   ],
   "has_more_events": false,

package/src/dashboard/dist/data/convoys/demo-docs-update.json

@@ -42,21 +42,21 @@
       "name": "docs/ARCHITECTURE.md",
       "type": "file",
       "task_id": "docs-t1",
-      "created_at": "2026-03-18T01:38:47.257Z"
+      "created_at": "2026-03-18T16:27:21.683Z"
     },
     {
       "id": "artifact-demo-docs-update-docs-README-md",
       "name": "docs/README.md",
       "type": "file",
       "task_id": "docs-t1",
-      "created_at": "2026-03-18T01:38:47.257Z"
+      "created_at": "2026-03-18T16:27:21.683Z"
     },
     {
       "id": "artifact-demo-docs-update-docs-api-reference-json",
       "name": "docs/api-reference.json",
       "type": "json",
       "task_id": "docs-t2",
-      "created_at": "2026-03-18T01:38:47.257Z"
+      "created_at": "2026-03-18T16:27:21.683Z"
     }
   ],
   "has_more_events": false,

package/src/dashboard/dist/data/convoys/demo-perf-opt.json

@@ -42,28 +42,28 @@
       "name": "reports/bundle-analysis.json",
       "type": "json",
       "task_id": "perf-t1",
-      "created_at": "2026-03-18T01:38:47.256Z"
+      "created_at": "2026-03-18T16:27:21.682Z"
     },
     {
       "id": "artifact-demo-perf-opt-reports-web-vitals-improvement-md",
       "name": "reports/web-vitals-improvement.md",
       "type": "summary",
       "task_id": "perf-t4",
-      "created_at": "2026-03-18T01:38:47.256Z"
+      "created_at": "2026-03-18T16:27:21.682Z"
     },
     {
       "id": "artifact-demo-perf-opt-src-charts-index-ts",
       "name": "src/charts/index.ts",
       "type": "file",
       "task_id": "perf-t2",
-      "created_at": "2026-03-18T01:38:47.256Z"
+      "created_at": "2026-03-18T16:27:21.682Z"
     },
     {
       "id": "artifact-demo-perf-opt-src-utils-image-loader-ts",
       "name": "src/utils/image-loader.ts",
       "type": "file",
       "task_id": "perf-t3",
-      "created_at": "2026-03-18T01:38:47.256Z"
+      "created_at": "2026-03-18T16:27:21.682Z"
     }
   ],
   "has_more_events": false,

package/src/dashboard/node_modules/.vite/deps/_metadata.json

@@ -1,25 +1,25 @@
 {
-  "hash": "6f3a0532",
+  "hash": "5b4f7f3a",
   "configHash": "30f8ea04",
-  "lockfileHash": "8703c4ad",
-  "browserHash": "b7dda761",
+  "lockfileHash": "97dd4ca5",
+  "browserHash": "5e0c0fdd",
   "optimized": {
     "astro > cssesc": {
       "src": "../../../../../node_modules/cssesc/cssesc.js",
       "file": "astro___cssesc.js",
-      "fileHash": "c1cf7e09",
+      "fileHash": "e6cc8cd0",
       "needsInterop": true
     },
     "astro > aria-query": {
       "src": "../../../../../node_modules/aria-query/lib/index.js",
       "file": "astro___aria-query.js",
-      "fileHash": "e7144660",
+      "fileHash": "1b619d97",
       "needsInterop": true
     },
     "astro > axobject-query": {
       "src": "../../../../../node_modules/axobject-query/lib/index.js",
       "file": "astro___axobject-query.js",
-      "fileHash": "66fabf2f",
+      "fileHash": "7383e20b",
       "needsInterop": true
     }
   },

package/src/dashboard/public/data/convoys/demo-api-v2.json

@@ -51,21 +51,21 @@
       "name": "docs/api-v2-contract.json",
       "type": "json",
       "task_id": "api-t1",
-      "created_at": "2026-03-18T01:38:47.256Z"
+      "created_at": "2026-03-18T16:27:21.682Z"
     },
     {
       "id": "artifact-demo-api-v2-reports-security-gate-failure-md",
       "name": "reports/security-gate-failure.md",
       "type": "summary",
       "task_id": "api-t3",
-      "created_at": "2026-03-18T01:38:47.256Z"
+      "created_at": "2026-03-18T16:27:21.682Z"
     },
     {
       "id": "artifact-demo-api-v2-src-api-rate-limiter-ts",
       "name": "src/api/rate-limiter.ts",
       "type": "file",
       "task_id": "api-t2",
-      "created_at": "2026-03-18T01:38:47.256Z"
+      "created_at": "2026-03-18T16:27:21.682Z"
     }
   ],
   "has_more_events": false,

package/src/dashboard/public/data/convoys/demo-auth-revamp.json

@@ -42,28 +42,28 @@
       "name": "libs/auth/src/jwt-middleware.ts",
       "type": "file",
       "task_id": "auth-t2",
-      "created_at": "2026-03-18T01:38:47.255Z"
+      "created_at": "2026-03-18T16:27:21.681Z"
     },
     {
       "id": "artifact-demo-auth-revamp-libs-auth-src-rls-policies-sql",
       "name": "libs/auth/src/rls-policies.sql",
       "type": "file",
       "task_id": "auth-t3",
-      "created_at": "2026-03-18T01:38:47.255Z"
+      "created_at": "2026-03-18T16:27:21.681Z"
     },
     {
       "id": "artifact-demo-auth-revamp-reports-auth-review-summary-md",
       "name": "reports/auth-review-summary.md",
       "type": "summary",
       "task_id": "auth-t5",
-      "created_at": "2026-03-18T01:38:47.255Z"
+      "created_at": "2026-03-18T16:27:21.681Z"
     },
     {
       "id": "artifact-demo-auth-revamp-tests-auth-integration-test-ts",
       "name": "tests/auth/integration.test.ts",
       "type": "file",
       "task_id": "auth-t4",
-      "created_at": "2026-03-18T01:38:47.255Z"
+      "created_at": "2026-03-18T16:27:21.681Z"
     }
   ],
   "has_more_events": false,

package/src/dashboard/public/data/convoys/demo-dashboard-ui.json

@@ -46,47 +46,47 @@
   ],
   "artifact_count": 6,
   "artifacts": [
+    {
+      "id": "artifact-demo-dashboard-ui-reports-panel-review-dashboard-md",
+      "name": "reports/panel-review-dashboard.md",
+      "type": "summary",
+      "task_id": "ui-t7",
+      "created_at": "2026-03-18T16:27:21.681Z"
+    },
+    {
+      "id": "artifact-demo-dashboard-ui-reports-visual-regression-json",
+      "name": "reports/visual-regression.json",
+      "type": "json",
+      "task_id": "ui-t6",
+      "created_at": "2026-03-18T16:27:21.681Z"
+    },
     {
       "id": "artifact-demo-dashboard-ui-src-components-DonutChart-tsx",
       "name": "src/components/DonutChart.tsx",
       "type": "file",
       "task_id": "ui-t3",
-      "created_at": "2026-03-18T01:38:47.255Z"
+      "created_at": "2026-03-18T16:27:21.681Z"
     },
     {
       "id": "artifact-demo-dashboard-ui-src-components-KpiCard-tsx",
       "name": "src/components/KpiCard.tsx",
       "type": "file",
       "task_id": "ui-t2",
-      "created_at": "2026-03-18T01:38:47.255Z"
+      "created_at": "2026-03-18T16:27:21.681Z"
     },
     {
       "id": "artifact-demo-dashboard-ui-src-components-design-tokens-ts",
       "name": "src/components/design-tokens.ts",
       "type": "file",
       "task_id": "ui-t1",
-      "created_at": "2026-03-18T01:38:47.255Z"
-    },
-    {
-      "id": "artifact-demo-dashboard-ui-reports-panel-review-dashboard-md",
-      "name": "reports/panel-review-dashboard.md",
-      "type": "summary",
-      "task_id": "ui-t7",
-      "created_at": "2026-03-18T01:38:47.256Z"
-    },
-    {
-      "id": "artifact-demo-dashboard-ui-reports-visual-regression-json",
-      "name": "reports/visual-regression.json",
-      "type": "json",
-      "task_id": "ui-t6",
-      "created_at": "2026-03-18T01:38:47.256Z"
+      "created_at": "2026-03-18T16:27:21.681Z"
     },
     {
       "id": "artifact-demo-dashboard-ui-src-styles-animations-css",
       "name": "src/styles/animations.css",
       "type": "file",
       "task_id": "ui-t4",
-      "created_at": "2026-03-18T01:38:47.256Z"
+      "created_at": "2026-03-18T16:27:21.681Z"
     }
   ],
   "has_more_events": false,

package/src/dashboard/public/data/convoys/demo-data-pipeline.json

@@ -37,26 +37,26 @@
   "dlq_entries": [],
   "artifact_count": 3,
   "artifacts": [
-    {
-      "id": "artifact-demo-data-pipeline-src-etl-schema-ts",
-      "name": "src/etl/schema.ts",
-      "type": "file",
-      "task_id": "etl-t1",
-      "created_at": "2026-03-18T01:38:47.256Z"
-    },
     {
       "id": "artifact-demo-data-pipeline-src-etl-pipeline-ts",
       "name": "src/etl/pipeline.ts",
       "type": "file",
       "task_id": "etl-t2",
-      "created_at": "2026-03-18T01:38:47.257Z"
+      "created_at": "2026-03-18T16:27:21.682Z"
+    },
+    {
+      "id": "artifact-demo-data-pipeline-src-etl-schema-ts",
+      "name": "src/etl/schema.ts",
+      "type": "file",
+      "task_id": "etl-t1",
+      "created_at": "2026-03-18T16:27:21.682Z"
     },
     {
       "id": "artifact-demo-data-pipeline-tests-etl-pipeline-test-ts",
       "name": "tests/etl/pipeline.test.ts",
       "type": "file",
       "task_id": "etl-t3",
-      "created_at": "2026-03-18T01:38:47.257Z"
+      "created_at": "2026-03-18T16:27:21.682Z"
     }
   ],
   "has_more_events": false,

package/src/dashboard/public/data/convoys/demo-deploy-ci.json

@@ -51,7 +51,7 @@
       "name": ".github/workflows/ci.yml",
       "type": "file",
       "task_id": "ci-t1",
-      "created_at": "2026-03-18T01:38:47.257Z"
+      "created_at": "2026-03-18T16:27:21.683Z"
     }
   ],
   "has_more_events": false,

package/src/dashboard/public/data/convoys/demo-docs-update.json

@@ -42,21 +42,21 @@
       "name": "docs/ARCHITECTURE.md",
       "type": "file",
       "task_id": "docs-t1",
-      "created_at": "2026-03-18T01:38:47.257Z"
+      "created_at": "2026-03-18T16:27:21.683Z"
     },
     {
       "id": "artifact-demo-docs-update-docs-README-md",
       "name": "docs/README.md",
       "type": "file",
       "task_id": "docs-t1",
-      "created_at": "2026-03-18T01:38:47.257Z"
+      "created_at": "2026-03-18T16:27:21.683Z"
     },
     {
       "id": "artifact-demo-docs-update-docs-api-reference-json",
       "name": "docs/api-reference.json",
       "type": "json",
       "task_id": "docs-t2",
-      "created_at": "2026-03-18T01:38:47.257Z"
+      "created_at": "2026-03-18T16:27:21.683Z"
     }
   ],
   "has_more_events": false,

package/src/dashboard/public/data/convoys/demo-perf-opt.json

@@ -42,28 +42,28 @@
       "name": "reports/bundle-analysis.json",
       "type": "json",
       "task_id": "perf-t1",
-      "created_at": "2026-03-18T01:38:47.256Z"
+      "created_at": "2026-03-18T16:27:21.682Z"
     },
     {
       "id": "artifact-demo-perf-opt-reports-web-vitals-improvement-md",
       "name": "reports/web-vitals-improvement.md",
       "type": "summary",
       "task_id": "perf-t4",
-      "created_at": "2026-03-18T01:38:47.256Z"
+      "created_at": "2026-03-18T16:27:21.682Z"
     },
     {
       "id": "artifact-demo-perf-opt-src-charts-index-ts",
       "name": "src/charts/index.ts",
       "type": "file",
       "task_id": "perf-t2",
-      "created_at": "2026-03-18T01:38:47.256Z"
+      "created_at": "2026-03-18T16:27:21.682Z"
     },
     {
       "id": "artifact-demo-perf-opt-src-utils-image-loader-ts",
       "name": "src/utils/image-loader.ts",
       "type": "file",
       "task_id": "perf-t3",
-      "created_at": "2026-03-18T01:38:47.256Z"
+      "created_at": "2026-03-18T16:27:21.682Z"
     }
   ],
   "has_more_events": false,

package/src/orchestrator/prompts/fix-prd.prompt.md

@@ -33,20 +33,15 @@ You are the Team Lead. The PRD below failed validation. Fix **every reported iss
 - Add the missing section with concrete, specific content — not placeholder text
 - If the section needs real data you cannot infer, write a reasonable default and mark with `<!-- TODO: verify -->`
 
-**Vague acceptance criteria**
-- Replace subjective language ("looks good", "feels responsive") with measurable conditions ("renders within 200ms", "meets WCAG 2.2 AA contrast ratio")
-- Replace modal verbs ("should", "might", "could") with definitive language ("must", "will")
-
-**Broad implementation scope**
-- Replace broad paths (`src/`, `the frontend`) with specific file names or subdirectory names
-- Remove glob patterns (`*`, `**`) from scope tables — use actual directory or file names
+**Conflicting requirements**
+- Resolve contradictions between sections — pick the intent that best matches the feature goals
 
 **File partition conflicts**
 - If two parallel workstreams claim the same file, move one to a later phase with explicit dependency
 - Or split the file's responsibilities across the two workstreams so each touches distinct files
 
-**Missing dependency declarations**
-- Add `depends on: Phase N` to phases that require output from earlier phases
+**Broad implementation scope**
+- Replace excessively broad paths (`src/`, `the frontend`) with specific subdirectories or file names
 
 **Placeholder text**
 - Replace template filler ("2–3 sentences about…", "Description here") with real content derived from the feature description

package/src/orchestrator/prompts/generate-convoy.prompt.md

@@ -205,6 +205,7 @@ When chain mode is detected:
 - **Only** generate tasks for the phases listed in the group scope. Do not include tasks from other phases.
 - Derive the convoy `name` from the group name (e.g. "Database Setup").
 - Derive the `branch` from the PRD's feature name (it will be overridden by the pipeline anyway).
+- **Keep prompts concise** — write prompts that are complete and self-contained but avoid unnecessary verbosity. Focus on: what to do, which files to create/modify, key constraints, and acceptance criteria.
 - Keep all other conventions the same as for single-spec generation.
 
 ---

package/src/orchestrator/prompts/generate-prd.prompt.md

@@ -10,6 +10,8 @@ output: prd
 
 You are the Team Lead. Convert the feature request below into a structured Product Requirements Document (PRD). The PRD will be consumed by the `generate-convoy` step to produce an automated agent task spec, so every section must be **concrete**, **specific**, and **implementation-ready**.
 
+> **⚠ QUALITY GATE:** This PRD goes through automated validation. Getting it right on the first attempt is critical — every fix cycle costs a full LLM round-trip. Follow ALL rules below precisely. The self-validation checklist at the end is mandatory.
+
 ## Feature Request
 
 {{goal}}
@@ -145,3 +147,30 @@ Measurable, binary checks that confirm the feature is shippable:
 - **[Open question]**: [What needs to be decided before implementation can start]
 
 If there are no risks or open questions, write "None identified."
+
+---
+
+## Self-Validation Checklist (MANDATORY)
+
+Before outputting the PRD, verify **every item** below. The downstream validator will reject your PRD if any of the blocking checks fail — fix them now to avoid expensive retry cycles.
+
+### Structural Integrity
+
+- [ ] **No conflicting requirements**: Technical Requirements, Non-Goals, Risks & Open Questions, and User Stories must not contradict each other.
+- [ ] **No duplicate open questions**: If a question is already answered elsewhere, do not re-open it in Risks & Open Questions.
+- [ ] **No circular dependencies**: Phase dependency graph is acyclic.
+- [ ] **No placeholder text**: Every section has real content, not template filler ("2–3 sentences about…", "Description here").
+
+### Implementation Coherence
+
+- [ ] **File completeness**: Every file mentioned in User Story acceptance criteria or Technical Requirements appears in the Implementation Scope table AND in the Task Breakdown file lists.
+- [ ] **No file partition conflicts**: No two parallel workstreams (same phase) claim the same file.
+- [ ] **Every workstream lists files**: Including verification-only workstreams — add "Files: none — verification only" if no artifacts are produced.
+- [ ] **No orphan files**: Every file in the Implementation Scope table is assigned to exactly one workstream in Task Breakdown.
+- [ ] **Scope specificity**: Implementation Scope uses specific subdirectory or file paths — not just `src/` or `the frontend`.
+
+### Language Quality
+
+- [ ] **Testable acceptance criteria**: Every criterion is evaluable as deterministic pass/fail — no subjective language ("looks good", "feels responsive").
+- [ ] **No optional modals in criteria**: Acceptance criteria do not use "should", "might", "could", "may" — use "must" or "will".
+- [ ] **Domain acronyms expanded**: Non-standard acronyms are expanded on first use (standard ones like API, CLI, JSON, REST, etc. are fine).

package/src/orchestrator/prompts/validate-prd.prompt.md

@@ -10,9 +10,7 @@ output: validation
 
 You are a senior technical reviewer. Your job is to validate the PRD below against strict quality criteria before it is used to generate an automated convoy spec. A PRD that passes this gate will produce a clean, executable convoy spec. A PRD that fails will produce bad tasks.
 
-Be strict. Do not pass a PRD with vague language or missing sections just because it "looks mostly right."
-
-> **⚠ EXHAUSTIVENESS MANDATE**: You MUST report ALL issues in a single pass. Do NOT stop at the first few problems. Systematically evaluate every section against every check below. A second validation pass should find zero new issues — if it would, your first pass was incomplete.
+Focus on **structural completeness** only — the PRD generator already enforces language quality and style. Your job is to catch structural problems that would break convoy spec generation. **Pass the PRD if sections exist and the structure is internally consistent.** Do not fail for stylistic preferences, word choice, or minor phrasing.
 
 ## PRD to Validate
 
@@ -22,47 +20,26 @@ Be strict. Do not pass a PRD with vague language or missing sections just becaus
 
 ## Validation Checklist
 
-> If the PRD below contains the marker `<!-- validation-pass: N -->`, this is validation pass N. On pass 1, be maximally thorough — report every issue you can find. On pass 2+, verify that previous fixes were applied correctly and check for regressions, but do NOT invent new categories of issues not covered by the checks below.
-
-Evaluate **every item** below. If ALL items pass, respond `VALID`. If ANY item fails, respond `INVALID` with a specific, actionable issue list.
-
-### Required Sections
-
-- [ ] `Overview` section is present and non-empty (at least 2 sentences)
-- [ ] `Goals` section is present with at least one numbered, specific goal
-- [ ] `Non-Goals` section is present (may say "None" but must not be missing)
-- [ ] `User Stories & Acceptance Criteria` section is present with at least one user story
-- [ ] Each user story has associated acceptance criteria (not just the story itself)
-- [ ] `Technical Requirements` section is present and non-empty
-- [ ] `Implementation Scope` section is present with a table or list of specific files/directories
-- [ ] `Task Breakdown` section is present with at least one phase and workstream
-- [ ] `Success Criteria` section is present with at least 3 measurable checks
-- [ ] `Risks & Open Questions` section is present (may say "None identified")
+> If the PRD contains `<!-- validation-pass: N -->`, this is pass N. On pass 2+, only verify previous fixes were applied — do NOT invent new issues.
 
-### Acceptance Criteria Quality
+Evaluate the checks below. If ALL pass, respond `VALID`. Only fail for checks marked BLOCKING.
 
-- [ ] All acceptance criteria can be evaluated as pass/fail (no subjective language like "looks good", "feels responsive", "is clean")
-- [ ] No criterion uses modal verbs that imply optionality ("should", "might", "could", "may")
-- [ ] No criterion references undefined external systems without explaining what they are
+### Required Sections (BLOCKING)
 
-### Implementation Scope Quality
+All of these sections must exist and contain real content (not just the heading):
+`Overview`, `Goals`, `Non-Goals`, `User Stories & Acceptance Criteria`, `Technical Requirements`, `Implementation Scope`, `Task Breakdown`, `Success Criteria`, `Risks & Open Questions`.
 
-- [ ] Scope lists **specific** file names or subdirectory names — not broad paths like `src/` or `the frontend`
-- [ ] Scope table does not use glob patterns (`*`, `**`)
-- [ ] Every concern area has at least one specific file or directory
+### Structural Integrity (BLOCKING)
 
-### Task Breakdown Quality
-
-- [ ] Each workstream lists the exact files it will modify
 - [ ] No two parallel workstreams (same phase) claim the same file
-- [ ] Phases have explicit dependency declarations (`depends on: Phase N`)
-- [ ] No circular dependencies
+- [ ] No circular dependencies between phases
+- [ ] No conflicting requirements across sections (e.g., a Non-Goal contradicts a Technical Requirement)
+- [ ] Section content is not placeholder/template text (e.g., "2–3 sentences about…", "Description here")
 
-### Language Quality
+### Implementation Coherence (BLOCKING)
 
-- [ ] No **domain-specific** acronyms or jargon used without explanation (standard software acronyms like API, CSS, HTML, CI/CD, CMS, SDK, CLI, URL, JSON, REST, SQL, SSR, SSG, CDN, DNS, TLS, JWT, OAuth, CRUD, DOM, UI, UX, HTTP, HTTPS, LTS, WCAG, RTL, MCP, PRD, E2E are considered universally understood and do not need expansion)
-- [ ] No conflicting requirements (e.g., "must be fast AND run full suite on every change")
-- [ ] Section content is not placeholder/template text (e.g., "2–3 sentences about…", "Description here")
+- [ ] Implementation Scope lists specific files or subdirectories (not just `src/` or `the frontend`)
+- [ ] Each workstream lists the files it will modify
 
 ---
 
@@ -76,7 +53,7 @@ Your entire response must be a single fenced JSON block — no text before or af
 }
 ```
 
-Or if any check fails:
+Or if any **BLOCKING** check fails:
 
 ```json
 {