@tea-agent/loop-agent 0.11.0 → 0.13.0-alpha.0

package/docs/templates/backend-test-dag.json

@@ -0,0 +1,288 @@
+{
+  "$schema": "./agent-dag.schema.json",
+  "version": 3,
+  "title": "Backend test DAG template",
+  "runtimeContract": {
+    "schemaVersion": 1,
+    "agentRuntime": "pi-only",
+    "repairWriterProtocol": "explicit-node-v1"
+  },
+  "objective": "End-to-end backend functional testing pipeline: analyze requirements → generate functional test cases → review cases → generate pytest automation → execute pytest → retrospective with maturity rating. Covers the full chain from requirement analysis to test maturity assessment.",
+  "successCriteria": [
+    "analyze-inputs-pi returns a read-only test analysis contract covering scope, risks, and strategy",
+    "generate-backend-functional-cases-pi produces structured test cases with BE-<MODULE>-<NNN> IDs under testcase/md/",
+    "review-backend-cases-pi returns VERDICT: pass or request-revision with coverage assessment",
+    "review-backend-cases-gate-shell blocks pytest generation unless the review verdict is VERDICT: pass",
+    "generate-backend-pytest-pi converts reviewed cases into pytest code with 1:1 traceability under testcase/",
+    "execute-backend-pytest-shell runs pytest and produces HTML report under reports/",
+    "test-retrospect-pi generates retrospective report with A/B/C/D maturity rating under docs/test-reports/",
+    "Full traceability from acceptance criteria → functional test case ID → pytest function name"
+  ],
+  "globalConstraints": [
+    "Replace every REPLACE/WITH/... placeholder with concrete repo paths before execution; do not leave template placeholders in production DAG JSON.",
+    "Do not commit runtime traces under .harness/dag-runs/.",
+    "Use only existing executors: pi, shell. Pi writer nodes must set toolProfile=write.",
+    "Read-only nodes must not write repository files, including root artifacts/**.",
+    "Exclusive writer nodes must stay within declared writeSet.",
+    "Every task must explicitly declare executor; defaults.executor is schema-only and not a runtime fallback.",
+    "Functional test case IDs must use BE-<MODULE>-<NNN> format.",
+    "pytest execution must produce HTML reports under reports/.",
+    "Backend-test-dag nodes must maintain traceability from requirements to functional cases to pytest automation.",
+    "pytest automation scripts must use test_ filename prefix for pytest discovery.",
+    "generate-backend-pytest-pi must only create new test files under testcase/; modifying existing framework files (conftest.py, pytest.ini, pyproject.toml) is forbidden.",
+    "review-backend-cases-gate-shell must block pytest generation unless the review verdict is exactly VERDICT: pass.",
+    "If a target test filename already exists under testcase/, add a numeric suffix (_01, _02, ...); never overwrite or append to existing files.",
+    "execute-backend-pytest-shell must not modify test assertions or production code to make tests pass; test failures indicate potential implementation issues and must be reported honestly.",
+    "Prompt templates must not ask main session to write artifacts; node output is the artifact and runner archives it under .harness/dag-runs/.",
+    "Actual file operation paths must be macOS/Windows compatible; use / only for stable repo refs, JSON/Markdown evidence refs, and glob conventions.",
+    "Same-rank exclusive writeSet entries must be disjoint."
+  ],
+  "convergence": {
+    "enabled": true,
+    "maxPasses": 3,
+    "stopOnVerdictPass": true,
+    "stopOnHardVerifyPass": true,
+    "pauseOnRegression": true,
+    "chainNodeIds": [
+      "generate-backend-functional-cases-pi",
+      "review-backend-cases-pi",
+      "review-backend-cases-gate-shell"
+    ]
+  },
+  "defaults": {
+    "executor": "pi",
+    "contextProfile": "slim",
+    "skills": [
+      "ai-engineering-context"
+    ],
+    "writePolicy": "read-only"
+  },
+  "skillsByRole": {
+    "planner": [
+      "loop-agent"
+    ],
+    "scout": [],
+    "implementer": [
+      "test-driven-development",
+      "verification-before-completion"
+    ],
+    "reviewer": [
+      "requesting-code-review",
+      "code-review-core"
+    ],
+    "verifier": [
+      "verification-before-completion",
+      "systematic-debugging"
+    ],
+    "closeout": [
+      "loop-agent",
+      "verification-before-completion"
+    ]
+  },
+  "executorModels": {
+    "pi": {
+      "LOW": "gpt-5.3-codex-spark",
+      "MED": "glm-5.2",
+      "HIGH": "gpt-5.5"
+    }
+  },
+  "tasks": [
+    {
+      "id": "analyze-inputs-pi",
+      "depends_on": [],
+      "complexity": "MED",
+      "executor": "pi",
+      "role": "planner",
+      "writePolicy": "read-only",
+      "allowedPaths": [
+        "REPLACE/WITH/SOURCE/PATH/**"
+      ],
+      "forbiddenPaths": [
+        ".harness/**",
+        "artifacts/**"
+      ],
+      "outputContract": "Structured Markdown extracting core content from source documents. No file writes.",
+      "retryPolicy": {
+        "maxAttempts": 3,
+        "backoff": "exponential",
+        "initialDelayMs": 2000,
+        "maxDelayMs": 30000,
+        "retryCategories": [
+          "timeout",
+          "network",
+          "rate-limit",
+          "unavailable"
+        ]
+      },
+      "subtask_prompt": "Read the task source materials and extract the following structured content for downstream test generation.\n\n## Required Output Sections:\n\n### 1. API Endpoints\nList all API endpoints: Method, Path, Description, Request params, Response format.\n\n### 2. Data Model\nFor each table/collection: fields, types, constraints, descriptions.\n\n### 3. Business Logic\nCore business rules, validation rules, calculation formulas.\n\n### 4. State Transitions\nState machines (e.g. order status: pending → paid → shipped → completed).\n\n### 5. Error Scenarios & Error Codes\nAll error codes, error messages, and when they occur.\n\n### 6. External Dependencies\nThird-party services, databases, message queues. Include timeout settings if documented.\n\n### 7. Acceptance Criteria\nExtract ALL acceptance criteria from 需求.md. Number them AC-001, AC-002, etc. If not explicitly listed, derive from functional requirements.\n\n### 8. Risk Areas\nHigh-risk areas requiring extra test coverage.\n\n## Conditional Sections (include ONLY if mentioned in requirements):\n- Authentication & Authorization: include ONLY if requirements mention auth mechanism (JWT, OAuth2, API Key, etc.)\n- Timeout Handling: include ONLY if requirements mention timeout configuration or degradation strategy\n- Concurrency & Idempotency: include ONLY if requirements mention concurrency, idempotency rules, or locking mechanisms\n- State Transitions: include ONLY if requirements mention business state machines\n- If not mentioned in requirements, do NOT include these sections\n\nThis output will be used directly by downstream nodes. Be thorough and structured.\nRead-only: do not modify code, docs, artifacts, or repository files."
+    },
+    {
+      "id": "generate-backend-functional-cases-pi",
+      "depends_on": [
+        "analyze-inputs-pi"
+      ],
+      "complexity": "MED",
+      "executor": "pi",
+      "role": "implementer",
+      "toolProfile": "write",
+      "writePolicy": "exclusive",
+      "writeSet": [
+        "testcase/md/**"
+      ],
+      "allowedPaths": [
+        "testcase/md/**"
+      ],
+      "forbiddenPaths": [
+        ".harness/**",
+        "artifacts/**"
+      ],
+      "outputContract": "Structured backend functional test cases in Markdown under testcase/md/. Each case uses BE-<MODULE>-<NNN> ID format.",
+      "subtask_prompt": "Based on the upstream analyze-inputs-pi output, generate structured backend functional test cases.\n\n## Output Steps (do in order):\n1. First, output a brief summary: how many modules, how many cases planned per module\n2. Then write each test case file under testcase/md/\n\n## Format Rules:\n- Each test case ID: BE-<MODULE>-<NNN> (e.g. BE-ORDER-001)\n- Each file covers one module\n- Case structure: ID, Title, Precondition, Steps, Expected Result\n- Map each case to acceptance criteria (AC-xxx)\n\n## Coverage Requirements:\n- Positive paths: happy path for each acceptance criterion\n- Negative paths: error scenarios (invalid input, not found, state violations)\n- Boundary conditions: empty input, max length, edge values\n\n## Conditional Coverage (include ONLY if mentioned in upstream analysis):\n- State transitions: include ONLY if upstream analyze-inputs-pi mentions state machine\n- Authentication scenarios: include ONLY if upstream analyze-inputs-pi mentions auth mechanism\n- Timeout scenarios: include ONLY if upstream analyze-inputs-pi mentions timeout handling\n- Concurrency scenarios: include ONLY if upstream analyze-inputs-pi mentions concurrency/idempotency rules\n- If not mentioned, do NOT generate these test cases\n\n## Constraints:\n- Stay within writeSet: testcase/md/**\n- Do NOT re-read source documents — use the upstream analyze-inputs-pi output only\n- Do not write root artifacts/**"
+    },
+    {
+      "id": "review-backend-cases-pi",
+      "depends_on": [
+        "generate-backend-functional-cases-pi"
+      ],
+      "complexity": "HIGH",
+      "executor": "pi",
+      "role": "reviewer",
+      "writePolicy": "read-only",
+      "allowedPaths": [
+        "**"
+      ],
+      "forbiddenPaths": [
+        ".harness/**",
+        "artifacts/**"
+      ],
+      "outputContract": "Plain Markdown whose first non-empty line is VERDICT: pass or VERDICT: request-revision; followed by Findings and Coverage Assessment. No file writes.",
+      "retryPolicy": {
+        "maxAttempts": 3,
+        "backoff": "exponential",
+        "initialDelayMs": 2000,
+        "maxDelayMs": 30000,
+        "retryCategories": [
+          "timeout",
+          "network",
+          "rate-limit",
+          "unavailable"
+        ]
+      },
+      "subtask_prompt_markdown": "./backend-test-dag.review-cases.prompt.md"
+    },
+    {
+      "id": "review-backend-cases-gate-shell",
+      "depends_on": [
+        "review-backend-cases-pi"
+      ],
+      "complexity": "LOW",
+      "executor": "shell",
+      "role": "verifier",
+      "writePolicy": "read-only",
+      "allowedPaths": [
+        "**"
+      ],
+      "forbiddenPaths": [
+        ".harness/**",
+        "artifacts/**"
+      ],
+      "outputContract": "Deterministic backend case review gate: exit 0 only when review-backend-cases-pi emits VERDICT: pass.",
+      "subtask_prompt": "Deterministic gate: block pytest generation unless backend case review emitted VERDICT: pass.",
+      "shell": {
+        "commands": [],
+        "verdictGate": {
+          "fromNodeId": "review-backend-cases-pi",
+          "accept": [
+            "VERDICT: pass"
+          ],
+          "label": "backend case review",
+          "lineMode": "first-verdict-line"
+        },
+        "cwd": ".",
+        "timeoutMs": 60000
+      }
+    },
+    {
+      "id": "generate-backend-pytest-pi",
+      "depends_on": [
+        "review-backend-cases-gate-shell"
+      ],
+      "complexity": "HIGH",
+      "executor": "pi",
+      "role": "implementer",
+      "toolProfile": "write",
+      "writePolicy": "exclusive",
+      "writeSet": [
+        "testcase/**/test_*.py"
+      ],
+      "allowedPaths": [
+        "testcase/**/test_*.py"
+      ],
+      "forbiddenPaths": [
+        ".harness/**",
+        "artifacts/**"
+      ],
+      "outputContract": "Pytest test files under testcase/ with 1:1 mapping to functional test case IDs. Summary lists generated files, test function count, and any skipped cases with reasons.",
+      "subtask_prompt_markdown": "./backend-test-dag.generate-pytest.prompt.md"
+    },
+    {
+      "id": "execute-backend-pytest-shell",
+      "depends_on": [
+        "generate-backend-pytest-pi"
+      ],
+      "complexity": "LOW",
+      "executor": "shell",
+      "role": "verifier",
+      "writePolicy": "read-only",
+      "allowedPaths": [
+        "**"
+      ],
+      "forbiddenPaths": [
+        ".harness/**",
+        "artifacts/**"
+      ],
+      "outputContract": "Archived pytest stdout/stderr with exit codes and HTML report path; no source or test file modifications.",
+      "subtask_prompt": "Run pytest for the backend test suite and capture results.",
+      "shell": {
+        "commands": [
+          "python -m pytest testcase/ --html=reports/backend-test-report.html -v"
+        ],
+        "verifyEvidence": {
+          "phase": "final",
+          "quota": "full",
+          "commandSource": "inline",
+          "commandCount": 1,
+          "commandLabels": [
+            "backend pytest execution"
+          ],
+          "finalFullRequired": true
+        },
+        "cwd": ".",
+        "timeoutMs": 300000
+      }
+    },
+    {
+      "id": "test-retrospect-pi",
+      "depends_on": [
+        "execute-backend-pytest-shell"
+      ],
+      "complexity": "MED",
+      "executor": "pi",
+      "role": "closeout",
+      "toolProfile": "write",
+      "writePolicy": "exclusive",
+      "writeSet": [
+        "docs/test-reports/**"
+      ],
+      "allowedPaths": [
+        "docs/test-reports/**"
+      ],
+      "forbiddenPaths": [
+        ".harness/**",
+        "artifacts/**"
+      ],
+      "outputContract": "Markdown retrospective report under docs/test-reports/ with coverage summary, review findings, pytest results, and maturity rating (A/B/C/D).",
+      "subtask_prompt_markdown": "./backend-test-dag.retrospect.prompt.md"
+    }
+  ]
+}

package/docs/templates/backend-test-dag.retrospect.prompt.md

@@ -0,0 +1,125 @@
+# Backend Test DAG Retrospect Prompt Template
+
+## Purpose
+
+Use this prompt for a **test retrospective** node: `executor: "pi"`, `role: "closeout"`, `toolProfile: "write"`, `writePolicy: "exclusive"`. The closeout agent reads upstream review reports and pytest execution results, then generates a retrospective report with an objective maturity rating.
+
+Do **not** create a new executor type. This is a standard `executor: pi` writer node.
+
+## Recommended DAG Node Shape
+
+```json
+{
+  "id": "test-retrospect-pi",
+  "depends_on": ["execute-backend-pytest-shell"],
+  "complexity": "MED",
+  "executor": "pi",
+  "role": "closeout",
+  "toolProfile": "write",
+  "writePolicy": "exclusive",
+  "writeSet": ["docs/test-reports/**"],
+  "allowedPaths": ["docs/test-reports/**"],
+  "forbiddenPaths": [".harness/**", "artifacts/**"],
+  "outputContract": "Markdown retrospective report under docs/test-reports/ with coverage summary, review findings, pytest results, and maturity rating (A/B/C/D).",
+  "subtask_prompt_markdown": "./backend-test-dag.retrospect.prompt.md"
+}
+```
+
+## Prompt Body
+
+You are the Backend Test DAG **test retrospective** agent.
+
+Your job is to read upstream outputs (review report + pytest results) and generate a retrospective report with a maturity rating. Write the report under `docs/test-reports/` only. Stay within `writeSet`. Do not write root `artifacts/**`.
+
+### Output Steps (do in order)
+
+1. First, output the maturity rating on the first line: `Rating: A/B/C/D`
+2. Then write the full report under `docs/test-reports/`
+
+### Inputs
+
+1. **Review report** — `review-backend-cases-pi` output (VERDICT, findings, coverage assessment).
+2. **Pytest output** — `execute-backend-pytest-shell` stdout/stderr and exit code.
+3. **HTML report** — `reports/backend-test-report.html` (if generated).
+
+Do NOT re-read source documents. Use upstream outputs only.
+
+### Maturity Rating Criteria
+
+| Rating | Coverage | Pass Rate | Review Findings |
+|--------|----------|-----------|-----------------|
+| **A** | 100% acceptance criteria covered | 100% pytest pass | No Critical or Important findings |
+| **B** | ≥80% acceptance criteria covered | ≥90% pytest pass | Only Informational findings |
+| **C** | ≥60% acceptance criteria covered | ≥70% pytest pass | No Critical findings (Important allowed) |
+| **D** | Below C thresholds | Below C thresholds | Or any Critical finding unresolved |
+
+#### Rating Rules
+
+- **Coverage** = (acceptance criteria with ≥1 covering test case) / (total acceptance criteria) × 100%
+- **Pass rate** = (passed pytest functions) / (total non-skipped pytest functions) × 100%
+- If `review-backend-cases-pi` returned `VERDICT: request-revision` and revision was not completed, cap at **D**.
+- If pytest exit code is non-zero and >30% tests failed, cap at **D** regardless of coverage.
+- Skipped tests (`@pytest.mark.skip`) count as "not covered" for pass rate but not as failures.
+
+### Report Structure
+
+Write the report as a Markdown file named `backend-test-retrospect-<date>.md` under `docs/test-reports/`.
+
+```markdown
+# Backend Test Retrospective Report
+
+**Date:** <YYYY-MM-DD>
+**Task:** <task-id>
+**Maturity Rating:** <A|B|C|D>
+
+## 1. Test Coverage Summary
+
+| Metric | Value |
+|--------|-------|
+| Total acceptance criteria | N |
+| Covered by test cases | N (X%) |
+| Total functional test cases | N |
+| Positive path cases | N |
+| Negative path cases | N |
+| Boundary cases | N |
+
+## 2. Automation Results
+
+| Metric | Value |
+|--------|-------|
+| Total pytest functions | N |
+| Passed | N |
+| Failed | N |
+| Skipped | N |
+| Pass rate | X% |
+| Pytest exit code | N |
+
+### Failed Test Analysis
+
+| Test Case ID | Function | Failure Reason | Root Cause |
+|--------------|----------|----------------|------------|
+| ... | ... | ... | ... |
+
+## 3. Review Findings
+
+| Severity | Finding | Status |
+|----------|---------|--------|
+| Critical | ... | Resolved / Unresolved |
+| Important | ... | Resolved / Unresolved |
+| Informational | ... | Resolved / Unresolved |
+
+## 4. Maturity Rating Rationale
+
+Explain which threshold was met or missed, and why the specific rating was assigned.
+
+## 5. Recommendations
+
+- Actionable items for improving the rating in the next iteration.
+- Specific gaps to close (uncovered criteria, flaky tests, missing negative paths).
+```
+
+### Output Shape (after rating line)
+
+After the mandatory maturity rating line, provide a brief summary paragraph before writing the full report file.
+
+Do not include chain-of-thought. Do not write root `artifacts/**`.

package/docs/templates/backend-test-dag.review-cases.prompt.md

@@ -0,0 +1,81 @@
+# Backend Test DAG Review Cases Prompt Template
+
+## Purpose
+
+Use this prompt for a read-only **backend test case review** node: `executor: "pi"`, `role: "reviewer"`, `writePolicy: "read-only"`. The reviewer audits generated backend functional test cases for completeness, format compliance, and traceability to source requirements. Downstream `generate-backend-pytest-pi` depends on a `VERDICT: pass` to proceed.
+
+Do **not** create `executor: reviewer`. Reviewer is a **role** on `executor: pi`.
+
+## Recommended DAG Node Shape
+
+```json
+{
+  "id": "review-backend-cases-pi",
+  "depends_on": ["generate-backend-functional-cases-pi"],
+  "complexity": "HIGH",
+  "executor": "pi",
+  "role": "reviewer",
+  "writePolicy": "read-only",
+  "allowedPaths": ["**"],
+  "forbiddenPaths": [".harness/**", "artifacts/**"],
+  "outputContract": "Plain Markdown whose first non-empty line is VERDICT: pass or VERDICT: request-revision; followed by Findings and Coverage Assessment. No file writes.",
+  "subtask_prompt_markdown": "./backend-test-dag.review-cases.prompt.md"
+}
+```
+
+## Prompt Body
+
+You are the Backend Test DAG **test case reviewer** (read-only).
+
+Your job is to audit the generated backend functional test cases for completeness, format compliance, requirement coverage, and traceability. You are **not** an implementer or test generator. Do not edit repository files, including root `artifacts/**`.
+
+### Mandatory First Line
+
+The **first non-empty line** of your response must be exactly one of:
+
+- `VERDICT: pass`
+- `VERDICT: request-revision`
+
+No preamble, heading, or blank lines before the verdict line.
+
+### Inputs to Review
+
+1. **Acceptance criteria** — from upstream `analyze-inputs-pi` output (AC-001, AC-002, ...).
+2. **Generated test cases** — files under `testcase/md/`.
+
+Do NOT re-read source documents. Use upstream outputs only.
+
+### Review Checklist
+
+| Area | Check | Severity if Missing |
+|------|-------|---------------------|
+| **ID format** | Every test case ID matches `BE-<MODULE>-<NNN>` (e.g. `BE-ORDER-001`) | Critical |
+| **Positive path coverage** | Happy-path scenarios for each acceptance criterion | Critical |
+| **Negative path coverage** | Error/exception scenarios (invalid input, not found, state violations) | Important |
+| **Boundary conditions** | Edge cases (empty input, max length, edge values) | Important |
+| **State transitions** | Illegal state changes covered | Important |
+| **Requirement traceability** | Each acceptance criterion (AC-xxx) maps to at least one test case ID | Critical |
+| **Case structure** | Each case has: ID, Title, Precondition, Steps, Expected Result | Important |
+| **No duplicate IDs** | All test case IDs are unique across files | Critical |
+
+### Conditional Coverage (check ONLY if mentioned in upstream analysis)
+
+- **Authentication coverage**: check ONLY if `analyze-inputs-pi` mentions auth mechanism (JWT, OAuth2, API Key, etc.)
+- **Timeout coverage**: check ONLY if `analyze-inputs-pi` mentions timeout handling or degradation strategy
+- If not mentioned in upstream analysis, do NOT flag as missing
+
+### Verdict Rules
+
+| Condition | Verdict |
+|-----------|---------|
+| All Critical checks pass, Important checks have no more than 2 findings | `VERDICT: pass` |
+| Any Critical check fails | `VERDICT: request-revision` |
+| More than 2 Important findings | `VERDICT: request-revision` |
+| Only Informational findings | `VERDICT: pass` (with findings listed) |
+
+### Output Shape (after verdict line)
+
+1. **Coverage Assessment** — table mapping each AC to covering test case IDs (or "uncovered").
+2. **Findings** — bullet list tagged `Critical`, `Important`, or `Informational`.
+3. **Statistics** — total case count, positive/negative/boundary breakdown, module distribution.
+4. **Required revisions** (only when `request-revision`) — numbered items for the upstream generator to fix.

package/docs/templates/knowledge-graph-bootstrap-dag.json

@@ -0,0 +1,118 @@
+{
+  "$schema": "./agent-dag.schema.json",
+  "version": 2,
+  "title": "Knowledge-graph bootstrap DAG template",
+  "objective": "AI-assisted business knowledge graph initialization: inventory repo signals, propose entities/edges under staging only, validate, review-gate, promote without overwrite, materialize query indexes.",
+  "successCriteria": [
+    "preflight requires knowledge/bootstrap/scope.yaml and status.yaml",
+    "inventory writes knowledge/bootstrap/inventory.json",
+    "propose-pi writes only knowledge/bootstrap/staging/** with evidence and non-asserted confidence",
+    "validate-shell fails on empty staging, missing edges.proposed/coverage-notes, or self-asserted confidence",
+    "review-gate blocks promote unless VERDICT: pass",
+    "promote merges new formal files only (no overwrite)",
+    "materialize writes knowledge/graph/entities-index.yaml and edges.yaml"
+  ],
+  "globalConstraints": [
+    "AI must never set confidence: asserted.",
+    "Do not modify src/** or Feature testing verdict/cases via bootstrap.",
+    "Promote must not overwrite existing formal knowledge files.",
+    "Complete B0/B1 skeleton before running this DAG."
+  ],
+  "defaults": {
+    "executor": "shell",
+    "contextProfile": "slim",
+    "writePolicy": "read-only"
+  },
+  "tasks": [
+    {
+      "id": "kg-bootstrap-preflight-shell",
+      "depends_on": [],
+      "role": "verifier",
+      "executor": "shell",
+      "complexity": "LOW",
+      "writePolicy": "read-only",
+      "subtask_prompt": "Require bootstrap skeleton."
+    },
+    {
+      "id": "kg-bootstrap-inventory-shell",
+      "depends_on": ["kg-bootstrap-preflight-shell"],
+      "role": "verifier",
+      "executor": "shell",
+      "complexity": "LOW",
+      "writePolicy": "exclusive",
+      "writeSet": ["knowledge/bootstrap/inventory.json"],
+      "subtask_prompt": "B2 inventory."
+    },
+    {
+      "id": "kg-bootstrap-propose-pi",
+      "depends_on": ["kg-bootstrap-inventory-shell"],
+      "role": "implementer",
+      "executor": "pi",
+      "toolProfile": "write",
+      "complexity": "HIGH",
+      "writePolicy": "exclusive",
+      "writeSet": [
+        "knowledge/bootstrap/staging/**",
+        "knowledge/bootstrap/runs/**"
+      ],
+      "subtask_prompt": "B3 AI proposals in staging only; never asserted."
+    },
+    {
+      "id": "kg-bootstrap-validate-shell",
+      "depends_on": ["kg-bootstrap-propose-pi"],
+      "role": "verifier",
+      "executor": "shell",
+      "complexity": "LOW",
+      "writePolicy": "read-only",
+      "subtask_prompt": "B4 validate staging."
+    },
+    {
+      "id": "kg-bootstrap-review-pi",
+      "depends_on": ["kg-bootstrap-validate-shell"],
+      "role": "reviewer",
+      "executor": "pi",
+      "complexity": "HIGH",
+      "writePolicy": "read-only",
+      "outputContract": "First line VERDICT: pass or VERDICT: request-revision.",
+      "subtask_prompt": "Review staging quality."
+    },
+    {
+      "id": "kg-bootstrap-review-gate-shell",
+      "depends_on": ["kg-bootstrap-review-pi"],
+      "role": "verifier",
+      "executor": "shell",
+      "complexity": "LOW",
+      "writePolicy": "read-only",
+      "subtask_prompt": "Gate on VERDICT: pass."
+    },
+    {
+      "id": "kg-bootstrap-promote-shell",
+      "depends_on": ["kg-bootstrap-review-gate-shell"],
+      "role": "verifier",
+      "executor": "shell",
+      "complexity": "LOW",
+      "writePolicy": "exclusive",
+      "writeSet": [
+        "knowledge/domains/**",
+        "knowledge/services/**",
+        "knowledge/modules/**",
+        "knowledge/graph/edges.manual.yaml",
+        "features/**/knowledge-links.yaml"
+      ],
+      "subtask_prompt": "B5 promote new files only."
+    },
+    {
+      "id": "kg-bootstrap-materialize-shell",
+      "depends_on": ["kg-bootstrap-promote-shell"],
+      "role": "closeout",
+      "executor": "shell",
+      "complexity": "LOW",
+      "writePolicy": "exclusive",
+      "writeSet": [
+        "knowledge/graph/entities-index.yaml",
+        "knowledge/graph/edges.yaml"
+      ],
+      "subtask_prompt": "B6 materialize indexes."
+    }
+  ]
+}