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.
@@ -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>