@boyingliu01/xp-gate 0.14.4 → 0.14.6

package/mock-policy/AGENTS.md

@@ -1,9 +1,9 @@
 # SRC/MOCK-POLICY KNOWLEDGE BASE
 
 **Generated:** 2026-07-09
-**Commit:** a09c009
+**Commit:** df2023f
 **Branch:** main
-**Version:** 0.14.3.0
+**Version:** 0.14.6.0
 
 ## OVERVIEW
 Mock layering policy enforcement — Gate M3 of pre-push hook. Ensures integration tests use real implementations for internal dependencies, mock external dependencies, and annotate pending mocks with removal plans. Combines project scope scanning, mock decision engine, and per-file validation into a single pipeline.

package/mutation/AGENTS.md

@@ -1,9 +1,9 @@
 # SRC/MUTATION KNOWLEDGE BASE
 
 **Generated:** 2026-07-09
-**Commit:** a09c009
+**Commit:** df2023f
 **Branch:** main
-**Version:** 0.14.3.0
+**Version:** 0.14.6.0
 
 ## OVERVIEW
 **Gate M** (incremental mutation testing) + **Gate M2** helpers (test-layer detection used by `src/mock-policy/`). Pre-push quality gate. TypeScript-only; uses Stryker.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boyingliu01/xp-gate",
-  "version": "0.14.4",
+  "version": "0.14.6",
   "description": "AI-driven development workflow: 6 quality gates + Delphi review + Sprint Flow",
   "bin": {
     "xp-gate": "./bin/xp-gate.js"

package/plugins/claude-code/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "xp-gate",
-  "version": "0.14.4",
+  "version": "0.14.6",
   "displayName": "XP-Gate",
   "description": "Extreme Programming quality gates + AI workflow skills for Claude Code. Includes 10 quality gates (Gate 0-9), Sprint Flow (11 phases), and Delphi multi-expert review (>=90% consensus).",
   "author": {

package/plugins/claude-code/skills/delphi-review/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/DELPHI-REVIEW KNOWLEDGE BASE
 
 **Generated:** 2026-07-09
-**Commit:** 8408ba6
-**Branch:** sprint/2026-07-09-01
-**Version:** 0.14.4.0
+**Commit:** df2023f
+**Branch:** main
+**Version:** 0.14.6.0
 
 ## OVERVIEW
 Delphi Consensus Review — multi-round anonymous expert review (≥90% threshold, 3 experts from ≥2 providers, domestic models only). Supports design + code-walkthrough modes.

package/plugins/claude-code/skills/sprint-flow/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/SPRINT-FLOW KNOWLEDGE BASE
 
 **Generated:** 2026-07-09
-**Commit:** 8408ba6
-**Branch:** sprint/2026-07-09-01
-**Version:** 0.14.4.0
+**Commit:** df2023f
+**Branch:** main
+**Version:** 0.14.6.0
 
 ## OVERVIEW
 **6-phase** development pipeline (v2.0 compact redesign, Issue #290): PREP → DESIGN → BUILD → VERIFY → SHIP → CLOSE. Phase 3/6 BUILD default build mode is **ralph-loop** (REQ-level iteration, 40-67% token savings vs parallel). HARD-GATE between DESIGN (2/6) and BUILD (3/6): design must pass Delphi review (≥90% consensus) before any coding.

package/plugins/claude-code/skills/sprint-flow/SKILL.md

@@ -201,6 +201,10 @@ Every phase MUST output its header as the first line of that phase's output. For
 5. Each phase completion MUST write Phase Summary to `.sprint-state/phase-outputs/phase-{N}-summary.md`
 6. Each phase completion MUST update `.sprint-state/sprint-state.json`
 
+### Required Rendering (MANDATORY per phase)
+
+7. Each phase completion MUST render the ASCII progress dashboard using `templates/sprint-progress-template.md` — the orchestrator reads `sprint-state.json` and outputs the dashboard after every phase's status block, so the user always sees current global progress without needing to ask
+
 ### Phase Output Status Schema (MANDATORY per phase)
 
 Each phase MUST close with structured status:

package/plugins/claude-code/skills/sprint-flow/__tests__/sprint-flow.test.cjs

@@ -9,13 +9,32 @@ const path = require('path');
 
 const SKILL_MD_PATH = path.join(__dirname, '..', 'SKILL.md');
 const REFERENCES_DIR = path.join(__dirname, '..', 'references');
+const PHASE_OVERVIEW_PATH = path.join(REFERENCES_DIR, 'phase-overview.md');
 const PHASE_2_BUILD_PATH = path.join(REFERENCES_DIR, 'phase-3-build.md');
 const ORCHESTRATION_RULES_PATH = path.join(REFERENCES_DIR, 'orchestration-rules.md');
 
 let skillContent = '';
+let phaseOverviewContent = '';
 
 function loadSkillMd() {
   skillContent = fs.readFileSync(SKILL_MD_PATH, 'utf-8');
+  if (fs.existsSync(PHASE_OVERVIEW_PATH)) {
+    phaseOverviewContent = fs.readFileSync(PHASE_OVERVIEW_PATH, 'utf-8');
+  }
+}
+
+// Search across SKILL.md AND references/phase-overview.md (progressive disclosure: sections
+// like "Unique Value Proposition" and "Phase Flow Consistency" moved to reference file).
+function contentIncludes(str) {
+  return skillContent.includes(str) || phaseOverviewContent.includes(str);
+}
+function contentSplit(str) {
+  // Return the part after str from whichever file contains it.
+  // Throws descriptive error instead of returning undefined so callers
+  // get a clear assertion message rather than a TypeError crash.
+  if (skillContent.includes(str)) return skillContent.split(str)[1];
+  if (phaseOverviewContent.includes(str)) return phaseOverviewContent.split(str)[1];
+  throw new Error(`Section "${str}" not found in SKILL.md or references/phase-overview.md`);
 }
 
 function parseFrontmatter(content) {
@@ -182,21 +201,21 @@ function testPhaseFlowDiagramOrder() {
 }
 
 function testPhaseFlowConsistencySectionExists() {
-  if (!skillContent.includes('Phase Flow Consistency')) {
-    throw new Error('SKILL.md must contain "Phase Flow Consistency" section');
+  if (!contentIncludes('Phase Flow Consistency')) {
+    throw new Error('SKILL.md or references/phase-overview.md must contain "Phase Flow Consistency" section');
   }
   console.log('  ✓ Phase Flow Consistency section exists');
 }
 
 function testCanonicalPhaseOrderTableExists() {
-  if (!skillContent.includes('Canonical Phase Order')) {
-    throw new Error('SKILL.md must contain "Canonical Phase Order" table');
+  if (!contentIncludes('Canonical Phase Order')) {
+    throw new Error('SKILL.md or references/phase-overview.md must contain "Canonical Phase Order" table');
   }
   console.log('  ✓ Canonical Phase Order table exists');
 }
 
 function testAll11PhasesInPhaseFlowConsistency() {
-  const section = skillContent.split('Phase Flow Consistency')[1];
+  const section = contentSplit('Phase Flow Consistency');
   const requiredPhases = [
     'PREP', 'DESIGN', 'BUILD', 'VERIFY', 'SHIP', 'CLOSE',
   ];
@@ -235,14 +254,14 @@ function testForceLevelsRequiresDelphi() {
 // === Value Proposition Tests ===
 
 function testUniqueValuePropositionExists() {
-  if (!skillContent.includes('Unique Value Proposition')) {
-    throw new Error('SKILL.md must contain "Unique Value Proposition" section');
+  if (!contentIncludes('Unique Value Proposition')) {
+    throw new Error('SKILL.md or references/phase-overview.md must contain "Unique Value Proposition" section');
   }
   console.log('  ✓ Unique Value Proposition section exists');
 }
 
 function testUvpMentionsTokenSavings() {
-  const section = skillContent.split('Unique Value Proposition')[1];
+  const section = contentSplit('Unique Value Proposition');
   if (!section.includes('40') || !section.includes('67') || !section.includes('token')) {
     throw new Error('Unique Value Proposition must mention 40-67% token savings');
   }
@@ -250,7 +269,7 @@ function testUvpMentionsTokenSavings() {
 }
 
 function testUvpMentionsHardGate() {
-  const section = skillContent.split('Unique Value Proposition')[1];
+  const section = contentSplit('Unique Value Proposition');
   if (!section.includes('HARD-GATE')) {
     throw new Error('Unique Value Proposition must mention HARD-GATE discipline');
   }
@@ -258,7 +277,7 @@ function testUvpMentionsHardGate() {
 }
 
 function testUvpMentionsEmergentRequirements() {
-  const section = skillContent.split('Unique Value Proposition')[1];
+  const section = contentSplit('Unique Value Proposition');
   if (!section.toLowerCase().includes('emergent')) {
     throw new Error('Unique Value Proposition must mention emergent requirements');
   }
@@ -360,7 +379,7 @@ function runTests(opts = {}) {
   }
 
   console.log(`\n=== Results: ${passed} passed, ${failed} failed ===\n`);
-  errors.forEach(e => console.log(e));
+  for (const e of errors) console.log(e);
 
   if (exitOnFail && failed > 0) {
     process.exit(1);

package/plugins/claude-code/skills/test-specification-alignment/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/TEST-SPECIFICATION-ALIGNMENT KNOWLEDGE BASE
 
 **Generated:** 2026-07-09
-**Commit:** 8408ba6
-**Branch:** sprint/2026-07-09-01
-**Version:** 0.14.4.0
+**Commit:** df2023f
+**Branch:** main
+**Version:** 0.14.6.0
 
 ## OVERVIEW
 Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.

package/plugins/opencode/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boyingliu01/opencode-plugin",
-  "version": "0.14.4",
+  "version": "0.14.6",
   "type": "module",
   "main": "index.ts",
   "description": "XP-Gate quality gates + AI workflow skills + Sprint Flow TUI sidebar for OpenCode",

package/plugins/opencode/skills/delphi-review/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/DELPHI-REVIEW KNOWLEDGE BASE
 
 **Generated:** 2026-07-09
-**Commit:** 8408ba6
-**Branch:** sprint/2026-07-09-01
-**Version:** 0.14.4.0
+**Commit:** df2023f
+**Branch:** main
+**Version:** 0.14.6.0
 
 ## OVERVIEW
 Delphi Consensus Review — multi-round anonymous expert review (≥90% threshold, 3 experts from ≥2 providers, domestic models only). Supports design + code-walkthrough modes.

package/plugins/opencode/skills/sprint-flow/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/SPRINT-FLOW KNOWLEDGE BASE
 
 **Generated:** 2026-07-09
-**Commit:** 8408ba6
-**Branch:** sprint/2026-07-09-01
-**Version:** 0.14.4.0
+**Commit:** df2023f
+**Branch:** main
+**Version:** 0.14.6.0
 
 ## OVERVIEW
 **6-phase** development pipeline (v2.0 compact redesign, Issue #290): PREP → DESIGN → BUILD → VERIFY → SHIP → CLOSE. Phase 3/6 BUILD default build mode is **ralph-loop** (REQ-level iteration, 40-67% token savings vs parallel). HARD-GATE between DESIGN (2/6) and BUILD (3/6): design must pass Delphi review (≥90% consensus) before any coding.

package/plugins/opencode/skills/sprint-flow/SKILL.md

@@ -201,6 +201,10 @@ Every phase MUST output its header as the first line of that phase's output. For
 5. Each phase completion MUST write Phase Summary to `.sprint-state/phase-outputs/phase-{N}-summary.md`
 6. Each phase completion MUST update `.sprint-state/sprint-state.json`
 
+### Required Rendering (MANDATORY per phase)
+
+7. Each phase completion MUST render the ASCII progress dashboard using `templates/sprint-progress-template.md` — the orchestrator reads `sprint-state.json` and outputs the dashboard after every phase's status block, so the user always sees current global progress without needing to ask
+
 ### Phase Output Status Schema (MANDATORY per phase)
 
 Each phase MUST close with structured status:

package/plugins/opencode/skills/sprint-flow/__tests__/sprint-flow.test.cjs

@@ -9,13 +9,32 @@ const path = require('path');
 
 const SKILL_MD_PATH = path.join(__dirname, '..', 'SKILL.md');
 const REFERENCES_DIR = path.join(__dirname, '..', 'references');
+const PHASE_OVERVIEW_PATH = path.join(REFERENCES_DIR, 'phase-overview.md');
 const PHASE_2_BUILD_PATH = path.join(REFERENCES_DIR, 'phase-3-build.md');
 const ORCHESTRATION_RULES_PATH = path.join(REFERENCES_DIR, 'orchestration-rules.md');
 
 let skillContent = '';
+let phaseOverviewContent = '';
 
 function loadSkillMd() {
   skillContent = fs.readFileSync(SKILL_MD_PATH, 'utf-8');
+  if (fs.existsSync(PHASE_OVERVIEW_PATH)) {
+    phaseOverviewContent = fs.readFileSync(PHASE_OVERVIEW_PATH, 'utf-8');
+  }
+}
+
+// Search across SKILL.md AND references/phase-overview.md (progressive disclosure: sections
+// like "Unique Value Proposition" and "Phase Flow Consistency" moved to reference file).
+function contentIncludes(str) {
+  return skillContent.includes(str) || phaseOverviewContent.includes(str);
+}
+function contentSplit(str) {
+  // Return the part after str from whichever file contains it.
+  // Throws descriptive error instead of returning undefined so callers
+  // get a clear assertion message rather than a TypeError crash.
+  if (skillContent.includes(str)) return skillContent.split(str)[1];
+  if (phaseOverviewContent.includes(str)) return phaseOverviewContent.split(str)[1];
+  throw new Error(`Section "${str}" not found in SKILL.md or references/phase-overview.md`);
 }
 
 function parseFrontmatter(content) {
@@ -182,21 +201,21 @@ function testPhaseFlowDiagramOrder() {
 }
 
 function testPhaseFlowConsistencySectionExists() {
-  if (!skillContent.includes('Phase Flow Consistency')) {
-    throw new Error('SKILL.md must contain "Phase Flow Consistency" section');
+  if (!contentIncludes('Phase Flow Consistency')) {
+    throw new Error('SKILL.md or references/phase-overview.md must contain "Phase Flow Consistency" section');
   }
   console.log('  ✓ Phase Flow Consistency section exists');
 }
 
 function testCanonicalPhaseOrderTableExists() {
-  if (!skillContent.includes('Canonical Phase Order')) {
-    throw new Error('SKILL.md must contain "Canonical Phase Order" table');
+  if (!contentIncludes('Canonical Phase Order')) {
+    throw new Error('SKILL.md or references/phase-overview.md must contain "Canonical Phase Order" table');
   }
   console.log('  ✓ Canonical Phase Order table exists');
 }
 
 function testAll11PhasesInPhaseFlowConsistency() {
-  const section = skillContent.split('Phase Flow Consistency')[1];
+  const section = contentSplit('Phase Flow Consistency');
   const requiredPhases = [
     'PREP', 'DESIGN', 'BUILD', 'VERIFY', 'SHIP', 'CLOSE',
   ];
@@ -235,14 +254,14 @@ function testForceLevelsRequiresDelphi() {
 // === Value Proposition Tests ===
 
 function testUniqueValuePropositionExists() {
-  if (!skillContent.includes('Unique Value Proposition')) {
-    throw new Error('SKILL.md must contain "Unique Value Proposition" section');
+  if (!contentIncludes('Unique Value Proposition')) {
+    throw new Error('SKILL.md or references/phase-overview.md must contain "Unique Value Proposition" section');
   }
   console.log('  ✓ Unique Value Proposition section exists');
 }
 
 function testUvpMentionsTokenSavings() {
-  const section = skillContent.split('Unique Value Proposition')[1];
+  const section = contentSplit('Unique Value Proposition');
   if (!section.includes('40') || !section.includes('67') || !section.includes('token')) {
     throw new Error('Unique Value Proposition must mention 40-67% token savings');
   }
@@ -250,7 +269,7 @@ function testUvpMentionsTokenSavings() {
 }
 
 function testUvpMentionsHardGate() {
-  const section = skillContent.split('Unique Value Proposition')[1];
+  const section = contentSplit('Unique Value Proposition');
   if (!section.includes('HARD-GATE')) {
     throw new Error('Unique Value Proposition must mention HARD-GATE discipline');
   }
@@ -258,7 +277,7 @@ function testUvpMentionsHardGate() {
 }
 
 function testUvpMentionsEmergentRequirements() {
-  const section = skillContent.split('Unique Value Proposition')[1];
+  const section = contentSplit('Unique Value Proposition');
   if (!section.toLowerCase().includes('emergent')) {
     throw new Error('Unique Value Proposition must mention emergent requirements');
   }
@@ -360,7 +379,7 @@ function runTests(opts = {}) {
   }
 
   console.log(`\n=== Results: ${passed} passed, ${failed} failed ===\n`);
-  errors.forEach(e => console.log(e));
+  for (const e of errors) console.log(e);
 
   if (exitOnFail && failed > 0) {
     process.exit(1);

package/plugins/opencode/skills/test-specification-alignment/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/TEST-SPECIFICATION-ALIGNMENT KNOWLEDGE BASE
 
 **Generated:** 2026-07-09
-**Commit:** 8408ba6
-**Branch:** sprint/2026-07-09-01
-**Version:** 0.14.4.0
+**Commit:** df2023f
+**Branch:** main
+**Version:** 0.14.6.0
 
 ## OVERVIEW
 Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.

package/plugins/qoder/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "xp-gate",
-  "version": "0.14.4",
+  "version": "0.14.6",
   "displayName": "XP-Gate",
   "description": "Extreme Programming quality gates + AI workflow skills for Qoder. Includes 10 quality gates (Gate 0-9), Sprint Flow (11 phases), and Delphi multi-expert review (>=90% consensus).",
   "author": {

package/plugins/qoder/skills/delphi-review/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/DELPHI-REVIEW KNOWLEDGE BASE
 
 **Generated:** 2026-07-09
-**Commit:** 8408ba6
-**Branch:** sprint/2026-07-09-01
-**Version:** 0.14.4.0
+**Commit:** df2023f
+**Branch:** main
+**Version:** 0.14.6.0
 
 ## OVERVIEW
 Delphi Consensus Review — multi-round anonymous expert review (≥90% threshold, 3 experts from ≥2 providers, domestic models only). Supports design + code-walkthrough modes.

package/plugins/qoder/skills/sprint-flow/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/SPRINT-FLOW KNOWLEDGE BASE
 
 **Generated:** 2026-07-09
-**Commit:** 8408ba6
-**Branch:** sprint/2026-07-09-01
-**Version:** 0.14.4.0
+**Commit:** df2023f
+**Branch:** main
+**Version:** 0.14.6.0
 
 ## OVERVIEW
 **6-phase** development pipeline (v2.0 compact redesign, Issue #290): PREP → DESIGN → BUILD → VERIFY → SHIP → CLOSE. Phase 3/6 BUILD default build mode is **ralph-loop** (REQ-level iteration, 40-67% token savings vs parallel). HARD-GATE between DESIGN (2/6) and BUILD (3/6): design must pass Delphi review (≥90% consensus) before any coding.

package/plugins/qoder/skills/test-specification-alignment/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/TEST-SPECIFICATION-ALIGNMENT KNOWLEDGE BASE
 
 **Generated:** 2026-07-09
-**Commit:** 8408ba6
-**Branch:** sprint/2026-07-09-01
-**Version:** 0.14.4.0
+**Commit:** df2023f
+**Branch:** main
+**Version:** 0.14.6.0
 
 ## OVERVIEW
 Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.

package/principles/AGENTS.md

@@ -1,9 +1,9 @@
 # PRINCIPLES CHECKER MODULE
 
 **Generated:** 2026-07-09
-**Commit:** a09c009
+**Commit:** df2023f
 **Branch:** main
-**Version:** 0.14.3.0
+**Version:** 0.14.6.0
 
 ## OVERVIEW
 Clean Code & SOLID principles checker — **Gate 4** of pre-commit. 14 rules × 9 language adapters, SARIF 2.1.0 output. Houses the **Boy Scout Rule** enforcement engine (Gate 6) and warning-baseline storage.

package/skills/delphi-review/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/DELPHI-REVIEW KNOWLEDGE BASE
 
 **Generated:** 2026-07-09
-**Commit:** 8408ba6
-**Branch:** sprint/2026-07-09-01
-**Version:** 0.14.4.0
+**Commit:** df2023f
+**Branch:** main
+**Version:** 0.14.6.0
 
 ## OVERVIEW
 Delphi Consensus Review — multi-round anonymous expert review (≥90% threshold, 3 experts from ≥2 providers, domestic models only). Supports design + code-walkthrough modes.

package/skills/sprint-flow/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/SPRINT-FLOW KNOWLEDGE BASE
 
 **Generated:** 2026-07-09
-**Commit:** 8408ba6
-**Branch:** sprint/2026-07-09-01
-**Version:** 0.14.4.0
+**Commit:** df2023f
+**Branch:** main
+**Version:** 0.14.6.0
 
 ## OVERVIEW
 **6-phase** development pipeline (v2.0 compact redesign, Issue #290): PREP → DESIGN → BUILD → VERIFY → SHIP → CLOSE. Phase 3/6 BUILD default build mode is **ralph-loop** (REQ-level iteration, 40-67% token savings vs parallel). HARD-GATE between DESIGN (2/6) and BUILD (3/6): design must pass Delphi review (≥90% consensus) before any coding.

package/skills/sprint-flow/SKILL.md

@@ -201,6 +201,10 @@ Every phase MUST output its header as the first line of that phase's output. For
 5. Each phase completion MUST write Phase Summary to `.sprint-state/phase-outputs/phase-{N}-summary.md`
 6. Each phase completion MUST update `.sprint-state/sprint-state.json`
 
+### Required Rendering (MANDATORY per phase)
+
+7. Each phase completion MUST render the ASCII progress dashboard using `templates/sprint-progress-template.md` — the orchestrator reads `sprint-state.json` and outputs the dashboard after every phase's status block, so the user always sees current global progress without needing to ask
+
 ### Phase Output Status Schema (MANDATORY per phase)
 
 Each phase MUST close with structured status:

package/skills/sprint-flow/__tests__/sprint-flow.test.cjs

@@ -9,13 +9,32 @@ const path = require('path');
 
 const SKILL_MD_PATH = path.join(__dirname, '..', 'SKILL.md');
 const REFERENCES_DIR = path.join(__dirname, '..', 'references');
+const PHASE_OVERVIEW_PATH = path.join(REFERENCES_DIR, 'phase-overview.md');
 const PHASE_2_BUILD_PATH = path.join(REFERENCES_DIR, 'phase-3-build.md');
 const ORCHESTRATION_RULES_PATH = path.join(REFERENCES_DIR, 'orchestration-rules.md');
 
 let skillContent = '';
+let phaseOverviewContent = '';
 
 function loadSkillMd() {
   skillContent = fs.readFileSync(SKILL_MD_PATH, 'utf-8');
+  if (fs.existsSync(PHASE_OVERVIEW_PATH)) {
+    phaseOverviewContent = fs.readFileSync(PHASE_OVERVIEW_PATH, 'utf-8');
+  }
+}
+
+// Search across SKILL.md AND references/phase-overview.md (progressive disclosure: sections
+// like "Unique Value Proposition" and "Phase Flow Consistency" moved to reference file).
+function contentIncludes(str) {
+  return skillContent.includes(str) || phaseOverviewContent.includes(str);
+}
+function contentSplit(str) {
+  // Return the part after str from whichever file contains it.
+  // Throws descriptive error instead of returning undefined so callers
+  // get a clear assertion message rather than a TypeError crash.
+  if (skillContent.includes(str)) return skillContent.split(str)[1];
+  if (phaseOverviewContent.includes(str)) return phaseOverviewContent.split(str)[1];
+  throw new Error(`Section "${str}" not found in SKILL.md or references/phase-overview.md`);
 }
 
 function parseFrontmatter(content) {
@@ -182,21 +201,21 @@ function testPhaseFlowDiagramOrder() {
 }
 
 function testPhaseFlowConsistencySectionExists() {
-  if (!skillContent.includes('Phase Flow Consistency')) {
-    throw new Error('SKILL.md must contain "Phase Flow Consistency" section');
+  if (!contentIncludes('Phase Flow Consistency')) {
+    throw new Error('SKILL.md or references/phase-overview.md must contain "Phase Flow Consistency" section');
   }
   console.log('  ✓ Phase Flow Consistency section exists');
 }
 
 function testCanonicalPhaseOrderTableExists() {
-  if (!skillContent.includes('Canonical Phase Order')) {
-    throw new Error('SKILL.md must contain "Canonical Phase Order" table');
+  if (!contentIncludes('Canonical Phase Order')) {
+    throw new Error('SKILL.md or references/phase-overview.md must contain "Canonical Phase Order" table');
   }
   console.log('  ✓ Canonical Phase Order table exists');
 }
 
 function testAll11PhasesInPhaseFlowConsistency() {
-  const section = skillContent.split('Phase Flow Consistency')[1];
+  const section = contentSplit('Phase Flow Consistency');
   const requiredPhases = [
     'PREP', 'DESIGN', 'BUILD', 'VERIFY', 'SHIP', 'CLOSE',
   ];
@@ -235,14 +254,14 @@ function testForceLevelsRequiresDelphi() {
 // === Value Proposition Tests ===
 
 function testUniqueValuePropositionExists() {
-  if (!skillContent.includes('Unique Value Proposition')) {
-    throw new Error('SKILL.md must contain "Unique Value Proposition" section');
+  if (!contentIncludes('Unique Value Proposition')) {
+    throw new Error('SKILL.md or references/phase-overview.md must contain "Unique Value Proposition" section');
   }
   console.log('  ✓ Unique Value Proposition section exists');
 }
 
 function testUvpMentionsTokenSavings() {
-  const section = skillContent.split('Unique Value Proposition')[1];
+  const section = contentSplit('Unique Value Proposition');
   if (!section.includes('40') || !section.includes('67') || !section.includes('token')) {
     throw new Error('Unique Value Proposition must mention 40-67% token savings');
   }
@@ -250,7 +269,7 @@ function testUvpMentionsTokenSavings() {
 }
 
 function testUvpMentionsHardGate() {
-  const section = skillContent.split('Unique Value Proposition')[1];
+  const section = contentSplit('Unique Value Proposition');
   if (!section.includes('HARD-GATE')) {
     throw new Error('Unique Value Proposition must mention HARD-GATE discipline');
   }
@@ -258,7 +277,7 @@ function testUvpMentionsHardGate() {
 }
 
 function testUvpMentionsEmergentRequirements() {
-  const section = skillContent.split('Unique Value Proposition')[1];
+  const section = contentSplit('Unique Value Proposition');
   if (!section.toLowerCase().includes('emergent')) {
     throw new Error('Unique Value Proposition must mention emergent requirements');
   }
@@ -360,7 +379,7 @@ function runTests(opts = {}) {
   }
 
   console.log(`\n=== Results: ${passed} passed, ${failed} failed ===\n`);
-  errors.forEach(e => console.log(e));
+  for (const e of errors) console.log(e);
 
   if (exitOnFail && failed > 0) {
     process.exit(1);

package/skills/test-specification-alignment/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/TEST-SPECIFICATION-ALIGNMENT KNOWLEDGE BASE
 
 **Generated:** 2026-07-09
-**Commit:** 8408ba6
-**Branch:** sprint/2026-07-09-01
-**Version:** 0.14.4.0
+**Commit:** df2023f
+**Branch:** main
+**Version:** 0.14.6.0
 
 ## OVERVIEW
 Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.