create-harness-vibe-coding 0.8.6 → 0.8.8

package/templates/common/scripts/validate-harness.mjs

@@ -25,6 +25,7 @@ const commonAgents = [
   'debugger',
   'reviewer',
   'verifier',
+  'reflector',
   'memory-master',
   'context-master',
   'explore-manager',
@@ -33,12 +34,12 @@ const commonAgents = [
   'review-manager',
 ];
 
-const commonSkills = [
-  'wf',
-  'tdd',
-  'wf-update',
-  'wf-max',
-  'wf-review',
+const commonSkills = [
+  'wf',
+  'tdd',
+  'wf-update',
+  'wf-max',
+  'wf-review',
   'wf-learn',
   'subagent-orchestrator',
   'wf-readme',
@@ -57,27 +58,30 @@ const required = [
   'AGENTS.md',
   'CLAUDE.md',
   'README.md',
-  'Harness/MEMORY.md',
-  'Harness/WF.md',
-  'Harness/WF-MAX.md',
-  'Harness/ACCEPTANCE_PROTOCOL.md',
-  'Harness/AGENT_ISOLATION.md',
-  'Harness/HARNESS_BRIDGE.md',
-  'Harness/DEBUG_PROTOCOL.md',
-  'Harness/MEMORY_PROTOCOL.md',
-  'Harness/templates/PRD.template.md',
-  'Harness/templates/ACCEPTANCE.template.md',
-  'Harness/templates/UI_CONTRACT.template.md',
-  'Harness/templates/API_CONTRACT.template.md',
-  'Harness/templates/TEST_PLAN.template.md',
-  'Harness/templates/PLAYWRIGHT_SPEC.template.ts',
-  'Harness/templates/VALIDATION_REPORT.template.md',
-  ...memoryFiles,
-  '.codex/config.toml',
-  '.claude/settings.json',
-  '.claude/commands/wf-help.md',
-  '.claude/rules/ecc/common.md',
+  'Harness/MEMORY.md',
+  'Harness/WF.md',
+  'Harness/WF-MAX.md',
+  'Harness/ACCEPTANCE_PROTOCOL.md',
+  'Harness/AGENT_ISOLATION.md',
+  'Harness/HARNESS_BRIDGE.md',
+  'Harness/DEBUG_PROTOCOL.md',
+  'Harness/MEMORY_PROTOCOL.md',
+  'Harness/templates/PRD.template.md',
+  'Harness/templates/ACCEPTANCE.template.md',
+  'Harness/templates/UI_CONTRACT.template.md',
+  'Harness/templates/API_CONTRACT.template.md',
+  'Harness/templates/TEST_PLAN.template.md',
+  'Harness/templates/PLAYWRIGHT_SPEC.template.ts',
+  'Harness/templates/VALIDATION_REPORT.template.md',
+  ...memoryFiles,
+  '.codex/config.toml',
+  'opencode.json',
+  '.claude/settings.json',
+  '.claude/commands/wf-help.md',
+  '.opencode/commands/wf-help.md',
+  '.claude/rules/ecc/common.md',
   ...commonAgents.map(agent => `.claude/agents/${agent}.md`),
+  ...commonAgents.map(agent => `.opencode/agents/${agent}.md`),
   ...commonSkills.map(skill => `.claude/skills/${skill}/SKILL.md`),
   ...commonSkills.map(skill => `.agents/skills/${skill}/SKILL.md`),
   'Harness/README.md',
@@ -91,8 +95,8 @@ const required = [
   'Harness/architecture.md',
   'Harness/research/README.md',
   'Harness/research/research-results.md',
-  'Harness/research/PRD.md',
-  'Harness/scripts/wf-update-check.mjs',
+  'Harness/research/PRD.md',
+  'Harness/scripts/wf-update-check.mjs',
   'Harness/scripts/wf-remove.mjs',
   'Harness/scripts/scan-clean.mjs',
   'Harness/.harness-version',
@@ -134,16 +138,16 @@ function read(rel) {
   return fs.existsSync(file) ? fs.readFileSync(file, 'utf8') : '';
 }
 
-function requireText(rel, text, label = text) {
-  const body = read(rel);
-  if (body && !body.includes(text)) errors.push(`${rel} missing ${label}`);
-}
-
-function forbidText(rel, text, label = text) {
-  const body = read(rel);
-  if (body && body.includes(text)) errors.push(`${rel} contains forbidden ${label}`);
-}
-
+function requireText(rel, text, label = text) {
+  const body = read(rel);
+  if (body && !body.includes(text)) errors.push(`${rel} missing ${label}`);
+}
+
+function forbidText(rel, text, label = text) {
+  const body = read(rel);
+  if (body && body.includes(text)) errors.push(`${rel} contains forbidden ${label}`);
+}
+
 function frontmatterField(text, field) {
   const match = text.match(new RegExp(`^${field}:\\s*(.+)$`, 'm'));
   return match ? match[1].trim() : '';
@@ -227,25 +231,40 @@ function registeredWorkflowFiles(...texts) {
   return [...files].sort();
 }
 
-for (const rel of required) {
-  if (!fs.existsSync(path.join(root, rel))) {
-    errors.push(`missing required file: ${rel}`);
-  }
-}
-
-const removedHookArtifacts = [
-  'Harness/HOOK_PROTOCOL.md',
-  'Harness/scripts/wf-mode-hook.mjs',
-  'Harness/scripts/wf-statusline.sh',
-  'Harness/scripts/wf-statusline.ps1',
-  'tests/e2e-wf-hooks.test.mjs',
-];
-
-for (const rel of removedHookArtifacts) {
-  if (fs.existsSync(path.join(root, rel))) {
-    errors.push(`removed hook artifact should not exist: ${rel}`);
-  }
-}
+function listedWorkflowCommands(...texts) {
+  const commands = new Set();
+  const pattern = /`\/(wf(?:-[a-z0-9]+)?)(?:\s+[^`]*)?`/g;
+
+  for (const text of texts) {
+    for (const match of text.matchAll(pattern)) {
+      const command = `/${match[1]}`;
+      if (command === '/wf-help') continue;
+      commands.add(command);
+    }
+  }
+
+  return [...commands].sort();
+}
+
+for (const rel of required) {
+  if (!fs.existsSync(path.join(root, rel))) {
+    errors.push(`missing required file: ${rel}`);
+  }
+}
+
+const removedHookArtifacts = [
+  'Harness/HOOK_PROTOCOL.md',
+  'Harness/scripts/wf-mode-hook.mjs',
+  'Harness/scripts/wf-statusline.sh',
+  'Harness/scripts/wf-statusline.ps1',
+  'tests/e2e-wf-hooks.test.mjs',
+];
+
+for (const rel of removedHookArtifacts) {
+  if (fs.existsSync(path.join(root, rel))) {
+    errors.push(`removed hook artifact should not exist: ${rel}`);
+  }
+}
 
 // Task capsule template files
 const taskTemplateDir = path.join(root, 'Harness', 'tasks', '_template');
@@ -312,17 +331,17 @@ for (const rel of durableCommunicationDocs) {
   requireText(rel, 'chat/subagent transcript state is non-authoritative', 'non-authoritative transcript invariant');
 }
 
-requireText('CLAUDE.md', 'same tool/use pattern fails 3+ times', 'tool reflection trigger');
-requireText('CLAUDE.md', 'user corrects the same assumption/pattern 2+ times', 'user correction reflection trigger');
+requireText('Harness/MEMORY_PROTOCOL.md', 'same tool or command pattern fails 3+ times', 'tool reflection trigger');
+requireText('Harness/MEMORY_PROTOCOL.md', 'user corrects the same assumption or preference 2+ times', 'user correction reflection trigger');
 requireText('CLAUDE.md', 'If `Harness/` exists, this repository is governed by the Harness contract', 'Harness binding contract');
-requireText('CLAUDE.md', 'Harness/MEMORY.md` is the memory/resource router', 'memory/resource router');
-requireText('CLAUDE.md', 'Harness/README.md#Load By Task', 'Harness task router');
-requireText('CLAUDE.md', 'Harness/SETUP.md` exists, follow it before normal project work', 'setup bootstrap contract');
-requireText('Harness/SETUP.md', 'Harness/MEMORY_PROTOCOL.md', 'setup memory protocol reference');
-requireText('CLAUDE.md', 'subagent-orchestrator` and `Harness/subagents.md', 'subagent orchestrator entry trigger');
-requireText('CLAUDE.md', 'Harness/PROGRESS.md` is the global task index', 'PROGRESS global task index');
+requireText('CLAUDE.md', 'memory and resource router', 'memory/resource router');
+requireText('Harness/README.md', 'Load By Task', 'Harness task router');
+requireText('CLAUDE.md', 'Harness/SETUP.md` exists, follow it before normal project work', 'setup bootstrap contract');
+requireText('Harness/SETUP.md', 'Harness/MEMORY_PROTOCOL.md', 'setup memory protocol reference');
+requireText('Harness/README.md', 'subagent-orchestrator', 'subagent orchestrator entry trigger');
+requireText('Harness/README.md', 'PROGRESS.md', 'PROGRESS global task index');
 requireText('CLAUDE.md', 'Harness/tasks/', 'task capsule directory reference');
-requireText('CLAUDE.md', 'Subagents are readers and reporters', 'subagent state committer rule');
+requireText('Harness/subagents.md', 'Subagents are readers and reporters', 'subagent state committer rule');
 for (const heading of ['## 2. Think Before Coding', '## 3. Simplicity First', '## 4. Surgical Changes', '## 5. Goal-Driven Execution']) {
   requireText('CLAUDE.md', heading, `Karpathy-style rule heading: ${heading}`);
 }
@@ -386,6 +405,18 @@ for (const skillFile of registeredSkillFiles(docsReadme, memory)) {
   }
 }
 
+for (const command of listedWorkflowCommands(docsReadme, read('.claude/commands/wf-help.md'))) {
+  const skill = command.slice(1);
+  const claudeSkill = `.claude/skills/${skill}/SKILL.md`;
+  const codexSkill = `.agents/skills/${skill}/SKILL.md`;
+  if (!fs.existsSync(path.join(root, claudeSkill))) {
+    errors.push(`command docs list missing Claude skill: ${command} -> ${claudeSkill}`);
+  }
+  if (!fs.existsSync(path.join(root, codexSkill))) {
+    errors.push(`command docs list missing Codex skill: ${command} -> ${codexSkill}`);
+  }
+}
+
 for (const workflowFile of registeredWorkflowFiles(docsReadme, memory)) {
   if (!fs.existsSync(path.join(root, workflowFile))) {
     // Optional workflows (browser-e2e, ts-react-frontend, etc.) may not be installed
@@ -476,20 +507,44 @@ for (const agent of commonAgents) {
   }
 }
 
-requireText('Harness/extension.md', 'Skills should extend the harness');
-requireText('Harness/agent-workflow.md', 'Harness/tasks/<task-id>/PROGRESS.md');
-requireText('Harness/agent-workflow.md', 'TDD-GUIDE.md', 'agent workflow loads TDD guide');
-requireText('Harness/agent-workflow.md', 'real user-path test', 'agent workflow real user path requirement');
-requireText('Harness/research/README.md', 'research-results.md');
+for (const agent of commonAgents) {
+  const rel = `.opencode/agents/${agent}.md`;
+  const text = read(rel);
+  if (!text) continue;
+
+  for (const field of ['description', 'mode']) {
+    if (!frontmatterField(text, field)) errors.push(`${rel} missing frontmatter field: ${field}:`);
+  }
+
+  const mode = frontmatterField(text, 'mode');
+  if (mode && mode !== 'subagent') {
+    errors.push(`${rel} frontmatter mode should be subagent (got: ${mode})`);
+  }
+}
+
+requireText('Harness/extension.md', 'Skills should extend the harness');
+requireText('Harness/agent-workflow.md', 'Harness/tasks/<task-id>/PROGRESS.md');
+requireText('Harness/README.md', 'Task records are compact by default', 'compact task record router rule');
+requireText('Harness/agent-workflow.md', 'AC record size', 'compact AC record size rule');
+requireText('Harness/ACCEPTANCE_PROTOCOL.md', 'Default to 1-3 concise ACs', 'compact AC default');
+requireText('Harness/WF.md', 'Do not paste command logs or subagent transcripts', 'compact heartbeat rule');
+requireText('Harness/tasks/_template/PLAN.md', 'Compact task record', 'compact task PLAN template');
+requireText('Harness/tasks/_template/PLAN.md', 'Default: keep 1-3 concise ACs', 'compact task PLAN AC guidance');
+requireText('Harness/tasks/_template/PROGRESS.md', 'Compact heartbeat', 'compact task PROGRESS template');
+requireText('Harness/agent-workflow.md', 'TDD-GUIDE.md', 'agent workflow loads TDD guide');
+requireText('Harness/agent-workflow.md', 'real user-path test', 'agent workflow real user path requirement');
+requireText('Harness/research/README.md', 'research-results.md');
 requireText('Harness/WF.md', 'Ralph-style harness loop', 'WF loop description');
 requireText('Harness/WF.md', 'Heartbeat Protocol', 'heartbeat protocol');
-requireText('Harness/WF.md', 'WF mode requires multi-subagent orchestration by default', 'WF multi-subagent default');
-requireText('Harness/WF.md', 'Explicit `/wf`, `$wf`, `wf mode`, `workflow mode`, or `wk mode` MUST use at least 3 distinct role passes', 'explicit WF/WK role-pass minimum');
+requireText('Harness/WF.md', 'WF mode requires the complete role chain by default', 'WF complete role chain default');
+requireText('Harness/WF.md', 'MUST cover every mandatory role class before closeout', 'explicit WF/WK complete role chain');
+requireText('Harness/WF.md', 'Independent Validation', 'WF independent validation role');
+requireText('Harness/WF.md', 'reflector', 'WF reflector gate');
 requireText('Harness/WF.md', '.claude/agents/', 'WF built-in agent roster path');
-requireText('Harness/WF.md', 'Collaboration decision tree', 'WF decision tree');
-requireText('Harness/WF.md', 'Harness/tasks/', 'WF task directory reference');
-requireText('Harness/WF.md', 'IMPLEMENT-GATE', 'WF implement gate naming');
-requireText('Harness/README.md', '`wf mode`, `workflow mode`, or `wk mode`', 'WF/WK router aliases');
+requireText('Harness/WF.md', 'Collaboration decision tree', 'WF decision tree');
+requireText('Harness/WF.md', 'Harness/tasks/', 'WF task directory reference');
+requireText('Harness/WF.md', 'IMPLEMENT-GATE', 'WF implement gate naming');
+requireText('Harness/README.md', '`wf mode`, `workflow mode`, or `wk mode`', 'WF/WK router aliases');
 requireText('Harness/README.md', 'explicit WF/WK loads subagent docs immediately', 'explicit WF/WK router output');
 requireText('.claude/skills/wf/SKILL.md', 'Harness/WF.md', 'wf skill loads core WF doc');
 requireText('.agents/skills/wf/SKILL.md', 'Harness/WF.md', 'Codex wf skill loads core WF doc');
@@ -506,89 +561,133 @@ requireText('Harness/subagents.md', '## Built-in Agent Roster', 'built-in agent
 requireText('Harness/subagents.md', '## WF Default Fan-Out', 'WF default fan-out');
 requireText('Harness/subagents.md', 'concrete conditions', 'subagent decision tree');
 requireText('Harness/subagents.md', 'parallel planner/researcher/docs-researcher/architect subagents', 'WF roster orchestration shape');
+requireText('Harness/subagents.md', '`reflector`', 'reflector agent roster');
+requireText('Harness/subagents.md', 'reflector PASS', 'reflector review gate');
 requireText('Harness/subagents.md', '## Efficiency Ladder', 'subagent efficiency ladder');
 requireText('Harness/subagents.md', '## Review Gates', 'subagent review gates');
 requireText('Harness/architecture.md', '## 2. Interface Decoupling', 'architecture interface decoupling');
 requireText('Harness/architecture.md', '## 3. State Design', 'architecture state design');
 requireText('Harness/architecture.md', 'Avoid speculative abstraction', 'anti-overengineering architecture rule');
 requireText('CLAUDE.md', 'Use explicit interfaces or state models only when they protect a real boundary', 'CLAUDE interface/state simplicity rule');
-requireText('CLAUDE.md', '/wf-update', 'wf update startup instruction');
+requireText('Harness/README.md', '/wf-update', 'wf update startup instruction');
 requireText('Harness/README.md', 'Need harness update', 'update routing row');
 requireText('Harness/WF-MAX.md', 'three-layer architecture', 'WF-MAX three-layer architecture');
 requireText('Harness/WF-MAX.md', 'agent role', 'WF-MAX agent role separation');
 requireText('Harness/WF-MAX.md', 'write-set coloring', 'WF-MAX coloring algorithm');
 requireText('Harness/WF-MAX.md', 'wave dispatch', 'WF-MAX wave dispatch');
+requireText('Harness/WF-MAX.md', 'strict superset', 'WF-MAX strict superset');
+requireText('Harness/WF-MAX.md', 'cross-CLI overflow', 'WF-MAX cross-CLI overflow');
+requireText('Harness/WF-MAX.md', 'claude -p', 'WF-MAX Claude CLI overflow');
+requireText('Harness/WF-MAX.md', 'codex exec', 'WF-MAX Codex CLI overflow');
+requireText('Harness/WF-MAX.md', 'agents.max_threads', 'WF-MAX Codex max_threads config');
+requireText('Harness/WF-MAX.md', 'agents.max_depth', 'WF-MAX Codex max_depth config');
+requireText('Harness/WF-MAX.md', 'max_threads = 12', 'WF-MAX Codex scaffold max_threads default');
+requireText('Harness/WF-MAX.md', 'max_depth = 1', 'WF-MAX Codex scaffold max_depth default');
+requireText('Harness/WF-MAX.md', 'ask the user before raising `agents.max_threads`', 'WF-MAX asks before raising Codex thread cap');
+requireText('Harness/WF-MAX.md', 'Close completed agents', 'WF-MAX close completed agents before overflow');
+requireText('Harness/WF-MAX.md', 'Codex++', 'WF-MAX forbids relying on Codex++ as stable capacity');
+requireText('.claude/skills/wf-max/SKILL.md', 'agents.max_threads', 'wf-max skill Codex thread config');
+requireText('.claude/skills/wf-max/SKILL.md', 'max_threads = 12', 'wf-max skill Codex scaffold max_threads default');
+requireText('.claude/skills/wf-max/SKILL.md', 'ask the user before raising', 'wf-max skill asks before raising Codex thread cap');
+requireText('.claude/skills/wf-max/SKILL.md', 'Codex++', 'wf-max skill forbids Codex++ capacity assumption');
+requireText('.codex/config.toml', '[agents]', 'Codex agents config table');
+requireText('.codex/config.toml', 'max_threads = 12', 'Codex scaffold max_threads default');
+requireText('.codex/config.toml', 'max_depth = 1', 'Codex scaffold max_depth default');
+requireText('opencode.json', '"$schema": "https://opencode.ai/config.json"', 'OpenCode config schema');
+requireText('opencode.json', '.claude/rules/ecc/common.md', 'OpenCode instructions reference to ECC rules');
 requireText('Harness/README.md', '/wf-max', 'wf max router alias');
-requireText('Harness/README.md', 'WF-MAX.md', 'WF-MAX router reference');
-requireText('Harness/README.md', 'ACCEPTANCE_PROTOCOL.md', 'acceptance protocol router reference');
-requireText('Harness/README.md', 'TDD-GUIDE.md', 'TDD guide router reference');
-requireText('Harness/ACCEPTANCE_PROTOCOL.md', 'PRD-GATE', 'acceptance PRD gate');
-requireText('Harness/ACCEPTANCE_PROTOCOL.md', 'AC-GATE', 'acceptance AC gate');
-requireText('Harness/ACCEPTANCE_PROTOCOL.md', 'Acceptance Result', 'acceptance result matrix');
-requireText('Harness/ACCEPTANCE_PROTOCOL.md', 'Syntax-only checks', 'syntax-only checks are not browser acceptance evidence');
-requireText('Harness/AGENT_ISOLATION.md', 'implementer', 'agent isolation implementer rule');
-requireText('Harness/HARNESS_BRIDGE.md', 'Network Trace Collector', 'harness bridge network trace collector');
-requireText('Harness/WF-AUTO.md', 'Intent Checkpoint', 'wf-auto intent checkpoint');
-requireText('Harness/MEMORY_PROTOCOL.md', 'Scenario Memory Hints', 'memory protocol scenario hints');
-requireText('Harness/MEMORY_PROTOCOL.md', 'WF closeout', 'memory protocol WF closeout injection row');
-requireText('Harness/MEMORY_PROTOCOL.md', 'memory-master owns writes', 'memory protocol memory write ownership');
-requireText('Harness/TDD-GUIDE.md', 'Browser/UI Acceptance TDD Gate', 'browser UI acceptance TDD gate');
-requireText('Harness/TDD-GUIDE.md', 'syntax-only', 'syntax-only acceptance prohibition');
-requireText('Harness/TDD-GUIDE.md', 'Playwright/CDP', 'Playwright/CDP acceptance requirement');
-requireText('Harness/TDD-GUIDE.md', 'AC-by-AC result matrix', 'AC-by-AC TDD evidence matrix');
-requireText('Harness/tasks/_template/PLAN.md', 'User Action / API Request', 'task template user action/API test-plan column');
-requireText('Harness/templates/TEST_PLAN.template.md', 'syntax-only checks', 'test plan template syntax-only prohibition');
-requireText('.claude/skills/tdd/SKILL.md', 'Harness/ACCEPTANCE_PROTOCOL.md', 'tdd skill loads acceptance protocol');
-requireText('.claude/skills/tdd/SKILL.md', 'Harness/HARNESS_BRIDGE.md', 'tdd skill loads harness bridge');
-requireText('.claude/skills/tdd/SKILL.md', 'No syntax-only acceptance', 'tdd skill forbids syntax-only acceptance');
-requireText('.claude/skills/wf-remove/SKILL.md', 'User-facing removal is the slash/skill command', 'wf-remove slash command is user-facing');
-requireText('.claude/skills/wf-remove/SKILL.md', 'agent-internal execution steps', 'wf-remove script commands are agent-internal');
-requireText('.claude/skills/wf-remove/SKILL.md', 'verify residual discovery folders', 'wf-remove residual discovery verification');
-requireText('.claude/agents/tdd-guide.md', 'Browser Acceptance Rules', 'tdd-guide browser acceptance rules');
-requireText('.claude/agents/tdd-guide.md', 'real user actions', 'tdd-guide real user action requirement');
-requireText('.claude/agents/test-writer.md', 'Harness/ACCEPTANCE_PROTOCOL.md', 'test-writer loads acceptance protocol');
-requireText('.claude/agents/test-writer.md', 'real user-path test', 'test-writer real user path requirement');
-requireText('.claude/agents/test-writer.md', 'network URL, method, payload', 'test-writer network assertion requirement');
-requireText('Harness/DEBUG_PROTOCOL.md', 'Layer Classification', 'debug layer classification');
-requireText('Harness/MEMORY_PROTOCOL.md', 'AC ID', 'memory AC traceability');
-requireText('Harness/subagents.md', 'Max parallelism', 'subagents max parallelism row');
+requireText('Harness/README.md', 'WF-MAX.md', 'WF-MAX router reference');
+requireText('Harness/README.md', 'ACCEPTANCE_PROTOCOL.md', 'acceptance protocol router reference');
+requireText('Harness/README.md', 'TDD-GUIDE.md', 'TDD guide router reference');
+requireText('Harness/ACCEPTANCE_PROTOCOL.md', 'PRD-GATE', 'acceptance PRD gate');
+requireText('Harness/ACCEPTANCE_PROTOCOL.md', 'AC-GATE', 'acceptance AC gate');
+requireText('Harness/ACCEPTANCE_PROTOCOL.md', 'Acceptance Result', 'acceptance result matrix');
+requireText('Harness/ACCEPTANCE_PROTOCOL.md', 'Syntax-only checks', 'syntax-only checks are not browser acceptance evidence');
+requireText('Harness/AGENT_ISOLATION.md', 'implementer', 'agent isolation implementer rule');
+requireText('Harness/HARNESS_BRIDGE.md', 'Network Trace Collector', 'harness bridge network trace collector');
+requireText('Harness/WF-AUTO.md', 'Intent Checkpoint', 'wf-auto intent checkpoint');
+requireText('Harness/WF-AUTO.md', 'Adaptive Coverage Exhaustion Gate', 'wf-auto adaptive coverage exhaustion gate');
+requireText('Harness/WF-AUTO.md', 'dynamic high-risk obligations', 'wf-auto dynamic high-risk obligations');
+requireText('Harness/WF-AUTO.md', 'two different confirmation strategies', 'wf-auto two different confirmation strategies');
+requireText('Harness/WF-AUTO-ANGLES.md', 'Selection algorithm', 'wf-auto adaptive angle selection');
+requireText('Harness/WF-AUTO-ANGLES.md', 'Dynamic obligations', 'wf-auto dynamic obligations');
+requireText('Harness/WF-AUTO-ANGLES.md', 'Common probe recipes', 'wf-auto common probe recipes');
+forbidText('Harness/WF-AUTO.md', 'All 8 exhausted', 'stale eight-angle exhaustion rule');
+forbidText('Harness/WF-AUTO.md', '3 consecutive all-exhausted rounds', 'stale three-consecutive-all-exhausted stop rule');
+forbidText('Harness/WF-AUTO.md', '8-Angle Exhaustion Gate', 'stale eight-angle exhaustion gate name');
+forbidText('Harness/WF-AUTO-SPARK.md', '8 parallel external searches', 'stale eight-spark fixed-count search');
+requireText('Harness/WF-AUTO.md', 'Inherited WF/WF-MAX Constraints', 'wf-auto inherited WF/WF-MAX constraints');
+requireText('Harness/WF-AUTO.md', 'Mini PRD -> AC IDs -> test/validation plan -> implementer -> verifier', 'wf-auto per-cycle WF chain');
+requireText('Harness/WF-AUTO.md', 'reflector PASS', 'wf-auto reflector gate');
+requireText('Harness/WF-AUTO-SPARK.md', 'Inherited Execution Chain', 'wf-auto-spark inherited execution chain');
+requireText('Harness/WF-AUTO-SPARK.md', 'External spark search replaces discovery only', 'wf-auto-spark discovery-only inheritance');
+requireText('Harness/WF-AUTO-SPARK.md', 'reflector PASS', 'wf-auto-spark reflector gate');
+requireText('Harness/MEMORY_PROTOCOL.md', 'Scenario Memory Hints', 'memory protocol scenario hints');
+requireText('Harness/MEMORY_PROTOCOL.md', 'WF closeout', 'memory protocol WF closeout injection row');
+requireText('Harness/MEMORY_PROTOCOL.md', 'memory-master owns writes', 'memory protocol memory write ownership');
+requireText('Harness/TDD-GUIDE.md', 'Browser/UI Acceptance TDD Gate', 'browser UI acceptance TDD gate');
+requireText('Harness/TDD-GUIDE.md', 'syntax-only', 'syntax-only acceptance prohibition');
+requireText('Harness/TDD-GUIDE.md', 'Playwright/CDP', 'Playwright/CDP acceptance requirement');
+requireText('Harness/TDD-GUIDE.md', 'AC-by-AC result matrix', 'AC-by-AC TDD evidence matrix');
+requireText('Harness/tasks/_template/PLAN.md', 'Expanded evidence required when triggered', 'task template expanded evidence trigger');
+requireText('Harness/templates/TEST_PLAN.template.md', 'syntax-only checks', 'test plan template syntax-only prohibition');
+requireText('.claude/skills/tdd/SKILL.md', 'Harness/ACCEPTANCE_PROTOCOL.md', 'tdd skill loads acceptance protocol');
+requireText('.claude/skills/tdd/SKILL.md', 'Harness/HARNESS_BRIDGE.md', 'tdd skill loads harness bridge');
+requireText('.claude/skills/tdd/SKILL.md', 'No syntax-only acceptance', 'tdd skill forbids syntax-only acceptance');
+requireText('.claude/skills/wf-remove/SKILL.md', 'User-facing removal is the slash/skill command', 'wf-remove slash command is user-facing');
+requireText('.claude/skills/wf-remove/SKILL.md', 'agent-internal execution steps', 'wf-remove script commands are agent-internal');
+requireText('.claude/skills/wf-remove/SKILL.md', 'verify residual discovery folders', 'wf-remove residual discovery verification');
+requireText('.claude/agents/tdd-guide.md', 'Browser Acceptance Rules', 'tdd-guide browser acceptance rules');
+requireText('.claude/agents/tdd-guide.md', 'real user actions', 'tdd-guide real user action requirement');
+requireText('.claude/agents/test-writer.md', 'Harness/ACCEPTANCE_PROTOCOL.md', 'test-writer loads acceptance protocol');
+requireText('.claude/agents/test-writer.md', 'real user-path test', 'test-writer real user path requirement');
+requireText('.claude/agents/test-writer.md', 'network URL, method, payload', 'test-writer network assertion requirement');
+requireText('.claude/agents/reflector.md', 'PASS, RETURN_TO_DEBUG, or BLOCKED', 'reflector verdict contract');
+requireText('Harness/DEBUG_PROTOCOL.md', 'Layer Classification', 'debug layer classification');
+requireText('Harness/MEMORY_PROTOCOL.md', 'AC ID', 'memory AC traceability');
+requireText('Harness/subagents.md', 'Max parallelism', 'subagents max parallelism row');
 requireText('Harness/dispatch.md', 'Concurrency group', 'dispatch concurrency group field');
 requireText('Harness/dispatch.md', 'File claim', 'dispatch file claim field');
-requireText('CLAUDE.md', '/wf-max', 'wf max startup instruction');
-requireText('.claude/commands/wf-help.md', 'Do not invoke a skill', 'wf-help direct command boundary');
-requireText('.claude/commands/wf-help.md', '| `/wf-help` |', 'wf-help command row');
-requireText('.claude/commands/wf-help.md', '| `/wf-max <task>` |', 'wf-help wf-max row');
-requireText('.claude/commands/wf-help.md', '| `/wf-auto` |', 'wf-help wf-auto row');
-requireText('.claude/commands/wf-help.md', '| `/wf-readme <task>` |', 'wf-help wf-readme row');
-requireText('Harness/README.md', '## Direct Commands', 'direct commands section');
-requireText('Harness/README.md', '.claude/commands/wf-help.md', 'wf-help router reference');
-requireText('CLAUDE.md', 'three-layer architecture', 'CLAUDE.md three-layer role architecture');
-requireText('CLAUDE.md', 'not hook-enforced', 'CLAUDE no-hook role enforcement statement');
-requireText('Harness/README.md', 'no runtime hook state', 'README no-hook runtime statement');
-requireText('Harness/WF-AUTO.md', 'WF-AUTO Hook Exception', 'wf-auto-only hook exception');
-requireText('Harness/WF-AUTO.md', 'only `/wf-auto` may use a runtime hook', 'wf-auto-only hook boundary');
-forbidText('CLAUDE.md', 'Enforced by hooks', 'WF-MAX hook enforcement claim');
-forbidText('CLAUDE.md', 'WF-MAX hooks', 'WF-MAX hook enforcement claim');
-forbidText('Harness/README.md', 'PreToolUse hook', 'WF-MAX PreToolUse hook claim');
-forbidText('Harness/README.md', 'SessionStart hook', 'WF-MAX SessionStart hook claim');
-forbidText('Harness/README.md', 'hook-managed', 'hook-managed runtime claim');
-forbidText('Harness/README.md', 'HOOK_PROTOCOL.md', 'removed hook protocol reference');
-forbidText('Harness/WF-AUTO.md', 'Hook-Assisted Long Loop', 'wf-auto hook loop section');
-forbidText('Harness/MEMORY_PROTOCOL.md', 'Hooks may', 'hook-triggered memory claim');
-forbidText('.claude/settings.json', 'wf-mode-hook.mjs', 'Claude WF hook command registration');
-forbidText('.codex/hooks.json', 'wf-mode-hook.mjs', 'Codex WF hook command registration');
-const codexHookConfig = read('.codex/hooks.json');
-const claudeSettings = read('.claude/settings.json');
-if (codexHookConfig && !codexHookConfig.includes('wf-auto')) {
-  errors.push('.codex/hooks.json may only exist for a wf-auto hook configuration');
-}
-if (claudeSettings.includes('"hooks"') && !claudeSettings.includes('wf-auto')) {
-  errors.push('.claude/settings.json hooks may only be used for wf-auto');
-}
-if (read('.codex/config.toml').includes('hooks = true') && !codexHookConfig.includes('wf-auto')) {
-  errors.push('.codex/config.toml may enable hooks only with a wf-auto hook configuration');
-}
-if (errors.length) {
+requireText('CLAUDE.md', '/wf-max', 'wf max startup instruction');
+requireText('.claude/commands/wf-help.md', 'Do not invoke a skill', 'wf-help direct command boundary');
+requireText('.claude/commands/wf-help.md', '| `/wf-help` |', 'wf-help command row');
+requireText('.claude/commands/wf-help.md', '| `/wf-max <task>` |', 'wf-help wf-max row');
+requireText('.claude/commands/wf-help.md', '| `/wf-auto` |', 'wf-help wf-auto row');
+requireText('.claude/commands/wf-help.md', '| `/wf-readme <task>` |', 'wf-help wf-readme row');
+requireText('Harness/README.md', '## Direct Commands', 'direct commands section');
+requireText('Harness/README.md', '.claude/commands/wf-help.md', 'wf-help router reference');
+requireText('Harness/WF-MAX.md', 'three-layer architecture', 'CLAUDE.md three-layer role architecture');
+requireText('Harness/README.md', 'no runtime hook state', 'CLAUDE no-hook role enforcement statement');
+requireText('Harness/README.md', 'no runtime hook state', 'README no-hook runtime statement');
+requireText('Harness/WF-AUTO.md', 'WF-AUTO Hook Exception', 'wf-auto-only hook exception');
+requireText('Harness/WF-AUTO.md', 'only `/wf-auto` may use a runtime hook', 'wf-auto-only hook boundary');
+forbidText('CLAUDE.md', 'Enforced by hooks', 'WF-MAX hook enforcement claim');
+forbidText('Harness/WF.md', 'MUST use at least 3 distinct role passes', 'old WF role-pass minimum');
+forbidText('Harness/WF.md', 'at least three distinct role passes', 'old WF role-pass wording');
+forbidText('Harness/dispatch.md', 'requires ≥3 distinct subagents', 'old dispatch WF role minimum');
+forbidText('CLAUDE.md', 'WF-MAX hooks', 'WF-MAX hook enforcement claim');
+forbidText('Harness/README.md', 'PreToolUse hook', 'WF-MAX PreToolUse hook claim');
+forbidText('Harness/README.md', 'SessionStart hook', 'WF-MAX SessionStart hook claim');
+forbidText('Harness/README.md', 'hook-managed', 'hook-managed runtime claim');
+forbidText('Harness/README.md', 'HOOK_PROTOCOL.md', 'removed hook protocol reference');
+forbidText('Harness/WF-AUTO.md', 'Hook-Assisted Long Loop', 'wf-auto hook loop section');
+forbidText('Harness/dispatch.md', 'removes the cap entirely', 'unbounded runtime-cap claim');
+forbidText('Harness/WF-MAX.md', 'no hard agent cap; recursion governed', 'unbounded agent-cap claim');
+forbidText('Harness/MEMORY_PROTOCOL.md', 'Hooks may', 'hook-triggered memory claim');
+forbidText('.claude/settings.json', 'wf-mode-hook.mjs', 'Claude WF hook command registration');
+forbidText('.codex/hooks.json', 'wf-mode-hook.mjs', 'Codex WF hook command registration');
+const codexHookConfig = read('.codex/hooks.json');
+const claudeSettings = read('.claude/settings.json');
+if (codexHookConfig && !codexHookConfig.includes('wf-auto')) {
+  errors.push('.codex/hooks.json may only exist for a wf-auto hook configuration');
+}
+if (claudeSettings.includes('"hooks"') && !claudeSettings.includes('wf-auto')) {
+  errors.push('.claude/settings.json hooks may only be used for wf-auto');
+}
+if (read('.codex/config.toml').includes('hooks = true') && !codexHookConfig.includes('wf-auto')) {
+  errors.push('.codex/config.toml may enable hooks only with a wf-auto hook configuration');
+}
+if (errors.length) {
   console.error(`Harness validation failed${strict ? ' (strict)' : ''}:`);
   for (const error of errors) console.error(`- ${error}`);
   process.exit(1);