opencastle 0.32.10 → 0.32.11

package/README.md

@@ -9,9 +9,9 @@
 </p>
 
 <p align="center">
-  <a href="https://github.com/etylsarin/opencastle/stargazers"><img src="https://img.shields.io/github/stars/etylsarin/opencastle?style=flat" alt="GitHub stars" /></a>
+  <a href="https://github.com/monkilabs/opencastle/stargazers"><img src="https://img.shields.io/github/stars/monkilabs/opencastle?style=flat" alt="GitHub stars" /></a>
   <a href="https://www.npmjs.com/package/opencastle"><img src="https://img.shields.io/npm/v/opencastle.svg?v=1" alt="npm version" /></a>
-  <a href="https://github.com/etylsarin/opencastle/actions/workflows/ci.yml"><img src="https://github.com/etylsarin/opencastle/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+  <a href="https://github.com/monkilabs/opencastle/actions/workflows/ci.yml"><img src="https://github.com/monkilabs/opencastle/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
   <a href="https://www.npmjs.com/package/opencastle"><img src="https://img.shields.io/npm/dm/opencastle.svg?v=1" alt="downloads" /></a>
 </p>
 
@@ -217,7 +217,7 @@ See **[ARCHITECTURE.md](ARCHITECTURE.md)** for the full diagram, workflow templa
 3. Make changes and ensure `npm run build:cli` passes
 4. Open a PR
 
-For large changes, [open an issue](https://github.com/etylsarin/opencastle/issues) first.
+For large changes, [open an issue](https://github.com/monkilabs/opencastle/issues) first.
 
 <br>
 
@@ -229,7 +229,7 @@ OpenCastle is free and open-source.
   <a href="https://ko-fi.com/A0A61V4992" target="_blank"><img height="36" style="border:0px;height:36px;" src="https://storage.ko-fi.com/cdn/kofi4.png?v=6" border="0" alt="Buy Me a Coffee at ko-fi.com" /></a>
 </p>
 
-For corporate sponsorship inquiries, open a [GitHub Discussion](https://github.com/etylsarin/opencastle/discussions).
+For corporate sponsorship inquiries, open a [GitHub Discussion](https://github.com/monkilabs/opencastle/discussions).
 
 <br>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencastle",
-  "version": "0.32.10",
+  "version": "0.32.11",
   "type": "module",
   "description": "Multi-agent orchestration framework for AI coding assistants",
   "bin": {
@@ -25,10 +25,10 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/etylsarin/opencastle.git"
+    "url": "git+https://github.com/monkilabs/opencastle.git"
   },
   "bugs": {
-    "url": "https://github.com/etylsarin/opencastle/issues"
+    "url": "https://github.com/monkilabs/opencastle/issues"
   },
   "homepage": "https://www.opencastle.dev/",
   "license": "BUSL-1.1",

package/src/dashboard/dist/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-18T16:27:21.682Z"
+      "created_at": "2026-03-19T08:38:59.892Z"
     },
     {
       "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-18T16:27:21.682Z"
+      "created_at": "2026-03-19T08:38:59.892Z"
     },
     {
       "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-18T16:27:21.682Z"
+      "created_at": "2026-03-19T08:38:59.892Z"
     }
   ],
   "has_more_events": false,

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-18T16:27:21.681Z"
+      "created_at": "2026-03-19T08:38:59.891Z"
     },
     {
       "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-18T16:27:21.681Z"
+      "created_at": "2026-03-19T08:38:59.891Z"
     },
     {
       "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-18T16:27:21.681Z"
+      "created_at": "2026-03-19T08:38:59.891Z"
     },
     {
       "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-18T16:27:21.681Z"
+      "created_at": "2026-03-19T08:38:59.891Z"
     }
   ],
   "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-src-components-KpiCard-tsx",
+      "name": "src/components/KpiCard.tsx",
+      "type": "file",
+      "task_id": "ui-t2",
+      "created_at": "2026-03-19T08:38:59.891Z"
+    },
+    {
+      "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-19T08:38:59.891Z"
+    },
     {
       "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"
+      "created_at": "2026-03-19T08:38:59.892Z"
     },
     {
       "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"
+      "created_at": "2026-03-19T08:38:59.892Z"
     },
     {
       "id": "artifact-demo-dashboard-ui-src-components-DonutChart-tsx",
       "name": "src/components/DonutChart.tsx",
       "type": "file",
       "task_id": "ui-t3",
-      "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-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-18T16:27:21.681Z"
+      "created_at": "2026-03-19T08:38:59.892Z"
     },
     {
       "id": "artifact-demo-dashboard-ui-src-styles-animations-css",
       "name": "src/styles/animations.css",
       "type": "file",
       "task_id": "ui-t4",
-      "created_at": "2026-03-18T16:27:21.681Z"
+      "created_at": "2026-03-19T08:38:59.892Z"
     }
   ],
   "has_more_events": false,

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

@@ -42,21 +42,21 @@
       "name": "src/etl/pipeline.ts",
       "type": "file",
       "task_id": "etl-t2",
-      "created_at": "2026-03-18T16:27:21.682Z"
+      "created_at": "2026-03-19T08:38:59.893Z"
     },
     {
       "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"
+      "created_at": "2026-03-19T08:38:59.893Z"
     },
     {
       "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-18T16:27:21.682Z"
+      "created_at": "2026-03-19T08:38:59.893Z"
     }
   ],
   "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-18T16:27:21.683Z"
+      "created_at": "2026-03-19T08:38:59.893Z"
     }
   ],
   "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-18T16:27:21.683Z"
+      "created_at": "2026-03-19T08:38:59.893Z"
     },
     {
       "id": "artifact-demo-docs-update-docs-README-md",
       "name": "docs/README.md",
       "type": "file",
       "task_id": "docs-t1",
-      "created_at": "2026-03-18T16:27:21.683Z"
+      "created_at": "2026-03-19T08:38:59.893Z"
     },
     {
       "id": "artifact-demo-docs-update-docs-api-reference-json",
       "name": "docs/api-reference.json",
       "type": "json",
       "task_id": "docs-t2",
-      "created_at": "2026-03-18T16:27:21.683Z"
+      "created_at": "2026-03-19T08:38:59.893Z"
     }
   ],
   "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-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-18T16:27:21.682Z"
+      "created_at": "2026-03-19T08:38:59.892Z"
     },
     {
       "id": "artifact-demo-perf-opt-src-charts-index-ts",
       "name": "src/charts/index.ts",
       "type": "file",
       "task_id": "perf-t2",
-      "created_at": "2026-03-18T16:27:21.682Z"
+      "created_at": "2026-03-19T08:38:59.892Z"
     },
     {
       "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-18T16:27:21.682Z"
+      "created_at": "2026-03-19T08:38:59.892Z"
+    },
+    {
+      "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-19T08:38:59.893Z"
     }
   ],
   "has_more_events": false,

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

@@ -1,25 +1,25 @@
 {
-  "hash": "5b4f7f3a",
+  "hash": "020233d7",
   "configHash": "30f8ea04",
-  "lockfileHash": "97dd4ca5",
-  "browserHash": "5e0c0fdd",
+  "lockfileHash": "69796611",
+  "browserHash": "34d3234c",
   "optimized": {
     "astro > cssesc": {
       "src": "../../../../../node_modules/cssesc/cssesc.js",
       "file": "astro___cssesc.js",
-      "fileHash": "e6cc8cd0",
+      "fileHash": "05b8ecee",
       "needsInterop": true
     },
     "astro > aria-query": {
       "src": "../../../../../node_modules/aria-query/lib/index.js",
       "file": "astro___aria-query.js",
-      "fileHash": "1b619d97",
+      "fileHash": "ef1888bf",
       "needsInterop": true
     },
     "astro > axobject-query": {
       "src": "../../../../../node_modules/axobject-query/lib/index.js",
       "file": "astro___axobject-query.js",
-      "fileHash": "7383e20b",
+      "fileHash": "e8ea3992",
       "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-18T16:27:21.682Z"
+      "created_at": "2026-03-19T08:38:59.892Z"
     },
     {
       "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-18T16:27:21.682Z"
+      "created_at": "2026-03-19T08:38:59.892Z"
     },
     {
       "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-18T16:27:21.682Z"
+      "created_at": "2026-03-19T08:38:59.892Z"
     }
   ],
   "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-18T16:27:21.681Z"
+      "created_at": "2026-03-19T08:38:59.891Z"
     },
     {
       "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-18T16:27:21.681Z"
+      "created_at": "2026-03-19T08:38:59.891Z"
     },
     {
       "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-18T16:27:21.681Z"
+      "created_at": "2026-03-19T08:38:59.891Z"
     },
     {
       "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-18T16:27:21.681Z"
+      "created_at": "2026-03-19T08:38:59.891Z"
     }
   ],
   "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-src-components-KpiCard-tsx",
+      "name": "src/components/KpiCard.tsx",
+      "type": "file",
+      "task_id": "ui-t2",
+      "created_at": "2026-03-19T08:38:59.891Z"
+    },
+    {
+      "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-19T08:38:59.891Z"
+    },
     {
       "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"
+      "created_at": "2026-03-19T08:38:59.892Z"
     },
     {
       "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"
+      "created_at": "2026-03-19T08:38:59.892Z"
     },
     {
       "id": "artifact-demo-dashboard-ui-src-components-DonutChart-tsx",
       "name": "src/components/DonutChart.tsx",
       "type": "file",
       "task_id": "ui-t3",
-      "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-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-18T16:27:21.681Z"
+      "created_at": "2026-03-19T08:38:59.892Z"
     },
     {
       "id": "artifact-demo-dashboard-ui-src-styles-animations-css",
       "name": "src/styles/animations.css",
       "type": "file",
       "task_id": "ui-t4",
-      "created_at": "2026-03-18T16:27:21.681Z"
+      "created_at": "2026-03-19T08:38:59.892Z"
     }
   ],
   "has_more_events": false,

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

@@ -42,21 +42,21 @@
       "name": "src/etl/pipeline.ts",
       "type": "file",
       "task_id": "etl-t2",
-      "created_at": "2026-03-18T16:27:21.682Z"
+      "created_at": "2026-03-19T08:38:59.893Z"
     },
     {
       "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"
+      "created_at": "2026-03-19T08:38:59.893Z"
     },
     {
       "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-18T16:27:21.682Z"
+      "created_at": "2026-03-19T08:38:59.893Z"
     }
   ],
   "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-18T16:27:21.683Z"
+      "created_at": "2026-03-19T08:38:59.893Z"
     }
   ],
   "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-18T16:27:21.683Z"
+      "created_at": "2026-03-19T08:38:59.893Z"
     },
     {
       "id": "artifact-demo-docs-update-docs-README-md",
       "name": "docs/README.md",
       "type": "file",
       "task_id": "docs-t1",
-      "created_at": "2026-03-18T16:27:21.683Z"
+      "created_at": "2026-03-19T08:38:59.893Z"
     },
     {
       "id": "artifact-demo-docs-update-docs-api-reference-json",
       "name": "docs/api-reference.json",
       "type": "json",
       "task_id": "docs-t2",
-      "created_at": "2026-03-18T16:27:21.683Z"
+      "created_at": "2026-03-19T08:38:59.893Z"
     }
   ],
   "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-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-18T16:27:21.682Z"
+      "created_at": "2026-03-19T08:38:59.892Z"
     },
     {
       "id": "artifact-demo-perf-opt-src-charts-index-ts",
       "name": "src/charts/index.ts",
       "type": "file",
       "task_id": "perf-t2",
-      "created_at": "2026-03-18T16:27:21.682Z"
+      "created_at": "2026-03-19T08:38:59.892Z"
     },
     {
       "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-18T16:27:21.682Z"
+      "created_at": "2026-03-19T08:38:59.892Z"
+    },
+    {
+      "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-19T08:38:59.893Z"
     }
   ],
   "has_more_events": false,

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

@@ -173,25 +173,7 @@ Each task `prompt` must be a **complete, standalone instruction**. Include:
 >
 > **Weak page prompt:** "Build the About page with a bio and skills section." — No foundation references, agent will create its own styles.
 
-### 6. Validate Before Outputting
-
-- [ ] Every task has a unique `id`
-- [ ] Every `depends_on` reference points to a valid `id` defined earlier in the list
-- [ ] No dependency cycles exist
-- [ ] No two parallel tasks share the same `files` entries — group tasks by phase and check each phase for overlaps; resolve with specific file paths or `depends_on` (see Step 2, rule 4)
-- [ ] No `files` entry contains `*`, `?`, or `**` — use plain file paths or directory paths only
-- [ ] Prompts are self-contained — an agent with zero context can execute them
-- [ ] Timeouts are reasonable for the scope of each task
-- [ ] **Dependency completeness**: For every task prompt, scan for imports, references, or usage of files/types/components produced by other tasks. Each such cross-reference MUST have a `depends_on` edge to the producing task.
-- [ ] **Agent domain matching**: Verify each task's `agent` matches the domain — `developer` for code, `testing-expert` for tests, `documentation-writer` for docs, `copywriter` for marketing copy, `ui-ux-expert` for UI components, `database-engineer` for migrations, `security-expert` for auth/security, `data-expert` for ETL/scraping. A `content-engineer` should NOT be assigned to pure TypeScript code tasks.
-- [ ] **File list completeness**: Every file mentioned in a task's prompt that the agent will create or modify MUST appear in that task's `files` list. Don't omit utility files, sub-components, or config files if the prompt instructs the agent to create them.
-- [ ] **Prompt instruction accuracy**: Don't include instructions that contradict the dependency graph. If a task depends on another task (via `depends_on`), the depended task's outputs will exist when this task runs — don't add `@ts-expect-error` comments, stub files, or "if not found" fallbacks for files produced by dependencies.
-- [ ] **Content research rule compliance**: If a prompt concerns real people, places, or organisations, it includes a research instruction telling the agent to search the internet first.
-- [ ] **Foundation phase present**: If the plan involves 2+ pages or UI sections, a `foundation-setup` task exists with no dependencies, and all page tasks depend on it
-- [ ] **Foundation references in page prompts**: Every page-building task prompt includes the 5 mandatory Foundation References (design tokens path, layout path, UI component path, aesthetic direction, content tone)
-- [ ] **No token duplication**: Page task prompts do NOT instruct agents to create new design tokens, layout components, or shared UI primitives — only to import and use existing ones from the foundation
-
-### 7. Output
+### 6. Output
 
 Your response must contain **ONLY** a single ` ```json ` fenced code block — no text before it, no text after it, no explanations, no summaries, no DAG diagrams.
 
@@ -234,6 +216,38 @@ When chain mode is detected:
 }
 ````
 
+## Self-Validation Checklist (MANDATORY)
+
+Before outputting the JSON, verify **every item** below. The downstream validator will reject your plan if any blocking checks fail — fix them now to avoid expensive retry cycles.
+
+### Structural Integrity
+
+- [ ] Every task has a unique `id` (lowercase, kebab-case)
+- [ ] Every `depends_on` reference points to a valid `id` defined in the task list
+- [ ] No dependency cycles exist (DAG is acyclic)
+- [ ] No `files` entry contains `*`, `?`, or `**` — plain paths only
+- [ ] Top-level `name` and `tasks` fields are present; `tasks` is non-empty
+- [ ] Every task has both `id` and `prompt` fields (both non-empty strings)
+
+### Partition & Dependency Coherence
+
+- [ ] No two parallel tasks (same phase / no `depends_on` edge) share any `files` entry — resolve with specific file paths or sequencing
+- [ ] **Dependency completeness**: For every task prompt, scan for imports or references to files/types/components produced by other tasks. Each cross-reference MUST have a `depends_on` edge to the producing task.
+- [ ] **File list completeness**: Every file mentioned in a task's prompt that the agent will create or modify appears in that task's `files` list. Don't omit utility files, sub-components, or config files.
+- [ ] **Prompt-dependency coherence**: Prompts do not include workarounds (stub files, `@ts-expect-error`, conditional imports) for outputs of tasks listed in `depends_on`, since those outputs are guaranteed to exist.
+
+### Prompt Quality
+
+- [ ] **Self-contained**: An agent with zero context can execute the prompt without external clarification.
+- [ ] **File-specific**: Names the exact files to create or modify — no vague references ("the frontend", "the codebase").
+- [ ] **Substantive**: At least 2 meaningful sentences; no stubs (`...`), no placeholders.
+- [ ] **Verifiable**: Contains acceptance criteria or explicit verification steps.
+- [ ] **Agent domain matching**: Each task's `agent` matches the domain — `developer` for code, `testing-expert` for tests, `documentation-writer` for docs, `copywriter` for marketing copy, `ui-ux-expert` for UI, `database-engineer` for migrations, `security-expert` for auth/security, `data-expert` for ETL/scraping.
+- [ ] **Content research compliance**: If a prompt concerns real people, places, or organisations, it includes a research instruction.
+- [ ] **Foundation phase present** (multi-page only): If 2+ pages/UI sections, a `foundation-setup` task exists and all page tasks depend on it with the 5 mandatory Foundation References.
+
+---
+
 ## Historical Performance Context
 
 When historical execution data is available (via `opencastle insights --json`), the Team Lead should include a compact summary in the context. Example:

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

@@ -8,11 +8,9 @@ output: validation
 
 # Validate Task Plan
 
-> **Note:** Schema validation (field types, YAML syntax, dependency cycles, glob patterns) has already passed. Focus ONLY on the semantic checks below.
+> **Note:** Schema validation (field types, YAML syntax, dependency cycles, glob patterns) has already passed. The generator already enforces prompt quality, agent matching, and file list completeness. Focus ONLY on the structural and logical checks below.
 
-You are a senior technical reviewer. Validate the task plan below for semantic correctness. Be strict — a plan that passes this gate will be executed autonomously by AI agents.
-
-> **⚠ EXHAUSTIVENESS MANDATE**: You MUST report ALL errors in a single pass. Do NOT stop at the first few issues. Systematically evaluate every task against every check below. A second validation pass should find zero new issues — if it would, your first pass was incomplete. Cross-reference every task's prompt against every other task's files list and dependency edges before concluding.
+You are a senior technical reviewer. Validate the task plan below for **structural correctness**. Pass the plan if the structure is sound — do not fail for prompt wording, style, or verbosity.
 
 ## Task Plan to Validate
 
@@ -20,46 +18,31 @@ You are a senior technical reviewer. Validate the task plan below for semantic c
 
 ---
 
-## Semantic Checks
+## Validation Checks
 
-> If the spec 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.
+> If the spec contains `<!-- validation-pass: N -->`, this is pass N. On pass 2+, verify previous fixes were applied — do NOT invent new issues.
 
-Evaluate **every check** below. If ALL pass, respond `VALID`. If ANY fail, respond `INVALID` with specific, actionable errors.
+Evaluate the checks below. If ALL pass, respond `VALID`. Only fail for checks marked BLOCKING.
 
-### 1. Partition Conflicts
+### Partition Conflicts (BLOCKING)
 
 Two tasks that can run in parallel (no direct or transitive `depends_on` edge between them) must not share any `files` entry.
 
 - [ ] For every pair of potentially-parallel tasks, confirm they share no file or directory path in their `files` lists
 - [ ] Transitive dependencies count: if A → B → C, then A and C are NOT parallel
 
-### 2. Prompt Quality
-
-Each task `prompt` must be:
-
-- [ ] **Self-contained** — an agent with zero context can execute it without external clarification
-- [ ] **File-specific** — names the exact files to create or modify (not vague references like "the frontend" or "the codebase")
-- [ ] **Substantive** — at least 2 meaningful sentences; no stubs (`...`), no placeholders
-- [ ] **Verifiable** — contains acceptance criteria or explicit verification steps
-- [ ] **Research-instructed** — if the prompt concerns real people, places, or organisations, it includes a research instruction
-
-### 3. Dependency Completeness
-
-If a task's prompt imports, references, or builds on files, types, components, or packages produced by another task, a `depends_on` edge to that producing task must exist.
+### Dependency Completeness (BLOCKING)
 
-- [ ] Scan every prompt for cross-task file imports, type usage, or component references
-- [ ] Each such reference must be covered by a `depends_on` edge to the task that creates it
+If a task's prompt imports, references, or builds on files produced by another task, a `depends_on` edge to that producing task must exist.
 
-### 4. Logical Soundness
+- [ ] Scan every prompt for cross-task file references
+- [ ] Each such reference must be covered by a `depends_on` edge
 
-The overall plan must make engineering sense.
+### Logical Soundness (BLOCKING)
 
 - [ ] No redundant tasks doing the same work
-- [ ] No obvious missing tasks (gaps that would leave the goal unachievable)
-- [ ] File ownership matches task descriptions (a task that owns a file should actually modify it)
-- [ ] Agent assignment matches domain — `developer` for code, `documentation-writer` for docs, `copywriter` for marketing copy, etc.
-- [ ] File list completeness — every file the prompt instructs the agent to create/modify appears in the task's `files` list
-- [ ] Prompt-dependency coherence — prompts do not include workarounds (stub files, `@ts-expect-error`, conditional imports) for outputs of tasks listed in `depends_on`, since those outputs are guaranteed to exist
+- [ ] No obvious missing tasks that would leave the goal unachievable
+- [ ] No tasks with empty or stub prompts (`...`, placeholder text)
 
 ---