devflow-kit 0.6.0 → 0.7.0
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/CHANGELOG.md +55 -0
- package/README.md +86 -19
- package/dist/commands/init.d.ts.map +1 -1
- package/dist/commands/init.js +42 -9
- package/dist/commands/init.js.map +1 -1
- package/dist/commands/uninstall.d.ts.map +1 -1
- package/dist/commands/uninstall.js +32 -1
- package/dist/commands/uninstall.js.map +1 -1
- package/package.json +1 -1
- package/src/claude/agents/devflow/audit-performance.md +1 -1
- package/src/claude/agents/devflow/audit-security.md +1 -1
- package/src/claude/agents/devflow/brainstorm.md +279 -0
- package/src/claude/agents/devflow/catch-up.md +3 -6
- package/src/claude/agents/devflow/commit.md +3 -5
- package/src/claude/agents/devflow/debug.md +2 -1
- package/src/claude/agents/devflow/design.md +491 -0
- package/src/claude/commands/devflow/brainstorm.md +68 -0
- package/src/claude/commands/devflow/breakdown.md +125 -0
- package/src/claude/commands/devflow/code-review.md +2 -1
- package/src/claude/commands/devflow/commit.md +8 -19
- package/src/claude/commands/devflow/design.md +82 -0
- package/src/claude/commands/devflow/devlog.md +2 -3
- package/src/claude/commands/devflow/implement.md +50 -457
- package/src/claude/commands/devflow/plan.md +133 -395
- package/src/claude/skills/devflow/research/SKILL.md +36 -33
- package/src/claude/agents/devflow/research.md +0 -609
- package/src/claude/commands/devflow/plan-next-steps.md +0 -212
- package/src/claude/commands/devflow/research.md +0 -51
|
@@ -1,212 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
allowed-tools: TodoWrite, Read, Write, Edit, Bash, Grep, Glob
|
|
3
|
-
description: Extract actionable next steps from current discussion and save to todo list
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
## Your task
|
|
7
|
-
|
|
8
|
-
Analyze the current discussion and convert it into specific, actionable next steps that can be saved to the agent's internal todo list using TodoWrite. This command bridges the gap between talking about what to do and actually tracking concrete steps.
|
|
9
|
-
|
|
10
|
-
**🎯 FOCUS**: Turn discussion into trackable action items for the agent's internal todo list.
|
|
11
|
-
|
|
12
|
-
### Step 1: Extract Next Steps from Discussion
|
|
13
|
-
|
|
14
|
-
**FOCUS**: Look at the current discussion and identify concrete next steps that emerged from the conversation.
|
|
15
|
-
|
|
16
|
-
**What to Extract**:
|
|
17
|
-
- **Immediate tasks** mentioned or implied in the discussion
|
|
18
|
-
- **Code changes** that were discussed or agreed upon
|
|
19
|
-
- **Files** that need to be created, modified, or reviewed
|
|
20
|
-
- **Dependencies** that need to be installed or configured
|
|
21
|
-
- **Tests** that need to be written or updated
|
|
22
|
-
- **Documentation** that needs updating
|
|
23
|
-
- **Investigations** or research tasks mentioned
|
|
24
|
-
- **Decisions** that need to be made before proceeding
|
|
25
|
-
|
|
26
|
-
**Look for phrases like**:
|
|
27
|
-
- "We should..."
|
|
28
|
-
- "Next, I'll..."
|
|
29
|
-
- "Let me..."
|
|
30
|
-
- "I need to..."
|
|
31
|
-
- "We could..."
|
|
32
|
-
- "First, we'll..."
|
|
33
|
-
|
|
34
|
-
### Step 2: Convert to Actionable Todo Items
|
|
35
|
-
|
|
36
|
-
Transform the extracted items into specific todo tasks that can be tracked:
|
|
37
|
-
|
|
38
|
-
**Good todo items**:
|
|
39
|
-
- ✅ "Add authentication middleware to routes in `/src/middleware/auth`"
|
|
40
|
-
- ✅ "Write unit tests for user registration in `/tests/auth_test`"
|
|
41
|
-
- ✅ "Install password hashing library dependency"
|
|
42
|
-
- ✅ "Research API schema design for user endpoints"
|
|
43
|
-
- ✅ "Update README.md with new authentication setup instructions"
|
|
44
|
-
|
|
45
|
-
**Bad todo items**:
|
|
46
|
-
- ❌ "Improve authentication" (too vague)
|
|
47
|
-
- ❌ "Add better error handling" (not specific)
|
|
48
|
-
- ❌ "Make it more secure" (not actionable)
|
|
49
|
-
|
|
50
|
-
### Step 3: Save to Todo List with TodoWrite
|
|
51
|
-
|
|
52
|
-
**IMMEDIATELY** use TodoWrite to save the action items to the agent's internal todo list. Each task should:
|
|
53
|
-
- Be specific and testable
|
|
54
|
-
- Include file paths when relevant
|
|
55
|
-
- Be completable in 15-30 minutes
|
|
56
|
-
- Have clear success criteria
|
|
57
|
-
- Start as "pending" status
|
|
58
|
-
|
|
59
|
-
Example todo structure:
|
|
60
|
-
```json
|
|
61
|
-
[
|
|
62
|
-
{
|
|
63
|
-
"content": "Install password hashing library dependency",
|
|
64
|
-
"status": "pending",
|
|
65
|
-
"activeForm": "Installing password hashing library"
|
|
66
|
-
},
|
|
67
|
-
{
|
|
68
|
-
"content": "Create authentication middleware in src/middleware/auth",
|
|
69
|
-
"status": "pending",
|
|
70
|
-
"activeForm": "Creating authentication middleware"
|
|
71
|
-
},
|
|
72
|
-
{
|
|
73
|
-
"content": "Add password hashing to user registration in src/routes/users",
|
|
74
|
-
"status": "pending",
|
|
75
|
-
"activeForm": "Adding password hashing to user registration"
|
|
76
|
-
},
|
|
77
|
-
{
|
|
78
|
-
"content": "Write unit tests for auth middleware in tests/auth_test",
|
|
79
|
-
"status": "pending",
|
|
80
|
-
"activeForm": "Writing unit tests for auth middleware"
|
|
81
|
-
},
|
|
82
|
-
{
|
|
83
|
-
"content": "Update API documentation for new auth endpoints",
|
|
84
|
-
"status": "pending",
|
|
85
|
-
"activeForm": "Updating API documentation"
|
|
86
|
-
}
|
|
87
|
-
]
|
|
88
|
-
```
|
|
89
|
-
|
|
90
|
-
### Step 4: Prioritize the Todo Items
|
|
91
|
-
|
|
92
|
-
Arrange the todo items in logical order:
|
|
93
|
-
1. **Dependencies first** (installations, setup)
|
|
94
|
-
2. **Core implementation** (main functionality)
|
|
95
|
-
3. **Tests and validation** (verification)
|
|
96
|
-
4. **Documentation** (updates, guides)
|
|
97
|
-
5. **Follow-up tasks** (optimizations, research)
|
|
98
|
-
|
|
99
|
-
### Step 5: Present the Todo List
|
|
100
|
-
|
|
101
|
-
Show the developer what was extracted and saved:
|
|
102
|
-
|
|
103
|
-
```markdown
|
|
104
|
-
## 📋 Next Steps Added to Todo List
|
|
105
|
-
|
|
106
|
-
Based on our discussion, I've identified and saved these action items:
|
|
107
|
-
|
|
108
|
-
### Immediate Tasks (Dependencies)
|
|
109
|
-
- [ ] {Task 1}
|
|
110
|
-
- [ ] {Task 2}
|
|
111
|
-
|
|
112
|
-
### Core Implementation
|
|
113
|
-
- [ ] {Task 3}
|
|
114
|
-
- [ ] {Task 4}
|
|
115
|
-
- [ ] {Task 5}
|
|
116
|
-
|
|
117
|
-
### Testing & Validation
|
|
118
|
-
- [ ] {Task 6}
|
|
119
|
-
- [ ] {Task 7}
|
|
120
|
-
|
|
121
|
-
### Documentation
|
|
122
|
-
- [ ] {Task 8}
|
|
123
|
-
|
|
124
|
-
**Total: {X} tasks added to internal todo list**
|
|
125
|
-
**Ready to begin? The agent can now start working through these systematically.**
|
|
126
|
-
```
|
|
127
|
-
|
|
128
|
-
---
|
|
129
|
-
|
|
130
|
-
## Usage Examples
|
|
131
|
-
|
|
132
|
-
### Example 1: After Feature Discussion
|
|
133
|
-
```
|
|
134
|
-
Human: "Add user authentication to our web application"
|
|
135
|
-
AI: "I can help with that. What type of auth do you prefer?"
|
|
136
|
-
Human: "Token-based auth, and we need password reset functionality"
|
|
137
|
-
AI: "Got it. Should I use a password hashing library?"
|
|
138
|
-
Human: "Yes, and integrate with our existing database"
|
|
139
|
-
Developer: "/standup"
|
|
140
|
-
|
|
141
|
-
Result: AI extracts action items from discussion:
|
|
142
|
-
- Install password hashing and token libraries
|
|
143
|
-
- Create user authentication middleware
|
|
144
|
-
- Set up password reset email functionality
|
|
145
|
-
- Create database migration for user auth tables
|
|
146
|
-
- Write unit tests for auth endpoints
|
|
147
|
-
- Update API documentation
|
|
148
|
-
|
|
149
|
-
📋 6 tasks added to internal todo list
|
|
150
|
-
```
|
|
151
|
-
|
|
152
|
-
### Example 2: After Bug Investigation
|
|
153
|
-
```
|
|
154
|
-
Human: "Users are reporting slow page loads on the dashboard"
|
|
155
|
-
AI: "Let me investigate the dashboard queries. I found the issue - it's doing N+1 queries on user data."
|
|
156
|
-
Human: "Can you fix that?"
|
|
157
|
-
AI: "Yes, I'll add proper joins and implement pagination."
|
|
158
|
-
Developer: "/plan-next-steps"
|
|
159
|
-
|
|
160
|
-
Result: AI creates specific action items:
|
|
161
|
-
- Add eager loading to user dashboard query
|
|
162
|
-
- Implement pagination for dashboard data
|
|
163
|
-
- Add database indexes for performance
|
|
164
|
-
- Write performance test for dashboard endpoint
|
|
165
|
-
- Update frontend to handle paginated data
|
|
166
|
-
|
|
167
|
-
📋 5 tasks added to internal todo list
|
|
168
|
-
```
|
|
169
|
-
|
|
170
|
-
### Example 3: After Planning Discussion
|
|
171
|
-
```
|
|
172
|
-
Human: "I want to migrate our REST API to a query-based API"
|
|
173
|
-
AI: "That's a big change. Should we do it gradually?"
|
|
174
|
-
Human: "Yes, start with user endpoints but keep REST for compatibility"
|
|
175
|
-
AI: "I'll create a hybrid approach with both API styles."
|
|
176
|
-
Developer: "/standup"
|
|
177
|
-
|
|
178
|
-
Result: AI saves implementation steps:
|
|
179
|
-
- Install query API framework dependencies
|
|
180
|
-
- Create API schema for user types
|
|
181
|
-
- Implement user query resolvers
|
|
182
|
-
- Set up query endpoint alongside REST
|
|
183
|
-
- Write integration tests for new API
|
|
184
|
-
- Update documentation for new endpoints
|
|
185
|
-
|
|
186
|
-
📋 6 tasks added to internal todo list
|
|
187
|
-
```
|
|
188
|
-
|
|
189
|
-
---
|
|
190
|
-
|
|
191
|
-
## Command Behavior Rules
|
|
192
|
-
|
|
193
|
-
### ALWAYS Do These:
|
|
194
|
-
- ✅ Extract concrete action items from the discussion
|
|
195
|
-
- ✅ Use TodoWrite to save tasks to internal todo list
|
|
196
|
-
- ✅ Break tasks into 15-30 minute chunks
|
|
197
|
-
- ✅ Include file paths and specific details
|
|
198
|
-
- ✅ Prioritize tasks in logical order
|
|
199
|
-
|
|
200
|
-
### NEVER Do These:
|
|
201
|
-
- ❌ Create vague or untestable tasks
|
|
202
|
-
- ❌ Skip obvious implementation steps
|
|
203
|
-
- ❌ Forget to use TodoWrite to save the list
|
|
204
|
-
- ❌ Make tasks too large or complex
|
|
205
|
-
- ❌ Ignore dependencies or prerequisites
|
|
206
|
-
|
|
207
|
-
### Focus Areas:
|
|
208
|
-
- 🎯 **Extract**: Pull concrete next steps from discussion
|
|
209
|
-
- 🎯 **Clarify**: Make each task specific and actionable
|
|
210
|
-
- 🎯 **Save**: Use TodoWrite to store in agent's todo list
|
|
211
|
-
- 🎯 **Present**: Show what was captured for verification
|
|
212
|
-
|
|
@@ -1,51 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
allowed-tools: Task
|
|
3
|
-
description: Comprehensive research workflow before implementation - use '/research [topic or feature description]'
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
## Your task
|
|
7
|
-
|
|
8
|
-
Launch the `research` sub-agent to conduct thorough research for implementing: `$ARGUMENTS`
|
|
9
|
-
|
|
10
|
-
If no arguments provided, prompt the user for the feature or topic to research.
|
|
11
|
-
|
|
12
|
-
### Research Process
|
|
13
|
-
|
|
14
|
-
The research agent will:
|
|
15
|
-
|
|
16
|
-
1. **Analyze Implementation Approaches** - Evaluate multiple solutions, trade-offs, and best practices
|
|
17
|
-
2. **Study Official Documentation** - Find code examples, patterns, and recommended approaches
|
|
18
|
-
3. **Review Codebase Patterns** - Understand existing architecture, conventions, and reusable code
|
|
19
|
-
4. **Design Integration Strategy** - Plan how new code integrates elegantly with existing patterns
|
|
20
|
-
5. **Produce Implementation Plan** - Concrete, actionable plan ready for development
|
|
21
|
-
|
|
22
|
-
### Next: Synthesize Results
|
|
23
|
-
|
|
24
|
-
After the sub-agent completes, present a concise summary to the user:
|
|
25
|
-
|
|
26
|
-
```markdown
|
|
27
|
-
🔬 RESEARCH COMPLETE: $ARGUMENTS
|
|
28
|
-
|
|
29
|
-
## 📊 RECOMMENDED APPROACH
|
|
30
|
-
{Chosen solution with rationale}
|
|
31
|
-
|
|
32
|
-
## 🏗️ INTEGRATION STRATEGY
|
|
33
|
-
{How it fits into existing codebase}
|
|
34
|
-
|
|
35
|
-
## 📝 IMPLEMENTATION PLAN
|
|
36
|
-
{Step-by-step plan with file references}
|
|
37
|
-
|
|
38
|
-
## ⚠️ CONSIDERATIONS
|
|
39
|
-
{Risks, trade-offs, dependencies}
|
|
40
|
-
|
|
41
|
-
## 🔗 KEY REFERENCES
|
|
42
|
-
{Relevant docs, examples, existing code}
|
|
43
|
-
|
|
44
|
-
📄 Full research report available from sub-agent output above
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
💡 **Usage Examples**:
|
|
48
|
-
- `/research authentication with JWT tokens`
|
|
49
|
-
- `/research add dark mode support`
|
|
50
|
-
- `/research implement real-time websocket notifications`
|
|
51
|
-
- `/research migrate from REST to GraphQL`
|