opencode-agile-agent 1.0.1 → 1.0.3
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 +65 -71
- package/bin/cli.js +342 -431
- package/bin/sync-templates.js +45 -0
- package/bin/validate-templates.js +44 -6
- package/package.json +2 -1
- package/templates/.opencode/ARCHITECTURE.md +82 -368
- package/templates/.opencode/README.md +110 -391
- package/templates/.opencode/agents/api-designer.md +45 -312
- package/templates/.opencode/agents/backend-specialist.md +46 -214
- package/templates/.opencode/agents/code-archaeologist.md +45 -260
- package/templates/.opencode/agents/context-gatherer.md +51 -0
- package/templates/.opencode/agents/database-architect.md +45 -212
- package/templates/.opencode/agents/debugger.md +45 -302
- package/templates/.opencode/agents/developer.md +45 -523
- package/templates/.opencode/agents/devops-engineer.md +45 -253
- package/templates/.opencode/agents/documentation-writer.md +45 -247
- package/templates/.opencode/agents/explorer-agent.md +49 -233
- package/templates/.opencode/agents/feature-lead.md +62 -302
- package/templates/.opencode/agents/frontend-specialist.md +46 -186
- package/templates/.opencode/agents/game-developer.md +45 -391
- package/templates/.opencode/agents/mobile-developer.md +45 -264
- package/templates/.opencode/agents/orchestrator.md +48 -463
- package/templates/.opencode/agents/penetration-tester.md +44 -254
- package/templates/.opencode/agents/performance-optimizer.md +45 -292
- package/templates/.opencode/agents/pr-reviewer.md +45 -468
- package/templates/.opencode/agents/product-manager.md +46 -225
- package/templates/.opencode/agents/project-planner.md +45 -248
- package/templates/.opencode/agents/qa-automation-engineer.md +45 -275
- package/templates/.opencode/agents/security-auditor.md +44 -258
- package/templates/.opencode/agents/seo-specialist.md +45 -266
- package/templates/.opencode/agents/system-analyst.md +48 -428
- package/templates/.opencode/agents/test-engineer.md +45 -229
- package/templates/.opencode/archive/README.md +24 -0
- package/templates/.opencode/commands/brainstorm.md +10 -0
- package/templates/.opencode/commands/create.md +11 -0
- package/templates/.opencode/commands/debug.md +10 -0
- package/templates/.opencode/commands/plan.md +9 -0
- package/templates/.opencode/commands/review.md +11 -0
- package/templates/.opencode/commands/status.md +9 -0
- package/templates/.opencode/commands/test.md +10 -0
- package/templates/.opencode/skills/api-patterns/SKILL.md +25 -149
- package/templates/.opencode/skills/brainstorming/SKILL.md +26 -242
- package/templates/.opencode/skills/clean-code/SKILL.md +27 -339
- package/templates/.opencode/skills/code-philosophy/SKILL.md +27 -499
- package/templates/.opencode/skills/context-archive/SKILL.md +47 -0
- package/templates/.opencode/skills/context-gathering/SKILL.md +51 -0
- package/templates/.opencode/skills/frontend-design/SKILL.md +26 -224
- package/templates/.opencode/skills/intelligent-routing/SKILL.md +25 -182
- package/templates/.opencode/skills/parallel-agents/SKILL.md +25 -261
- package/templates/.opencode/skills/plan-writing/SKILL.md +28 -238
- package/templates/.opencode/skills/redteam-validation/SKILL.md +33 -0
- package/templates/.opencode/skills/security-gate/SKILL.md +33 -0
- package/templates/.opencode/skills/systematic-debugging/SKILL.md +25 -197
- package/templates/.opencode/skills/testing-patterns/SKILL.md +25 -238
- package/templates/AGENTS.template.md +300 -426
- package/templates/.opencode/agents/product-owner.md +0 -264
- package/templates/.opencode/workflows/brainstorm.md +0 -110
- package/templates/.opencode/workflows/create.md +0 -108
- package/templates/.opencode/workflows/debug.md +0 -128
- package/templates/.opencode/workflows/deploy.md +0 -160
- package/templates/.opencode/workflows/enhance.md +0 -253
- package/templates/.opencode/workflows/orchestrate.md +0 -130
- package/templates/.opencode/workflows/plan.md +0 -163
- package/templates/.opencode/workflows/review.md +0 -135
- package/templates/.opencode/workflows/status.md +0 -102
- package/templates/.opencode/workflows/test.md +0 -146
|
@@ -1,135 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Code review workflow for validating implementations. Use when reviewing code quality and standards compliance.
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /review Workflow
|
|
6
|
-
|
|
7
|
-
Comprehensive code review against project standards and best practices.
|
|
8
|
-
|
|
9
|
-
## When to Use
|
|
10
|
-
|
|
11
|
-
- After completing implementation
|
|
12
|
-
- Before merging PRs
|
|
13
|
-
- Quality assurance
|
|
14
|
-
- Standards compliance check
|
|
15
|
-
|
|
16
|
-
## Workflow Steps
|
|
17
|
-
|
|
18
|
-
### Step 1: Identify Scope
|
|
19
|
-
|
|
20
|
-
```
|
|
21
|
-
What to review:
|
|
22
|
-
- Recent changes
|
|
23
|
-
- Specific files
|
|
24
|
-
- Full codebase
|
|
25
|
-
- Specific concerns (security, performance, etc.)
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
### Step 2: Run Automated Checks
|
|
29
|
-
|
|
30
|
-
```
|
|
31
|
-
Automated quality gates:
|
|
32
|
-
- [ ] Linting passes
|
|
33
|
-
- [ ] TypeScript compiles
|
|
34
|
-
- [ ] Tests pass
|
|
35
|
-
- [ ] No security vulnerabilities
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
### Step 3: Manual Review
|
|
39
|
-
|
|
40
|
-
```
|
|
41
|
-
Code quality review:
|
|
42
|
-
- [ ] Code follows project conventions
|
|
43
|
-
- [ ] No anti-patterns detected
|
|
44
|
-
- [ ] Proper error handling
|
|
45
|
-
- [ ] Appropriate abstractions
|
|
46
|
-
- [ ] Clear naming
|
|
47
|
-
- [ ] Adequate comments
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
### Step 4: Domain-Specific Review
|
|
51
|
-
|
|
52
|
-
```
|
|
53
|
-
Based on code type:
|
|
54
|
-
- Frontend: Accessibility, performance, responsive
|
|
55
|
-
- Backend: Security, error handling, validation
|
|
56
|
-
- Database: Indexes, query efficiency, migrations
|
|
57
|
-
```
|
|
58
|
-
|
|
59
|
-
### Step 5: Generate Report
|
|
60
|
-
|
|
61
|
-
```
|
|
62
|
-
Review summary:
|
|
63
|
-
- Overall assessment
|
|
64
|
-
- Issues found (critical, major, minor)
|
|
65
|
-
- Recommendations
|
|
66
|
-
- Approval status
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
## Review Checklist
|
|
70
|
-
|
|
71
|
-
### General
|
|
72
|
-
- [ ] Code is readable and maintainable
|
|
73
|
-
- [ ] Functions have single responsibility
|
|
74
|
-
- [ ] No code duplication
|
|
75
|
-
- [ ] Proper error handling
|
|
76
|
-
- [ ] Appropriate logging
|
|
77
|
-
|
|
78
|
-
### Security
|
|
79
|
-
- [ ] No hardcoded secrets
|
|
80
|
-
- [ ] Input validation present
|
|
81
|
-
- [ ] Proper authentication checks
|
|
82
|
-
- [ ] SQL injection prevention
|
|
83
|
-
- [ ] XSS prevention
|
|
84
|
-
|
|
85
|
-
### Performance
|
|
86
|
-
- [ ] No N+1 queries
|
|
87
|
-
- [ ] Appropriate caching
|
|
88
|
-
- [ ] No memory leaks
|
|
89
|
-
- [ ] Efficient algorithms
|
|
90
|
-
|
|
91
|
-
### Testing
|
|
92
|
-
- [ ] Adequate test coverage
|
|
93
|
-
- [ ] Tests are meaningful
|
|
94
|
-
- [ ] Edge cases covered
|
|
95
|
-
|
|
96
|
-
## Example
|
|
97
|
-
|
|
98
|
-
```
|
|
99
|
-
User: /review recent changes
|
|
100
|
-
|
|
101
|
-
Agent: I'll review the recent changes.
|
|
102
|
-
|
|
103
|
-
**Scope:** Last 5 commits (auth feature)
|
|
104
|
-
|
|
105
|
-
**Automated Checks:**
|
|
106
|
-
- [x] Lint: Pass
|
|
107
|
-
- [x] TypeScript: Pass
|
|
108
|
-
- [x] Tests: 12/12 Pass
|
|
109
|
-
- [x] Security: No vulnerabilities
|
|
110
|
-
|
|
111
|
-
**Code Review:**
|
|
112
|
-
|
|
113
|
-
✅ Good:
|
|
114
|
-
- Clear function naming
|
|
115
|
-
- Proper error handling
|
|
116
|
-
- Tests for edge cases
|
|
117
|
-
|
|
118
|
-
⚠️ Issues Found:
|
|
119
|
-
|
|
120
|
-
[MAJOR] auth.service.ts:45
|
|
121
|
-
- Password comparison not timing-safe
|
|
122
|
-
- Recommendation: Use bcrypt.compare()
|
|
123
|
-
|
|
124
|
-
[MINOR] login.tsx:23
|
|
125
|
-
- Missing loading state during submission
|
|
126
|
-
- Recommendation: Add isSubmitting state
|
|
127
|
-
|
|
128
|
-
**Verdict: CHANGES REQUESTED**
|
|
129
|
-
|
|
130
|
-
Please address the timing-safe comparison issue before merging.
|
|
131
|
-
```
|
|
132
|
-
|
|
133
|
-
---
|
|
134
|
-
|
|
135
|
-
**Review catches what automation misses.**
|
|
@@ -1,102 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Check project status, health, and metrics. Use for quick project overview.
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /status Workflow
|
|
6
|
-
|
|
7
|
-
Get a quick overview of project status, health, and key metrics.
|
|
8
|
-
|
|
9
|
-
## When to Use
|
|
10
|
-
|
|
11
|
-
- Starting a work session
|
|
12
|
-
- Quick project health check
|
|
13
|
-
- Before/after changes
|
|
14
|
-
- Daily standup preparation
|
|
15
|
-
|
|
16
|
-
## Workflow Steps
|
|
17
|
-
|
|
18
|
-
### Step 1: Analyze Codebase
|
|
19
|
-
|
|
20
|
-
```
|
|
21
|
-
Gather information:
|
|
22
|
-
- Project structure
|
|
23
|
-
- Technology stack
|
|
24
|
-
- File counts
|
|
25
|
-
- Code statistics
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
### Step 2: Check Quality
|
|
29
|
-
|
|
30
|
-
```
|
|
31
|
-
Run quality checks:
|
|
32
|
-
- Linting status
|
|
33
|
-
- Type check status
|
|
34
|
-
- Test status
|
|
35
|
-
- Build status
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
### Step 3: Check Dependencies
|
|
39
|
-
|
|
40
|
-
```
|
|
41
|
-
Review dependencies:
|
|
42
|
-
- Outdated packages
|
|
43
|
-
- Security vulnerabilities
|
|
44
|
-
- Unused dependencies
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
### Step 4: Generate Report
|
|
48
|
-
|
|
49
|
-
```
|
|
50
|
-
Create status summary:
|
|
51
|
-
- Project health score
|
|
52
|
-
- Key metrics
|
|
53
|
-
- Recommendations
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
## Example Output
|
|
57
|
-
|
|
58
|
-
```markdown
|
|
59
|
-
# Project Status
|
|
60
|
-
|
|
61
|
-
## Overview
|
|
62
|
-
- **Type**: Next.js Application
|
|
63
|
-
- **Framework**: React 18
|
|
64
|
-
- **Language**: TypeScript
|
|
65
|
-
|
|
66
|
-
## Statistics
|
|
67
|
-
- Files: 245
|
|
68
|
-
- Lines of code: ~15,000
|
|
69
|
-
- Components: 42
|
|
70
|
-
- Pages: 12
|
|
71
|
-
- API Routes: 8
|
|
72
|
-
|
|
73
|
-
## Quality Checks
|
|
74
|
-
| Check | Status |
|
|
75
|
-
|-------|--------|
|
|
76
|
-
| Lint | ✅ Pass |
|
|
77
|
-
| TypeScript | ✅ Pass |
|
|
78
|
-
| Tests | ✅ 156/156 |
|
|
79
|
-
| Build | ✅ Success |
|
|
80
|
-
|
|
81
|
-
## Dependencies
|
|
82
|
-
- **Total**: 48
|
|
83
|
-
- **Outdated**: 3
|
|
84
|
-
- **Vulnerabilities**: 0
|
|
85
|
-
|
|
86
|
-
## Test Coverage
|
|
87
|
-
- Statements: 82%
|
|
88
|
-
- Branches: 78%
|
|
89
|
-
- Functions: 85%
|
|
90
|
-
- Lines: 81%
|
|
91
|
-
|
|
92
|
-
## Recommendations
|
|
93
|
-
1. Update 3 outdated packages
|
|
94
|
-
2. Improve branch coverage to 80%+
|
|
95
|
-
3. Consider adding E2E tests
|
|
96
|
-
|
|
97
|
-
## Health Score: 85/100
|
|
98
|
-
```
|
|
99
|
-
|
|
100
|
-
---
|
|
101
|
-
|
|
102
|
-
**Know your project's health at a glance.**
|
|
@@ -1,146 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Run and generate tests for the codebase. Use when adding test coverage or running test suites.
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /test Workflow
|
|
6
|
-
|
|
7
|
-
Generate, run, and manage tests for your codebase.
|
|
8
|
-
|
|
9
|
-
## When to Use
|
|
10
|
-
|
|
11
|
-
- Running test suites
|
|
12
|
-
- Adding test coverage
|
|
13
|
-
- Fixing failing tests
|
|
14
|
-
- Setting up testing infrastructure
|
|
15
|
-
|
|
16
|
-
## Workflow Steps
|
|
17
|
-
|
|
18
|
-
### Step 1: Identify Test Scope
|
|
19
|
-
|
|
20
|
-
```
|
|
21
|
-
What to test:
|
|
22
|
-
- Specific files or functions?
|
|
23
|
-
- Full test suite?
|
|
24
|
-
- Integration tests?
|
|
25
|
-
- E2E tests?
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
### Step 2: Run Tests
|
|
29
|
-
|
|
30
|
-
```bash
|
|
31
|
-
# Unit tests
|
|
32
|
-
npm test
|
|
33
|
-
|
|
34
|
-
# With coverage
|
|
35
|
-
npm run test:coverage
|
|
36
|
-
|
|
37
|
-
# Watch mode
|
|
38
|
-
npm run test:watch
|
|
39
|
-
|
|
40
|
-
# E2E tests
|
|
41
|
-
npm run test:e2e
|
|
42
|
-
```
|
|
43
|
-
|
|
44
|
-
### Step 3: Analyze Results
|
|
45
|
-
|
|
46
|
-
```
|
|
47
|
-
Review results:
|
|
48
|
-
- Which tests passed?
|
|
49
|
-
- Which tests failed?
|
|
50
|
-
- What's the coverage?
|
|
51
|
-
- Are there flaky tests?
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
### Step 4: Fix or Add Tests
|
|
55
|
-
|
|
56
|
-
```
|
|
57
|
-
For failing tests:
|
|
58
|
-
1. Identify the cause
|
|
59
|
-
2. Fix the code or test
|
|
60
|
-
3. Verify fix
|
|
61
|
-
|
|
62
|
-
For missing coverage:
|
|
63
|
-
1. Identify uncovered code
|
|
64
|
-
2. Write appropriate tests
|
|
65
|
-
3. Verify coverage improvement
|
|
66
|
-
```
|
|
67
|
-
|
|
68
|
-
## Test Types
|
|
69
|
-
|
|
70
|
-
### Unit Tests
|
|
71
|
-
|
|
72
|
-
```typescript
|
|
73
|
-
describe('calculateTotal', () => {
|
|
74
|
-
it('should sum item prices', () => {
|
|
75
|
-
const items = [{ price: 10 }, { price: 20 }];
|
|
76
|
-
expect(calculateTotal(items)).toBe(30);
|
|
77
|
-
});
|
|
78
|
-
|
|
79
|
-
it('should handle empty array', () => {
|
|
80
|
-
expect(calculateTotal([])).toBe(0);
|
|
81
|
-
});
|
|
82
|
-
});
|
|
83
|
-
```
|
|
84
|
-
|
|
85
|
-
### Integration Tests
|
|
86
|
-
|
|
87
|
-
```typescript
|
|
88
|
-
describe('POST /api/users', () => {
|
|
89
|
-
it('should create user', async () => {
|
|
90
|
-
const response = await request(app)
|
|
91
|
-
.post('/api/users')
|
|
92
|
-
.send({ name: 'Test', email: 'test@example.com' });
|
|
93
|
-
|
|
94
|
-
expect(response.status).toBe(201);
|
|
95
|
-
expect(response.body.name).toBe('Test');
|
|
96
|
-
});
|
|
97
|
-
});
|
|
98
|
-
```
|
|
99
|
-
|
|
100
|
-
## Example
|
|
101
|
-
|
|
102
|
-
```
|
|
103
|
-
User: /test checkout flow
|
|
104
|
-
|
|
105
|
-
Agent: I'll help you test the checkout flow.
|
|
106
|
-
|
|
107
|
-
**Test Scope:**
|
|
108
|
-
- Unit tests for calculation functions
|
|
109
|
-
- Integration tests for API endpoints
|
|
110
|
-
- E2E test for full checkout flow
|
|
111
|
-
|
|
112
|
-
**Running Tests:**
|
|
113
|
-
|
|
114
|
-
[Unit Tests] calculateTotal
|
|
115
|
-
✅ should sum item prices
|
|
116
|
-
✅ should apply discounts
|
|
117
|
-
✅ should handle empty cart
|
|
118
|
-
|
|
119
|
-
[Unit Tests] validatePayment
|
|
120
|
-
✅ should validate card number
|
|
121
|
-
✅ should reject invalid cards
|
|
122
|
-
|
|
123
|
-
[Integration Tests] POST /api/checkout
|
|
124
|
-
✅ should process payment
|
|
125
|
-
❌ should send confirmation email
|
|
126
|
-
|
|
127
|
-
**Failed Test:**
|
|
128
|
-
- should send confirmation email
|
|
129
|
-
- Error: Email service not mocked
|
|
130
|
-
- Fix: Add mock for email service
|
|
131
|
-
|
|
132
|
-
**Coverage:**
|
|
133
|
-
- Statements: 82%
|
|
134
|
-
- Branches: 78%
|
|
135
|
-
- Functions: 85%
|
|
136
|
-
- Lines: 81%
|
|
137
|
-
|
|
138
|
-
**Next Steps:**
|
|
139
|
-
1. Fix failing email test
|
|
140
|
-
2. Add E2E test for full flow
|
|
141
|
-
3. Improve branch coverage
|
|
142
|
-
```
|
|
143
|
-
|
|
144
|
-
---
|
|
145
|
-
|
|
146
|
-
**Tests enable confident refactoring.**
|