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.
- package/dist/antigravity/gspec-architect/SKILL.md +2 -2
- package/dist/antigravity/gspec-dor/SKILL.md +2 -2
- package/dist/antigravity/gspec-epic/SKILL.md +1 -1
- package/dist/antigravity/gspec-feature/SKILL.md +1 -1
- package/dist/antigravity/gspec-implement/SKILL.md +1 -1
- package/dist/antigravity/gspec-migrate/SKILL.md +5 -5
- package/dist/antigravity/gspec-practices/SKILL.md +1 -1
- package/dist/antigravity/gspec-profile/SKILL.md +1 -1
- package/dist/antigravity/gspec-record/SKILL.md +2 -2
- package/dist/antigravity/gspec-research/SKILL.md +3 -3
- package/dist/antigravity/gspec-stack/SKILL.md +1 -1
- package/dist/antigravity/gspec-style/SKILL.md +1 -1
- package/dist/claude/gspec-architect/SKILL.md +2 -2
- package/dist/claude/gspec-dor/SKILL.md +2 -2
- package/dist/claude/gspec-epic/SKILL.md +1 -1
- package/dist/claude/gspec-feature/SKILL.md +1 -1
- package/dist/claude/gspec-implement/SKILL.md +1 -1
- package/dist/claude/gspec-migrate/SKILL.md +5 -5
- package/dist/claude/gspec-practices/SKILL.md +1 -1
- package/dist/claude/gspec-profile/SKILL.md +1 -1
- package/dist/claude/gspec-record/SKILL.md +2 -2
- package/dist/claude/gspec-research/SKILL.md +3 -3
- package/dist/claude/gspec-stack/SKILL.md +1 -1
- package/dist/claude/gspec-style/SKILL.md +1 -1
- package/dist/codex/gspec-architect/SKILL.md +2 -2
- package/dist/codex/gspec-dor/SKILL.md +2 -2
- package/dist/codex/gspec-epic/SKILL.md +1 -1
- package/dist/codex/gspec-feature/SKILL.md +1 -1
- package/dist/codex/gspec-implement/SKILL.md +1 -1
- package/dist/codex/gspec-migrate/SKILL.md +5 -5
- package/dist/codex/gspec-practices/SKILL.md +1 -1
- package/dist/codex/gspec-profile/SKILL.md +1 -1
- package/dist/codex/gspec-record/SKILL.md +2 -2
- package/dist/codex/gspec-research/SKILL.md +3 -3
- package/dist/codex/gspec-stack/SKILL.md +1 -1
- package/dist/codex/gspec-style/SKILL.md +1 -1
- package/dist/cursor/gspec-architect.mdc +2 -2
- package/dist/cursor/gspec-dor.mdc +2 -2
- package/dist/cursor/gspec-epic.mdc +1 -1
- package/dist/cursor/gspec-feature.mdc +1 -1
- package/dist/cursor/gspec-implement.mdc +1 -1
- package/dist/cursor/gspec-migrate.mdc +5 -5
- package/dist/cursor/gspec-practices.mdc +1 -1
- package/dist/cursor/gspec-profile.mdc +1 -1
- package/dist/cursor/gspec-record.mdc +2 -2
- package/dist/cursor/gspec-research.mdc +3 -3
- package/dist/cursor/gspec-stack.mdc +1 -1
- package/dist/cursor/gspec-style.mdc +1 -1
- package/package.json +1 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: gspec-architect
|
|
3
|
-
description: Define the technical architecture
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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]
|
|
@@ -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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
201
|
+
gspec-version: 1.5.1
|
|
202
202
|
---
|
|
203
203
|
|
|
204
204
|
# Competitive Research
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: gspec-architect
|
|
3
|
-
description: Define the technical architecture
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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]
|
|
@@ -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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
201
|
+
gspec-version: 1.5.1
|
|
202
202
|
---
|
|
203
203
|
|
|
204
204
|
# Competitive Research
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: gspec-architect
|
|
3
|
-
description: Define the technical architecture
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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]
|
|
@@ -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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
201
|
+
gspec-version: 1.5.1
|
|
202
202
|
---
|
|
203
203
|
|
|
204
204
|
# Competitive Research
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description: Define the technical architecture
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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]
|
|
@@ -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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
200
|
+
gspec-version: 1.5.1
|
|
201
201
|
---
|
|
202
202
|
|
|
203
203
|
# Competitive Research
|