get-shit-done-cc 1.2.13 → 1.3.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/README.md +3 -4
- package/commands/gsd/create-roadmap.md +3 -40
- package/commands/gsd/help.md +21 -25
- package/commands/gsd/map-codebase.md +85 -0
- package/commands/gsd/new-project.md +36 -8
- package/commands/gsd/plan-phase.md +3 -0
- package/get-shit-done/templates/codebase/architecture.md +249 -0
- package/get-shit-done/templates/codebase/concerns.md +299 -0
- package/get-shit-done/templates/codebase/conventions.md +307 -0
- package/get-shit-done/templates/codebase/integrations.md +280 -0
- package/get-shit-done/templates/codebase/stack.md +187 -0
- package/get-shit-done/templates/codebase/structure.md +285 -0
- package/get-shit-done/templates/codebase/testing.md +480 -0
- package/get-shit-done/workflows/create-roadmap.md +0 -105
- package/get-shit-done/workflows/execute-phase.md +47 -0
- package/get-shit-done/workflows/map-codebase.md +397 -0
- package/get-shit-done/workflows/plan-phase.md +48 -0
- package/package.json +1 -1
- package/commands/gsd/research-project.md +0 -195
- package/get-shit-done/references/research-subagent-prompts.md +0 -451
- package/get-shit-done/templates/project-research.md +0 -243
- package/get-shit-done/workflows/research-project.md +0 -223
|
@@ -1,223 +0,0 @@
|
|
|
1
|
-
<purpose>
|
|
2
|
-
Research implementation context for Claude Code before roadmap creation.
|
|
3
|
-
|
|
4
|
-
This is NOT research for human decision-making.
|
|
5
|
-
This is CONTEXT INJECTION so Claude Code implements correctly.
|
|
6
|
-
|
|
7
|
-
Research quality directly impacts implementation quality.
|
|
8
|
-
Claude's training data may have outdated APIs, deprecated patterns, old syntax.
|
|
9
|
-
This research provides current, accurate context to override stale knowledge.
|
|
10
|
-
</purpose>
|
|
11
|
-
|
|
12
|
-
<research_philosophy>
|
|
13
|
-
## What This Research Is
|
|
14
|
-
|
|
15
|
-
**Context injection for Claude Code implementation quality.**
|
|
16
|
-
|
|
17
|
-
Claude Code will read these files during implementation. The research should:
|
|
18
|
-
- Override outdated patterns Claude might default to
|
|
19
|
-
- Provide current API syntax and code examples
|
|
20
|
-
- Explicitly correct common mistakes Claude makes
|
|
21
|
-
- Include version-specific details (as of 2024-2025)
|
|
22
|
-
|
|
23
|
-
## What This Research Is NOT
|
|
24
|
-
|
|
25
|
-
- A survey of options for humans to choose from
|
|
26
|
-
- Generic "best practices" documentation
|
|
27
|
-
- Padding with low-confidence "might be useful" items
|
|
28
|
-
- Academic completeness over practical utility
|
|
29
|
-
|
|
30
|
-
## Quality Bar
|
|
31
|
-
|
|
32
|
-
**Include if:** High confidence, directly actionable, will improve Claude's implementation
|
|
33
|
-
**Exclude if:** Low confidence, tangential, "might be relevant", padding
|
|
34
|
-
</research_philosophy>
|
|
35
|
-
|
|
36
|
-
<required_reading>
|
|
37
|
-
**Read before executing:**
|
|
38
|
-
1. `~/.claude/get-shit-done/references/research-subagent-prompts.md` - Prompt templates
|
|
39
|
-
2. `~/.claude/get-shit-done/templates/project-research.md` - Output format
|
|
40
|
-
</required_reading>
|
|
41
|
-
|
|
42
|
-
<process>
|
|
43
|
-
|
|
44
|
-
<step name="setup">
|
|
45
|
-
Create research directory:
|
|
46
|
-
|
|
47
|
-
```bash
|
|
48
|
-
mkdir -p .planning/research
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
Parse PROJECT.md to create research manifest:
|
|
52
|
-
|
|
53
|
-
```
|
|
54
|
-
## Research Manifest
|
|
55
|
-
|
|
56
|
-
### Features to Implement
|
|
57
|
-
[Extract from Scope > Building]
|
|
58
|
-
- Feature 1: [description]
|
|
59
|
-
- Feature 2: [description]
|
|
60
|
-
- Feature 3: [description]
|
|
61
|
-
|
|
62
|
-
### Stack Constraints
|
|
63
|
-
[Extract from Constraints]
|
|
64
|
-
- [constraint 1]
|
|
65
|
-
- [constraint 2]
|
|
66
|
-
|
|
67
|
-
### Open Questions to Answer
|
|
68
|
-
[Extract from Open Questions]
|
|
69
|
-
- [question 1]
|
|
70
|
-
- [question 2]
|
|
71
|
-
|
|
72
|
-
### Decisions to Validate
|
|
73
|
-
[Extract from Decisions Made]
|
|
74
|
-
- [decision 1]: Any gotchas?
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
This manifest drives ALL research. Subagents research these specific items, not generic domain knowledge.
|
|
78
|
-
</step>
|
|
79
|
-
|
|
80
|
-
<step name="define_research_categories">
|
|
81
|
-
Three research categories, each PROJECT.md-driven:
|
|
82
|
-
|
|
83
|
-
1. **stack.md** - What to use for each feature
|
|
84
|
-
- For each feature in Scope: what library/tool?
|
|
85
|
-
- For each constraint: what works within it?
|
|
86
|
-
- Current versions, import statements, setup code
|
|
87
|
-
|
|
88
|
-
2. **implementation.md** - How to implement correctly
|
|
89
|
-
- Current API patterns for chosen stack
|
|
90
|
-
- Actual code examples with correct syntax
|
|
91
|
-
- "Do this (current) not that (deprecated)"
|
|
92
|
-
|
|
93
|
-
3. **risks.md** - What Claude might get wrong
|
|
94
|
-
- Deprecated patterns Claude may default to
|
|
95
|
-
- Common implementation mistakes
|
|
96
|
-
- Version-specific gotchas
|
|
97
|
-
|
|
98
|
-
Each subagent writes directly to `.planning/research/{category}.md`
|
|
99
|
-
</step>
|
|
100
|
-
|
|
101
|
-
<step name="spawn_subagents">
|
|
102
|
-
## Subagent Spawning
|
|
103
|
-
|
|
104
|
-
Read prompt templates from `~/.claude/get-shit-done/references/research-subagent-prompts.md`
|
|
105
|
-
|
|
106
|
-
**Single batch (spawn all 3 in parallel):**
|
|
107
|
-
|
|
108
|
-
```
|
|
109
|
-
Task 1:
|
|
110
|
-
description: "Research stack for [project]"
|
|
111
|
-
prompt: [stack_subagent_prompt with research manifest]
|
|
112
|
-
|
|
113
|
-
Task 2:
|
|
114
|
-
description: "Research implementation for [project]"
|
|
115
|
-
prompt: [implementation_subagent_prompt with research manifest]
|
|
116
|
-
|
|
117
|
-
Task 3:
|
|
118
|
-
description: "Research risks for [project]"
|
|
119
|
-
prompt: [risks_subagent_prompt with research manifest]
|
|
120
|
-
```
|
|
121
|
-
|
|
122
|
-
Send ALL Task calls in a single message. Wait for completion.
|
|
123
|
-
|
|
124
|
-
**Each subagent receives:**
|
|
125
|
-
- The research manifest (features, constraints, questions, decisions)
|
|
126
|
-
- Category assignment (stack, implementation, risks)
|
|
127
|
-
- Output format from templates/project-research.md
|
|
128
|
-
- Instruction: HIGH-CONFIDENCE ONLY
|
|
129
|
-
</step>
|
|
130
|
-
|
|
131
|
-
<step name="verify_outputs">
|
|
132
|
-
After subagents complete:
|
|
133
|
-
|
|
134
|
-
```bash
|
|
135
|
-
# Check all files exist
|
|
136
|
-
ls -la .planning/research/
|
|
137
|
-
|
|
138
|
-
# Verify each file has content
|
|
139
|
-
for f in stack implementation risks; do
|
|
140
|
-
[ -s ".planning/research/${f}.md" ] && echo "✓ ${f}.md" || echo "✗ ${f}.md MISSING"
|
|
141
|
-
done
|
|
142
|
-
```
|
|
143
|
-
|
|
144
|
-
**Quality verification (read each file):**
|
|
145
|
-
|
|
146
|
-
For each file, check:
|
|
147
|
-
- [ ] Addresses specific features from research manifest?
|
|
148
|
-
- [ ] Contains actual code examples?
|
|
149
|
-
- [ ] No low-confidence items included?
|
|
150
|
-
- [ ] Current syntax (2024-2025)?
|
|
151
|
-
|
|
152
|
-
**If quality issues found:**
|
|
153
|
-
- Note specific problems
|
|
154
|
-
- Consider re-running that subagent with stricter prompt
|
|
155
|
-
- Or flag for manual review
|
|
156
|
-
</step>
|
|
157
|
-
|
|
158
|
-
<step name="aggregate">
|
|
159
|
-
Extract key findings for summary:
|
|
160
|
-
|
|
161
|
-
From stack.md:
|
|
162
|
-
- Primary libraries chosen for each feature
|
|
163
|
-
- Any constraint-driven choices
|
|
164
|
-
|
|
165
|
-
From implementation.md:
|
|
166
|
-
- Most important API patterns
|
|
167
|
-
- Key code examples
|
|
168
|
-
|
|
169
|
-
From risks.md:
|
|
170
|
-
- Critical mistakes to avoid
|
|
171
|
-
- Deprecated patterns flagged
|
|
172
|
-
|
|
173
|
-
Present summary to user with next steps.
|
|
174
|
-
</step>
|
|
175
|
-
|
|
176
|
-
</process>
|
|
177
|
-
|
|
178
|
-
<subagent_quality_rules>
|
|
179
|
-
## Quality Rules for Subagents
|
|
180
|
-
|
|
181
|
-
**INCLUDE:**
|
|
182
|
-
- High-confidence, verified information
|
|
183
|
-
- Current API patterns with actual code
|
|
184
|
-
- Direct answers to Open Questions from PROJECT.md
|
|
185
|
-
- Specific recommendations for features in Scope
|
|
186
|
-
|
|
187
|
-
**EXCLUDE:**
|
|
188
|
-
- Low or medium confidence items
|
|
189
|
-
- "Might be useful" padding
|
|
190
|
-
- Generic advice not specific to this project
|
|
191
|
-
- Old repos/articles marked as outdated
|
|
192
|
-
- Options without clear recommendation
|
|
193
|
-
|
|
194
|
-
**Format for Claude consumption:**
|
|
195
|
-
```markdown
|
|
196
|
-
## [Feature Name] Implementation
|
|
197
|
-
|
|
198
|
-
**Use:** [Library] v[X.Y]
|
|
199
|
-
|
|
200
|
-
```[language]
|
|
201
|
-
// Current pattern (2025)
|
|
202
|
-
import { Thing } from 'library'
|
|
203
|
-
const result = await Thing.doCorrectThing()
|
|
204
|
-
```
|
|
205
|
-
|
|
206
|
-
**NOT:**
|
|
207
|
-
```[language]
|
|
208
|
-
// Deprecated - Claude may generate this
|
|
209
|
-
import Thing from 'library' // Old syntax
|
|
210
|
-
Thing.doOldThing() // Removed in v2.0
|
|
211
|
-
```
|
|
212
|
-
```
|
|
213
|
-
</subagent_quality_rules>
|
|
214
|
-
|
|
215
|
-
<success_criteria>
|
|
216
|
-
Research workflow complete when:
|
|
217
|
-
- [ ] All 3 research files exist in .planning/research/
|
|
218
|
-
- [ ] Each file addresses PROJECT.md features specifically
|
|
219
|
-
- [ ] Open Questions from PROJECT.md are answered
|
|
220
|
-
- [ ] Only high-confidence information included
|
|
221
|
-
- [ ] Code examples use current syntax
|
|
222
|
-
- [ ] Main agent context preserved
|
|
223
|
-
</success_criteria>
|