gspec 1.5.0 → 1.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/dist/antigravity/gspec-architect/SKILL.md +2 -2
  2. package/dist/antigravity/gspec-dor/SKILL.md +2 -2
  3. package/dist/antigravity/gspec-epic/SKILL.md +1 -1
  4. package/dist/antigravity/gspec-feature/SKILL.md +1 -1
  5. package/dist/antigravity/gspec-implement/SKILL.md +1 -1
  6. package/dist/antigravity/gspec-migrate/SKILL.md +5 -5
  7. package/dist/antigravity/gspec-practices/SKILL.md +1 -1
  8. package/dist/antigravity/gspec-profile/SKILL.md +1 -1
  9. package/dist/antigravity/gspec-record/SKILL.md +2 -2
  10. package/dist/antigravity/gspec-research/SKILL.md +3 -3
  11. package/dist/antigravity/gspec-stack/SKILL.md +1 -1
  12. package/dist/antigravity/gspec-style/SKILL.md +1 -1
  13. package/dist/claude/gspec-architect/SKILL.md +2 -2
  14. package/dist/claude/gspec-dor/SKILL.md +2 -2
  15. package/dist/claude/gspec-epic/SKILL.md +1 -1
  16. package/dist/claude/gspec-feature/SKILL.md +1 -1
  17. package/dist/claude/gspec-implement/SKILL.md +1 -1
  18. package/dist/claude/gspec-migrate/SKILL.md +5 -5
  19. package/dist/claude/gspec-practices/SKILL.md +1 -1
  20. package/dist/claude/gspec-profile/SKILL.md +1 -1
  21. package/dist/claude/gspec-record/SKILL.md +2 -2
  22. package/dist/claude/gspec-research/SKILL.md +3 -3
  23. package/dist/claude/gspec-stack/SKILL.md +1 -1
  24. package/dist/claude/gspec-style/SKILL.md +1 -1
  25. package/dist/codex/gspec-architect/SKILL.md +2 -2
  26. package/dist/codex/gspec-dor/SKILL.md +2 -2
  27. package/dist/codex/gspec-epic/SKILL.md +1 -1
  28. package/dist/codex/gspec-feature/SKILL.md +1 -1
  29. package/dist/codex/gspec-implement/SKILL.md +1 -1
  30. package/dist/codex/gspec-migrate/SKILL.md +5 -5
  31. package/dist/codex/gspec-practices/SKILL.md +1 -1
  32. package/dist/codex/gspec-profile/SKILL.md +1 -1
  33. package/dist/codex/gspec-record/SKILL.md +2 -2
  34. package/dist/codex/gspec-research/SKILL.md +3 -3
  35. package/dist/codex/gspec-stack/SKILL.md +1 -1
  36. package/dist/codex/gspec-style/SKILL.md +1 -1
  37. package/dist/cursor/gspec-architect.mdc +2 -2
  38. package/dist/cursor/gspec-dor.mdc +2 -2
  39. package/dist/cursor/gspec-epic.mdc +1 -1
  40. package/dist/cursor/gspec-feature.mdc +1 -1
  41. package/dist/cursor/gspec-implement.mdc +1 -1
  42. package/dist/cursor/gspec-migrate.mdc +5 -5
  43. package/dist/cursor/gspec-practices.mdc +1 -1
  44. package/dist/cursor/gspec-profile.mdc +1 -1
  45. package/dist/cursor/gspec-record.mdc +2 -2
  46. package/dist/cursor/gspec-research.mdc +3 -3
  47. package/dist/cursor/gspec-stack.mdc +1 -1
  48. package/dist/cursor/gspec-style.mdc +1 -1
  49. package/package.json +1 -1
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: gspec-architect
3
- description: Define the technical architecture: project structure, data model, API design, and environment setup
3
+ description: Define the technical architecture project structure, data model, API design, and environment setup
4
4
  ---
5
5
 
6
6
  You are a Senior Software Architect at a high-performing software company.
@@ -46,7 +46,7 @@ All of these provide essential context. If any are missing, note the gap and mak
46
46
  - Begin the file with YAML frontmatter containing the gspec version:
47
47
  ```
48
48
  ---
49
- gspec-version: 1.5.0
49
+ gspec-version: 1.5.1
50
50
  ---
51
51
  ```
52
52
  The frontmatter must be the very first content in the file, before the main heading.
@@ -144,7 +144,7 @@ After approval, write the spec updates:
144
144
  - Dependencies (on other features or external services)
145
145
  - Assumptions & Risks (assumptions, open questions, key risks and mitigations — note in assumptions that this feature was identified during iterative development)
146
146
  - Success Metrics
147
- - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.0\n---`
147
+ - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.1\n---`
148
148
  - **Also update `gspec/architecture.md`** if the new feature introduces data entities, API endpoints, or new components — add them to the appropriate architecture sections
149
149
 
150
150
  ### Phase 7: Verify — Confirm Consistency
@@ -177,7 +177,7 @@ After writing spec updates:
177
177
 
178
178
  **Implementation checkboxes.** Feature PRDs use markdown checkboxes (`- [ ]` / `- [x]`) on capabilities to track implementation status for `gspec-implement`. When DOR adds new capabilities, use unchecked checkboxes (`- [ ]`). When modifying a capability that was already checked (`- [x]`) and the code change reflects the modification, keep it checked. When creating a new feature PRD, use unchecked checkboxes for all capabilities. Do not check off capabilities that DOR did not implement in the current session.
179
179
 
180
- **Version frontmatter.** When updating existing gspec files, preserve the `gspec-version` YAML frontmatter at the top of the file. If a file lacks frontmatter, add `---\ngspec-version: 1.5.0\n---` as the very first content before the main heading.
180
+ **Version frontmatter.** When updating existing gspec files, preserve the `gspec-version` YAML frontmatter at the top of the file. If a file lacks frontmatter, add `---\ngspec-version: 1.5.1\n---` as the very first content before the main heading.
181
181
 
182
182
  ---
183
183
 
@@ -78,7 +78,7 @@ Epic summaries and the feature PRDs they produce are designed to be **portable a
78
78
  - Begin every output file (both epic summary and individual feature PRDs) with YAML frontmatter containing the gspec version:
79
79
  ```
80
80
  ---
81
- gspec-version: 1.5.0
81
+ gspec-version: 1.5.1
82
82
  ---
83
83
  ```
84
84
  The frontmatter must be the very first content in the file, before the main heading.
@@ -68,7 +68,7 @@ Feature PRDs are designed to be **portable across projects**. A feature spec wri
68
68
  - Begin the file with YAML frontmatter containing the gspec version:
69
69
  ```
70
70
  ---
71
- gspec-version: 1.5.0
71
+ gspec-version: 1.5.1
72
72
  ---
73
73
  ```
74
74
  The frontmatter must be the very first content in the file, before the main heading.
@@ -112,7 +112,7 @@ Present a brief scaffold summary to the user before proceeding to feature implem
112
112
  b. **Follow the practices** — Adhere to coding standards, testing requirements, and conventions from `gspec/practices.md`
113
113
  c. **Follow the style** — Apply the design system, tokens, and component patterns from `gspec/style.md`
114
114
  d. **Satisfy the requirements** — Trace each piece of code back to a functional requirement in the feature PRD (if available) or to the user's stated goals and the approved implementation plan
115
- 3. **Mark capabilities as implemented** — After successfully implementing each capability, immediately update the feature PRD by changing its checkbox from `- [ ]` to `- [x]`. Do this incrementally as each capability is completed, not in a batch at the end. If a capability line did not have a checkbox prefix, add one as `- [x]`. This ensures that if the session is interrupted, progress is not lost. When updating gspec files, preserve existing `gspec-version` YAML frontmatter. If a file lacks frontmatter, add `---\ngspec-version: 1.5.0\n---` at the top.
115
+ 3. **Mark capabilities as implemented** — After successfully implementing each capability, immediately update the feature PRD by changing its checkbox from `- [ ]` to `- [x]`. Do this incrementally as each capability is completed, not in a batch at the end. If a capability line did not have a checkbox prefix, add one as `- [x]`. This ensures that if the session is interrupted, progress is not lost. When updating gspec files, preserve existing `gspec-version` YAML frontmatter. If a file lacks frontmatter, add `---\ngspec-version: 1.5.1\n---` at the top.
116
116
  4. **Update epic status** — When all capabilities in a feature PRD are checked, update the corresponding feature's checkbox in the epic summary file (if one exists) from `- [ ]` to `- [x]`.
117
117
  5. **Run tests** — Execute the tests defined for this phase (and any existing tests to catch regressions). Fix any failures before proceeding.
118
118
  6. **Surface new gaps** — If implementation reveals new ambiguities, pause and consult the user rather than making silent assumptions
@@ -5,7 +5,7 @@ description: Migrate existing gspec files to the current format when upgrading t
5
5
 
6
6
  You are a Technical Documentation Migration Specialist.
7
7
 
8
- Your task is to update existing gspec specification documents to match the current gspec format (version 1.5.0). You preserve all substantive content while ensuring documents follow the latest structural conventions.
8
+ Your task is to update existing gspec specification documents to match the current gspec format (version 1.5.1). You preserve all substantive content while ensuring documents follow the latest structural conventions.
9
9
 
10
10
  ---
11
11
 
@@ -21,14 +21,14 @@ Scan the `gspec/` directory for all Markdown files:
21
21
  For each file, check the YAML frontmatter at the top of the file:
22
22
  - If the file starts with `---` followed by YAML content and another `---`, read the `gspec-version` field
23
23
  - If no frontmatter exists, the file predates version tracking
24
- - If `gspec-version` matches `1.5.0`, the file is current — skip it
24
+ - If `gspec-version` matches `1.5.1`, the file is current — skip it
25
25
 
26
26
  Present an inventory to the user:
27
27
 
28
28
  > **gspec File Inventory:**
29
29
  > - `gspec/profile.md` — no version (needs migration)
30
30
  > - `gspec/stack.md` — version 1.0.3 (needs migration)
31
- > - `gspec/style.md` — version 1.5.0 (current, skipping)
31
+ > - `gspec/style.md` — version 1.5.1 (current, skipping)
32
32
  > - `gspec/features/user-auth.md` — no version (needs migration)
33
33
 
34
34
  Ask the user to confirm which files to migrate, or confirm all.
@@ -64,7 +64,7 @@ For each file to migrate:
64
64
  5. **Add or update the frontmatter** — Ensure the file starts with:
65
65
  ```
66
66
  ---
67
- gspec-version: 1.5.0
67
+ gspec-version: 1.5.1
68
68
  ---
69
69
  ```
70
70
  6. **Present the proposed changes** to the user before writing. Show what sections are being reorganized, what is being added, and confirm no content is being lost.
@@ -78,7 +78,7 @@ After migrating all files:
78
78
  3. **Present a completion summary**:
79
79
 
80
80
  > **Migration Complete:**
81
- > - 4 files migrated to version 1.5.0
81
+ > - 4 files migrated to version 1.5.1
82
82
  > - 2 files were already current (skipped)
83
83
  > - Content preserved in all files
84
84
  > - Sections reorganized: [list any structural changes]
@@ -25,7 +25,7 @@ You should:
25
25
  - Begin the file with YAML frontmatter containing the gspec version:
26
26
  ```
27
27
  ---
28
- gspec-version: 1.5.0
28
+ gspec-version: 1.5.1
29
29
  ---
30
30
  ```
31
31
  The frontmatter must be the very first content in the file, before the main heading.
@@ -25,7 +25,7 @@ You should:
25
25
  - Begin the file with YAML frontmatter containing the gspec version:
26
26
  ```
27
27
  ---
28
- gspec-version: 1.5.0
28
+ gspec-version: 1.5.1
29
29
  ---
30
30
  ```
31
31
  The frontmatter must be the very first content in the file, before the main heading.
@@ -128,7 +128,7 @@ After approval, write the spec updates:
128
128
  - Dependencies (on other features or external services)
129
129
  - Assumptions & Risks (assumptions, open questions, key risks and mitigations — note in assumptions that this feature was recorded during iterative development)
130
130
  - Success Metrics
131
- - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.0\n---`
131
+ - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.1\n---`
132
132
  - **Also update `gspec/architecture.md`** if the new feature introduces data entities, API endpoints, or new components — add them to the appropriate architecture sections
133
133
 
134
134
  ### Phase 6: Verify — Confirm Consistency
@@ -157,7 +157,7 @@ After writing spec updates:
157
157
 
158
158
  **When to create vs. update.** If a change adds a small capability that fits naturally within an existing feature PRD, update that PRD. If a change introduces a wholly new product area that does not belong in any existing PRD, create a new feature PRD. When in doubt, ask the user.
159
159
 
160
- **Version frontmatter.** When updating existing gspec files, preserve the `gspec-version` YAML frontmatter at the top of the file. If a file lacks frontmatter, add `---\ngspec-version: 1.5.0\n---` as the very first content before the main heading.
160
+ **Version frontmatter.** When updating existing gspec files, preserve the `gspec-version` YAML frontmatter at the top of the file. If a file lacks frontmatter, add `---\ngspec-version: 1.5.1\n---` as the very first content before the main heading.
161
161
 
162
162
  **No code changes.** This command never creates, modifies, or deletes code files. If the user needs code changes alongside spec updates, suggest using `gspec-dor` instead.
163
163
 
@@ -162,7 +162,7 @@ After writing `gspec/research.md`, ask the user:
162
162
  - Assumptions & Risks (assumptions, open questions, key risks and mitigations)
163
163
  - Success Metrics
164
164
  - Implementation Context (standard portability note)
165
- - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.0\n---`
165
+ - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.1\n---`
166
166
  2. **Name the file** descriptively based on the feature (e.g., `gspec/features/csv-export.md`, `gspec/features/onboarding-wizard.md`)
167
167
  3. **Keep the PRD portable** — use generic role descriptions (not project-specific persona names), define success metrics in terms of the feature's own outcomes (not project-level KPIs), and describe UX behavior generically (not tied to a specific design system). The PRD should be reusable across projects.
168
168
  4. **Keep the PRD product-focused** — describe *what* and *why*, not *how*. Implementation details belong in the code, not the PRD.
@@ -181,7 +181,7 @@ After writing `gspec/research.md`, ask the user:
181
181
  - Begin `gspec/research.md` with YAML frontmatter containing the gspec version:
182
182
  ```
183
183
  ---
184
- gspec-version: 1.5.0
184
+ gspec-version: 1.5.1
185
185
  ---
186
186
  ```
187
187
  The frontmatter must be the very first content in the file, before the main heading.
@@ -198,7 +198,7 @@ The `gspec/research.md` file must follow this structure:
198
198
 
199
199
  ```markdown
200
200
  ---
201
- gspec-version: 1.5.0
201
+ gspec-version: 1.5.1
202
202
  ---
203
203
 
204
204
  # Competitive Research
@@ -25,7 +25,7 @@ You should:
25
25
  - Begin the file with YAML frontmatter containing the gspec version:
26
26
  ```
27
27
  ---
28
- gspec-version: 1.5.0
28
+ gspec-version: 1.5.1
29
29
  ---
30
30
  ```
31
31
  The frontmatter must be the very first content in the file, before the main heading.
@@ -27,7 +27,7 @@ You should:
27
27
  - Begin the file with YAML frontmatter containing the gspec version:
28
28
  ```
29
29
  ---
30
- gspec-version: 1.5.0
30
+ gspec-version: 1.5.1
31
31
  ---
32
32
  ```
33
33
  The frontmatter must be the very first content in the file, before the main heading.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: gspec-architect
3
- description: Define the technical architecture: project structure, data model, API design, and environment setup
3
+ description: Define the technical architecture project structure, data model, API design, and environment setup
4
4
  ---
5
5
 
6
6
  You are a Senior Software Architect at a high-performing software company.
@@ -46,7 +46,7 @@ All of these provide essential context. If any are missing, note the gap and mak
46
46
  - Begin the file with YAML frontmatter containing the gspec version:
47
47
  ```
48
48
  ---
49
- gspec-version: 1.5.0
49
+ gspec-version: 1.5.1
50
50
  ---
51
51
  ```
52
52
  The frontmatter must be the very first content in the file, before the main heading.
@@ -144,7 +144,7 @@ After approval, write the spec updates:
144
144
  - Dependencies (on other features or external services)
145
145
  - Assumptions & Risks (assumptions, open questions, key risks and mitigations — note in assumptions that this feature was identified during iterative development)
146
146
  - Success Metrics
147
- - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.0\n---`
147
+ - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.1\n---`
148
148
  - **Also update `gspec/architecture.md`** if the new feature introduces data entities, API endpoints, or new components — add them to the appropriate architecture sections
149
149
 
150
150
  ### Phase 7: Verify — Confirm Consistency
@@ -177,7 +177,7 @@ After writing spec updates:
177
177
 
178
178
  **Implementation checkboxes.** Feature PRDs use markdown checkboxes (`- [ ]` / `- [x]`) on capabilities to track implementation status for `gspec-implement`. When DOR adds new capabilities, use unchecked checkboxes (`- [ ]`). When modifying a capability that was already checked (`- [x]`) and the code change reflects the modification, keep it checked. When creating a new feature PRD, use unchecked checkboxes for all capabilities. Do not check off capabilities that DOR did not implement in the current session.
179
179
 
180
- **Version frontmatter.** When updating existing gspec files, preserve the `gspec-version` YAML frontmatter at the top of the file. If a file lacks frontmatter, add `---\ngspec-version: 1.5.0\n---` as the very first content before the main heading.
180
+ **Version frontmatter.** When updating existing gspec files, preserve the `gspec-version` YAML frontmatter at the top of the file. If a file lacks frontmatter, add `---\ngspec-version: 1.5.1\n---` as the very first content before the main heading.
181
181
 
182
182
  ---
183
183
 
@@ -78,7 +78,7 @@ Epic summaries and the feature PRDs they produce are designed to be **portable a
78
78
  - Begin every output file (both epic summary and individual feature PRDs) with YAML frontmatter containing the gspec version:
79
79
  ```
80
80
  ---
81
- gspec-version: 1.5.0
81
+ gspec-version: 1.5.1
82
82
  ---
83
83
  ```
84
84
  The frontmatter must be the very first content in the file, before the main heading.
@@ -68,7 +68,7 @@ Feature PRDs are designed to be **portable across projects**. A feature spec wri
68
68
  - Begin the file with YAML frontmatter containing the gspec version:
69
69
  ```
70
70
  ---
71
- gspec-version: 1.5.0
71
+ gspec-version: 1.5.1
72
72
  ---
73
73
  ```
74
74
  The frontmatter must be the very first content in the file, before the main heading.
@@ -112,7 +112,7 @@ Present a brief scaffold summary to the user before proceeding to feature implem
112
112
  b. **Follow the practices** — Adhere to coding standards, testing requirements, and conventions from `gspec/practices.md`
113
113
  c. **Follow the style** — Apply the design system, tokens, and component patterns from `gspec/style.md`
114
114
  d. **Satisfy the requirements** — Trace each piece of code back to a functional requirement in the feature PRD (if available) or to the user's stated goals and the approved implementation plan
115
- 3. **Mark capabilities as implemented** — After successfully implementing each capability, immediately update the feature PRD by changing its checkbox from `- [ ]` to `- [x]`. Do this incrementally as each capability is completed, not in a batch at the end. If a capability line did not have a checkbox prefix, add one as `- [x]`. This ensures that if the session is interrupted, progress is not lost. When updating gspec files, preserve existing `gspec-version` YAML frontmatter. If a file lacks frontmatter, add `---\ngspec-version: 1.5.0\n---` at the top.
115
+ 3. **Mark capabilities as implemented** — After successfully implementing each capability, immediately update the feature PRD by changing its checkbox from `- [ ]` to `- [x]`. Do this incrementally as each capability is completed, not in a batch at the end. If a capability line did not have a checkbox prefix, add one as `- [x]`. This ensures that if the session is interrupted, progress is not lost. When updating gspec files, preserve existing `gspec-version` YAML frontmatter. If a file lacks frontmatter, add `---\ngspec-version: 1.5.1\n---` at the top.
116
116
  4. **Update epic status** — When all capabilities in a feature PRD are checked, update the corresponding feature's checkbox in the epic summary file (if one exists) from `- [ ]` to `- [x]`.
117
117
  5. **Run tests** — Execute the tests defined for this phase (and any existing tests to catch regressions). Fix any failures before proceeding.
118
118
  6. **Surface new gaps** — If implementation reveals new ambiguities, pause and consult the user rather than making silent assumptions
@@ -5,7 +5,7 @@ description: Migrate existing gspec files to the current format when upgrading t
5
5
 
6
6
  You are a Technical Documentation Migration Specialist.
7
7
 
8
- Your task is to update existing gspec specification documents to match the current gspec format (version 1.5.0). You preserve all substantive content while ensuring documents follow the latest structural conventions.
8
+ Your task is to update existing gspec specification documents to match the current gspec format (version 1.5.1). You preserve all substantive content while ensuring documents follow the latest structural conventions.
9
9
 
10
10
  ---
11
11
 
@@ -21,14 +21,14 @@ Scan the `gspec/` directory for all Markdown files:
21
21
  For each file, check the YAML frontmatter at the top of the file:
22
22
  - If the file starts with `---` followed by YAML content and another `---`, read the `gspec-version` field
23
23
  - If no frontmatter exists, the file predates version tracking
24
- - If `gspec-version` matches `1.5.0`, the file is current — skip it
24
+ - If `gspec-version` matches `1.5.1`, the file is current — skip it
25
25
 
26
26
  Present an inventory to the user:
27
27
 
28
28
  > **gspec File Inventory:**
29
29
  > - `gspec/profile.md` — no version (needs migration)
30
30
  > - `gspec/stack.md` — version 1.0.3 (needs migration)
31
- > - `gspec/style.md` — version 1.5.0 (current, skipping)
31
+ > - `gspec/style.md` — version 1.5.1 (current, skipping)
32
32
  > - `gspec/features/user-auth.md` — no version (needs migration)
33
33
 
34
34
  Ask the user to confirm which files to migrate, or confirm all.
@@ -64,7 +64,7 @@ For each file to migrate:
64
64
  5. **Add or update the frontmatter** — Ensure the file starts with:
65
65
  ```
66
66
  ---
67
- gspec-version: 1.5.0
67
+ gspec-version: 1.5.1
68
68
  ---
69
69
  ```
70
70
  6. **Present the proposed changes** to the user before writing. Show what sections are being reorganized, what is being added, and confirm no content is being lost.
@@ -78,7 +78,7 @@ After migrating all files:
78
78
  3. **Present a completion summary**:
79
79
 
80
80
  > **Migration Complete:**
81
- > - 4 files migrated to version 1.5.0
81
+ > - 4 files migrated to version 1.5.1
82
82
  > - 2 files were already current (skipped)
83
83
  > - Content preserved in all files
84
84
  > - Sections reorganized: [list any structural changes]
@@ -25,7 +25,7 @@ You should:
25
25
  - Begin the file with YAML frontmatter containing the gspec version:
26
26
  ```
27
27
  ---
28
- gspec-version: 1.5.0
28
+ gspec-version: 1.5.1
29
29
  ---
30
30
  ```
31
31
  The frontmatter must be the very first content in the file, before the main heading.
@@ -25,7 +25,7 @@ You should:
25
25
  - Begin the file with YAML frontmatter containing the gspec version:
26
26
  ```
27
27
  ---
28
- gspec-version: 1.5.0
28
+ gspec-version: 1.5.1
29
29
  ---
30
30
  ```
31
31
  The frontmatter must be the very first content in the file, before the main heading.
@@ -128,7 +128,7 @@ After approval, write the spec updates:
128
128
  - Dependencies (on other features or external services)
129
129
  - Assumptions & Risks (assumptions, open questions, key risks and mitigations — note in assumptions that this feature was recorded during iterative development)
130
130
  - Success Metrics
131
- - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.0\n---`
131
+ - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.1\n---`
132
132
  - **Also update `gspec/architecture.md`** if the new feature introduces data entities, API endpoints, or new components — add them to the appropriate architecture sections
133
133
 
134
134
  ### Phase 6: Verify — Confirm Consistency
@@ -157,7 +157,7 @@ After writing spec updates:
157
157
 
158
158
  **When to create vs. update.** If a change adds a small capability that fits naturally within an existing feature PRD, update that PRD. If a change introduces a wholly new product area that does not belong in any existing PRD, create a new feature PRD. When in doubt, ask the user.
159
159
 
160
- **Version frontmatter.** When updating existing gspec files, preserve the `gspec-version` YAML frontmatter at the top of the file. If a file lacks frontmatter, add `---\ngspec-version: 1.5.0\n---` as the very first content before the main heading.
160
+ **Version frontmatter.** When updating existing gspec files, preserve the `gspec-version` YAML frontmatter at the top of the file. If a file lacks frontmatter, add `---\ngspec-version: 1.5.1\n---` as the very first content before the main heading.
161
161
 
162
162
  **No code changes.** This command never creates, modifies, or deletes code files. If the user needs code changes alongside spec updates, suggest using `gspec-dor` instead.
163
163
 
@@ -162,7 +162,7 @@ After writing `gspec/research.md`, ask the user:
162
162
  - Assumptions & Risks (assumptions, open questions, key risks and mitigations)
163
163
  - Success Metrics
164
164
  - Implementation Context (standard portability note)
165
- - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.0\n---`
165
+ - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.1\n---`
166
166
  2. **Name the file** descriptively based on the feature (e.g., `gspec/features/csv-export.md`, `gspec/features/onboarding-wizard.md`)
167
167
  3. **Keep the PRD portable** — use generic role descriptions (not project-specific persona names), define success metrics in terms of the feature's own outcomes (not project-level KPIs), and describe UX behavior generically (not tied to a specific design system). The PRD should be reusable across projects.
168
168
  4. **Keep the PRD product-focused** — describe *what* and *why*, not *how*. Implementation details belong in the code, not the PRD.
@@ -181,7 +181,7 @@ After writing `gspec/research.md`, ask the user:
181
181
  - Begin `gspec/research.md` with YAML frontmatter containing the gspec version:
182
182
  ```
183
183
  ---
184
- gspec-version: 1.5.0
184
+ gspec-version: 1.5.1
185
185
  ---
186
186
  ```
187
187
  The frontmatter must be the very first content in the file, before the main heading.
@@ -198,7 +198,7 @@ The `gspec/research.md` file must follow this structure:
198
198
 
199
199
  ```markdown
200
200
  ---
201
- gspec-version: 1.5.0
201
+ gspec-version: 1.5.1
202
202
  ---
203
203
 
204
204
  # Competitive Research
@@ -25,7 +25,7 @@ You should:
25
25
  - Begin the file with YAML frontmatter containing the gspec version:
26
26
  ```
27
27
  ---
28
- gspec-version: 1.5.0
28
+ gspec-version: 1.5.1
29
29
  ---
30
30
  ```
31
31
  The frontmatter must be the very first content in the file, before the main heading.
@@ -27,7 +27,7 @@ You should:
27
27
  - Begin the file with YAML frontmatter containing the gspec version:
28
28
  ```
29
29
  ---
30
- gspec-version: 1.5.0
30
+ gspec-version: 1.5.1
31
31
  ---
32
32
  ```
33
33
  The frontmatter must be the very first content in the file, before the main heading.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: gspec-architect
3
- description: Define the technical architecture: project structure, data model, API design, and environment setup
3
+ description: Define the technical architecture project structure, data model, API design, and environment setup
4
4
  ---
5
5
 
6
6
  You are a Senior Software Architect at a high-performing software company.
@@ -46,7 +46,7 @@ All of these provide essential context. If any are missing, note the gap and mak
46
46
  - Begin the file with YAML frontmatter containing the gspec version:
47
47
  ```
48
48
  ---
49
- gspec-version: 1.5.0
49
+ gspec-version: 1.5.1
50
50
  ---
51
51
  ```
52
52
  The frontmatter must be the very first content in the file, before the main heading.
@@ -144,7 +144,7 @@ After approval, write the spec updates:
144
144
  - Dependencies (on other features or external services)
145
145
  - Assumptions & Risks (assumptions, open questions, key risks and mitigations — note in assumptions that this feature was identified during iterative development)
146
146
  - Success Metrics
147
- - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.0\n---`
147
+ - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.1\n---`
148
148
  - **Also update `gspec/architecture.md`** if the new feature introduces data entities, API endpoints, or new components — add them to the appropriate architecture sections
149
149
 
150
150
  ### Phase 7: Verify — Confirm Consistency
@@ -177,7 +177,7 @@ After writing spec updates:
177
177
 
178
178
  **Implementation checkboxes.** Feature PRDs use markdown checkboxes (`- [ ]` / `- [x]`) on capabilities to track implementation status for `gspec-implement`. When DOR adds new capabilities, use unchecked checkboxes (`- [ ]`). When modifying a capability that was already checked (`- [x]`) and the code change reflects the modification, keep it checked. When creating a new feature PRD, use unchecked checkboxes for all capabilities. Do not check off capabilities that DOR did not implement in the current session.
179
179
 
180
- **Version frontmatter.** When updating existing gspec files, preserve the `gspec-version` YAML frontmatter at the top of the file. If a file lacks frontmatter, add `---\ngspec-version: 1.5.0\n---` as the very first content before the main heading.
180
+ **Version frontmatter.** When updating existing gspec files, preserve the `gspec-version` YAML frontmatter at the top of the file. If a file lacks frontmatter, add `---\ngspec-version: 1.5.1\n---` as the very first content before the main heading.
181
181
 
182
182
  ---
183
183
 
@@ -78,7 +78,7 @@ Epic summaries and the feature PRDs they produce are designed to be **portable a
78
78
  - Begin every output file (both epic summary and individual feature PRDs) with YAML frontmatter containing the gspec version:
79
79
  ```
80
80
  ---
81
- gspec-version: 1.5.0
81
+ gspec-version: 1.5.1
82
82
  ---
83
83
  ```
84
84
  The frontmatter must be the very first content in the file, before the main heading.
@@ -68,7 +68,7 @@ Feature PRDs are designed to be **portable across projects**. A feature spec wri
68
68
  - Begin the file with YAML frontmatter containing the gspec version:
69
69
  ```
70
70
  ---
71
- gspec-version: 1.5.0
71
+ gspec-version: 1.5.1
72
72
  ---
73
73
  ```
74
74
  The frontmatter must be the very first content in the file, before the main heading.
@@ -112,7 +112,7 @@ Present a brief scaffold summary to the user before proceeding to feature implem
112
112
  b. **Follow the practices** — Adhere to coding standards, testing requirements, and conventions from `gspec/practices.md`
113
113
  c. **Follow the style** — Apply the design system, tokens, and component patterns from `gspec/style.md`
114
114
  d. **Satisfy the requirements** — Trace each piece of code back to a functional requirement in the feature PRD (if available) or to the user's stated goals and the approved implementation plan
115
- 3. **Mark capabilities as implemented** — After successfully implementing each capability, immediately update the feature PRD by changing its checkbox from `- [ ]` to `- [x]`. Do this incrementally as each capability is completed, not in a batch at the end. If a capability line did not have a checkbox prefix, add one as `- [x]`. This ensures that if the session is interrupted, progress is not lost. When updating gspec files, preserve existing `gspec-version` YAML frontmatter. If a file lacks frontmatter, add `---\ngspec-version: 1.5.0\n---` at the top.
115
+ 3. **Mark capabilities as implemented** — After successfully implementing each capability, immediately update the feature PRD by changing its checkbox from `- [ ]` to `- [x]`. Do this incrementally as each capability is completed, not in a batch at the end. If a capability line did not have a checkbox prefix, add one as `- [x]`. This ensures that if the session is interrupted, progress is not lost. When updating gspec files, preserve existing `gspec-version` YAML frontmatter. If a file lacks frontmatter, add `---\ngspec-version: 1.5.1\n---` at the top.
116
116
  4. **Update epic status** — When all capabilities in a feature PRD are checked, update the corresponding feature's checkbox in the epic summary file (if one exists) from `- [ ]` to `- [x]`.
117
117
  5. **Run tests** — Execute the tests defined for this phase (and any existing tests to catch regressions). Fix any failures before proceeding.
118
118
  6. **Surface new gaps** — If implementation reveals new ambiguities, pause and consult the user rather than making silent assumptions
@@ -5,7 +5,7 @@ description: Migrate existing gspec files to the current format when upgrading t
5
5
 
6
6
  You are a Technical Documentation Migration Specialist.
7
7
 
8
- Your task is to update existing gspec specification documents to match the current gspec format (version 1.5.0). You preserve all substantive content while ensuring documents follow the latest structural conventions.
8
+ Your task is to update existing gspec specification documents to match the current gspec format (version 1.5.1). You preserve all substantive content while ensuring documents follow the latest structural conventions.
9
9
 
10
10
  ---
11
11
 
@@ -21,14 +21,14 @@ Scan the `gspec/` directory for all Markdown files:
21
21
  For each file, check the YAML frontmatter at the top of the file:
22
22
  - If the file starts with `---` followed by YAML content and another `---`, read the `gspec-version` field
23
23
  - If no frontmatter exists, the file predates version tracking
24
- - If `gspec-version` matches `1.5.0`, the file is current — skip it
24
+ - If `gspec-version` matches `1.5.1`, the file is current — skip it
25
25
 
26
26
  Present an inventory to the user:
27
27
 
28
28
  > **gspec File Inventory:**
29
29
  > - `gspec/profile.md` — no version (needs migration)
30
30
  > - `gspec/stack.md` — version 1.0.3 (needs migration)
31
- > - `gspec/style.md` — version 1.5.0 (current, skipping)
31
+ > - `gspec/style.md` — version 1.5.1 (current, skipping)
32
32
  > - `gspec/features/user-auth.md` — no version (needs migration)
33
33
 
34
34
  Ask the user to confirm which files to migrate, or confirm all.
@@ -64,7 +64,7 @@ For each file to migrate:
64
64
  5. **Add or update the frontmatter** — Ensure the file starts with:
65
65
  ```
66
66
  ---
67
- gspec-version: 1.5.0
67
+ gspec-version: 1.5.1
68
68
  ---
69
69
  ```
70
70
  6. **Present the proposed changes** to the user before writing. Show what sections are being reorganized, what is being added, and confirm no content is being lost.
@@ -78,7 +78,7 @@ After migrating all files:
78
78
  3. **Present a completion summary**:
79
79
 
80
80
  > **Migration Complete:**
81
- > - 4 files migrated to version 1.5.0
81
+ > - 4 files migrated to version 1.5.1
82
82
  > - 2 files were already current (skipped)
83
83
  > - Content preserved in all files
84
84
  > - Sections reorganized: [list any structural changes]
@@ -25,7 +25,7 @@ You should:
25
25
  - Begin the file with YAML frontmatter containing the gspec version:
26
26
  ```
27
27
  ---
28
- gspec-version: 1.5.0
28
+ gspec-version: 1.5.1
29
29
  ---
30
30
  ```
31
31
  The frontmatter must be the very first content in the file, before the main heading.
@@ -25,7 +25,7 @@ You should:
25
25
  - Begin the file with YAML frontmatter containing the gspec version:
26
26
  ```
27
27
  ---
28
- gspec-version: 1.5.0
28
+ gspec-version: 1.5.1
29
29
  ---
30
30
  ```
31
31
  The frontmatter must be the very first content in the file, before the main heading.
@@ -128,7 +128,7 @@ After approval, write the spec updates:
128
128
  - Dependencies (on other features or external services)
129
129
  - Assumptions & Risks (assumptions, open questions, key risks and mitigations — note in assumptions that this feature was recorded during iterative development)
130
130
  - Success Metrics
131
- - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.0\n---`
131
+ - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.1\n---`
132
132
  - **Also update `gspec/architecture.md`** if the new feature introduces data entities, API endpoints, or new components — add them to the appropriate architecture sections
133
133
 
134
134
  ### Phase 6: Verify — Confirm Consistency
@@ -157,7 +157,7 @@ After writing spec updates:
157
157
 
158
158
  **When to create vs. update.** If a change adds a small capability that fits naturally within an existing feature PRD, update that PRD. If a change introduces a wholly new product area that does not belong in any existing PRD, create a new feature PRD. When in doubt, ask the user.
159
159
 
160
- **Version frontmatter.** When updating existing gspec files, preserve the `gspec-version` YAML frontmatter at the top of the file. If a file lacks frontmatter, add `---\ngspec-version: 1.5.0\n---` as the very first content before the main heading.
160
+ **Version frontmatter.** When updating existing gspec files, preserve the `gspec-version` YAML frontmatter at the top of the file. If a file lacks frontmatter, add `---\ngspec-version: 1.5.1\n---` as the very first content before the main heading.
161
161
 
162
162
  **No code changes.** This command never creates, modifies, or deletes code files. If the user needs code changes alongside spec updates, suggest using `gspec-dor` instead.
163
163
 
@@ -162,7 +162,7 @@ After writing `gspec/research.md`, ask the user:
162
162
  - Assumptions & Risks (assumptions, open questions, key risks and mitigations)
163
163
  - Success Metrics
164
164
  - Implementation Context (standard portability note)
165
- - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.0\n---`
165
+ - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.1\n---`
166
166
  2. **Name the file** descriptively based on the feature (e.g., `gspec/features/csv-export.md`, `gspec/features/onboarding-wizard.md`)
167
167
  3. **Keep the PRD portable** — use generic role descriptions (not project-specific persona names), define success metrics in terms of the feature's own outcomes (not project-level KPIs), and describe UX behavior generically (not tied to a specific design system). The PRD should be reusable across projects.
168
168
  4. **Keep the PRD product-focused** — describe *what* and *why*, not *how*. Implementation details belong in the code, not the PRD.
@@ -181,7 +181,7 @@ After writing `gspec/research.md`, ask the user:
181
181
  - Begin `gspec/research.md` with YAML frontmatter containing the gspec version:
182
182
  ```
183
183
  ---
184
- gspec-version: 1.5.0
184
+ gspec-version: 1.5.1
185
185
  ---
186
186
  ```
187
187
  The frontmatter must be the very first content in the file, before the main heading.
@@ -198,7 +198,7 @@ The `gspec/research.md` file must follow this structure:
198
198
 
199
199
  ```markdown
200
200
  ---
201
- gspec-version: 1.5.0
201
+ gspec-version: 1.5.1
202
202
  ---
203
203
 
204
204
  # Competitive Research
@@ -25,7 +25,7 @@ You should:
25
25
  - Begin the file with YAML frontmatter containing the gspec version:
26
26
  ```
27
27
  ---
28
- gspec-version: 1.5.0
28
+ gspec-version: 1.5.1
29
29
  ---
30
30
  ```
31
31
  The frontmatter must be the very first content in the file, before the main heading.
@@ -27,7 +27,7 @@ You should:
27
27
  - Begin the file with YAML frontmatter containing the gspec version:
28
28
  ```
29
29
  ---
30
- gspec-version: 1.5.0
30
+ gspec-version: 1.5.1
31
31
  ---
32
32
  ```
33
33
  The frontmatter must be the very first content in the file, before the main heading.
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Define the technical architecture: project structure, data model, API design, and environment setup
2
+ description: Define the technical architecture project structure, data model, API design, and environment setup
3
3
  ---
4
4
 
5
5
  You are a Senior Software Architect at a high-performing software company.
@@ -45,7 +45,7 @@ All of these provide essential context. If any are missing, note the gap and mak
45
45
  - Begin the file with YAML frontmatter containing the gspec version:
46
46
  ```
47
47
  ---
48
- gspec-version: 1.5.0
48
+ gspec-version: 1.5.1
49
49
  ---
50
50
  ```
51
51
  The frontmatter must be the very first content in the file, before the main heading.
@@ -143,7 +143,7 @@ After approval, write the spec updates:
143
143
  - Dependencies (on other features or external services)
144
144
  - Assumptions & Risks (assumptions, open questions, key risks and mitigations — note in assumptions that this feature was identified during iterative development)
145
145
  - Success Metrics
146
- - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.0\n---`
146
+ - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.1\n---`
147
147
  - **Also update `gspec/architecture.md`** if the new feature introduces data entities, API endpoints, or new components — add them to the appropriate architecture sections
148
148
 
149
149
  ### Phase 7: Verify — Confirm Consistency
@@ -176,7 +176,7 @@ After writing spec updates:
176
176
 
177
177
  **Implementation checkboxes.** Feature PRDs use markdown checkboxes (`- [ ]` / `- [x]`) on capabilities to track implementation status for `gspec-implement`. When DOR adds new capabilities, use unchecked checkboxes (`- [ ]`). When modifying a capability that was already checked (`- [x]`) and the code change reflects the modification, keep it checked. When creating a new feature PRD, use unchecked checkboxes for all capabilities. Do not check off capabilities that DOR did not implement in the current session.
178
178
 
179
- **Version frontmatter.** When updating existing gspec files, preserve the `gspec-version` YAML frontmatter at the top of the file. If a file lacks frontmatter, add `---\ngspec-version: 1.5.0\n---` as the very first content before the main heading.
179
+ **Version frontmatter.** When updating existing gspec files, preserve the `gspec-version` YAML frontmatter at the top of the file. If a file lacks frontmatter, add `---\ngspec-version: 1.5.1\n---` as the very first content before the main heading.
180
180
 
181
181
  ---
182
182
 
@@ -77,7 +77,7 @@ Epic summaries and the feature PRDs they produce are designed to be **portable a
77
77
  - Begin every output file (both epic summary and individual feature PRDs) with YAML frontmatter containing the gspec version:
78
78
  ```
79
79
  ---
80
- gspec-version: 1.5.0
80
+ gspec-version: 1.5.1
81
81
  ---
82
82
  ```
83
83
  The frontmatter must be the very first content in the file, before the main heading.
@@ -67,7 +67,7 @@ Feature PRDs are designed to be **portable across projects**. A feature spec wri
67
67
  - Begin the file with YAML frontmatter containing the gspec version:
68
68
  ```
69
69
  ---
70
- gspec-version: 1.5.0
70
+ gspec-version: 1.5.1
71
71
  ---
72
72
  ```
73
73
  The frontmatter must be the very first content in the file, before the main heading.
@@ -111,7 +111,7 @@ Present a brief scaffold summary to the user before proceeding to feature implem
111
111
  b. **Follow the practices** — Adhere to coding standards, testing requirements, and conventions from `gspec/practices.md`
112
112
  c. **Follow the style** — Apply the design system, tokens, and component patterns from `gspec/style.md`
113
113
  d. **Satisfy the requirements** — Trace each piece of code back to a functional requirement in the feature PRD (if available) or to the user's stated goals and the approved implementation plan
114
- 3. **Mark capabilities as implemented** — After successfully implementing each capability, immediately update the feature PRD by changing its checkbox from `- [ ]` to `- [x]`. Do this incrementally as each capability is completed, not in a batch at the end. If a capability line did not have a checkbox prefix, add one as `- [x]`. This ensures that if the session is interrupted, progress is not lost. When updating gspec files, preserve existing `gspec-version` YAML frontmatter. If a file lacks frontmatter, add `---\ngspec-version: 1.5.0\n---` at the top.
114
+ 3. **Mark capabilities as implemented** — After successfully implementing each capability, immediately update the feature PRD by changing its checkbox from `- [ ]` to `- [x]`. Do this incrementally as each capability is completed, not in a batch at the end. If a capability line did not have a checkbox prefix, add one as `- [x]`. This ensures that if the session is interrupted, progress is not lost. When updating gspec files, preserve existing `gspec-version` YAML frontmatter. If a file lacks frontmatter, add `---\ngspec-version: 1.5.1\n---` at the top.
115
115
  4. **Update epic status** — When all capabilities in a feature PRD are checked, update the corresponding feature's checkbox in the epic summary file (if one exists) from `- [ ]` to `- [x]`.
116
116
  5. **Run tests** — Execute the tests defined for this phase (and any existing tests to catch regressions). Fix any failures before proceeding.
117
117
  6. **Surface new gaps** — If implementation reveals new ambiguities, pause and consult the user rather than making silent assumptions
@@ -4,7 +4,7 @@ description: Migrate existing gspec files to the current format when upgrading t
4
4
 
5
5
  You are a Technical Documentation Migration Specialist.
6
6
 
7
- Your task is to update existing gspec specification documents to match the current gspec format (version 1.5.0). You preserve all substantive content while ensuring documents follow the latest structural conventions.
7
+ Your task is to update existing gspec specification documents to match the current gspec format (version 1.5.1). You preserve all substantive content while ensuring documents follow the latest structural conventions.
8
8
 
9
9
  ---
10
10
 
@@ -20,14 +20,14 @@ Scan the `gspec/` directory for all Markdown files:
20
20
  For each file, check the YAML frontmatter at the top of the file:
21
21
  - If the file starts with `---` followed by YAML content and another `---`, read the `gspec-version` field
22
22
  - If no frontmatter exists, the file predates version tracking
23
- - If `gspec-version` matches `1.5.0`, the file is current — skip it
23
+ - If `gspec-version` matches `1.5.1`, the file is current — skip it
24
24
 
25
25
  Present an inventory to the user:
26
26
 
27
27
  > **gspec File Inventory:**
28
28
  > - `gspec/profile.md` — no version (needs migration)
29
29
  > - `gspec/stack.md` — version 1.0.3 (needs migration)
30
- > - `gspec/style.md` — version 1.5.0 (current, skipping)
30
+ > - `gspec/style.md` — version 1.5.1 (current, skipping)
31
31
  > - `gspec/features/user-auth.md` — no version (needs migration)
32
32
 
33
33
  Ask the user to confirm which files to migrate, or confirm all.
@@ -63,7 +63,7 @@ For each file to migrate:
63
63
  5. **Add or update the frontmatter** — Ensure the file starts with:
64
64
  ```
65
65
  ---
66
- gspec-version: 1.5.0
66
+ gspec-version: 1.5.1
67
67
  ---
68
68
  ```
69
69
  6. **Present the proposed changes** to the user before writing. Show what sections are being reorganized, what is being added, and confirm no content is being lost.
@@ -77,7 +77,7 @@ After migrating all files:
77
77
  3. **Present a completion summary**:
78
78
 
79
79
  > **Migration Complete:**
80
- > - 4 files migrated to version 1.5.0
80
+ > - 4 files migrated to version 1.5.1
81
81
  > - 2 files were already current (skipped)
82
82
  > - Content preserved in all files
83
83
  > - Sections reorganized: [list any structural changes]
@@ -24,7 +24,7 @@ You should:
24
24
  - Begin the file with YAML frontmatter containing the gspec version:
25
25
  ```
26
26
  ---
27
- gspec-version: 1.5.0
27
+ gspec-version: 1.5.1
28
28
  ---
29
29
  ```
30
30
  The frontmatter must be the very first content in the file, before the main heading.
@@ -24,7 +24,7 @@ You should:
24
24
  - Begin the file with YAML frontmatter containing the gspec version:
25
25
  ```
26
26
  ---
27
- gspec-version: 1.5.0
27
+ gspec-version: 1.5.1
28
28
  ---
29
29
  ```
30
30
  The frontmatter must be the very first content in the file, before the main heading.
@@ -127,7 +127,7 @@ After approval, write the spec updates:
127
127
  - Dependencies (on other features or external services)
128
128
  - Assumptions & Risks (assumptions, open questions, key risks and mitigations — note in assumptions that this feature was recorded during iterative development)
129
129
  - Success Metrics
130
- - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.0\n---`
130
+ - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.1\n---`
131
131
  - **Also update `gspec/architecture.md`** if the new feature introduces data entities, API endpoints, or new components — add them to the appropriate architecture sections
132
132
 
133
133
  ### Phase 6: Verify — Confirm Consistency
@@ -156,7 +156,7 @@ After writing spec updates:
156
156
 
157
157
  **When to create vs. update.** If a change adds a small capability that fits naturally within an existing feature PRD, update that PRD. If a change introduces a wholly new product area that does not belong in any existing PRD, create a new feature PRD. When in doubt, ask the user.
158
158
 
159
- **Version frontmatter.** When updating existing gspec files, preserve the `gspec-version` YAML frontmatter at the top of the file. If a file lacks frontmatter, add `---\ngspec-version: 1.5.0\n---` as the very first content before the main heading.
159
+ **Version frontmatter.** When updating existing gspec files, preserve the `gspec-version` YAML frontmatter at the top of the file. If a file lacks frontmatter, add `---\ngspec-version: 1.5.1\n---` as the very first content before the main heading.
160
160
 
161
161
  **No code changes.** This command never creates, modifies, or deletes code files. If the user needs code changes alongside spec updates, suggest using `gspec-dor` instead.
162
162
 
@@ -161,7 +161,7 @@ After writing `gspec/research.md`, ask the user:
161
161
  - Assumptions & Risks (assumptions, open questions, key risks and mitigations)
162
162
  - Success Metrics
163
163
  - Implementation Context (standard portability note)
164
- - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.0\n---`
164
+ - Begin the file with YAML frontmatter: `---\ngspec-version: 1.5.1\n---`
165
165
  2. **Name the file** descriptively based on the feature (e.g., `gspec/features/csv-export.md`, `gspec/features/onboarding-wizard.md`)
166
166
  3. **Keep the PRD portable** — use generic role descriptions (not project-specific persona names), define success metrics in terms of the feature's own outcomes (not project-level KPIs), and describe UX behavior generically (not tied to a specific design system). The PRD should be reusable across projects.
167
167
  4. **Keep the PRD product-focused** — describe *what* and *why*, not *how*. Implementation details belong in the code, not the PRD.
@@ -180,7 +180,7 @@ After writing `gspec/research.md`, ask the user:
180
180
  - Begin `gspec/research.md` with YAML frontmatter containing the gspec version:
181
181
  ```
182
182
  ---
183
- gspec-version: 1.5.0
183
+ gspec-version: 1.5.1
184
184
  ---
185
185
  ```
186
186
  The frontmatter must be the very first content in the file, before the main heading.
@@ -197,7 +197,7 @@ The `gspec/research.md` file must follow this structure:
197
197
 
198
198
  ```markdown
199
199
  ---
200
- gspec-version: 1.5.0
200
+ gspec-version: 1.5.1
201
201
  ---
202
202
 
203
203
  # Competitive Research
@@ -24,7 +24,7 @@ You should:
24
24
  - Begin the file with YAML frontmatter containing the gspec version:
25
25
  ```
26
26
  ---
27
- gspec-version: 1.5.0
27
+ gspec-version: 1.5.1
28
28
  ---
29
29
  ```
30
30
  The frontmatter must be the very first content in the file, before the main heading.
@@ -26,7 +26,7 @@ You should:
26
26
  - Begin the file with YAML frontmatter containing the gspec version:
27
27
  ```
28
28
  ---
29
- gspec-version: 1.5.0
29
+ gspec-version: 1.5.1
30
30
  ---
31
31
  ```
32
32
  The frontmatter must be the very first content in the file, before the main heading.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "gspec",
3
- "version": "1.5.0",
3
+ "version": "1.5.1",
4
4
  "description": "Install gspec specification commands for Claude Code, Cursor, and other AI tools",
5
5
  "main": "bin/gspec.js",
6
6
  "type": "module",