fix(docs): use {phase_num} instead of ambiguous {phase} for filenames (#601)

The verifier agent interpreted {phase} as the full directory slug
(e.g., 01-foundation-target-system) instead of just the padded phase
number (01), producing wrong filenames like
01-foundation-target-system-VERIFICATION.md.

Changed all {phase}-*.md references to {phase_num}-*.md to match the
convention used in gsd-tools.js (${padded}-VERIFICATION.md).

Files: VERIFICATION.md, RESEARCH.md, CONTEXT.md, UAT.md patterns.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Lex Christopherson
2026-02-15 07:45:33 -06:00
parent 5154446056
commit d86385887a
15 changed files with 28 additions and 28 deletions

View File

@@ -177,7 +177,7 @@ Priority: Context7 > Official Docs > Official GitHub > Verified WebSearch > Unve
## RESEARCH.md Structure
**Location:** `.planning/phases/XX-name/{phase}-RESEARCH.md`
**Location:** `.planning/phases/XX-name/{phase_num}-RESEARCH.md`
```markdown
# Phase [X]: [Name] - Research

View File

@@ -317,7 +317,7 @@ gaps:
## Create VERIFICATION.md
Create `.planning/phases/{phase_dir}/{phase}-VERIFICATION.md`:
Create `.planning/phases/{phase_dir}/{phase_num}-VERIFICATION.md`:
```markdown
---
@@ -411,7 +411,7 @@ Return with:
**Status:** {passed | gaps_found | human_needed}
**Score:** {N}/{M} must-haves verified
**Report:** .planning/phases/{phase_dir}/{phase}-VERIFICATION.md
**Report:** .planning/phases/{phase_dir}/{phase_num}-VERIFICATION.md
{If passed:}
All must-haves verified. Phase goal achieved. Ready to proceed.