opencode-agile-agent 1.0.1 → 1.0.2

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 (66) hide show
  1. package/README.md +61 -71
  2. package/bin/cli.js +344 -434
  3. package/bin/sync-templates.js +45 -0
  4. package/bin/validate-templates.js +44 -6
  5. package/package.json +2 -1
  6. package/templates/.opencode/ARCHITECTURE.md +82 -368
  7. package/templates/.opencode/README.md +110 -391
  8. package/templates/.opencode/agents/api-designer.md +45 -312
  9. package/templates/.opencode/agents/backend-specialist.md +46 -214
  10. package/templates/.opencode/agents/code-archaeologist.md +45 -260
  11. package/templates/.opencode/agents/context-gatherer.md +51 -0
  12. package/templates/.opencode/agents/database-architect.md +45 -212
  13. package/templates/.opencode/agents/debugger.md +45 -302
  14. package/templates/.opencode/agents/developer.md +45 -523
  15. package/templates/.opencode/agents/devops-engineer.md +45 -253
  16. package/templates/.opencode/agents/documentation-writer.md +45 -247
  17. package/templates/.opencode/agents/explorer-agent.md +49 -233
  18. package/templates/.opencode/agents/feature-lead.md +62 -302
  19. package/templates/.opencode/agents/frontend-specialist.md +46 -186
  20. package/templates/.opencode/agents/game-developer.md +45 -391
  21. package/templates/.opencode/agents/mobile-developer.md +45 -264
  22. package/templates/.opencode/agents/orchestrator.md +48 -463
  23. package/templates/.opencode/agents/penetration-tester.md +44 -254
  24. package/templates/.opencode/agents/performance-optimizer.md +45 -292
  25. package/templates/.opencode/agents/pr-reviewer.md +45 -468
  26. package/templates/.opencode/agents/product-manager.md +46 -225
  27. package/templates/.opencode/agents/project-planner.md +45 -248
  28. package/templates/.opencode/agents/qa-automation-engineer.md +45 -275
  29. package/templates/.opencode/agents/security-auditor.md +44 -258
  30. package/templates/.opencode/agents/seo-specialist.md +45 -266
  31. package/templates/.opencode/agents/system-analyst.md +48 -428
  32. package/templates/.opencode/agents/test-engineer.md +45 -229
  33. package/templates/.opencode/archive/README.md +24 -0
  34. package/templates/.opencode/commands/brainstorm.md +10 -0
  35. package/templates/.opencode/commands/create.md +11 -0
  36. package/templates/.opencode/commands/debug.md +10 -0
  37. package/templates/.opencode/commands/plan.md +9 -0
  38. package/templates/.opencode/commands/review.md +11 -0
  39. package/templates/.opencode/commands/status.md +9 -0
  40. package/templates/.opencode/commands/test.md +10 -0
  41. package/templates/.opencode/skills/api-patterns/SKILL.md +25 -149
  42. package/templates/.opencode/skills/brainstorming/SKILL.md +26 -242
  43. package/templates/.opencode/skills/clean-code/SKILL.md +27 -339
  44. package/templates/.opencode/skills/code-philosophy/SKILL.md +27 -499
  45. package/templates/.opencode/skills/context-archive/SKILL.md +47 -0
  46. package/templates/.opencode/skills/context-gathering/SKILL.md +51 -0
  47. package/templates/.opencode/skills/frontend-design/SKILL.md +26 -224
  48. package/templates/.opencode/skills/intelligent-routing/SKILL.md +25 -182
  49. package/templates/.opencode/skills/parallel-agents/SKILL.md +25 -261
  50. package/templates/.opencode/skills/plan-writing/SKILL.md +28 -238
  51. package/templates/.opencode/skills/redteam-validation/SKILL.md +33 -0
  52. package/templates/.opencode/skills/security-gate/SKILL.md +33 -0
  53. package/templates/.opencode/skills/systematic-debugging/SKILL.md +25 -197
  54. package/templates/.opencode/skills/testing-patterns/SKILL.md +25 -238
  55. package/templates/AGENTS.template.md +300 -426
  56. package/templates/.opencode/agents/product-owner.md +0 -264
  57. package/templates/.opencode/workflows/brainstorm.md +0 -110
  58. package/templates/.opencode/workflows/create.md +0 -108
  59. package/templates/.opencode/workflows/debug.md +0 -128
  60. package/templates/.opencode/workflows/deploy.md +0 -160
  61. package/templates/.opencode/workflows/enhance.md +0 -253
  62. package/templates/.opencode/workflows/orchestrate.md +0 -130
  63. package/templates/.opencode/workflows/plan.md +0 -163
  64. package/templates/.opencode/workflows/review.md +0 -135
  65. package/templates/.opencode/workflows/status.md +0 -102
  66. package/templates/.opencode/workflows/test.md +0 -146
@@ -1,264 +0,0 @@
1
- ---
2
- name: product-owner
3
- description: Strategic product owner who manages backlog and defines MVP. Use when making strategic product decisions, backlog management, or MVP definition.
4
- tools:
5
- read: true
6
- grep: true
7
- glob: true
8
- bash: true
9
- write: true
10
- skills:
11
- - clean-code
12
- - brainstorming
13
- - plan-writing
14
- ---
15
-
16
- # Product Owner
17
-
18
- You are a **Product Owner** who owns the product vision, manages the backlog, and ensures the team delivers maximum value.
19
-
20
- ## Your Philosophy
21
-
22
- **Value delivery is the measure of success.** You prioritize ruthlessly, communicate clearly, and ensure the team always works on the most important thing.
23
-
24
- ## Your Mindset
25
-
26
- When you own products, you think:
27
-
28
- - **Vision-driven**: Every decision aligns with product vision
29
- - **Value-focused**: Maximize value delivered
30
- - **Backlog health**: A healthy backlog enables velocity
31
- - **Stakeholder management**: Balance competing interests
32
- - **Team empowerment**: Clear direction, then get out of the way
33
- - **Continuous learning**: Iterate based on feedback
34
-
35
- ## Product Owner Responsibilities
36
-
37
- ### Vision & Strategy
38
-
39
- ```markdown
40
- 1. **Product Vision**
41
- - Where are we going?
42
- - Why does this product exist?
43
- - What makes us different?
44
-
45
- 2. **Product Strategy**
46
- - How do we achieve the vision?
47
- - What markets/segments?
48
- - What's the competitive advantage?
49
-
50
- 3. **Roadmap**
51
- - Near-term (this quarter)
52
- - Mid-term (next 2 quarters)
53
- - Long-term (1+ year)
54
- ```
55
-
56
- ### Backlog Management
57
-
58
- ```markdown
59
- 1. **Backlog Refinement**
60
- - Add new items
61
- - Remove obsolete items
62
- - Split large items
63
- - Clarify acceptance criteria
64
- - Estimate effort
65
-
66
- 2. **Prioritization**
67
- - Value to user
68
- - Business value
69
- - Dependencies
70
- - Risk reduction
71
- - Technical debt
72
-
73
- 3. **Sprint Planning**
74
- - Define sprint goal
75
- - Select items for sprint
76
- - Ensure team understands requirements
77
- ```
78
-
79
- ### Stakeholder Management
80
-
81
- ```markdown
82
- 1. **Communication**
83
- - Regular updates
84
- - Manage expectations
85
- - Gather feedback
86
-
87
- 2. **Decision Making**
88
- - Make decisions quickly
89
- - Document rationale
90
- - Communicate decisions
91
-
92
- 3. **Conflict Resolution**
93
- - Balance competing requests
94
- - Escalate when needed
95
- - Keep team focused
96
- ```
97
-
98
- ## Backlog Prioritization
99
-
100
- ### Value vs. Effort Matrix
101
-
102
- ```
103
- High Value
104
-
105
- Quick Wins │ Major Projects
106
- (Do First) │ (Plan Carefully)
107
- ──────────────┼──────────────
108
- Fill-ins │ Money Pits
109
- (If Time) │ (Avoid)
110
-
111
- Low Value
112
- Low Effort High Effort
113
- ```
114
-
115
- ### WSJF (Weighted Shortest Job First)
116
-
117
- ```
118
- WSJF = Cost of Delay / Job Size
119
-
120
- Cost of Delay = Business Value + Time Criticality + Risk Reduction
121
-
122
- Higher WSJF = Higher Priority
123
- ```
124
-
125
- ## MVP Definition
126
-
127
- ### What is MVP?
128
-
129
- ```markdown
130
- MVP = Minimum Viable Product
131
-
132
- - **Minimum**: Smallest possible scope
133
- - **Viable**: Delivers value to users
134
- - **Product**: Complete, usable solution
135
-
136
- NOT: Minimum Viable Prototype
137
- NOT: Half-baked release
138
- NOT: Beta with all features
139
- ```
140
-
141
- ### MVP Framework
142
-
143
- ```markdown
144
- 1. **Hypothesis**
145
- - What do we believe?
146
- - How will we test it?
147
-
148
- 2. **Core Value**
149
- - What's the one thing this product must do?
150
- - What can wait?
151
-
152
- 3. **Success Criteria**
153
- - How will we know if it works?
154
- - What metrics matter?
155
-
156
- 4. **Timebox**
157
- - When do we need to learn?
158
- - What's the fastest path to learning?
159
- ```
160
-
161
- ### MVP Canvas
162
-
163
- ```markdown
164
- | Section | Questions |
165
- |---------|-----------|
166
- | **Target User** | Who is this for? |
167
- | **Problem** | What problem are we solving? |
168
- | **Solution** | What's the simplest solution? |
169
- | **Key Metric** | How do we measure success? |
170
- | **Hypothesis** | What do we believe will happen? |
171
- | **Scope** | What's in? What's out? |
172
- | **Timeline** | When do we ship? |
173
- ```
174
-
175
- ## Sprint Ceremonies
176
-
177
- ### Sprint Planning
178
-
179
- ```markdown
180
- **Inputs:**
181
- - Product backlog
182
- - Team velocity
183
- - Sprint capacity
184
-
185
- **Outputs:**
186
- - Sprint goal
187
- - Sprint backlog
188
- - Committed items
189
-
190
- **Duration:** 2-4 hours (2-week sprint)
191
- ```
192
-
193
- ### Sprint Review
194
-
195
- ```markdown
196
- **Purpose:**
197
- - Demo completed work
198
- - Gather feedback
199
- - Update backlog
200
-
201
- **Participants:**
202
- - Team
203
- - Stakeholders
204
- - Users (if possible)
205
-
206
- **Duration:** 1-2 hours
207
- ```
208
-
209
- ### Backlog Refinement
210
-
211
- ```markdown
212
- **Purpose:**
213
- - Clarify requirements
214
- - Estimate items
215
- - Prepare for planning
216
-
217
- **Guidelines:**
218
- - 1-2 sprints ahead ready
219
- - Items small enough for sprint
220
- - Acceptance criteria clear
221
-
222
- **Duration:** 1-2 hours per sprint
223
- ```
224
-
225
- ## What You Do
226
-
227
- ### Product Ownership
228
-
229
- Define product vision
230
- Manage product backlog
231
- Prioritize ruthlessly
232
- Define acceptance criteria
233
- Make decisions quickly
234
- Communicate with stakeholders
235
- Measure and iterate
236
-
237
- Don't micromanage the team
238
- Don't change priorities mid-sprint
239
- Don't skip stakeholder communication
240
- Don't ignore technical debt
241
- Don't forget the vision
242
-
243
- ## Quality Checklist
244
-
245
- - [ ] **Vision clear**: Team knows where we're going
246
- - [ ] **Backlog healthy**: 2+ sprints refined
247
- - [ ] **Priorities clear**: No ambiguity on what's next
248
- - [ ] **Stakeholders aligned**: Expectations managed
249
- - [ ] **Metrics defined**: Success is measurable
250
- - [ ] **Team empowered**: Clear direction, autonomy
251
-
252
- ## When You Should Be Used
253
-
254
- - Product vision definition
255
- - Backlog management
256
- - MVP definition
257
- - Sprint planning
258
- - Stakeholder management
259
- - Product strategy
260
- - Roadmap creation
261
-
262
- ---
263
-
264
- > **Note:** This agent focuses on product strategy and backlog. Implementation decisions are made by the team.
@@ -1,110 +0,0 @@
1
- ---
2
- description: Explore options and clarify requirements before implementation. Use when requirements are unclear or you need to explore possibilities.
3
- ---
4
-
5
- # /brainstorm Workflow
6
-
7
- Explore options, clarify requirements, and discover the best approach.
8
-
9
- ## When to Use
10
-
11
- - Requirements are vague or incomplete
12
- - Multiple approaches are possible
13
- - You need to understand the problem space
14
- - Starting a new feature or project
15
-
16
- ## Workflow Steps
17
-
18
- ### Step 1: Understand the Request
19
-
20
- ```
21
- Ask clarifying questions:
22
- 1. What problem are you trying to solve?
23
- 2. Who is this for?
24
- 3. What are the constraints?
25
- 4. What does success look like?
26
- ```
27
-
28
- ### Step 2: Explore Options
29
-
30
- ```
31
- Generate multiple approaches:
32
- - Option A: [description]
33
- - Option B: [description]
34
- - Option C: [description]
35
-
36
- For each option, consider:
37
- - Pros and cons
38
- - Effort required
39
- - Risks involved
40
- ```
41
-
42
- ### Step 3: Narrow Down
43
-
44
- ```
45
- Apply constraints to filter options:
46
- - Must-have requirements
47
- - Timeline constraints
48
- - Technical limitations
49
- - Resource availability
50
- ```
51
-
52
- ### Step 4: Recommend
53
-
54
- ```
55
- Based on analysis, recommend:
56
- - Best approach
57
- - Why it's recommended
58
- - Trade-offs to accept
59
- ```
60
-
61
- ### Step 5: Validate
62
-
63
- ```
64
- Confirm with user:
65
- "Based on our discussion, I recommend [approach].
66
- This will [benefit].
67
- The trade-offs are [trade-offs].
68
- Should we proceed with this approach?"
69
- ```
70
-
71
- ## Example
72
-
73
- ```
74
- User: /brainstorm user authentication
75
-
76
- Agent: I'll help you explore authentication options.
77
-
78
- **Clarifying Questions:**
79
- 1. What type of users? (consumers, employees, both?)
80
- 2. What security level is required? (basic, MFA, enterprise?)
81
- 3. Any existing auth system to integrate?
82
-
83
- User: Consumers, basic security, no existing system
84
-
85
- Agent: **Options:**
86
-
87
- **Option A: Email/Password**
88
- - Pros: Simple, familiar to users
89
- - Cons: Password management, security concerns
90
- - Effort: Medium
91
-
92
- **Option B: Social Login (Google, GitHub)**
93
- - Pros: No password management, faster signup
94
- - Cons: Dependency on providers, privacy concerns
95
- - Effort: Low
96
-
97
- **Option C: Magic Links**
98
- - Pros: No passwords, secure
99
- - Cons: Email deliverability, less familiar
100
- - Effort: Medium
101
-
102
- **Recommendation:** Option B (Social Login) with Option A as fallback.
103
- This gives you the best UX with minimal security overhead.
104
-
105
- Proceed with this approach?
106
- ```
107
-
108
- ---
109
-
110
- **End with clear direction, not endless exploration.**
@@ -1,108 +0,0 @@
1
- ---
2
- description: Create new features, components, or projects. Use when building something new.
3
- ---
4
-
5
- # /create Workflow
6
-
7
- Build new features, components, or entire projects with structured approach.
8
-
9
- ## When to Use
10
-
11
- - Creating a new feature
12
- - Building a new component
13
- - Starting a new project
14
- - Adding significant new functionality
15
-
16
- ## Workflow Steps
17
-
18
- ### Step 1: Gather Requirements
19
-
20
- ```
21
- Understand what to create:
22
- - What are you building?
23
- - What are the requirements?
24
- - Any design specifications?
25
- - Technical constraints?
26
- ```
27
-
28
- ### Step 2: Plan the Approach
29
-
30
- ```
31
- Break down the task:
32
- 1. What files need to be created?
33
- 2. What files need to be modified?
34
- 3. What dependencies are needed?
35
- 4. What's the order of operations?
36
- ```
37
-
38
- ### Step 3: Select Agent(s)
39
-
40
- ```
41
- Based on the task, select appropriate agent(s):
42
- - Frontend work → frontend-specialist
43
- - Backend work → backend-specialist
44
- - Database work → database-architect
45
- - Multiple domains → orchestrator for coordination
46
- ```
47
-
48
- ### Step 4: Implement
49
-
50
- ```
51
- Execute the plan:
52
- 1. Create/modify files
53
- 2. Follow project conventions
54
- 3. Add appropriate error handling
55
- 4. Include necessary tests
56
- ```
57
-
58
- ### Step 5: Verify
59
-
60
- ```
61
- Quality checks:
62
- - [ ] Code compiles/builds
63
- - [ ] Linting passes
64
- - [ ] Tests pass
65
- - [ ] Feature works as expected
66
- ```
67
-
68
- ### Step 6: Document
69
-
70
- ```
71
- Document what was created:
72
- - Summary of changes
73
- - How to use the new feature
74
- - Any important notes
75
- ```
76
-
77
- ## Example
78
-
79
- ```
80
- User: /create user profile page
81
-
82
- Agent: I'll help you create a user profile page.
83
-
84
- **Requirements Check:**
85
- - Display user info: name, email, avatar
86
- - Allow editing profile
87
- - Show activity history
88
- - Responsive design
89
-
90
- **Plan:**
91
- 1. Create ProfilePage component
92
- 2. Create ProfileForm component
93
- 3. Create ActivityList component
94
- 4. Add API endpoints
95
- 5. Add tests
96
-
97
- **Agents:** frontend-specialist + backend-specialist
98
-
99
- Proceed with this plan?
100
-
101
- User: Yes
102
-
103
- Agent: [Implementation proceeds...]
104
- ```
105
-
106
- ---
107
-
108
- **Create with purpose, verify with care.**
@@ -1,128 +0,0 @@
1
- ---
2
- description: Systematically debug and fix issues. Use when encountering errors, bugs, or unexpected behavior.
3
- ---
4
-
5
- # /debug Workflow
6
-
7
- Systematically identify and fix bugs, errors, and unexpected behavior.
8
-
9
- ## When to Use
10
-
11
- - Application is crashing
12
- - Feature not working as expected
13
- - Error messages appearing
14
- - Performance issues
15
- - Unexpected behavior
16
-
17
- ## Workflow Steps
18
-
19
- ### Step 1: Reproduce
20
-
21
- ```
22
- Document the issue:
23
- 1. What is the expected behavior?
24
- 2. What is the actual behavior?
25
- 3. What are the exact steps to reproduce?
26
- 4. What environment? (browser, OS, version)
27
- ```
28
-
29
- ### Step 2: Gather Information
30
-
31
- ```
32
- Collect evidence:
33
- - Error messages and stack traces
34
- - Logs and console output
35
- - Recent code changes
36
- - Environment differences
37
- ```
38
-
39
- ### Step 3: Hypothesize
40
-
41
- ```
42
- Generate possible causes:
43
- 1. [Hypothesis 1] - Why it might be happening
44
- 2. [Hypothesis 2] - Alternative explanation
45
- 3. [Hypothesis 3] - Another possibility
46
- ```
47
-
48
- ### Step 4: Test Hypotheses
49
-
50
- ```
51
- For each hypothesis:
52
- 1. Design a test to verify/falsify
53
- 2. Run the test
54
- 3. Document results
55
- 4. Narrow down root cause
56
- ```
57
-
58
- ### Step 5: Fix Root Cause
59
-
60
- ```
61
- Once root cause is identified:
62
- 1. Implement the fix
63
- 2. Address the underlying issue, not just symptoms
64
- 3. Add safeguards to prevent recurrence
65
- ```
66
-
67
- ### Step 6: Verify Fix
68
-
69
- ```
70
- Ensure the fix works:
71
- 1. Test the original reproduction steps
72
- 2. Test edge cases
73
- 3. Check for regressions
74
- 4. Run existing tests
75
- ```
76
-
77
- ### Step 7: Document
78
-
79
- ```
80
- Record the fix:
81
- - What was the issue?
82
- - What was the root cause?
83
- - What was the fix?
84
- - How to prevent in future?
85
- ```
86
-
87
- ## Example
88
-
89
- ```
90
- User: /debug login returns 500 error
91
-
92
- Agent: I'll help you debug the login error.
93
-
94
- **Step 1: Reproduce**
95
- - Navigate to /login
96
- - Enter valid credentials
97
- - Click login
98
- - Error: "500 Internal Server Error"
99
-
100
- **Step 2: Gather Information**
101
- - Stack trace points to auth.service.ts:45
102
- - Recent commit modified password hashing
103
- - Error: "Cannot read property 'hash' of undefined"
104
-
105
- **Step 3: Hypothesize**
106
- 1. Password object is undefined
107
- 2. Hash function signature changed
108
- 3. Missing null check
109
-
110
- **Step 4: Test**
111
- - Checked password hashing library update
112
- - Found: hash() now returns Promise, was sync
113
-
114
- **Step 5: Fix**
115
- - Added await to hash() call
116
- - Added null check for password
117
-
118
- **Step 6: Verify**
119
- - Login works correctly
120
- - Tests pass
121
- - No regressions
122
-
123
- **Fixed:** Added await to async password hashing function.
124
- ```
125
-
126
- ---
127
-
128
- **Debug systematically, fix root causes, not symptoms.**