@tea-agent/loop-agent 0.44.0-next.12 → 0.44.0-next.14

package/docs/init-surface.manifest.json

@@ -1,284 +1,27 @@
 {
-  "version": 1,
-  "description": "Machine-checked contract for files that must remain available through npm packaging and target-project initialization.",
+  "version": 2,
+  "description": "Machine-checked contract for package resources and the minimal target-project initialization surface.",
+  "resourceCatalog": "resource-catalog.v1.json",
   "packageRequired": [
     "AGENTS.md",
     "CHANGELOG.md",
     "README.md",
     "harness.json",
     "bin/loop-agent.js",
-    "docs/README.md",
-    "docs/governance/harness-methodology-tdd.md",
-    "docs/governance/harness-methodology-verification.md",
-    "docs/governance/harness-methodology-debugging.md",
-    "docs/operations/local-development-environment.md",
+    "bin/agent-worker.js",
     "docs/init-surface.manifest.json",
     "docs/architecture/runtime-boundaries.md",
-    "docs/architecture/README.md",
-    "docs/architecture/system-overview.md",
-    "docs/architecture/dag-execution.md",
-    "docs/architecture/worker-and-feature.md",
-    "docs/architecture/facts-and-state.md",
-    "docs/architecture/evolution.md",
-    "docs/skills/README.md",
-    "docs/skills/vetted-skill-registry.md",
-    "docs/templates/README.md",
-    "docs/templates/init-managed-agents.md",
-    "docs/templates/init-evolution-review.md",
-    "docs/templates/exec-plan.md",
-    "docs/templates/production-readiness-checklist.md",
-    "docs/templates/frontend-task-requirement.md",
-    "docs/templates/frontend-task-constraints.md",
-    "docs/templates/frontend-design-contract.md",
-    "docs/templates/frontend-implementation-contract.schema.json",
-    "docs/templates/worker-dogfood-setup.md",
-    "docs/templates/worker-dogfood-evidence.md",
     "docs/templates/harness.schema.json",
-    "docs/templates/spec-registry.schema.json",
-    "docs/templates/interactive-ui-round2-experiment.md",
-    "docs/templates/product-line/README.md",
-    "docs/templates/product-line/AGENTS.md",
-    "docs/templates/product-line/requirement.md",
-    "docs/templates/product-line/acceptance.yaml",
-    "docs/templates/product-line/design.md",
-    "docs/templates/product-line/test-plan.md",
-    "docs/templates/product-line/task-graph.yaml",
-    "docs/templates/product-line/task.yaml",
-    "docs/templates/product-line/feature.yaml",
-    "docs/templates/product-line/closeout.yaml",
-    "docs/templates/product-line/links.md",
-    "scripts/kb-bootstrap-init-skeleton.sh",
-    "scripts/kb-query.mjs",
-    "scripts/kb-graph-materialize.mjs",
-    "scripts/kb-graph-promote.mjs",
-    "scripts/kb-graph-incremental-prepare.mjs",
-    "scripts/next-info.mjs",
-    "scripts/next-publish-gate.mjs",
-    "scripts/release-source-binding.mjs",
-    "docs/templates/agent-dag.schema.json",
-    "examples/example-dag.json",
+    "resource-catalog.v1.json",
+    "resources/agent-bridge/loop-agent/SKILL.md",
     "skills/agent-worker/SKILL.md",
-    "skills/agent-worker/references/agent-worker-operator.md",
-    "skills/loop-agent/SKILL.md",
-    "skills/loop-agent/references/command-reference.md",
-    "skills/loop-agent/references/hybrid-dag.md",
-    "skills/loop-agent/references/source-and-plan-practice.md",
-    "skills/loop-agent/references/docs-converge.md",
-    "skills/ai-engineering-context/SKILL.md",
-    "skills/verification-before-completion/SKILL.md",
-    "skills/systematic-debugging/SKILL.md",
-    "skills/requesting-code-review/SKILL.md",
-    "skills/codebase-scout/SKILL.md",
-    "skills/test-driven-development/SKILL.md",
-    "skills/code-review-core/SKILL.md",
-    "skills/init-capability-evolution/SKILL.md",
-    "skills/grill-with-docs/SKILL.md",
-    "skills/grill-with-docs/context-format.md",
-    "skills/grill-with-docs/adr-format.md",
-    "skills/webapp-testing/SKILL.md",
-    "skills/playwright-cli/SKILL.md",
-    "skills/playwright-cli-case-generator/SKILL.md",
-    "skills/frontend-contract/SKILL.md",
-    "skills/frontend-contract/references/contract-protocol.md",
-    "skills/frontend-scout/SKILL.md",
-    "skills/frontend-scout/references/scout-evidence.md",
-    "skills/frontend-scout/references/design-evidence.md",
-    "skills/frontend-plan/SKILL.md",
-    "skills/frontend-plan/references/decision-contract.md",
-    "skills/frontend-plan/references/design-decisions.md",
-    "skills/frontend-bounded-implement/SKILL.md",
-    "skills/frontend-bounded-implement/references/code-standards.md",
-    "skills/frontend-design-review/SKILL.md",
-    "skills/frontend-design-review/references/review-checklist.md",
-    "skills/frontend-review/SKILL.md",
-    "skills/frontend-review/references/review-findings.md",
-    "skills/frontend-verification/SKILL.md",
-    "skills/frontend-verification/references/verification-checklist.md",
-    "docs/templates/backend-test-analysis.schema.json",
-    "docs/templates/backend-test-execution.schema.json",
-    "docs/templates/backend-test-result.schema.json",
-    "docs/templates/backend-test-case-manifest.schema.json"
-  ],
-  "initFullRequired": [
-    "README.md",
-    "AGENTS.md",
-    ".gitignore",
-    "harness.json",
-    "docs/README.md",
-    "docs/development-principles.md",
-    "docs/feature-workflow.md",
-    "docs/verification-matrix.md",
-    "docs/loop-agent-harness.md",
-    "docs/spec-registry.json",
-    "docs/harness-methodology-tdd.md",
-    "docs/harness-methodology-verification.md",
-    "docs/harness-methodology-debugging.md",
-    "docs/templates/README.md",
-    "docs/templates/init-evolution-review.md",
-    "docs/templates/production-readiness-checklist.md",
-    "docs/templates/frontend-task-requirement.md",
-    "docs/templates/frontend-task-constraints.md",
-    "docs/templates/frontend-design-contract.md",
-    "docs/templates/worker-dogfood-setup.md",
-    "docs/templates/worker-dogfood-evidence.md",
-    "docs/templates/harness.schema.json",
-    "docs/templates/interactive-ui-round2-experiment.md",
-    "docs/templates/product-line/README.md",
-    "docs/templates/product-line/AGENTS.md",
-    "docs/templates/product-line/requirement.md",
-    "docs/templates/product-line/acceptance.yaml",
-    "docs/templates/product-line/design.md",
-    "docs/templates/product-line/test-plan.md",
-    "docs/templates/product-line/task-graph.yaml",
-    "docs/templates/product-line/task.yaml",
-    "docs/templates/product-line/feature.yaml",
-    "docs/templates/product-line/closeout.yaml",
-    "docs/templates/product-line/links.md",
-    "scripts/check-skill-entry.sh",
-    "scripts/check-product-line-docs.sh",
-    "scripts/check-repo.sh",
-    "scripts/ci-governance.sh",
-    "scripts/ci-tests.sh",
-    "scripts/ci.sh",
-    ".harness/prompts/analyze.md",
-    ".harness/tasks",
-    ".harness/dag-runs/active",
-    ".agents/skills/agent-worker/SKILL.md",
-    ".agents/skills/agent-worker/references/agent-worker-operator.md",
-    ".agents/skills/loop-agent/SKILL.md",
-    ".agents/skills/loop-agent/references/command-reference.md",
-    ".agents/skills/loop-agent/references/hybrid-dag.md",
-    ".agents/skills/loop-agent/references/source-and-plan-practice.md",
-    ".agents/skills/loop-agent/references/docs-converge.md",
-    ".agents/skills/ai-engineering-context/SKILL.md",
-    ".agents/skills/verification-before-completion/SKILL.md",
-    ".agents/skills/systematic-debugging/SKILL.md",
-    ".agents/skills/requesting-code-review/SKILL.md",
-    ".agents/skills/codebase-scout/SKILL.md",
-    ".agents/skills/test-driven-development/SKILL.md",
-    ".agents/skills/code-review-core/SKILL.md",
-    ".agents/skills/init-capability-evolution/SKILL.md",
-    ".agents/skills/grill-with-docs/SKILL.md",
-    ".agents/skills/grill-with-docs/context-format.md",
-    ".agents/skills/grill-with-docs/adr-format.md",
-    ".agents/skills/webapp-testing/SKILL.md",
-    ".agents/skills/playwright-cli/SKILL.md",
-    ".agents/skills/playwright-cli-case-generator/SKILL.md",
-    ".agents/skills/frontend-contract/SKILL.md",
-    ".agents/skills/frontend-contract/references/contract-protocol.md",
-    ".agents/skills/frontend-scout/SKILL.md",
-    ".agents/skills/frontend-scout/references/scout-evidence.md",
-    ".agents/skills/frontend-scout/references/design-evidence.md",
-    ".agents/skills/frontend-plan/SKILL.md",
-    ".agents/skills/frontend-plan/references/decision-contract.md",
-    ".agents/skills/frontend-plan/references/design-decisions.md",
-    ".agents/skills/frontend-bounded-implement/SKILL.md",
-    ".agents/skills/frontend-bounded-implement/references/code-standards.md",
-    ".agents/skills/frontend-design-review/SKILL.md",
-    ".agents/skills/frontend-design-review/references/review-checklist.md",
-    ".agents/skills/frontend-review/SKILL.md",
-    ".agents/skills/frontend-review/references/review-findings.md",
-    ".agents/skills/frontend-verification/SKILL.md",
-    ".agents/skills/frontend-verification/references/verification-checklist.md",
-    "docs/templates/backend-test-analysis.schema.json",
-    "docs/templates/backend-test-execution.schema.json",
-    "docs/templates/backend-test-result.schema.json",
-    "docs/templates/backend-test-case-manifest.schema.json",
-    ".opencode/plugins/loop-agent-transient-retry.js",
-    ".opencode/plugins/loop-agent-context-overflow-compact.js",
-    ".pi/extensions/loop-agent-context-overflow.js",
-    ".pi/settings.json"
+    "skills/loop-agent/SKILL.md"
   ],
   "initSurface": {
-    "docs/spec-registry.json": "generated",
-    "README.md": "managed-block",
-    "AGENTS.md": "managed-block",
     ".gitignore": "managed-block",
     "harness.json": "generated",
-    "docs/README.md": "generated",
-    "docs/development-principles.md": "generated",
-    "docs/feature-workflow.md": "generated",
-    "docs/verification-matrix.md": "generated",
-    "docs/loop-agent-harness.md": "generated",
-    "docs/harness-methodology-tdd.md": "copied",
-    "docs/harness-methodology-verification.md": "copied",
-    "docs/harness-methodology-debugging.md": "copied",
-    "docs/templates/README.md": "copied",
-    "docs/templates/init-evolution-review.md": "copied",
-    "docs/templates/production-readiness-checklist.md": "copied",
-    "docs/templates/frontend-task-requirement.md": "copied",
-    "docs/templates/frontend-task-constraints.md": "copied",
-    "docs/templates/frontend-design-contract.md": "copied",
-    "docs/templates/worker-dogfood-setup.md": "copied",
-    "docs/templates/worker-dogfood-evidence.md": "copied",
-    "docs/templates/harness.schema.json": "copied",
-    "docs/templates/interactive-ui-round2-experiment.md": "copied",
-    "docs/templates/product-line/README.md": "copied",
-    "docs/templates/product-line/AGENTS.md": "copied",
-    "docs/templates/product-line/requirement.md": "copied",
-    "docs/templates/product-line/acceptance.yaml": "copied",
-    "docs/templates/product-line/design.md": "copied",
-    "docs/templates/product-line/test-plan.md": "copied",
-    "docs/templates/product-line/task-graph.yaml": "copied",
-    "docs/templates/product-line/task.yaml": "copied",
-    "docs/templates/product-line/feature.yaml": "copied",
-    "docs/templates/product-line/closeout.yaml": "copied",
-    "docs/templates/product-line/links.md": "copied",
-    "scripts/check-skill-entry.sh": "generated",
-    "scripts/check-product-line-docs.sh": "generated",
-    "scripts/check-repo.sh": "generated",
-    "scripts/ci-governance.sh": "generated",
-    "scripts/ci-tests.sh": "generated",
-    "scripts/ci.sh": "generated",
-    ".harness/prompts/analyze.md": "generated",
-    ".harness/tasks": "directory",
-    ".harness/dag-runs/active": "directory",
-    ".harness/init-surface.json": "state",
-    ".agents/skills/agent-worker/SKILL.md": "copied",
-    ".agents/skills/agent-worker/references/agent-worker-operator.md": "copied",
     ".agents/skills/loop-agent/SKILL.md": "copied",
-    ".agents/skills/loop-agent/references/command-reference.md": "copied",
-    ".agents/skills/loop-agent/references/hybrid-dag.md": "copied",
-    ".agents/skills/loop-agent/references/source-and-plan-practice.md": "copied",
-    ".agents/skills/loop-agent/references/docs-converge.md": "copied",
-    ".agents/skills/ai-engineering-context/SKILL.md": "copied",
-    ".agents/skills/verification-before-completion/SKILL.md": "copied",
-    ".agents/skills/systematic-debugging/SKILL.md": "copied",
-    ".agents/skills/requesting-code-review/SKILL.md": "copied",
-    ".agents/skills/codebase-scout/SKILL.md": "copied",
-    ".agents/skills/test-driven-development/SKILL.md": "copied",
-    ".agents/skills/code-review-core/SKILL.md": "copied",
-    ".agents/skills/init-capability-evolution/SKILL.md": "copied",
-    ".agents/skills/grill-with-docs/SKILL.md": "copied",
-    ".agents/skills/grill-with-docs/context-format.md": "copied",
-    ".agents/skills/grill-with-docs/adr-format.md": "copied",
-    ".agents/skills/webapp-testing/SKILL.md": "copied",
-    ".agents/skills/playwright-cli/SKILL.md": "copied",
-    ".agents/skills/playwright-cli-case-generator/SKILL.md": "copied",
-    ".agents/skills/frontend-contract/SKILL.md": "copied",
-    ".agents/skills/frontend-contract/references/contract-protocol.md": "copied",
-    ".agents/skills/frontend-scout/SKILL.md": "copied",
-    ".agents/skills/frontend-scout/references/scout-evidence.md": "copied",
-    ".agents/skills/frontend-scout/references/design-evidence.md": "copied",
-    ".agents/skills/frontend-plan/SKILL.md": "copied",
-    ".agents/skills/frontend-plan/references/decision-contract.md": "copied",
-    ".agents/skills/frontend-plan/references/design-decisions.md": "copied",
-    ".agents/skills/frontend-bounded-implement/SKILL.md": "copied",
-    ".agents/skills/frontend-bounded-implement/references/code-standards.md": "copied",
-    ".agents/skills/frontend-design-review/SKILL.md": "copied",
-    ".agents/skills/frontend-design-review/references/review-checklist.md": "copied",
-    ".agents/skills/frontend-review/SKILL.md": "copied",
-    ".agents/skills/frontend-review/references/review-findings.md": "copied",
-    ".agents/skills/frontend-verification/SKILL.md": "copied",
-    ".agents/skills/frontend-verification/references/verification-checklist.md": "copied",
-    "docs/templates/backend-test-analysis.schema.json": "copied",
-    "docs/templates/backend-test-execution.schema.json": "copied",
-    "docs/templates/backend-test-result.schema.json": "copied",
-    "docs/templates/backend-test-case-manifest.schema.json": "copied",
-    ".opencode/plugins/loop-agent-transient-retry.js": "generated",
-    ".opencode/plugins/loop-agent-context-overflow-compact.js": "generated",
-    ".pi/extensions/loop-agent-context-overflow.js": "generated",
-    ".pi/settings.json": "generated"
+    ".harness/init-surface.json": "state"
   },
   "packageExcluded": [
     "docs/progress/20*.md",
@@ -288,9 +31,18 @@
     "docs/exec-plans/completed/20*.md"
   ],
   "initExcluded": [
-    "examples/example-dag.json",
-    "docs/skills/vetted-skill-registry.md",
-    "docs/templates/init-managed-agents.md"
+    "README.md",
+    "AGENTS.md",
+    "ai_workspace/loop-agent",
+    "scripts",
+    ".harness/prompts",
+    ".harness/tasks",
+    ".harness/dag-runs",
+    ".agents/skills/agent-worker",
+    ".opencode/plugins/loop-agent-transient-retry.js",
+    ".opencode/plugins/loop-agent-context-overflow-compact.js",
+    ".pi/extensions/loop-agent-context-overflow.js",
+    ".pi/settings.json"
   ],
   "reviewTriggers": [
     "AGENTS.md",
@@ -298,19 +50,16 @@
     "CHANGELOG.md",
     "harness.json",
     "package.json",
+    "resource-catalog.v1.json",
+    "resources/**",
     "src/commands/init.ts",
-    "src/commands/init-model-catalog.ts",
-    "src/commands/client-recovery.ts",
     "src/commands/init-upgrade.ts",
-    "src/cli.ts",
-    "src/cli/update/init-surface-notifier.ts",
-    "src/cli/update/policy.ts",
-    "src/cli/update/runtime-activity.ts",
+    "src/governance/project-config.ts",
+    "src/governance/project-capability-scanner.ts",
+    "src/governance/resource-catalog.ts",
     "src/workflows/dag/skills.ts",
-    "src/workflows/dag/init-hybrid.ts",
     "src/workflows/dag/skill-instructions.ts",
     "docs/templates/**",
-    "docs/skills/**",
     "skills/**",
     "scripts/**"
   ],
@@ -322,25 +71,23 @@
         "name": "model-review",
         "severity": "high",
         "strictRequiresReport": true,
-        "description": "Changes that may alter target-project initialization behavior, default DAG role skills, skill resolution, or package/init contracts.",
+        "description": "Changes that may alter minimal initialization, migration ownership, normalized project context, package resources, or DAG Skill resolution.",
         "patterns": [
           "src/commands/init.ts",
-          "src/commands/init-model-catalog.ts",
-          "src/commands/client-recovery.ts",
           "src/commands/init-upgrade.ts",
-          "src/cli.ts",
           "src/cli/update/init-surface-notifier.ts",
           "src/cli/update/policy.ts",
-          "src/cli/update/runtime-activity.ts",
+          "src/shared/runtime-activity.ts",
+          "src/governance/project-config.ts",
+          "src/governance/project-capability-scanner.ts",
+          "src/governance/resource-catalog.ts",
           "src/workflows/dag/skills.ts",
-          "src/workflows/dag/init-hybrid.ts",
           "src/workflows/dag/skill-instructions.ts",
-          "src/workflows/dag/prompt.ts",
-          "src/workflows/dag/node-execution.ts",
           "docs/init-surface.manifest.json",
+          "resource-catalog.v1.json",
+          "resources/**",
           "package.json",
           "harness.json",
-          "AGENTS.md",
           "README.md"
         ]
       },
@@ -348,20 +95,22 @@
         "name": "surface-check",
         "severity": "medium",
         "strictRequiresReport": false,
-        "description": "Asset surface changes that usually need deterministic package/init smoke checks but not a model review when the checks pass.",
+        "description": "Package resource and bridge changes that require deterministic catalog, package, and minimal-init checks.",
         "patterns": [
           "skills/**",
           "docs/templates/**",
-          "docs/skills/**",
+          "resources/**",
+          "resource-catalog.v1.json",
           "scripts/check-init-surface.sh",
-          "scripts/check-repo.sh"
+          "scripts/check-skill-entry.sh",
+          "scripts/generate-resource-catalog.mjs"
         ]
       },
       {
         "name": "advisory",
         "severity": "low",
         "strictRequiresReport": false,
-        "description": "Documentation and user-facing guidance changes that should be considered but should not slow normal iteration.",
+        "description": "User-facing guidance changes that should be reviewed without slowing normal iteration.",
         "patterns": [
           "CHANGELOG.md",
           "CHANGELOG/**",
@@ -372,12 +121,11 @@
       }
     ],
     "modelReviewQuestions": [
-      "Does this change alter files or guidance produced by loop-agent init --profile full --merge?",
-      "Does a new or changed skill need to be bundled, projected to target projects, or documented as optional only?",
-      "Do target-project AGENTS.md, README managed blocks, governance docs, templates, or script matrix need updates?",
-      "Does package.json files include every static asset required by the runtime and init projection?",
-      "Does docs/init-surface.manifest.json still match the intended package and init surface?",
-      "Do older initialized target projects need a migration note, manual copy guidance, or future init audit/update support?"
+      "Does this change alter the four-file minimal init surface or old-project migration ownership?",
+      "Does a runtime resource belong in the package catalog instead of the target project?",
+      "Can a project or user Skill shadow a builtin Skill, or can resume observe live package drift?",
+      "Can tracked project verification be removed or weakened by local harness settings?",
+      "Do package files, the resource catalog, and the init manifest describe the same shipped bytes?"
     ]
   }
 }

package/docs/templates/README.md

@@ -42,15 +42,15 @@
 - `frontend-test-dag.json` — frontend-test DAG 模板；其 deterministic checklist 会拒绝 alternative executable instructions，仅允许 allowlisted `playwright-cli` command。Pi generator/reviser 的 runtime writeSet 仅授权下列目标项目生成路径（不是本仓库文档索引目标）：
 
   ~~~text
-  testcase/frontend/cases/FE-*.md
-  testcase/frontend/cases/index.md
-  testcase/frontend/cases/manifest.draft.json
+  .harness/testcase/frontend/cases/FE-*.md
+  .harness/testcase/frontend/cases/index.md
+  .harness/testcase/frontend/cases/manifest.draft.json
   ~~~
 
   Pi writer writeSet 不包含 final manifest（文件名 manifest.json）。依赖 checklist 的 exclusive shell materializer 是 final manifest 的唯一写入者，以 temp+rename 原子生成 final，后续 map 只消费该 materializer 输出。
 - `frontend-test-dag.retrieve-context.prompt.md`、`frontend-test-dag.generate-cases.prompt.md`、`frontend-test-dag.review-cases.prompt.md`、`frontend-test-dag.review-execution.prompt.md`、`frontend-test-dag.retrospect.prompt.md` — 上下文、用例、审查、执行审查和复盘提示。
 - `frontend-test-case-checklist.md` — 前端测试用例检查清单。
-- `frontend-test-standard-scenarios.v1.json` — frontend-test 标准场景规范（generate 覆盖 must 场景；运行时可物化到目标项目 testcase/frontend/rag 下的 standard-scenarios.v1.json）。
+- `frontend-test-standard-scenarios.v1.json` — frontend-test 标准场景规范（generate 覆盖 must 场景；运行时可物化到目标项目 .harness/testcase/frontend/rag 下的 standard-scenarios.v1.json）。
 
 ## 知识同步与配置
 

package/docs/templates/agent-dag.base.json

@@ -30,30 +30,30 @@
     "executor": "pi",
     "contextProfile": "slim",
     "skills": [
-      "ai-engineering-context"
+      "builtin:ai-engineering-context"
     ],
     "writePolicy": "read-only"
   },
   "skillsByRole": {
     "planner": [
-      "loop-agent"
+      "builtin:loop-agent"
     ],
     "scout": [
-      "ai-engineering-context"
+      "builtin:ai-engineering-context"
     ],
     "implementer": [
-      "verification-before-completion"
+      "builtin:verification-before-completion"
     ],
     "reviewer": [
-      "requesting-code-review"
+      "builtin:requesting-code-review"
     ],
     "verifier": [
-      "verification-before-completion",
-      "systematic-debugging"
+      "builtin:verification-before-completion",
+      "builtin:systematic-debugging"
     ],
     "closeout": [
-      "loop-agent",
-      "verification-before-completion"
+      "builtin:loop-agent",
+      "builtin:verification-before-completion"
     ]
   },
   "executorModels": {

package/docs/templates/agent-dag.final-verification.json

@@ -8,7 +8,7 @@
     "static-invariant-shell uses task-scoped constraints only",
     "changeset-impact-shell can skip with an explicit reason when the repo has no changesets/release impact",
     "closeout-artifact-shell runs before final-verify-shell",
-    "final-verify-shell uses repo manifest or task-provided commands without host-specific wrappers"
+    "final-verify-shell uses Task Contract, normalized project verification, or bounded capability-scan commands without host-specific wrappers"
   ],
   "globalConstraints": [
     "Do not implement Project Policy Gate",
@@ -21,7 +21,7 @@
     "contextProfile": "slim",
     "writePolicy": "read-only",
     "skills": [
-      "ai-engineering-context"
+      "builtin:ai-engineering-context"
     ]
   },
   "executorModels": {
@@ -33,11 +33,11 @@
   },
   "skillsByRole": {
     "verifier": [
-      "verification-before-completion"
+      "builtin:verification-before-completion"
     ],
     "closeout": [
-      "loop-agent",
-      "verification-before-completion"
+      "builtin:loop-agent",
+      "builtin:verification-before-completion"
     ]
   },
   "tasks": [
@@ -158,7 +158,7 @@
       ],
       "shell": {
         "commands": [
-          "CHECK_REPO=$(node -e 'const fs=require(\"fs\"); const manifest=JSON.parse(fs.readFileSync(\"harness.json\",\"utf8\")); process.stdout.write((manifest.scripts&&manifest.scripts.checkRepo)||\"scripts/check-repo.sh\");'); HARNESS_ALLOW_ACTIVE_DAG_RUNS=1 bash \"$CHECK_REPO\""
+          "REPLACE_WITH_PROJECT_VERIFICATION_COMMAND"
         ]
       },
       "outputContract": "Final verification evidence captured after closeout artifact creation.",

package/docs/templates/agent-dag.supervised-implementation.json

@@ -50,35 +50,35 @@
     "executor": "pi",
     "contextProfile": "slim",
     "skills": [
-      "ai-engineering-context"
+      "builtin:ai-engineering-context"
     ],
     "writePolicy": "read-only"
   },
   "skillsByRole": {
     "planner": [
-      "loop-agent"
+      "builtin:loop-agent"
     ],
     "scout": [
-      "ai-engineering-context"
+      "builtin:ai-engineering-context"
     ],
     "implementer": [
-      "verification-before-completion"
+      "builtin:verification-before-completion"
     ],
     "reviewer": [
-      "requesting-code-review",
-      "verification-before-completion"
+      "builtin:requesting-code-review",
+      "builtin:verification-before-completion"
     ],
     "supervisor": [
-      "verification-before-completion",
-      "loop-agent"
+      "builtin:verification-before-completion",
+      "builtin:loop-agent"
     ],
     "verifier": [
-      "verification-before-completion",
-      "systematic-debugging"
+      "builtin:verification-before-completion",
+      "builtin:systematic-debugging"
     ],
     "closeout": [
-      "loop-agent",
-      "verification-before-completion"
+      "builtin:loop-agent",
+      "builtin:verification-before-completion"
     ]
   },
   "executorModels": {

package/docs/templates/backend-test-dag.generate-pytest.prompt.md

@@ -6,9 +6,9 @@
 
 ## 当前合同
 
-- 输入：最终 `testcase/md/**`、run-owned 环境报告与 Markdown 校验报告，以及有界的 pytest config / `conftest.py`。
+- 输入：最终 `.harness/testcase/md/**`、run-owned 环境报告与 Markdown 校验报告，以及有界的 pytest config / `conftest.py`。
 - 禁止重新读取 `source/**`、新增测试场景、重新分配 AC、执行 pytest、修改生产代码/配置或输出业务 JSON。
-- 写入范围：`testcase/**/test_*.py`、`testcase/**/helpers/**`、`testcase/**/factories/**`。
+- 写入范围：`.harness/testcase/**/test_*.py`、`.harness/testcase/**/helpers/**`、`.harness/testcase/**/factories/**`。
 - pytest 可以使用模块级 `test_*` 函数，也可以使用 pytest 测试类中的 `test_*` 方法；不得为了追溯强迫目标项目放弃现有 class-based 风格。
 - 每个最终 Markdown Case ID 必须出现在至少一个真实测试函数/方法区域中，优先同时出现在函数/方法名和 docstring：
 
@@ -26,7 +26,7 @@ class TestOrderApi:
 - 禁止 `skip` / `xfail`、吞断言、宽异常静默通过、mock 替代真实目标、删除用例或弱化断言。
 - best-effort 清理只能捕获所选 HTTP client 实际抛出的窄 transport exception，例如 `requests.RequestException` 或 `urllib.error.URLError`；禁止 `except:`、`except Exception`、`except BaseException` 后 `pass`。
 - 同一 Case ID 可以由多个 pytest 函数覆盖；额外映射会进入 traceability 报告，但不能伪造未在 Markdown 中定义的业务场景。
-- 生成 pytest 文件名必须与 Markdown 模块一一对应：`testcase/md/<module>.md` → `testcase/test_<module>.py`（`<module>` 为文件名去 `.md` 后小写、非字母数字转 `_`）。即使 Markdown `自动化映射` 写了别的路径，也必须写模块 stem 路径，不得额外发明 `test_be_*` 前缀。
+- 生成 pytest 文件名必须与 Markdown 模块一一对应：`.harness/testcase/md/<module>.md` → `.harness/testcase/test_<module>.py`（`<module>` 为文件名去 `.md` 后小写、非字母数字转 `_`）。即使 Markdown `自动化映射` 写了别的路径，也必须写模块 stem 路径，不得额外发明 `test_be_*` 前缀。
 - 测试失败必须诚实保留，后续节点只执行一次 pytest，并从同一 pytest-html 报告生成 HTML/facts。
 
 ## 推荐输出