Commit 22a8dad
committed
docs(commands): fix stale path refs, phantom phase, duplicate numbering
Four small doc corrections in templates/commands/*.md, surfaced while
integrating Spec Kit into a Claude Code project:
- plan.md: "Command ends after Phase 2 planning" referenced a phase
that doesn't exist in this file. Only Phase 0 (research) and Phase 1
(data-model, contracts, quickstart) are defined; the command actually
ends after Phase 1. Updated the terminal step to match.
- implement.md: step 5 "Task phases" parse-list was "Setup, Tests, Core,
Integration, Polish" — an older layered taxonomy that doesn't match
what tasks.md currently emits ("Setup, Foundational, User Stories in
priority order, Polish"). The mismatch meant /speckit.implement
wouldn't find any of the phase headers it was looking for. Aligned
the parse list with tasks.md's actual output.
- constitution.md: step 4 instructed the user to "Read each command
file in .specify/templates/commands/*.md" — that path isn't
materialized on every integration install (e.g., Claude Code puts
command files under .claude/skills/speckit-*/SKILL.md; Copilot uses
.github/prompts/). Softened the reference to name the likely
integration-specific locations and note the path varies.
- taskstoissues.md: four consecutive `1.` source-level numbered items
in the Outline block. Markdown auto-renumbers on render, but the
source reads oddly and encourages the same pattern in new specs.
Renumbered to 1/2/3/4.
All four reproduce on main as of this branch-off; none touch behavior
beyond what each docstring already describes.
## AI disclosure
This PR was drafted with assistance from Claude (Opus 4.7) while
integrating Spec Kit into a live project. The rationale for each fix
came from actually running the affected commands end-to-end through
an agent; the one-line edits are mechanical corrections to existing
text, not new guidance.1 parent c118c1c commit 22a8dad
4 files changed
Lines changed: 6 additions & 6 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
80 | 80 | | |
81 | 81 | | |
82 | 82 | | |
83 | | - | |
| 83 | + | |
84 | 84 | | |
85 | 85 | | |
86 | 86 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
135 | 135 | | |
136 | 136 | | |
137 | 137 | | |
138 | | - | |
| 138 | + | |
139 | 139 | | |
140 | 140 | | |
141 | 141 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
70 | 70 | | |
71 | 71 | | |
72 | 72 | | |
73 | | - | |
| 73 | + | |
74 | 74 | | |
75 | 75 | | |
76 | 76 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
51 | 51 | | |
52 | 52 | | |
53 | 53 | | |
54 | | - | |
55 | | - | |
| 54 | + | |
| 55 | + | |
56 | 56 | | |
57 | 57 | | |
58 | 58 | | |
| |||
61 | 61 | | |
62 | 62 | | |
63 | 63 | | |
64 | | - | |
| 64 | + | |
65 | 65 | | |
66 | 66 | | |
67 | 67 | | |
| |||
0 commit comments