vibe-coding-master 0.6.20 → 0.6.22

package/dist/backend/services/harness-service.js

@@ -8,9 +8,12 @@ import { renderGateReviewerAgentRules, renderRequestGateReviewTool, renderTransl
 import { renderHarnessEngineerHarnessRules } from "../templates/harness/harness-engineer-agent.js";
 import { renderRootClaudeHarnessRules } from "../templates/harness/claude-root.js";
 import { renderGitignoreHarnessRules } from "../templates/harness/gitignore.js";
+import { renderLegacyProjectCodingStandardsTemplate, renderProjectCodingStandardsProjectSection, renderProjectCodingStandardsRules } from "../templates/harness/project-coding-standards.js";
+import { renderProjectGlossaryTemplate } from "../templates/harness/project-glossary.js";
+import { renderLegacyProjectKnownIssuesTemplate, renderProjectKnownIssuesRules, renderProjectKnownIssuesSection } from "../templates/harness/project-known-issues.js";
 import { renderProjectManagerHarnessRules } from "../templates/harness/project-manager-agent.js";
 import { renderPullRequestTemplateHarnessRules } from "../templates/harness/pull-request-template.js";
-import { renderReviewerHarnessRules } from "../templates/harness/reviewer-agent.js";
+import { renderTesterHarnessRules } from "../templates/harness/tester-agent.js";
 import { renderVcmFinalAcceptanceSkillRules } from "../templates/harness/vcm-final-acceptance-skill.js";
 import { renderVcmHarnessBootstrapSkillRules } from "../templates/harness/vcm-harness-bootstrap-skill.js";
 import { renderVcmLongRunningValidationSkillRules } from "../templates/harness/vcm-long-running-validation-skill.js";
@@ -38,6 +41,7 @@ const VCM_STOP_HOOK_COMMAND = `sh -c 'if [ -z "\${VCM_TASK_SLUG:-}" ] || [ -z "\
 const VCM_PERMISSION_REQUEST_HOOK_COMMAND = `sh -c 'if [ -z "\${VCM_TASK_SLUG:-}" ] || [ -z "\${VCM_ROLE:-}" ] || [ -z "\${VCM_API_URL:-}" ]; then exit 0; fi; node -e '"'"'let s="";process.stdin.setEncoding("utf8");process.stdin.on("data",d=>s+=d);process.stdin.on("end",()=>{let event={};try{event=s.trim()?JSON.parse(s):{};}catch{event={raw:s};}process.stdout.write(JSON.stringify({taskSlug:process.env.VCM_TASK_SLUG,role:process.env.VCM_ROLE,event}));});'"'"' | curl -fsS --max-time 5 -X POST "\${VCM_API_URL}/api/hooks/claude-code/permission-request" -H "content-type: application/json" --data-binary @- || true'`;
 const VCM_BASH_GUARD_HOOK_COMMAND = `sh -c 'if [ -z "\${VCM_TASK_SLUG:-}" ] || [ -z "\${VCM_ROLE:-}" ]; then exit 0; fi; guard=""; repo="$(git rev-parse --show-toplevel 2>/dev/null || true)"; if [ -n "$repo" ] && [ -f "$repo/.ai/tools/vcm-bash-guard" ]; then guard="$repo/.ai/tools/vcm-bash-guard"; else cwd="$(pwd -P 2>/dev/null || pwd)"; dir="$cwd"; while [ -n "$dir" ] && [ "$dir" != "/" ]; do if [ -f "$dir/.ai/tools/vcm-bash-guard" ]; then guard="$dir/.ai/tools/vcm-bash-guard"; break; fi; dir="$(dirname "$dir")"; done; if [ -z "$guard" ] && [ -n "\${CLAUDE_PROJECT_DIR:-}" ] && [ -f "\${CLAUDE_PROJECT_DIR}/.ai/tools/vcm-bash-guard" ]; then guard="\${CLAUDE_PROJECT_DIR}/.ai/tools/vcm-bash-guard"; fi; fi; [ -n "$guard" ] || exit 0; python3 "$guard" || exit 0'`;
 const VCM_BASH_DEFAULT_TIMEOUT_MS = "600000";
+const VCM_AUTO_MEMORY_ENABLED = false;
 const VCM_HOOK_DEFINITIONS = [
     { eventName: "PreToolUse", matcher: "Bash", command: VCM_BASH_GUARD_HOOK_COMMAND, timeout: 10 },
     { eventName: "UserPromptSubmit", command: VCM_HOOK_COMMAND, timeout: 5 },
@@ -54,6 +58,29 @@ const HARNESS_FILES = [
         blankLineBeforeEnd: true,
         renderRules: renderRootClaudeHarnessRules
     },
+    {
+        kind: "project-glossary",
+        path: "docs/GLOSSARY.md",
+        title: "Glossary",
+        ownership: "project-file",
+        renderRules: renderProjectGlossaryTemplate
+    },
+    {
+        kind: "project-coding-standards",
+        path: "docs/CODING_STANDARDS.md",
+        title: "Coding Standards",
+        defaultContentAfterBlock: renderProjectCodingStandardsProjectSection(),
+        legacyWholeFile: renderLegacyProjectCodingStandardsTemplate(),
+        renderRules: renderProjectCodingStandardsRules
+    },
+    {
+        kind: "project-known-issues",
+        path: "docs/known-issues.md",
+        title: "Known Issues",
+        defaultContentAfterBlock: renderProjectKnownIssuesSection(),
+        legacyWholeFile: renderLegacyProjectKnownIssuesTemplate(),
+        renderRules: renderProjectKnownIssuesRules
+    },
     {
         kind: "gitignore",
         path: ".gitignore",
@@ -71,7 +98,7 @@ const HARNESS_FILES = [
         kind: "skill-vcm-route-message",
         path: ".claude/skills/vcm-route-message/SKILL.md",
         title: "VCM Route Message Skill",
-        frontmatter: renderSkillFrontmatter("vcm-route-message", "Use when a VCM role needs to hand off work, ask a question, report a result, report a blocker, or raise a finding to another VCM role."),
+        frontmatter: renderSkillFrontmatter("vcm-route-message", "Use when project-manager dispatches a VCM role or when a VCM role reports a question, result, blocker, or finding back to project-manager."),
         ownership: "whole-file",
         renderRules: renderVcmRouteMessageSkillRules
     },
@@ -79,7 +106,7 @@ const HARNESS_FILES = [
         kind: "skill-vcm-final-acceptance",
         path: ".claude/skills/vcm-final-acceptance/SKILL.md",
         title: "VCM Final Acceptance Skill",
-        frontmatter: renderSkillFrontmatter("vcm-final-acceptance", "Use when project-manager is ready to decide whether a VCM-managed task can be accepted, returned for follow-up, or blocked for a decision."),
+        frontmatter: renderSkillFrontmatter("vcm-final-acceptance", "Use when project-manager is ready to close a complete VCM code-delivery flow."),
         ownership: "whole-file",
         renderRules: renderVcmFinalAcceptanceSkillRules
     },
@@ -119,7 +146,7 @@ const HARNESS_FILES = [
         kind: "agent-gate-reviewer",
         path: ".claude/agents/gate-reviewer.md",
         title: "Gate Reviewer Agent",
-        frontmatter: renderAgentFrontmatter("gate-reviewer", "VCM independent gate review role for architecture plans, validation adequacy, and final diffs."),
+        frontmatter: renderAgentFrontmatter("gate-reviewer", "VCM independent gate review role for architecture plans, validation adequacy, and code diffs.", { tools: "Read, Grep, Glob, Bash, Write" }),
         renderRules: renderGateReviewerAgentRules
     },
     {
@@ -173,11 +200,11 @@ const HARNESS_FILES = [
         renderRules: renderCoderHarnessRules
     },
     {
-        kind: "agent-reviewer",
-        path: ".claude/agents/reviewer.md",
-        title: "Reviewer Agent",
-        frontmatter: renderAgentFrontmatter("reviewer", "VCM independent review role for acceptance, test adequacy, scope checks, and risk findings."),
-        renderRules: renderReviewerHarnessRules
+        kind: "agent-tester",
+        path: ".claude/agents/tester.md",
+        title: "Tester Agent",
+        frontmatter: renderAgentFrontmatter("tester", "VCM testing role for validation, test adequacy, approved-scope validation, and risk findings."),
+        renderRules: renderTesterHarnessRules
     }
 ];
 export function createHarnessService(deps) {
@@ -976,7 +1003,7 @@ function assertManagedBlockUnchanged(definition, currentContent, nextContent) {
     }
 }
 function extractManagedBlock(definition, content) {
-    if (definition.ownership === "whole-file" || definition.ownership === "raw-file") {
+    if (definition.ownership === "whole-file" || definition.ownership === "raw-file" || definition.ownership === "project-file") {
         return undefined;
     }
     return content.match(getManagedBlockPattern(definition))?.[0];
@@ -991,6 +1018,27 @@ async function analyzeHarnessFiles(fs, repoRoot) {
 }
 async function analyzeHarnessFile(fs, repoRoot, definition) {
     const absolutePath = resolveHarnessPath(repoRoot, definition.path);
+    if (definition.ownership === "project-file") {
+        const exists = await fs.pathExists(absolutePath);
+        return {
+            definition,
+            status: {
+                kind: definition.kind,
+                path: definition.path,
+                exists,
+                hasManagedBlock: false,
+                action: exists ? "ok" : "create"
+            },
+            plannedChange: exists
+                ? undefined
+                : {
+                    path: definition.path,
+                    action: "create",
+                    reason: "Project-owned harness file is missing; VCM will create an editable default."
+                },
+            nextContent: exists ? undefined : ensureTrailingNewline(definition.renderRules().trimEnd())
+        };
+    }
     const expectedContent = definition.ownership === "whole-file" || definition.ownership === "raw-file"
         ? renderWholeHarnessFile(definition)
         : undefined;
@@ -1046,6 +1094,25 @@ async function analyzeHarnessFile(fs, repoRoot, definition) {
     }
     const match = currentContent.match(managedBlockPattern);
     if (!match) {
+        const migratedContent = migrateLegacyHarnessFile(definition, currentContent, expectedBlock);
+        if (migratedContent) {
+            return {
+                definition,
+                status: {
+                    kind: definition.kind,
+                    path: definition.path,
+                    exists: true,
+                    hasManagedBlock: false,
+                    action: "update"
+                },
+                plannedChange: {
+                    path: definition.path,
+                    action: "update",
+                    reason: "Legacy VCM whole-file baseline will be migrated to a managed block."
+                },
+                nextContent: migratedContent
+            };
+        }
         return {
             definition,
             status: {
@@ -1166,11 +1233,24 @@ function getManagedBlockPattern(definition) {
         ? HASH_MANAGED_BLOCK_PATTERN
         : MANAGED_BLOCK_PATTERN;
 }
-function renderNewHarnessFile(definition, block) {
+function renderNewHarnessFile(definition, block, contentAfterBlock = definition.defaultContentAfterBlock) {
     const frontmatter = definition.frontmatter
         ? `${definition.frontmatter.trimEnd()}\n\n`
         : "";
-    return `${frontmatter}# ${definition.title}\n\n${block}\n`;
+    const suffix = contentAfterBlock?.trim();
+    return `${frontmatter}# ${definition.title}\n\n${block}${suffix ? `\n\n${suffix}` : ""}\n`;
+}
+function migrateLegacyHarnessFile(definition, currentContent, block) {
+    const legacyContent = definition.legacyWholeFile?.trimEnd();
+    if (!legacyContent) {
+        return undefined;
+    }
+    const current = currentContent.trimEnd();
+    if (current !== legacyContent && !current.startsWith(`${legacyContent}\n`)) {
+        return undefined;
+    }
+    const projectContent = current.slice(legacyContent.length).trim();
+    return renderNewHarnessFile(definition, block, projectContent || undefined);
 }
 function renderWholeHarnessFile(definition) {
     if (definition.ownership === "raw-file") {
@@ -1265,7 +1345,8 @@ function withVcmClaudeHooks(settings) {
     return {
         ...settings,
         hooks,
-        env
+        env,
+        autoMemoryEnabled: VCM_AUTO_MEMORY_ENABLED
     };
 }
 function isVcmHookMatcher(value) {
@@ -1334,6 +1415,8 @@ async function getHarnessBootstrapStatus(deps, repoRoot, targetRepoRoot, now, vc
         await checkProjectContext(deps.fs, targetRepoRoot),
         checkGeneratedJson(moduleIndex, ".ai/generated/module-index.json", "module-index", "Module index"),
         checkGeneratedJson(await readOptionalJsonObject(deps.fs, targetRepoRoot, ".ai/generated/public-surface.json"), ".ai/generated/public-surface.json", "public-surface", "Public surface"),
+        await checkFilledMarkdown(deps.fs, targetRepoRoot, "docs/GLOSSARY.md", "Glossary", "glossary-doc"),
+        await checkFilledMarkdown(deps.fs, targetRepoRoot, "docs/CODING_STANDARDS.md", "Coding standards", "coding-standards-doc"),
         await checkFilledMarkdown(deps.fs, targetRepoRoot, "docs/ARCHITECTURE.md", "Project architecture", "project-architecture"),
         await checkModuleArchitectureDocs(deps.fs, targetRepoRoot, moduleIndex),
         await checkFilledMarkdown(deps.fs, targetRepoRoot, "docs/TESTING.md", "Testing doc", "testing-doc")
@@ -1367,6 +1450,8 @@ async function checkFixedHarness(fs, repoRoot, vcmVersion) {
         "CLAUDE.md",
         MANIFEST_PATH,
         ".claude/skills/vcm-harness-bootstrap/SKILL.md",
+        "docs/GLOSSARY.md",
+        "docs/CODING_STANDARDS.md",
         ".ai/tools/generate-module-index",
         ".ai/tools/generate-public-surface"
     ];
@@ -1665,6 +1750,8 @@ Required work:
 - Run .ai/tools/generate-module-index from the target task worktree when available.
 - Run .ai/tools/generate-public-surface from the target task worktree after module-index.json exists.
 - Add or update project-specific Project Context and Project Constraints in target CLAUDE.md above the VCM managed block.
+- Fill target docs/GLOSSARY.md with the project abbreviation allowlist.
+- Add project-specific coding standards outside the VCM managed block in target docs/CODING_STANDARDS.md when needed; do not edit the installer-maintained baseline.
 - Fill target docs/ARCHITECTURE.md with project-level module overview, responsibilities, relationships, dependency direction, project-wide constraints, and links to module-level architecture docs.
 - Create or update target module-level ARCHITECTURE.md files for clear non-root module boundaries with architectureDoc paths in module-index.json.
 - Fill target docs/TESTING.md with project-native validation levels, commands, validation selection rules, final-validation cleanup, test layout, integration/E2E case lists, generated-context freshness checks, and known testing gaps.

package/dist/backend/services/job-guard-service.js

@@ -177,9 +177,9 @@ function buildCoderWorkerBlockReason(tasks) {
     const reports = tasks
         .map((task) => task.reportPath)
         .filter((reportPath) => Boolean(reportPath));
-    const reportHint = reports.length > 0 ? ` Review report(s): ${reports.join(", ")}.` : "";
+    const reportHint = reports.length > 0 ? ` Test report(s): ${reports.join(", ")}.` : "";
     return `VCM: coder worker task ${listing} is still unhandled. Do not end the Coder turn while worker tasks are unhandled. `
-        + `Wait for worker subagents, review reports and commits, resolve failed or incomplete workers, set \`handled: true\` in each worker state, and continue.${reportHint}`;
+        + `Wait for worker subagents, test reports and commits, resolve failed or incomplete workers, set \`handled: true\` in each worker state, and continue.${reportHint}`;
 }
 function latestMtime(...values) {
     return values.reduce((latest, value) => value !== undefined && (latest === undefined || value > latest) ? value : latest, undefined);

package/dist/backend/services/message-service.js

@@ -10,6 +10,7 @@ const DEFAULT_AUTO_DISPATCH_ENTER_DELAY_MS = 500;
 const DEFAULT_DISPATCH_CONFIRMATION_RETRY_DELAYS_MS = [1500, 3000];
 const DEFAULT_DISPATCH_CONFIRMATION_FAILURE_DELAY_MS = 3000;
 const DISPATCH_NOT_CONFIRMED_REASON = "Auto orchestration pasted the message, but Claude Code did not confirm submission. Press Enter in the target terminal or resend the route message.";
+const INVALID_ROUTE_REASON = "Invalid route: non-PM roles must route through project-manager.";
 export function createMessageService(deps) {
     const now = deps.now ?? (() => new Date().toISOString());
     const id = deps.id ?? (() => `msg_${randomUUID()}`);
@@ -61,6 +62,14 @@ export function createMessageService(deps) {
         return all.filter((routeFile) => routeFile.pending);
     }
     async function dispatchRouteFile(input, routeFile, state, timestamp) {
+        if (!isAllowedRoute(routeFile.fromRole, routeFile.toRole)) {
+            return {
+                delivered: false,
+                requiresUserApproval: false,
+                clearedRouteFile: false,
+                failureReason: INVALID_ROUTE_REASON
+            };
+        }
         const session = await deps.sessionService.getRoleSession(input.repoRoot, input.taskSlug, routeFile.toRole);
         if (!session || session.status !== "running") {
             return {
@@ -357,6 +366,9 @@ function getDefaultMessageType(fromRole, toRole) {
     }
     return "question";
 }
+function isAllowedRoute(fromRole, toRole) {
+    return (fromRole === PM_ROLE && toRole !== PM_ROLE) || (fromRole !== PM_ROLE && toRole === PM_ROLE);
+}
 function selectDispatchCandidates(routeFiles, stoppedRole) {
     const candidates = stoppedRole
         ? routeFiles.filter((routeFile) => routeFile.fromRole === stoppedRole || routeFile.toRole === stoppedRole)

package/dist/backend/services/session-service.js

@@ -15,6 +15,7 @@ const HARNESS_ENGINEER_SESSION_PATH = ".ai/vcm/harness-engineer/session.json";
 const PROJECT_TRANSLATOR_SCOPE = "__project__";
 const PROJECT_HARNESS_ENGINEER_SCOPE = "__project_harness_engineer__";
 const PROJECT_TOOL_CD_ENTER_DELAY_MS = 500;
+const CLAUDE_CODE_DISABLE_AUTO_MEMORY = "1";
 // Project tool sessions launch a Claude Code TUI inside a PTY. The PTY reports
 // "running" the instant it is spawned, which is earlier than the moment the TUI
 // can actually accept pasted input. These bounds drive a quiescence-based
@@ -81,14 +82,14 @@ export function createSessionService(deps) {
             command: startCommand.command,
             args: startCommand.args,
             cwd: startCommand.cwd,
-            env: {
+            env: withClaudeCodeRuntimeEnv({
                 VCM_API_URL: deps.apiUrl,
                 VCM_BASE_REPO_ROOT: repoRoot,
                 VCM_TASK_REPO_ROOT: taskRepoRoot,
                 VCM_TASK_SLUG: taskSlug,
                 VCM_ROLE: role,
                 VCM_SESSION_ID: claudeSessionId || undefined
-            },
+            }),
             cols: input.cols,
             rows: input.rows
         });
@@ -174,7 +175,7 @@ export function createSessionService(deps) {
             command: startCommand.command,
             args: startCommand.args,
             cwd: startCommand.cwd,
-            env: {
+            env: withClaudeCodeRuntimeEnv({
                 VCM_API_URL: deps.apiUrl,
                 VCM_BASE_REPO_ROOT: repoRoot,
                 VCM_TASK_REPO_ROOT: taskContext.taskRepoRoot,
@@ -184,7 +185,7 @@ export function createSessionService(deps) {
                 VCM_TASK_SLUG: PROJECT_TRANSLATOR_SCOPE,
                 VCM_ROLE: TRANSLATOR_ROLE,
                 VCM_SESSION_ID: claudeSessionId || undefined
-            },
+            }),
             cols: input.cols,
             rows: input.rows
         });
@@ -279,7 +280,7 @@ export function createSessionService(deps) {
             command: startCommand.command,
             args: startCommand.args,
             cwd: startCommand.cwd,
-            env: {
+            env: withClaudeCodeRuntimeEnv({
                 VCM_API_URL: deps.apiUrl,
                 VCM_BASE_REPO_ROOT: repoRoot,
                 VCM_TASK_REPO_ROOT: taskContext.taskRepoRoot,
@@ -289,7 +290,7 @@ export function createSessionService(deps) {
                 VCM_TASK_SLUG: PROJECT_HARNESS_ENGINEER_SCOPE,
                 VCM_ROLE: HARNESS_ENGINEER_ROLE,
                 VCM_SESSION_ID: claudeSessionId || undefined
-            },
+            }),
             cols: input.cols,
             rows: input.rows
         });
@@ -468,14 +469,14 @@ export function createSessionService(deps) {
             command: startCommand.command,
             args: startCommand.args,
             cwd: startCommand.cwd,
-            env: {
+            env: withClaudeCodeRuntimeEnv({
                 VCM_API_URL: deps.apiUrl,
                 VCM_BASE_REPO_ROOT: repoRoot,
                 VCM_TASK_REPO_ROOT: targetCwd,
                 VCM_TASK_SLUG: normalizeProjectScopedRecordForPersistence(session).taskSlug,
                 VCM_ROLE: session.role,
                 VCM_SESSION_ID: session.claudeSessionId
-            }
+            })
         });
         if ((await waitForSessionInputReady(runtimeSession.id)) === "exited") {
             deps.registry.remove(runtimeSession.id);
@@ -1217,8 +1218,8 @@ function getHandoffArtifactPath(paths, role) {
     if (role === "architect") {
         return paths.architecturePlanPath;
     }
-    if (role === "reviewer") {
-        return paths.reviewReportPath;
+    if (role === "tester") {
+        return paths.testReportPath;
     }
     return undefined;
 }
@@ -1472,7 +1473,7 @@ function createEmptyTaskSessionRecord(taskSlug, updatedAt) {
             "project-manager": { id: null, status: "not_started" },
             architect: { id: null, status: "not_started" },
             coder: { id: null, status: "not_started" },
-            reviewer: { id: null, status: "not_started" }
+            tester: { id: null, status: "not_started" }
         }
     };
 }
@@ -1517,6 +1518,12 @@ function formatClaudeCdCommand(targetCwd) {
 function isExitedStatus(status) {
     return status === "exited" || status === "crashed" || status === "missing";
 }
+function withClaudeCodeRuntimeEnv(env) {
+    return {
+        ...env,
+        CLAUDE_CODE_DISABLE_AUTO_MEMORY
+    };
+}
 function delay(ms) {
     if (ms <= 0) {
         return Promise.resolve();

package/dist/backend/services/status-service.js

@@ -31,9 +31,6 @@ export function createStatusService(deps) {
                 }
                 warnings.push(`Role sessions are temporarily unavailable because the backend hit the open-files limit: ${errorMessage(error)}`);
             }
-            warnings.push(...artifacts.checks
-                .filter((check) => check.status !== "ok")
-                .map((check) => `${check.path}: ${check.status}`));
             return {
                 task,
                 sessions,
@@ -55,7 +52,7 @@ function degradedArtifactSummary(handoffDir) {
             messageRoutePaths: {},
             architecturePlanPath: `${handoffDir}/architecture-plan.md`,
             knownIssuesPath: `${handoffDir}/known-issues.md`,
-            reviewReportPath: `${handoffDir}/review-report.md`,
+            testReportPath: `${handoffDir}/test-report.md`,
             docsSyncReportPath: `${handoffDir}/docs-sync-report.md`,
             finalAcceptancePath: `${handoffDir}/final-acceptance.md`
         },

package/dist/backend/templates/handoff.js

@@ -1,7 +1,11 @@
 export function renderArchitecturePlanTemplate(taskSlug) {
     return `# Architecture Plan: ${taskSlug}
 
-## Context
+## Accepted Scope
+
+TBD
+
+## Current Code Reality
 
 TBD
 
@@ -9,25 +13,37 @@ TBD
 
 TBD
 
+## Module/File Plan
+
+TBD
+
+## Public Surface Impact
+
+TBD
+
 ## Scaffold Manifest
 
 Task-specific context and coder guidance go here, not in source-code comments.
 Source-code comments should only describe durable behavior, contracts, invariants,
 error boundaries, or non-obvious logic that should remain useful after this task.
 
-| ID | File | Action | Task Context | Durable Code Comment Needed | Coder Work | Allowed Freedom | VCM:CODE | Proof Point | Replan Trigger |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| SCF-001 | TBD | TBD | TBD | TBD | TBD | TBD | TBD | TBD | TBD |
+| ID | File / Action | Why In Scope | Coder Work | Allowed Freedom | Expected VCM:CODE | Durable Comment Needs | Behavior / Contract Proof Points |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| SCF-001 | TBD | TBD | TBD | TBD | TBD | TBD | TBD |
 
-## Implementation Plan
+## Tester Coverage Hints
 
 TBD
 
-## Risks
+## Docs Impact
 
 TBD
 
-## Stop Conditions
+## Known Risks
+
+TBD
+
+## Coder Handoff Notes
 
 TBD
 `;
@@ -44,22 +60,90 @@ No unresolved task issues recorded yet.
 At task close, promote still-relevant confirmed issues to \`docs/known-issues.md\`; delete this task-local file with the rest of \`.ai/vcm/\` runtime state.
 `;
 }
-export function renderReviewReportTemplate(taskSlug) {
-    return `# Review Report: ${taskSlug}
+export function renderTestReportTemplate(taskSlug) {
+    return `# Test Report: ${taskSlug}
 
-## Summary
+Test Result: pass|fail
+
+## Evidence Reviewed
 
 TBD
 
-## Findings
+## Tests Added Or Updated
 
 TBD
 
-## Validation
+## Commands Run Or Checked
 
 TBD
 
-## Decision
+## Validation Results
+
+TBD
+
+## Failed Expectations
+
+TBD
+
+## Reproduction Steps
+
+TBD
+
+## Skipped Checks With Reasons
+
+TBD
+
+## Coverage Gaps
+
+TBD
+
+## Blocking Validation Issues
+
+TBD
+`;
+}
+export function renderCoderCompletionTemplate(taskSlug) {
+    return `# Coder Completion: ${taskSlug}
+
+Decision: ready_for_review|incomplete|failed
+
+## Scaffold Completion
+
+TBD
+
+## Remaining Markers
+
+TBD
+
+## Changed Files
+
+TBD
+
+## Private Helpers Added
+
+TBD
+
+## Manifest Deviations
+
+TBD
+
+## Generated Context
+
+TBD
+
+## Baseline Tests Added Or Updated
+
+TBD
+
+## L0/L1 Validation
+
+TBD
+
+## Worker Results
+
+TBD
+
+## Objective Failures
 
 TBD
 `;
@@ -113,11 +197,11 @@ TBD
 
 ## Scope Traceability
 
-### Expected Changes
+### Expected Files
 
 TBD
 
-### Supporting Changes
+### Supporting Files
 
 TBD
 
@@ -125,11 +209,11 @@ TBD
 
 TBD
 
-### Unexplained Changes
+### Unexplained Files
 
 TBD
 
-### High-Risk Unexpected Changes
+### High-Risk Unexpected Files
 
 TBD
 
@@ -145,6 +229,10 @@ TBD
 
 TBD
 
+## Gate Review Gates
+
+TBD
+
 ## Cleanup Readiness
 
 TBD