opencode-cc10x 6.0.21
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/LICENSE +21 -0
- package/README.md +283 -0
- package/bun.lock +20 -0
- package/dist/agents.d.ts +3 -0
- package/dist/agents.d.ts.map +1 -0
- package/dist/agents.js +483 -0
- package/dist/agents.js.map +1 -0
- package/dist/compatibility-layer.d.ts +18 -0
- package/dist/compatibility-layer.d.ts.map +1 -0
- package/dist/compatibility-layer.js +150 -0
- package/dist/compatibility-layer.js.map +1 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +1459 -0
- package/dist/index.js.map +1 -0
- package/dist/intent-detection.d.ts +14 -0
- package/dist/intent-detection.d.ts.map +1 -0
- package/dist/intent-detection.js +121 -0
- package/dist/intent-detection.js.map +1 -0
- package/dist/memory.d.ts +41 -0
- package/dist/memory.d.ts.map +1 -0
- package/dist/memory.js +330 -0
- package/dist/memory.js.map +1 -0
- package/dist/router.d.ts +15 -0
- package/dist/router.d.ts.map +1 -0
- package/dist/router.js +208 -0
- package/dist/router.js.map +1 -0
- package/dist/skills.d.ts +3 -0
- package/dist/skills.d.ts.map +1 -0
- package/dist/skills.js +2790 -0
- package/dist/skills.js.map +1 -0
- package/dist/task-orchestrator.d.ts +46 -0
- package/dist/task-orchestrator.d.ts.map +1 -0
- package/dist/task-orchestrator.js +262 -0
- package/dist/task-orchestrator.js.map +1 -0
- package/dist/workflow-executor.d.ts +29 -0
- package/dist/workflow-executor.d.ts.map +1 -0
- package/dist/workflow-executor.js +414 -0
- package/dist/workflow-executor.js.map +1 -0
- package/install-from-github.mjs +152 -0
- package/install-from-github.sh +106 -0
- package/install.sh +295 -0
- package/opencode.json +118 -0
- package/package.json +41 -0
- package/tsconfig.json +23 -0
package/dist/skills.js
ADDED
|
@@ -0,0 +1,2790 @@
|
|
|
1
|
+
export const skillDefinitions = [
|
|
2
|
+
{
|
|
3
|
+
name: 'cc10x-session-memory',
|
|
4
|
+
description: 'MANDATORY: Load and update .claude/cc10x/ memory files. All cc10x agents use this for persistence.',
|
|
5
|
+
license: 'MIT',
|
|
6
|
+
compatibility: 'opencode',
|
|
7
|
+
metadata: {
|
|
8
|
+
audience: 'cc10x-agents',
|
|
9
|
+
purpose: 'memory-persistence',
|
|
10
|
+
required: 'true'
|
|
11
|
+
},
|
|
12
|
+
content: `# Session Memory (MANDATORY)
|
|
13
|
+
|
|
14
|
+
## The Iron Law
|
|
15
|
+
EVERY WORKFLOW MUST:
|
|
16
|
+
1. LOAD memory at START (and before key decisions)
|
|
17
|
+
2. UPDATE memory at END (and after learnings/decisions)
|
|
18
|
+
|
|
19
|
+
**Brevity Rule:** Memory is an index, not a document. Be brief—one line per item.
|
|
20
|
+
|
|
21
|
+
## Memory Surfaces (Types)
|
|
22
|
+
1. **Index / Working Memory**: .claude/cc10x/activeContext.md
|
|
23
|
+
- "What matters right now": focus, next steps, active decisions, learnings
|
|
24
|
+
- Links to durable artifacts (plans/research)
|
|
25
|
+
2. **Long-Term Project Memory**: .claude/cc10x/patterns.md
|
|
26
|
+
- Conventions, architecture decisions, common gotchas, reusable solutions
|
|
27
|
+
3. **Progress + Evidence Memory**: .claude/cc10x/progress.md
|
|
28
|
+
- What's done/remaining + verification evidence (commands + exit codes)
|
|
29
|
+
4. **Artifact Memory (Durable)**: docs/plans/*, docs/research/*
|
|
30
|
+
5. **Tasks (Execution State)**: OpenCode Tasks
|
|
31
|
+
|
|
32
|
+
## Permission-Free Operations
|
|
33
|
+
- Create memory directory: Bash(command="mkdir -p .claude/cc10x")
|
|
34
|
+
- **Read memory files**: Read tool (FREE)
|
|
35
|
+
- **Create NEW memory file**: Write tool (FREE if file doesn't exist)
|
|
36
|
+
- **Update EXISTING memory**: Edit tool (FREE - no permission prompt)
|
|
37
|
+
|
|
38
|
+
**CRITICAL: Use Write for NEW files, Edit for UPDATES.**
|
|
39
|
+
|
|
40
|
+
## At Workflow START (REQUIRED)
|
|
41
|
+
1. Bash(command="mkdir -p .claude/cc10x")
|
|
42
|
+
2. Read(file_path=".claude/cc10x/activeContext.md")
|
|
43
|
+
3. Read(file_path=".claude/cc10x/patterns.md")
|
|
44
|
+
4. Read(file_path=".claude/cc10x/progress.md")
|
|
45
|
+
|
|
46
|
+
## At Workflow END (REQUIRED)
|
|
47
|
+
Use Edit tool (NO permission prompt) to update:
|
|
48
|
+
- activeContext.md: add Recent Changes, Decisions, Learnings
|
|
49
|
+
- progress.md: add Completed items with verification evidence
|
|
50
|
+
- patterns.md: only if discovered reusable convention/gotcha
|
|
51
|
+
|
|
52
|
+
## Read Triggers
|
|
53
|
+
Read memory BEFORE:
|
|
54
|
+
- Making architectural decisions (check patterns.md)
|
|
55
|
+
- Starting to build something (check progress.md)
|
|
56
|
+
- Debugging an error (check activeContext.md + patterns.md)
|
|
57
|
+
- Making any decision (check Decisions section)
|
|
58
|
+
|
|
59
|
+
## File Purposes
|
|
60
|
+
- activeContext.md: current state + pointers
|
|
61
|
+
- patterns.md: reusable knowledge (conventions, gotchas)
|
|
62
|
+
- progress.md: execution tracking + hard evidence
|
|
63
|
+
|
|
64
|
+
## Memory File Contract
|
|
65
|
+
- Do NOT rename top-level headers or section headers
|
|
66
|
+
- Only add content inside existing sections
|
|
67
|
+
- After every Edit, Read back to confirm change applied
|
|
68
|
+
- If Edit fails, STOP and retry with exact anchor
|
|
69
|
+
|
|
70
|
+
## Red Flags - STOP IMMEDIATELY
|
|
71
|
+
- Starting work WITHOUT loading memory
|
|
72
|
+
- Making decisions WITHOUT checking Decisions section
|
|
73
|
+
- Completing work WITHOUT updating memory
|
|
74
|
+
- Saying "I'll remember" instead of writing to memory
|
|
75
|
+
|
|
76
|
+
## Integration with Agents
|
|
77
|
+
- WRITE agents (component-builder, bug-investigator, planner): load and update memory directly
|
|
78
|
+
- READ-ONLY agents (code-reviewer, silent-failure-hunter, integration-verifier): output Memory Notes section
|
|
79
|
+
- Main assistant (router) persists read-only agent notes via Edit tool
|
|
80
|
+
|
|
81
|
+
## Rationalization Prevention
|
|
82
|
+
| Excuse | Reality |
|
|
83
|
+
|--------|---------|
|
|
84
|
+
| "I know what we decided" | Check the Decisions section. |
|
|
85
|
+
| "Small task, no need" | Small tasks have context too. Always update. |
|
|
86
|
+
| "I'll remember" | You won't. Write it down. |
|
|
87
|
+
| "Memory is optional" | Memory is MANDATORY. No exceptions.`
|
|
88
|
+
},
|
|
89
|
+
{
|
|
90
|
+
name: 'cc10x-verification-before-completion',
|
|
91
|
+
description: 'Enforces evidence-before-claims principle. All agents must provide verification evidence before marking tasks complete.',
|
|
92
|
+
license: 'MIT',
|
|
93
|
+
compatibility: 'opencode',
|
|
94
|
+
metadata: {
|
|
95
|
+
audience: 'all-agents',
|
|
96
|
+
purpose: 'verification-gate',
|
|
97
|
+
required: 'true'
|
|
98
|
+
},
|
|
99
|
+
content: `# Verification Before Completion
|
|
100
|
+
|
|
101
|
+
**Iron Law:** No claim without evidence. Exit code 0 or it didn't happen.
|
|
102
|
+
|
|
103
|
+
## The Gate
|
|
104
|
+
Before marking ANY task complete, you MUST provide:
|
|
105
|
+
1. **Commands executed** - exact commands with full arguments
|
|
106
|
+
2. **Exit codes** - actual exit codes (0 for success, non-zero for failure)
|
|
107
|
+
3. **Output evidence** - relevant output showing success/failure
|
|
108
|
+
4. **Verification steps** - how you confirmed it works
|
|
109
|
+
|
|
110
|
+
## Evidence Requirements by Agent
|
|
111
|
+
|
|
112
|
+
### component-builder (TDD)
|
|
113
|
+
- **RED Phase**: Test command → exit code 1 + failure message
|
|
114
|
+
- **GREEN Phase**: Implementation command → exit code 0 + test results (X/X)
|
|
115
|
+
- **Verification**: All tests pass command → exit code 0
|
|
116
|
+
|
|
117
|
+
### bug-investigator
|
|
118
|
+
- **Reproduction**: Command to reproduce issue → exit code showing error
|
|
119
|
+
- **Fix verification**: Command after fix → exit code 0
|
|
120
|
+
- **Regression test**: Command to ensure no side effects → exit code 0
|
|
121
|
+
|
|
122
|
+
### code-reviewer
|
|
123
|
+
- **Static analysis**: Commands run (grep, lint) → exit codes
|
|
124
|
+
- **Code inspection**: Specific file:line references with evidence
|
|
125
|
+
- **Confidence**: Only report issues with ≥80% confidence
|
|
126
|
+
|
|
127
|
+
### integration-verifier
|
|
128
|
+
- **Test suite**: Full test command → exit 0 (X/X passed)
|
|
129
|
+
- **Application start**: Start command → exit 0
|
|
130
|
+
- **Manual verification**: Steps taken with results
|
|
131
|
+
|
|
132
|
+
## Output Format
|
|
133
|
+
Always include in your response:
|
|
134
|
+
|
|
135
|
+
### Verification Evidence
|
|
136
|
+
- \`[command]\` → exit [code] ([X/X] tests passed)
|
|
137
|
+
- [Additional verification steps with results]
|
|
138
|
+
|
|
139
|
+
### Confidence Level
|
|
140
|
+
- **High**: Multiple verification methods confirm
|
|
141
|
+
- **Medium**: Single verification method but thorough
|
|
142
|
+
- **Low**: Limited verification, needs follow-up
|
|
143
|
+
|
|
144
|
+
## Router Contract
|
|
145
|
+
Include in YAML contract:
|
|
146
|
+
\`\`\`yaml
|
|
147
|
+
VERIFICATION_EVIDENCE:
|
|
148
|
+
- command: "npm test"
|
|
149
|
+
exit_code: 0
|
|
150
|
+
output: "X/X tests passed"
|
|
151
|
+
CONFIDENCE: 85
|
|
152
|
+
STATUS: PASS | FAIL
|
|
153
|
+
\`\`\`
|
|
154
|
+
|
|
155
|
+
## Common Violations (STOP THESE)
|
|
156
|
+
- "Tests should pass" (without running them)
|
|
157
|
+
- "It looks good" (without evidence)
|
|
158
|
+
- "I think it works" (without verification)
|
|
159
|
+
- "All tests passed" (without showing exit code)
|
|
160
|
+
|
|
161
|
+
## Reminder
|
|
162
|
+
If you cannot provide concrete evidence with exit codes, the task is NOT complete.`
|
|
163
|
+
},
|
|
164
|
+
{
|
|
165
|
+
name: 'cc10x-test-driven-development',
|
|
166
|
+
description: 'Enforces RED-GREEN-REFACTOR TDD cycle. Used by component-builder and bug-investigator.',
|
|
167
|
+
license: 'MIT',
|
|
168
|
+
compatibility: 'opencode',
|
|
169
|
+
metadata: {
|
|
170
|
+
audience: 'builder, investigator',
|
|
171
|
+
purpose: 'tdd-enforcement',
|
|
172
|
+
required: 'true'
|
|
173
|
+
},
|
|
174
|
+
content: `# Test-Driven Development (TDD)
|
|
175
|
+
|
|
176
|
+
**Cycle:** RED → GREEN → REFACTOR. No exceptions.
|
|
177
|
+
|
|
178
|
+
## The Three Phases
|
|
179
|
+
|
|
180
|
+
### RED Phase (Failing Test)
|
|
181
|
+
1. Write a test that fails for the desired functionality
|
|
182
|
+
2. Run the test - MUST exit with code 1
|
|
183
|
+
3. Verify the failure is for the right reason
|
|
184
|
+
4. **Evidence required**: Test command, exit code 1, failure message
|
|
185
|
+
|
|
186
|
+
### GREEN Phase (Minimal Implementation)
|
|
187
|
+
1. Write the minimal code to make the test pass
|
|
188
|
+
2. Run the test - MUST exit with code 0
|
|
189
|
+
3. Do NOT write more code than necessary
|
|
190
|
+
4. **Evidence required**: Implementation command, exit code 0, test results
|
|
191
|
+
|
|
192
|
+
### REFACTOR Phase (Clean Up)
|
|
193
|
+
1. Improve code structure while keeping tests green
|
|
194
|
+
2. Remove duplication
|
|
195
|
+
3. Improve naming and organization
|
|
196
|
+
4. Run tests continuously - must stay green (exit 0)
|
|
197
|
+
5. **Evidence required**: Refactor commands, final test run exit 0
|
|
198
|
+
|
|
199
|
+
## TDD Rules
|
|
200
|
+
|
|
201
|
+
### Never Skip RED
|
|
202
|
+
- No implementation without failing test first
|
|
203
|
+
- Even if you know exactly how to implement
|
|
204
|
+
- The test defines the expected behavior
|
|
205
|
+
|
|
206
|
+
### Minimal GREEN
|
|
207
|
+
- Write the simplest code that makes test pass
|
|
208
|
+
- Don't anticipate future requirements
|
|
209
|
+
- Trust the refactor phase to improve structure
|
|
210
|
+
|
|
211
|
+
### Continuous Green
|
|
212
|
+
- Run tests frequently during refactor
|
|
213
|
+
- Never commit code that breaks tests
|
|
214
|
+
- Maintain 100% test pass rate during refactor
|
|
215
|
+
|
|
216
|
+
## Test Quality Requirements
|
|
217
|
+
|
|
218
|
+
### Unit Tests
|
|
219
|
+
- Test one thing per test
|
|
220
|
+
- Use descriptive test names
|
|
221
|
+
- Arrange-Act-Assert pattern
|
|
222
|
+
- Mock external dependencies
|
|
223
|
+
|
|
224
|
+
### Integration Tests
|
|
225
|
+
- Test component interactions
|
|
226
|
+
- Use real dependencies where appropriate
|
|
227
|
+
- Test error handling paths
|
|
228
|
+
|
|
229
|
+
### Edge Cases
|
|
230
|
+
- Null/undefined inputs
|
|
231
|
+
- Boundary conditions
|
|
232
|
+
- Error conditions
|
|
233
|
+
- Empty collections
|
|
234
|
+
|
|
235
|
+
## Test Commands
|
|
236
|
+
Use appropriate commands for your stack:
|
|
237
|
+
- JavaScript/TypeScript: \`npm test\`, \`yarn test\`, \`bun test\`
|
|
238
|
+
- Python: \`pytest\`, \`python -m pytest\`, \`tox\`
|
|
239
|
+
- Go: \`go test\`
|
|
240
|
+
- Rust: \`cargo test\`
|
|
241
|
+
- Java: \`mvn test\`, \`gradle test\`
|
|
242
|
+
|
|
243
|
+
## Evidence Template
|
|
244
|
+
\`\`\`
|
|
245
|
+
### RED Phase
|
|
246
|
+
- Test file: path/to/test.ts
|
|
247
|
+
- Command: npm test -- test-file.test.ts
|
|
248
|
+
- Exit code: **1** (MUST be 1)
|
|
249
|
+
- Failure: Expected error message
|
|
250
|
+
|
|
251
|
+
### GREEN Phase
|
|
252
|
+
- Implementation: path/to/impl.ts
|
|
253
|
+
- Command: npm test
|
|
254
|
+
- Exit code: **0** (MUST be 0)
|
|
255
|
+
- Tests passed: 5/5
|
|
256
|
+
|
|
257
|
+
### REFACTOR Phase
|
|
258
|
+
- Refactor commands: [commands run]
|
|
259
|
+
- Final test: npm test → exit 0
|
|
260
|
+
\`\`\`
|
|
261
|
+
|
|
262
|
+
## Common TDD Violations
|
|
263
|
+
- ❌ Writing implementation first
|
|
264
|
+
- ❌ Skipping RED phase ("I know it will fail")
|
|
265
|
+
- ❌ Writing extra features during GREEN
|
|
266
|
+
- ❌ Breaking tests during refactor
|
|
267
|
+
- ❌ Not showing exit codes
|
|
268
|
+
|
|
269
|
+
## For component-builder
|
|
270
|
+
TDD is NON-NEGOTIABLE. Every feature must follow RED→GREEN→REFACTOR.
|
|
271
|
+
Include TDD evidence in your output using the template above.
|
|
272
|
+
|
|
273
|
+
## For bug-investigator
|
|
274
|
+
Use TDD pattern for fixes:
|
|
275
|
+
1. RED: Write test that reproduces bug (should fail)
|
|
276
|
+
2. GREEN: Fix the bug (test should pass)
|
|
277
|
+
3. REFACTOR: Clean up the fix
|
|
278
|
+
|
|
279
|
+
## For integration-verifier
|
|
280
|
+
Verify that all tests pass (exit 0) before approving.`
|
|
281
|
+
},
|
|
282
|
+
{
|
|
283
|
+
name: 'cc10x-code-generation',
|
|
284
|
+
description: 'Provides code generation patterns for consistent, minimal implementations. Used by component-builder.',
|
|
285
|
+
license: 'MIT',
|
|
286
|
+
compatibility: 'opencode',
|
|
287
|
+
metadata: {
|
|
288
|
+
audience: 'builder',
|
|
289
|
+
purpose: 'code-patterns',
|
|
290
|
+
required: 'false'
|
|
291
|
+
},
|
|
292
|
+
content: `# Code Generation Patterns
|
|
293
|
+
|
|
294
|
+
**Principle:** Minimal code, match existing patterns, follow conventions.
|
|
295
|
+
|
|
296
|
+
## Code Quality Principles
|
|
297
|
+
|
|
298
|
+
### Minimalism
|
|
299
|
+
- Write the simplest code that works
|
|
300
|
+
- Don't anticipate future requirements
|
|
301
|
+
- Remove unused code immediately
|
|
302
|
+
- Prefer composition over inheritance
|
|
303
|
+
|
|
304
|
+
### Consistency
|
|
305
|
+
- Match existing code patterns in the project
|
|
306
|
+
- Follow established naming conventions
|
|
307
|
+
- Use same formatting and style
|
|
308
|
+
- Reuse existing utilities and helpers
|
|
309
|
+
|
|
310
|
+
### Clarity
|
|
311
|
+
- Self-documenting code through naming
|
|
312
|
+
- Simple logic over clever solutions
|
|
313
|
+
- Clear function and variable names
|
|
314
|
+
- Comments only for "why", not "what"
|
|
315
|
+
|
|
316
|
+
## Implementation Patterns
|
|
317
|
+
|
|
318
|
+
### Function Design
|
|
319
|
+
- Single responsibility per function
|
|
320
|
+
- Small, focused functions (<20 lines)
|
|
321
|
+
- Clear inputs and outputs
|
|
322
|
+
- Avoid side effects when possible
|
|
323
|
+
|
|
324
|
+
### Error Handling
|
|
325
|
+
- Fail fast with clear error messages
|
|
326
|
+
- Use appropriate error types
|
|
327
|
+
- Don't swallow errors
|
|
328
|
+
- Provide context in error messages
|
|
329
|
+
|
|
330
|
+
### Data Structures
|
|
331
|
+
- Choose appropriate structures for the use case
|
|
332
|
+
- Consider performance implications
|
|
333
|
+
- Document complex data shapes
|
|
334
|
+
- Use type safety where available
|
|
335
|
+
|
|
336
|
+
## API Design Patterns
|
|
337
|
+
|
|
338
|
+
### RESTful Endpoints
|
|
339
|
+
- Use proper HTTP methods (GET, POST, PUT, DELETE)
|
|
340
|
+
- Consistent URL patterns
|
|
341
|
+
- Proper status codes
|
|
342
|
+
- Request/response validation
|
|
343
|
+
|
|
344
|
+
### Function Signatures
|
|
345
|
+
- Clear parameter names and types
|
|
346
|
+
- Optional parameters with defaults
|
|
347
|
+
- Return consistent types
|
|
348
|
+
- Document edge cases
|
|
349
|
+
|
|
350
|
+
## Testing Patterns
|
|
351
|
+
|
|
352
|
+
### Test Structure
|
|
353
|
+
- Arrange-Act-Assert pattern
|
|
354
|
+
- One assertion per test when possible
|
|
355
|
+
- Use descriptive test names
|
|
356
|
+
- Test behavior, not implementation
|
|
357
|
+
|
|
358
|
+
### Mocking Strategy
|
|
359
|
+
- Mock external dependencies
|
|
360
|
+
- Use test doubles for slow operations
|
|
361
|
+
- Verify interactions when needed
|
|
362
|
+
- Prefer integration tests for critical paths
|
|
363
|
+
|
|
364
|
+
## Security Patterns
|
|
365
|
+
|
|
366
|
+
### Input Validation
|
|
367
|
+
- Validate all user inputs
|
|
368
|
+
- Sanitize data before use
|
|
369
|
+
- Use parameterized queries
|
|
370
|
+
- Implement rate limiting
|
|
371
|
+
|
|
372
|
+
### Authentication/Authorization
|
|
373
|
+
- Never hardcode secrets
|
|
374
|
+
- Use environment variables
|
|
375
|
+
- Implement proper session management
|
|
376
|
+
- Follow principle of least privilege
|
|
377
|
+
|
|
378
|
+
## Performance Patterns
|
|
379
|
+
|
|
380
|
+
### Database Queries
|
|
381
|
+
- Use indexes appropriately
|
|
382
|
+
- Avoid N+1 query problems
|
|
383
|
+
- Batch operations when possible
|
|
384
|
+
- Cache expensive computations
|
|
385
|
+
|
|
386
|
+
### Caching Strategy
|
|
387
|
+
- Cache read-heavy operations
|
|
388
|
+
- Implement cache invalidation
|
|
389
|
+
- Use appropriate TTLs
|
|
390
|
+
- Consider cache warming
|
|
391
|
+
|
|
392
|
+
## For component-builder
|
|
393
|
+
1. First, check patterns.md for project-specific conventions
|
|
394
|
+
2. Follow the minimal code principle
|
|
395
|
+
3. Match existing patterns exactly
|
|
396
|
+
4. Write tests before implementation (TDD)
|
|
397
|
+
5. Update patterns.md if you discover new conventions
|
|
398
|
+
|
|
399
|
+
## Code Generation Rules
|
|
400
|
+
- ✅ Use existing utilities and helpers
|
|
401
|
+
- ✅ Follow project naming conventions
|
|
402
|
+
- ✅ Keep functions small and focused
|
|
403
|
+
- ✅ Write comprehensive tests
|
|
404
|
+
- ❌ Don't reinvent existing solutions
|
|
405
|
+
- ❌ Don't add unnecessary complexity
|
|
406
|
+
- ❌ Don't skip error handling
|
|
407
|
+
|
|
408
|
+
## When to Ask
|
|
409
|
+
- Unclear about project patterns → check patterns.md first
|
|
410
|
+
- Need to choose between approaches → consider trade-offs
|
|
411
|
+
- Performance critical → profile before optimizing
|
|
412
|
+
- Security sensitive → follow OWASP guidelines`
|
|
413
|
+
},
|
|
414
|
+
{
|
|
415
|
+
name: 'cc10x-debugging-patterns',
|
|
416
|
+
description: 'Systematic debugging approach and common patterns. Used by bug-investigator.',
|
|
417
|
+
license: 'MIT',
|
|
418
|
+
compatibility: 'opencode',
|
|
419
|
+
metadata: {
|
|
420
|
+
audience: 'investigator',
|
|
421
|
+
purpose: 'debugging-methodology',
|
|
422
|
+
required: 'false'
|
|
423
|
+
},
|
|
424
|
+
content: `# Debugging Patterns
|
|
425
|
+
|
|
426
|
+
**Methodology:** Systematic approach, evidence first, binary search narrowing.
|
|
427
|
+
|
|
428
|
+
## Debugging Methodology
|
|
429
|
+
|
|
430
|
+
### 1. Reproduce the Issue
|
|
431
|
+
- Get exact, reliable reproduction steps
|
|
432
|
+
- Identify consistent vs intermittent behavior
|
|
433
|
+
- Note environment and conditions
|
|
434
|
+
- Capture complete error information
|
|
435
|
+
|
|
436
|
+
### 2. Gather Evidence
|
|
437
|
+
- Stack traces and error messages
|
|
438
|
+
- Application logs (all levels)
|
|
439
|
+
- System state (memory, CPU, network)
|
|
440
|
+
- Recent changes (git diff, deployment history)
|
|
441
|
+
- Input data that triggered the issue
|
|
442
|
+
|
|
443
|
+
### 3. Form Hypotheses
|
|
444
|
+
- What changed recently?
|
|
445
|
+
- What component is failing?
|
|
446
|
+
- What conditions trigger the issue?
|
|
447
|
+
- What should happen vs what is happening?
|
|
448
|
+
|
|
449
|
+
### 4. Test Hypotheses
|
|
450
|
+
- Binary search approach (divide and conquer)
|
|
451
|
+
- Add logging to narrow down
|
|
452
|
+
- Isolate components
|
|
453
|
+
- Test with controlled inputs
|
|
454
|
+
|
|
455
|
+
### 5. Identify Root Cause
|
|
456
|
+
- The actual code defect
|
|
457
|
+
- Not just the symptom
|
|
458
|
+
- Understand why it happens
|
|
459
|
+
- Document the mechanism
|
|
460
|
+
|
|
461
|
+
### 6. Implement Fix
|
|
462
|
+
- Minimal change to resolve
|
|
463
|
+
- Address root cause, not symptoms
|
|
464
|
+
- Consider side effects
|
|
465
|
+
- Add tests to prevent regression
|
|
466
|
+
|
|
467
|
+
### 7. Verify Fix
|
|
468
|
+
- Original reproduction steps now work
|
|
469
|
+
- No new issues introduced
|
|
470
|
+
- Performance not degraded
|
|
471
|
+
- All existing tests still pass
|
|
472
|
+
|
|
473
|
+
## Common Debugging Patterns
|
|
474
|
+
|
|
475
|
+
### Binary Search Debugging
|
|
476
|
+
1. Identify roughly where issue occurs
|
|
477
|
+
2. Add logging/checks at midpoint
|
|
478
|
+
3. Narrow to half based on results
|
|
479
|
+
4. Repeat until exact location found
|
|
480
|
+
|
|
481
|
+
### Time Travel Debugging
|
|
482
|
+
1. Check recent changes (git log -p)
|
|
483
|
+
2. Identify when issue started
|
|
484
|
+
3. Compare working vs broken versions
|
|
485
|
+
4. Isolate the change that caused it
|
|
486
|
+
|
|
487
|
+
### Dependency Debugging
|
|
488
|
+
1. Check all external dependencies
|
|
489
|
+
2. Verify versions and compatibility
|
|
490
|
+
3. Test with minimal dependencies
|
|
491
|
+
4. Check for version conflicts
|
|
492
|
+
|
|
493
|
+
### State Debugging
|
|
494
|
+
1. Log state at key points
|
|
495
|
+
2. Compare expected vs actual state
|
|
496
|
+
3. Track state changes
|
|
497
|
+
4. Identify where state becomes invalid
|
|
498
|
+
|
|
499
|
+
### Race Condition Detection
|
|
500
|
+
1. Add timing logs with timestamps
|
|
501
|
+
2. Look for overlapping operations
|
|
502
|
+
3. Test with delays/sleeps
|
|
503
|
+
4. Check for unsynchronized access
|
|
504
|
+
|
|
505
|
+
## Tool-Based Debugging
|
|
506
|
+
|
|
507
|
+
### Git-Based
|
|
508
|
+
- \`git status\` - current state
|
|
509
|
+
- \`git diff\` - uncommitted changes
|
|
510
|
+
- \`git log -p\` - recent changes with diffs
|
|
511
|
+
- \`git bisect\` - binary search through history
|
|
512
|
+
|
|
513
|
+
### Log-Based
|
|
514
|
+
- Application logs (structured if possible)
|
|
515
|
+
- System logs (syslog, dmesg)
|
|
516
|
+
- Network logs (if applicable)
|
|
517
|
+
- Database query logs
|
|
518
|
+
|
|
519
|
+
### Static Analysis
|
|
520
|
+
- Linting rules violations
|
|
521
|
+
- Type checking errors
|
|
522
|
+
- Security scanning results
|
|
523
|
+
- Code complexity metrics
|
|
524
|
+
|
|
525
|
+
### Dynamic Analysis
|
|
526
|
+
- Profiling (CPU, memory)
|
|
527
|
+
- Tracing (distributed tracing)
|
|
528
|
+
- Debuggers (gdb, pdb, browser devtools)
|
|
529
|
+
- Network sniffers (wireshark, tcpdump)
|
|
530
|
+
|
|
531
|
+
## Stack Trace Analysis
|
|
532
|
+
|
|
533
|
+
### Reading Stack Traces
|
|
534
|
+
1. Start at the top (most recent call)
|
|
535
|
+
2. Look for your code frames
|
|
536
|
+
3. Identify the exact line and operation
|
|
537
|
+
4. Check for "Caused by" chains
|
|
538
|
+
|
|
539
|
+
### Common Patterns
|
|
540
|
+
- NullPointerException/TypeError - check for null/undefined
|
|
541
|
+
- IndexOutOfBounds - check array/list access
|
|
542
|
+
- Connection refused - check network/configuration
|
|
543
|
+
- Timeout - check blocking operations
|
|
544
|
+
- Memory error - check for leaks or large allocations
|
|
545
|
+
|
|
546
|
+
## Environment Debugging
|
|
547
|
+
|
|
548
|
+
### Configuration Issues
|
|
549
|
+
- Check environment variables
|
|
550
|
+
- Verify configuration files
|
|
551
|
+
- Test with minimal configuration
|
|
552
|
+
- Compare dev vs prod settings
|
|
553
|
+
|
|
554
|
+
### Dependency Issues
|
|
555
|
+
- Check package versions
|
|
556
|
+
- Verify installation integrity
|
|
557
|
+
- Test with clean install
|
|
558
|
+
- Check for version conflicts
|
|
559
|
+
|
|
560
|
+
### Permission Issues
|
|
561
|
+
- File system permissions
|
|
562
|
+
- Network access permissions
|
|
563
|
+
- Database access rights
|
|
564
|
+
- API key validity
|
|
565
|
+
|
|
566
|
+
## Performance Debugging
|
|
567
|
+
|
|
568
|
+
### Slow Operations
|
|
569
|
+
- Profile to identify bottlenecks
|
|
570
|
+
- Check database queries (N+1 problem)
|
|
571
|
+
- Look for blocking operations
|
|
572
|
+
- Check network latency
|
|
573
|
+
- Monitor resource usage (CPU, memory, I/O)
|
|
574
|
+
|
|
575
|
+
### Memory Leaks
|
|
576
|
+
- Monitor memory usage over time
|
|
577
|
+
- Check for unclosed resources
|
|
578
|
+
- Look for accumulating data structures
|
|
579
|
+
- Use heap profilers
|
|
580
|
+
|
|
581
|
+
## For bug-investigator
|
|
582
|
+
|
|
583
|
+
### LOG FIRST - Never Skip
|
|
584
|
+
1. **Reproduce** - Get exact steps, capture complete error
|
|
585
|
+
2. **Log Everything** - Stack trace, system state, recent changes
|
|
586
|
+
3. **Analyze** - Use patterns above to find root cause
|
|
587
|
+
4. **Fix** - Minimal change addressing root cause
|
|
588
|
+
5. **Verify** - Original steps now work, no regressions
|
|
589
|
+
|
|
590
|
+
### Evidence Requirements
|
|
591
|
+
- Reproduction steps with exact commands
|
|
592
|
+
- Error logs and stack traces
|
|
593
|
+
- Git context (recent changes)
|
|
594
|
+
- Before/after comparison
|
|
595
|
+
- Verification that fix works
|
|
596
|
+
|
|
597
|
+
### When to Use Research
|
|
598
|
+
- Unfamiliar error patterns
|
|
599
|
+
- Complex system interactions
|
|
600
|
+
- Need external examples
|
|
601
|
+
- Best practices for fix approach
|
|
602
|
+
|
|
603
|
+
## Common Gotchas to Check
|
|
604
|
+
- Off-by-one errors in loops
|
|
605
|
+
- Null/undefined handling
|
|
606
|
+
- Async/await mistakes
|
|
607
|
+
- Race conditions
|
|
608
|
+
- Configuration mismatches
|
|
609
|
+
- Environment differences
|
|
610
|
+
- Caching issues
|
|
611
|
+
- Timezone problems
|
|
612
|
+
- Character encoding issues
|
|
613
|
+
|
|
614
|
+
## Confidence Scoring
|
|
615
|
+
- **90%+**: Clear root cause with evidence
|
|
616
|
+
- **70-89%**: Likely cause with supporting evidence
|
|
617
|
+
- **50-69%**: Hypothesis needs more verification
|
|
618
|
+
- **<50%**: Speculation, gather more evidence
|
|
619
|
+
|
|
620
|
+
## Memory Updates
|
|
621
|
+
If you discover a new debugging pattern or common gotcha:
|
|
622
|
+
- Add to patterns.md Common Gotchas section
|
|
623
|
+
- Document the pattern and solution
|
|
624
|
+
- Update activeContext.md with recent learnings`
|
|
625
|
+
},
|
|
626
|
+
{
|
|
627
|
+
name: 'cc10x-code-review-patterns',
|
|
628
|
+
description: 'Comprehensive code review criteria and patterns. Used by code-reviewer for quality, security, and performance analysis.',
|
|
629
|
+
license: 'MIT',
|
|
630
|
+
compatibility: 'opencode',
|
|
631
|
+
metadata: {
|
|
632
|
+
audience: 'reviewer',
|
|
633
|
+
purpose: 'code-quality-standards',
|
|
634
|
+
required: 'false'
|
|
635
|
+
},
|
|
636
|
+
content: `# Code Review Patterns
|
|
637
|
+
|
|
638
|
+
**Standard:** 80%+ confidence threshold. No vague feedback.
|
|
639
|
+
|
|
640
|
+
## Review Categories
|
|
641
|
+
|
|
642
|
+
### Security (OWASP Top 10)
|
|
643
|
+
- **Injection**: SQL, NoSQL, OS command, LDAP injection
|
|
644
|
+
- **Broken Authentication**: Weak credentials, session management
|
|
645
|
+
- **Sensitive Data Exposure**: Unencrypted data, weak crypto
|
|
646
|
+
- **XML External Entities**: XXE vulnerabilities
|
|
647
|
+
- **Broken Access Control**: Authorization bypass, privilege escalation
|
|
648
|
+
- **Security Misconfiguration**: Default credentials, verbose errors
|
|
649
|
+
- **Cross-Site Scripting (XSS)**: Reflected, stored, DOM-based
|
|
650
|
+
- **Insecure Deserialization**: Arbitrary code execution
|
|
651
|
+
- **Using Components with Known Vulnerabilities**: Outdated dependencies
|
|
652
|
+
- **Insufficient Logging & Monitoring**: No audit trails
|
|
653
|
+
|
|
654
|
+
### Performance
|
|
655
|
+
- **Algorithm Complexity**: O(n²) vs O(n log n), unnecessary nested loops
|
|
656
|
+
- **Database Queries**: N+1 problems, missing indexes, full table scans
|
|
657
|
+
- **Memory Usage**: Memory leaks, unnecessary allocations, large object retention
|
|
658
|
+
- **Network**: Excessive requests, no caching, large payloads
|
|
659
|
+
- **Caching**: Missing cache, improper cache invalidation, cache stampede
|
|
660
|
+
|
|
661
|
+
### Maintainability
|
|
662
|
+
- **Code Complexity**: Cyclomatic complexity > 10, long functions (>50 lines)
|
|
663
|
+
- **Naming**: Unclear names, abbreviations, inconsistent conventions
|
|
664
|
+
- **Duplication**: Copy-pasted code, similar functions
|
|
665
|
+
- **Comments**: Outdated comments, commented-out code, missing explanations
|
|
666
|
+
- **Structure**: Tight coupling, violation of single responsibility
|
|
667
|
+
|
|
668
|
+
### Reliability
|
|
669
|
+
- **Error Handling**: Empty catch blocks, swallowed exceptions, missing validation
|
|
670
|
+
- **Resource Management**: Unclosed connections, file handles, database connections
|
|
671
|
+
- **Race Conditions**: Unsynchronized shared state, async timing issues
|
|
672
|
+
- **Input Validation**: Missing validation, type confusion, boundary checks
|
|
673
|
+
- **Edge Cases**: Null handling, empty collections, extreme values
|
|
674
|
+
|
|
675
|
+
### Testing
|
|
676
|
+
- **Test Coverage**: Missing tests for critical paths
|
|
677
|
+
- **Test Quality**: Brittle tests, implementation testing vs behavior testing
|
|
678
|
+
- **Edge Case Coverage**: Missing boundary tests, error path tests
|
|
679
|
+
- **Mocking**: Over-mocking, under-mocking, integration test gaps
|
|
680
|
+
|
|
681
|
+
## Review Process
|
|
682
|
+
|
|
683
|
+
### 1. Initial Scan
|
|
684
|
+
- Look for obvious red flags (security, empty catches)
|
|
685
|
+
- Check file size and complexity
|
|
686
|
+
- Identify high-risk areas (auth, payments, data)
|
|
687
|
+
|
|
688
|
+
### 2. Deep Dive
|
|
689
|
+
- Read the code thoroughly
|
|
690
|
+
- Understand the intent and implementation
|
|
691
|
+
- Check against requirements
|
|
692
|
+
- Look for subtle issues
|
|
693
|
+
|
|
694
|
+
### 3. Issue Classification
|
|
695
|
+
- **CRITICAL**: Security vulnerabilities, data loss, crashes
|
|
696
|
+
- **MAJOR**: Functional bugs, performance issues, reliability problems
|
|
697
|
+
- **MINOR**: Code quality, style, minor improvements
|
|
698
|
+
- **SUGGESTION**: Optional improvements, best practices
|
|
699
|
+
|
|
700
|
+
### 4. Confidence Assessment
|
|
701
|
+
For each issue:
|
|
702
|
+
- How certain are you? (0-100%)
|
|
703
|
+
- What evidence do you have?
|
|
704
|
+
- Could you be wrong? Why?
|
|
705
|
+
- Only report if ≥80% confidence
|
|
706
|
+
|
|
707
|
+
## Issue Reporting Format
|
|
708
|
+
|
|
709
|
+
### Critical Issues (≥80% Confidence)
|
|
710
|
+
- **[File:line]** Issue description (Confidence: XX%)
|
|
711
|
+
- **Evidence**: [specific code pattern]
|
|
712
|
+
- **Impact**: [what could go wrong, severity]
|
|
713
|
+
- **Fix**: [specific recommendation with code example]
|
|
714
|
+
- **CWE**: [relevant CWE identifier if security]
|
|
715
|
+
|
|
716
|
+
### Positive Feedback
|
|
717
|
+
- **[File:line]** What's done well
|
|
718
|
+
- **Why it's good**: [explanation]
|
|
719
|
+
- **Example for others**: [learning point]
|
|
720
|
+
|
|
721
|
+
## Specific Patterns to Check
|
|
722
|
+
|
|
723
|
+
### Security Patterns
|
|
724
|
+
- \`eval()\` usage
|
|
725
|
+
- SQL string concatenation
|
|
726
|
+
- Hardcoded passwords/keys
|
|
727
|
+
- Insecure direct object references
|
|
728
|
+
- Missing CSRF protection
|
|
729
|
+
- Excessive error information
|
|
730
|
+
|
|
731
|
+
### Code Smells
|
|
732
|
+
- Long parameter lists (>3-4 parameters)
|
|
733
|
+
- Large classes (>500 lines)
|
|
734
|
+
- God objects (know too much, do too much)
|
|
735
|
+
- Feature envy (method uses data from other class)
|
|
736
|
+
- Data clumps (same parameters passed together)
|
|
737
|
+
|
|
738
|
+
### Anti-Patterns
|
|
739
|
+
- Copy-paste programming
|
|
740
|
+
- Magic numbers/strings
|
|
741
|
+
- Deep nesting (>3 levels)
|
|
742
|
+
- Busy waiting
|
|
743
|
+
- Poltergeists (objects that exist only to pass data)
|
|
744
|
+
|
|
745
|
+
## For Different Workflows
|
|
746
|
+
|
|
747
|
+
### BUILD Workflow
|
|
748
|
+
- Review component-builder's implementation
|
|
749
|
+
- Check TDD compliance (tests first, green phase)
|
|
750
|
+
- Verify test coverage and quality
|
|
751
|
+
- Look for silent failures (coordinate with hunter)
|
|
752
|
+
|
|
753
|
+
### DEBUG Workflow
|
|
754
|
+
- Review bug-investigator's fix
|
|
755
|
+
- Ensure fix addresses root cause, not symptoms
|
|
756
|
+
- Check for side effects and regressions
|
|
757
|
+
- Verify fix doesn't introduce new issues
|
|
758
|
+
|
|
759
|
+
### REVIEW Workflow
|
|
760
|
+
- Comprehensive review of user-specified code
|
|
761
|
+
- Full analysis across all categories
|
|
762
|
+
- Provide actionable feedback with examples
|
|
763
|
+
- Consider business context and priorities
|
|
764
|
+
|
|
765
|
+
## Confidence Scoring Guidelines
|
|
766
|
+
|
|
767
|
+
### 90%+ Confidence
|
|
768
|
+
- Clear violation of established pattern
|
|
769
|
+
- Security vulnerability with proof of concept
|
|
770
|
+
- Test failure with reproducible steps
|
|
771
|
+
- Code that will definitely cause runtime error
|
|
772
|
+
|
|
773
|
+
### 70-89% Confidence
|
|
774
|
+
- Likely issue with strong evidence
|
|
775
|
+
- Performance problem that's measurable
|
|
776
|
+
- Code smell that violates best practices
|
|
777
|
+
- Potential edge case not handled
|
|
778
|
+
|
|
779
|
+
### 50-69% Confidence
|
|
780
|
+
- Possible issue, needs more investigation
|
|
781
|
+
- Style preference rather than problem
|
|
782
|
+
- Edge case that may not occur in practice
|
|
783
|
+
- Alternative approach that might be better
|
|
784
|
+
|
|
785
|
+
### <50% Confidence
|
|
786
|
+
- Speculation without evidence
|
|
787
|
+
- Personal preference
|
|
788
|
+
- "I would do it differently" without technical merit
|
|
789
|
+
- Hypothetical scenarios
|
|
790
|
+
|
|
791
|
+
## Only Report ≥80% Confidence
|
|
792
|
+
If confidence < 80%, either:
|
|
793
|
+
1. Gather more evidence to increase confidence
|
|
794
|
+
2. Don't include in critical issues
|
|
795
|
+
3. Maybe mention as "consideration" if very important
|
|
796
|
+
|
|
797
|
+
## Memory Notes
|
|
798
|
+
Include in your output:
|
|
799
|
+
- Security patterns discovered
|
|
800
|
+
- Performance issues found
|
|
801
|
+
- Code quality standards applied
|
|
802
|
+
- Any new review criteria for this project
|
|
803
|
+
- Patterns to add to patterns.md
|
|
804
|
+
|
|
805
|
+
## Verdict Logic
|
|
806
|
+
- **APPROVED**: No critical issues (≥80% confidence) found
|
|
807
|
+
- **CHANGES REQUESTED**: Critical issues must be addressed before approval
|
|
808
|
+
- Consider business impact and timeline when setting severity`
|
|
809
|
+
},
|
|
810
|
+
{
|
|
811
|
+
name: 'cc10x-github-research',
|
|
812
|
+
description: 'Research external packages, best practices, and implementation examples from GitHub. Used by planner and bug-investigator when needed.',
|
|
813
|
+
license: 'MIT',
|
|
814
|
+
compatibility: 'opencode',
|
|
815
|
+
metadata: {
|
|
816
|
+
audience: 'planner, investigator',
|
|
817
|
+
purpose: 'external-research',
|
|
818
|
+
required: 'false'
|
|
819
|
+
},
|
|
820
|
+
content: `# GitHub Research
|
|
821
|
+
|
|
822
|
+
**Purpose:** Find real-world examples, best practices, and proven solutions.
|
|
823
|
+
|
|
824
|
+
## When to Use Research
|
|
825
|
+
|
|
826
|
+
### Planner Triggers
|
|
827
|
+
- Unfamiliar technology or framework
|
|
828
|
+
- Complex integration patterns needed
|
|
829
|
+
- Need to evaluate multiple approaches
|
|
830
|
+
- Best practices for new domain
|
|
831
|
+
- Performance/security considerations
|
|
832
|
+
|
|
833
|
+
### Bug-investigator Triggers
|
|
834
|
+
- Exhausted local debugging (3+ attempts failed)
|
|
835
|
+
- External service error needing context
|
|
836
|
+
- Unusual error pattern requiring community knowledge
|
|
837
|
+
- Need to see how others solved similar issues
|
|
838
|
+
|
|
839
|
+
### User Explicit Requests
|
|
840
|
+
- "Research this approach"
|
|
841
|
+
- "Find examples on GitHub"
|
|
842
|
+
- "What are best practices for X?"
|
|
843
|
+
- "How do others handle Y?"
|
|
844
|
+
|
|
845
|
+
## Research Process
|
|
846
|
+
|
|
847
|
+
### 1. Define Search Query
|
|
848
|
+
- Be specific about technology and problem
|
|
849
|
+
- Include relevant keywords
|
|
850
|
+
- Consider synonyms and related terms
|
|
851
|
+
- Focus on recent, well-maintained solutions
|
|
852
|
+
|
|
853
|
+
### 2. Search Strategy
|
|
854
|
+
- Look for popular repositories (stars, recent activity)
|
|
855
|
+
- Check repository quality (documentation, tests, issues)
|
|
856
|
+
- Prefer solutions with active maintenance
|
|
857
|
+
- Consider multiple approaches
|
|
858
|
+
|
|
859
|
+
### 3. Evaluate Results
|
|
860
|
+
- Code quality and patterns
|
|
861
|
+
- Community adoption and feedback
|
|
862
|
+
- License compatibility
|
|
863
|
+
- Performance characteristics
|
|
864
|
+
- Security considerations
|
|
865
|
+
|
|
866
|
+
### 4. Synthesize Findings
|
|
867
|
+
- Compare different approaches
|
|
868
|
+
- Identify trade-offs
|
|
869
|
+
- Recommend based on project context
|
|
870
|
+
- Provide concrete examples
|
|
871
|
+
|
|
872
|
+
## Research Output Format
|
|
873
|
+
|
|
874
|
+
### Research Document
|
|
875
|
+
Save to: \`docs/research/YYYY-MM-DD-<topic>-research.md\`
|
|
876
|
+
|
|
877
|
+
Include:
|
|
878
|
+
- Search queries used
|
|
879
|
+
- Repositories examined (with links)
|
|
880
|
+
- Code examples found
|
|
881
|
+
- Analysis of approaches
|
|
882
|
+
- Recommendations with rationale
|
|
883
|
+
|
|
884
|
+
### Memory Updates
|
|
885
|
+
- Update activeContext.md with research reference
|
|
886
|
+
- Record key findings in patterns.md if reusable
|
|
887
|
+
- Update progress.md with research completion
|
|
888
|
+
|
|
889
|
+
## For Planner
|
|
890
|
+
1. Identify research needs during analysis phase
|
|
891
|
+
2. Use github-research skill to gather information
|
|
892
|
+
3. Synthesize findings into recommendations
|
|
893
|
+
4. Document research in plan
|
|
894
|
+
|
|
895
|
+
## For Bug-investigator
|
|
896
|
+
1. When stuck, request github-research
|
|
897
|
+
2. Focus on similar issues and solutions
|
|
898
|
+
3. Look for debugging approaches
|
|
899
|
+
4. Consider alternative implementations
|
|
900
|
+
|
|
901
|
+
## Quality Criteria
|
|
902
|
+
- **Relevance**: Matches the specific problem
|
|
903
|
+
- **Quality**: Well-maintained, good practices
|
|
904
|
+
- **Evidence**: Working code, tests, documentation
|
|
905
|
+
- **Community**: Adoption and positive feedback
|
|
906
|
+
- **Compatibility**: License and technology fit
|
|
907
|
+
|
|
908
|
+
## Avoid
|
|
909
|
+
- Outdated or unmaintained solutions
|
|
910
|
+
- Security anti-patterns
|
|
911
|
+
- Overly complex solutions for simple problems
|
|
912
|
+
- Solutions with restrictive licenses
|
|
913
|
+
- Code without proper attribution
|
|
914
|
+
|
|
915
|
+
## Attribution
|
|
916
|
+
Always attribute sources:
|
|
917
|
+
- Repository name and link
|
|
918
|
+
- Author/ maintainer
|
|
919
|
+
- License information
|
|
920
|
+
- Any modifications made
|
|
921
|
+
|
|
922
|
+
## Integration with Plan
|
|
923
|
+
Research findings should directly inform:
|
|
924
|
+
- Technology choices
|
|
925
|
+
- Architecture decisions
|
|
926
|
+
- Implementation approach
|
|
927
|
+
- Risk assessment
|
|
928
|
+
|
|
929
|
+
## Confidence in Research
|
|
930
|
+
- **High**: Multiple quality sources agree
|
|
931
|
+
- **Medium**: Limited sources but consistent
|
|
932
|
+
- **Low**: Single source or conflicting information
|
|
933
|
+
- Document confidence level in research document`
|
|
934
|
+
},
|
|
935
|
+
{
|
|
936
|
+
name: 'cc10x-planning-patterns',
|
|
937
|
+
description: 'Comprehensive planning methodology and structure. Used by planner to create detailed, actionable plans.',
|
|
938
|
+
license: 'MIT',
|
|
939
|
+
compatibility: 'opencode',
|
|
940
|
+
metadata: {
|
|
941
|
+
audience: 'planner',
|
|
942
|
+
purpose: 'planning-methodology',
|
|
943
|
+
required: 'false'
|
|
944
|
+
},
|
|
945
|
+
content: `# Planning Patterns
|
|
946
|
+
|
|
947
|
+
**Goal:** Create comprehensive, actionable plans with clear next steps.
|
|
948
|
+
|
|
949
|
+
## Planning Structure
|
|
950
|
+
|
|
951
|
+
### 1. Executive Summary
|
|
952
|
+
- Problem statement
|
|
953
|
+
- Proposed solution overview
|
|
954
|
+
- Key decisions and rationale
|
|
955
|
+
- Success criteria
|
|
956
|
+
|
|
957
|
+
### 2. Requirements Analysis
|
|
958
|
+
- Functional requirements
|
|
959
|
+
- Non-functional requirements (performance, security, scalability)
|
|
960
|
+
- Constraints and assumptions
|
|
961
|
+
- Dependencies and risks
|
|
962
|
+
|
|
963
|
+
### 3. Architecture & Design
|
|
964
|
+
- System architecture diagram (if applicable)
|
|
965
|
+
- Technology choices with rationale
|
|
966
|
+
- API design (endpoints, data models)
|
|
967
|
+
- Database schema (if applicable)
|
|
968
|
+
- Security considerations
|
|
969
|
+
|
|
970
|
+
### 4. Implementation Plan
|
|
971
|
+
#### Phase 1: Foundation
|
|
972
|
+
- Setup and configuration
|
|
973
|
+
- Core data models
|
|
974
|
+
- Basic infrastructure
|
|
975
|
+
- Success criteria
|
|
976
|
+
|
|
977
|
+
#### Phase 2: Core Features
|
|
978
|
+
- Primary functionality
|
|
979
|
+
- User-facing features
|
|
980
|
+
- Integration points
|
|
981
|
+
- Success criteria
|
|
982
|
+
|
|
983
|
+
#### Phase 3: Polish & Optimization
|
|
984
|
+
- Performance improvements
|
|
985
|
+
- Error handling
|
|
986
|
+
- Edge cases
|
|
987
|
+
- Documentation
|
|
988
|
+
|
|
989
|
+
#### Phase 4: Deployment & Monitoring
|
|
990
|
+
- Deployment strategy
|
|
991
|
+
- Monitoring setup
|
|
992
|
+
- Rollback plan
|
|
993
|
+
- Success criteria
|
|
994
|
+
|
|
995
|
+
### 5. Risk Assessment
|
|
996
|
+
- Technical risks and mitigation
|
|
997
|
+
- Timeline risks
|
|
998
|
+
- Resource constraints
|
|
999
|
+
- External dependencies
|
|
1000
|
+
|
|
1001
|
+
### 6. Testing Strategy
|
|
1002
|
+
- Unit testing approach
|
|
1003
|
+
- Integration testing
|
|
1004
|
+
- End-to-end testing
|
|
1005
|
+
- Performance testing
|
|
1006
|
+
- Security testing
|
|
1007
|
+
|
|
1008
|
+
### 7. Research Needs
|
|
1009
|
+
- Unfamiliar technologies to investigate
|
|
1010
|
+
- Best practices to research
|
|
1011
|
+
- Alternatives to evaluate
|
|
1012
|
+
- Proof of concepts needed
|
|
1013
|
+
|
|
1014
|
+
## Planning Process
|
|
1015
|
+
|
|
1016
|
+
### 1. Clarify Requirements
|
|
1017
|
+
Ask user questions to understand:
|
|
1018
|
+
- What problem are we solving?
|
|
1019
|
+
- Who are the users?
|
|
1020
|
+
- What are the success criteria?
|
|
1021
|
+
- What are the constraints?
|
|
1022
|
+
- What's the timeline?
|
|
1023
|
+
|
|
1024
|
+
### 2. Analyze Current State
|
|
1025
|
+
- Existing codebase structure
|
|
1026
|
+
- Current technologies and patterns
|
|
1027
|
+
- Team capabilities and experience
|
|
1028
|
+
- Infrastructure and deployment
|
|
1029
|
+
|
|
1030
|
+
### 3. Explore Options
|
|
1031
|
+
- Multiple architectural approaches
|
|
1032
|
+
- Technology choices with trade-offs
|
|
1033
|
+
- Implementation strategies
|
|
1034
|
+
- Consider "do nothing" option
|
|
1035
|
+
|
|
1036
|
+
### 4. Make Decisions
|
|
1037
|
+
- Document rationale for each decision
|
|
1038
|
+
- Consider alternatives and why rejected
|
|
1039
|
+
- Get user input on key decisions
|
|
1040
|
+
- Record decisions in patterns.md
|
|
1041
|
+
|
|
1042
|
+
### 5. Create Actionable Steps
|
|
1043
|
+
- Specific files to create/modify
|
|
1044
|
+
- Exact commands to run
|
|
1045
|
+
- Clear acceptance criteria
|
|
1046
|
+
- Dependencies between steps
|
|
1047
|
+
|
|
1048
|
+
## Plan Quality Checklist
|
|
1049
|
+
|
|
1050
|
+
### Completeness
|
|
1051
|
+
- [ ] All requirements addressed
|
|
1052
|
+
- [ ] Dependencies identified
|
|
1053
|
+
- [ ] Risks assessed with mitigation
|
|
1054
|
+
- [ ] Success criteria defined
|
|
1055
|
+
|
|
1056
|
+
### Clarity
|
|
1057
|
+
- [ ] Easy to understand for implementer
|
|
1058
|
+
- [ ] Specific, actionable steps
|
|
1059
|
+
- [ ] No ambiguous language
|
|
1060
|
+
- [ ] Clear ownership and responsibilities
|
|
1061
|
+
|
|
1062
|
+
### Feasibility
|
|
1063
|
+
- [ ] Realistic timeline
|
|
1064
|
+
- [ ] Available resources match scope
|
|
1065
|
+
- [ ] Technical feasibility confirmed
|
|
1066
|
+
- [ ] Dependencies can be satisfied
|
|
1067
|
+
|
|
1068
|
+
### Testability
|
|
1069
|
+
- [ ] Success criteria measurable
|
|
1070
|
+
- [ ] Verification steps defined
|
|
1071
|
+
- [ ] Acceptance criteria clear
|
|
1072
|
+
- [ ] Rollback plan defined
|
|
1073
|
+
|
|
1074
|
+
## For Planner Agent
|
|
1075
|
+
|
|
1076
|
+
### Before Creating Plan
|
|
1077
|
+
1. Load memory (activeContext, patterns, progress)
|
|
1078
|
+
2. Ask clarifying questions if requirements unclear
|
|
1079
|
+
3. Consider project context and constraints
|
|
1080
|
+
4. Identify research needs early
|
|
1081
|
+
|
|
1082
|
+
### During Planning
|
|
1083
|
+
1. Follow the structure above
|
|
1084
|
+
2. Document decisions with rationale
|
|
1085
|
+
3. Consider multiple approaches
|
|
1086
|
+
4. Identify risks and mitigation
|
|
1087
|
+
5. Create specific, actionable steps
|
|
1088
|
+
|
|
1089
|
+
### After Planning
|
|
1090
|
+
1. Save plan to docs/plans/YYYY-MM-DD-<topic>-plan.md
|
|
1091
|
+
2. Update activeContext.md with plan reference
|
|
1092
|
+
3. Record key decisions in patterns.md
|
|
1093
|
+
4. Set next steps in activeContext.md
|
|
1094
|
+
5. Request research if needed (github-research skill)
|
|
1095
|
+
|
|
1096
|
+
## Plan Template
|
|
1097
|
+
\`\`\`markdown
|
|
1098
|
+
# [Plan Title]
|
|
1099
|
+
|
|
1100
|
+
## Executive Summary
|
|
1101
|
+
[One paragraph overview]
|
|
1102
|
+
|
|
1103
|
+
## Requirements Analysis
|
|
1104
|
+
- Functional: [list]
|
|
1105
|
+
- Non-functional: [performance, security, etc.]
|
|
1106
|
+
- Constraints: [timeline, budget, technical]
|
|
1107
|
+
|
|
1108
|
+
## Architecture Decisions
|
|
1109
|
+
- [Decision]: [Choice] - [Rationale]
|
|
1110
|
+
- [Decision]: [Choice] - [Rationale]
|
|
1111
|
+
|
|
1112
|
+
## Implementation Phases
|
|
1113
|
+
### Phase 1: [Name]
|
|
1114
|
+
- [ ] Task 1
|
|
1115
|
+
- [ ] Task 2
|
|
1116
|
+
- Success criteria: [measurable]
|
|
1117
|
+
|
|
1118
|
+
### Phase 2: [Name]
|
|
1119
|
+
- [ ] Task 1
|
|
1120
|
+
- [ ] Task 2
|
|
1121
|
+
- Success criteria: [measurable]
|
|
1122
|
+
|
|
1123
|
+
## Risk Assessment
|
|
1124
|
+
- [Risk]: [Mitigation strategy]
|
|
1125
|
+
|
|
1126
|
+
## Testing Strategy
|
|
1127
|
+
- [Test type]: [Approach]
|
|
1128
|
+
|
|
1129
|
+
## Research Needs
|
|
1130
|
+
- [Topic] - [Why needed]
|
|
1131
|
+
|
|
1132
|
+
## Success Criteria
|
|
1133
|
+
- [Measurable outcome 1]
|
|
1134
|
+
- [Measurable outcome 2]
|
|
1135
|
+
\`\`\`
|
|
1136
|
+
|
|
1137
|
+
## Common Planning Mistakes
|
|
1138
|
+
- ❌ Vague, non-actionable steps
|
|
1139
|
+
- ❌ Missing dependencies between tasks
|
|
1140
|
+
- ❌ No risk assessment
|
|
1141
|
+
- ❌ Unclear success criteria
|
|
1142
|
+
- ❌ Ignoring team capabilities
|
|
1143
|
+
- ❌ No rollback or contingency plan
|
|
1144
|
+
|
|
1145
|
+
## Integration with Build
|
|
1146
|
+
The plan should be detailed enough that component-builder can:
|
|
1147
|
+
- Follow phases sequentially
|
|
1148
|
+
- Understand exact files to modify
|
|
1149
|
+
- Know test commands to run
|
|
1150
|
+
- Follow specific code patterns
|
|
1151
|
+
- Verify completion against success criteria
|
|
1152
|
+
|
|
1153
|
+
## Memory Updates
|
|
1154
|
+
- activeContext.md: Add plan reference in References section
|
|
1155
|
+
- patterns.md: Record architectural decisions
|
|
1156
|
+
- progress.md: Create tasks from plan phases
|
|
1157
|
+
|
|
1158
|
+
## User Interaction
|
|
1159
|
+
- Ask clarifying questions before finalizing
|
|
1160
|
+
- Present options with pros/cons
|
|
1161
|
+
- Get approval on key decisions
|
|
1162
|
+
- Confirm understanding of constraints`
|
|
1163
|
+
},
|
|
1164
|
+
{
|
|
1165
|
+
name: 'cc10x-brainstorming',
|
|
1166
|
+
description: 'Creative ideation and exploration of multiple approaches. Used by planner during analysis phase.',
|
|
1167
|
+
license: 'MIT',
|
|
1168
|
+
compatibility: 'opencode',
|
|
1169
|
+
metadata: {
|
|
1170
|
+
audience: 'planner',
|
|
1171
|
+
purpose: 'creative-ideation',
|
|
1172
|
+
required: 'false'
|
|
1173
|
+
},
|
|
1174
|
+
content: `# Brainstorming
|
|
1175
|
+
|
|
1176
|
+
**Goal:** Generate multiple creative approaches before settling on solution.
|
|
1177
|
+
|
|
1178
|
+
## When to Brainstorm
|
|
1179
|
+
|
|
1180
|
+
### Early in Planning
|
|
1181
|
+
- When problem is open-ended
|
|
1182
|
+
- Multiple valid approaches exist
|
|
1183
|
+
- Need innovative solutions
|
|
1184
|
+
- Exploring design space
|
|
1185
|
+
|
|
1186
|
+
### When Stuck
|
|
1187
|
+
- Standard approaches don't fit
|
|
1188
|
+
- Constraints limit usual solutions
|
|
1189
|
+
- Need breakthrough thinking
|
|
1190
|
+
- Considering radical alternatives
|
|
1191
|
+
|
|
1192
|
+
## Brainstorming Rules
|
|
1193
|
+
|
|
1194
|
+
### 1. Defer Judgment
|
|
1195
|
+
- No criticism during idea generation
|
|
1196
|
+
- All ideas welcome, no matter how wild
|
|
1197
|
+
- Quantity over quality initially
|
|
1198
|
+
- Build on others' ideas
|
|
1199
|
+
|
|
1200
|
+
### 2. Encourage Wild Ideas
|
|
1201
|
+
- Unconventional approaches
|
|
1202
|
+
- "What if" scenarios
|
|
1203
|
+
- Challenge assumptions
|
|
1204
|
+
- Think beyond current constraints
|
|
1205
|
+
|
|
1206
|
+
### 3. Seek Combinations
|
|
1207
|
+
- Hybrid approaches
|
|
1208
|
+
- Adapt solutions from other domains
|
|
1209
|
+
- Combine multiple ideas
|
|
1210
|
+
- Look for synergies
|
|
1211
|
+
|
|
1212
|
+
### 4. Stay Focused
|
|
1213
|
+
- Keep problem statement visible
|
|
1214
|
+
- Don't wander to unrelated topics
|
|
1215
|
+
- Timebox brainstorming sessions
|
|
1216
|
+
- Return to core requirements
|
|
1217
|
+
|
|
1218
|
+
## Brainstorming Techniques
|
|
1219
|
+
|
|
1220
|
+
### Mind Mapping
|
|
1221
|
+
- Start with central problem
|
|
1222
|
+
- Branch out with sub-problems
|
|
1223
|
+
- Add solutions to each branch
|
|
1224
|
+
- Look for connections between branches
|
|
1225
|
+
|
|
1226
|
+
### SCAMPER
|
|
1227
|
+
- **Substitute**: What can we replace?
|
|
1228
|
+
- **Combine**: What can we merge?
|
|
1229
|
+
- **Adapt**: What can we borrow from elsewhere?
|
|
1230
|
+
- **Modify**: What can we change?
|
|
1231
|
+
- **Put to other uses**: How else could this work?
|
|
1232
|
+
- **Eliminate**: What can we remove?
|
|
1233
|
+
- **Reverse**: What if we did the opposite?
|
|
1234
|
+
|
|
1235
|
+
### Worst Possible Idea
|
|
1236
|
+
- Deliberately think of terrible solutions
|
|
1237
|
+
- Then reverse or improve them
|
|
1238
|
+
- Breaks mental set patterns
|
|
1239
|
+
- Often leads to innovative approaches
|
|
1240
|
+
|
|
1241
|
+
### Analogies
|
|
1242
|
+
- How would nature solve this?
|
|
1243
|
+
- How would other industries solve this?
|
|
1244
|
+
- What's the historical precedent?
|
|
1245
|
+
- What's the opposite domain's approach?
|
|
1246
|
+
|
|
1247
|
+
## For Planner
|
|
1248
|
+
|
|
1249
|
+
### During Analysis Phase
|
|
1250
|
+
1. **Define problem clearly** - What exactly are we solving?
|
|
1251
|
+
2. **Generate multiple approaches** - At least 3-5 distinct options
|
|
1252
|
+
3. **Explore each briefly** - High-level pros/cons
|
|
1253
|
+
4. **Evaluate against criteria** - Fit requirements, constraints
|
|
1254
|
+
5. **Select and refine** - Choose best approach, enhance it
|
|
1255
|
+
|
|
1256
|
+
### Documenting Brainstorming
|
|
1257
|
+
|
|
1258
|
+
#### Options Considered
|
|
1259
|
+
For each approach:
|
|
1260
|
+
- **Description**: How it works
|
|
1261
|
+
- **Pros**: Advantages
|
|
1262
|
+
- **Cons**: Disadvantages
|
|
1263
|
+
- **Complexity**: Implementation difficulty
|
|
1264
|
+
- **Risk**: Potential issues
|
|
1265
|
+
- **Fit**: How well it matches requirements
|
|
1266
|
+
|
|
1267
|
+
#### Decision Rationale
|
|
1268
|
+
- Why chosen approach is best
|
|
1269
|
+
- Why others were rejected
|
|
1270
|
+
- Trade-offs accepted
|
|
1271
|
+
- Risks and mitigations
|
|
1272
|
+
|
|
1273
|
+
## Creative Constraints
|
|
1274
|
+
|
|
1275
|
+
### Technical Constraints
|
|
1276
|
+
- Current technology stack
|
|
1277
|
+
- Team expertise
|
|
1278
|
+
- Infrastructure limitations
|
|
1279
|
+
- Budget and timeline
|
|
1280
|
+
|
|
1281
|
+
### Business Constraints
|
|
1282
|
+
- User needs and preferences
|
|
1283
|
+
- Regulatory requirements
|
|
1284
|
+
- Market conditions
|
|
1285
|
+
- Competitive landscape
|
|
1286
|
+
|
|
1287
|
+
### Design Constraints
|
|
1288
|
+
- Performance requirements
|
|
1289
|
+
- Security requirements
|
|
1290
|
+
- Scalability needs
|
|
1291
|
+
- Maintainability requirements
|
|
1292
|
+
|
|
1293
|
+
## Evaluation Criteria
|
|
1294
|
+
|
|
1295
|
+
### Feasibility
|
|
1296
|
+
- Can we build this with current resources?
|
|
1297
|
+
- Do we have the necessary expertise?
|
|
1298
|
+
- Is timeline realistic?
|
|
1299
|
+
|
|
1300
|
+
### Effectiveness
|
|
1301
|
+
- Does it solve the core problem?
|
|
1302
|
+
- How well does it meet requirements?
|
|
1303
|
+
- What's the user experience?
|
|
1304
|
+
|
|
1305
|
+
### Efficiency
|
|
1306
|
+
- Resource usage (CPU, memory, network)
|
|
1307
|
+
- Development and maintenance cost
|
|
1308
|
+
- Operational complexity
|
|
1309
|
+
|
|
1310
|
+
### Adaptability
|
|
1311
|
+
- How well does it handle change?
|
|
1312
|
+
- Can it scale if needed?
|
|
1313
|
+
- Is it extensible for future needs?
|
|
1314
|
+
|
|
1315
|
+
## Common Brainstorming Pitfalls
|
|
1316
|
+
|
|
1317
|
+
### ❌ Early Convergence
|
|
1318
|
+
- Settling on first reasonable idea
|
|
1319
|
+
- Not exploring alternatives
|
|
1320
|
+
- Missing better solutions
|
|
1321
|
+
|
|
1322
|
+
### ❌ Idea Killing
|
|
1323
|
+
- Criticizing during generation
|
|
1324
|
+
- Dismissing "crazy" ideas too quickly
|
|
1325
|
+
- Not building on others' thoughts
|
|
1326
|
+
|
|
1327
|
+
### ❌ Scope Creep
|
|
1328
|
+
- Adding unrelated features
|
|
1329
|
+
- Losing focus on core problem
|
|
1330
|
+
- Trying to solve too many problems
|
|
1331
|
+
|
|
1332
|
+
### ❌ Analysis Paralysis
|
|
1333
|
+
- Too much discussion, no decisions
|
|
1334
|
+
- Fear of making wrong choice
|
|
1335
|
+
- Infinite refinement
|
|
1336
|
+
|
|
1337
|
+
## Output for Planning
|
|
1338
|
+
|
|
1339
|
+
### Include in Plan Document
|
|
1340
|
+
- Options considered with pros/cons
|
|
1341
|
+
- Decision rationale
|
|
1342
|
+
- Alternative approaches documented
|
|
1343
|
+
- Room for future pivots
|
|
1344
|
+
|
|
1345
|
+
### Update Memory
|
|
1346
|
+
- Record key insights in activeContext.md
|
|
1347
|
+
- Document decision in patterns.md
|
|
1348
|
+
- Note creative approaches for future reference
|
|
1349
|
+
|
|
1350
|
+
## Examples
|
|
1351
|
+
|
|
1352
|
+
### Problem: "Build a task tracker"
|
|
1353
|
+
**Options:**
|
|
1354
|
+
1. **Simple file-based** - JSON file, CLI interface
|
|
1355
|
+
- Pros: Simple, fast to build, no dependencies
|
|
1356
|
+
- Cons: No collaboration, limited features
|
|
1357
|
+
2. **Web app with database** - Full-stack with PostgreSQL
|
|
1358
|
+
- Pros: Scalable, collaborative, rich features
|
|
1359
|
+
- Cons: Complex, longer timeline
|
|
1360
|
+
3. **Git-based** - Use git as backend, markdown files
|
|
1361
|
+
- Pros: Version control, simple, portable
|
|
1362
|
+
- Cons: Limited querying, git conflicts possible
|
|
1363
|
+
|
|
1364
|
+
**Selected:** Web app with database (best fits scalability and collaboration needs)
|
|
1365
|
+
|
|
1366
|
+
### Problem: "Debug intermittent crash"
|
|
1367
|
+
**Options:**
|
|
1368
|
+
1. **Add more logging** - Instrument code extensively
|
|
1369
|
+
2. **Binary search** - Disable features until crash stops
|
|
1370
|
+
3. **Statistical profiling** - Run many times, analyze patterns
|
|
1371
|
+
4. **Race condition detection** - Use specialized tools
|
|
1372
|
+
|
|
1373
|
+
**Selected:** Combination: Add logging + statistical profiling (most likely to catch intermittent issues)
|
|
1374
|
+
|
|
1375
|
+
## Next Steps After Brainstorming
|
|
1376
|
+
1. Evaluate options against criteria
|
|
1377
|
+
2. Select best approach
|
|
1378
|
+
3. Create detailed implementation plan
|
|
1379
|
+
4. Identify research needs for selected approach
|
|
1380
|
+
5. Document decision rationale
|
|
1381
|
+
|
|
1382
|
+
Remember: The goal is not to find the "perfect" solution, but a "good enough" solution that can be implemented and improved upon.`
|
|
1383
|
+
},
|
|
1384
|
+
{
|
|
1385
|
+
name: 'cc10x-architecture-patterns',
|
|
1386
|
+
description: 'System design patterns, API design principles, and architectural decision records. Used by all agents for consistent architecture.',
|
|
1387
|
+
license: 'MIT',
|
|
1388
|
+
compatibility: 'opencode',
|
|
1389
|
+
metadata: {
|
|
1390
|
+
audience: 'all-agents',
|
|
1391
|
+
purpose: 'architecture-guidance',
|
|
1392
|
+
required: 'false'
|
|
1393
|
+
},
|
|
1394
|
+
content: `# Architecture Patterns
|
|
1395
|
+
|
|
1396
|
+
**Purpose:** Consistent system design and API patterns across the project.
|
|
1397
|
+
|
|
1398
|
+
## System Architecture Patterns
|
|
1399
|
+
|
|
1400
|
+
### Layered Architecture
|
|
1401
|
+
- **Presentation Layer**: UI, API endpoints, CLI
|
|
1402
|
+
- **Business Logic Layer**: Services, domain models, use cases
|
|
1403
|
+
- **Data Access Layer**: Repositories, data mappers, ORM
|
|
1404
|
+
- **Infrastructure Layer**: Databases, external services, frameworks
|
|
1405
|
+
|
|
1406
|
+
### Microservices
|
|
1407
|
+
- Service boundaries by business capability
|
|
1408
|
+
- API contracts between services
|
|
1409
|
+
- Independent deployment
|
|
1410
|
+
- Service discovery and configuration
|
|
1411
|
+
|
|
1412
|
+
### Event-Driven
|
|
1413
|
+
- Publish-subscribe patterns
|
|
1414
|
+
- Event sourcing for audit trails
|
|
1415
|
+
- Async processing for scalability
|
|
1416
|
+
- Eventual consistency models
|
|
1417
|
+
|
|
1418
|
+
## API Design Patterns
|
|
1419
|
+
|
|
1420
|
+
### RESTful Principles
|
|
1421
|
+
- Resource-oriented design
|
|
1422
|
+
- Proper HTTP methods (GET, POST, PUT, DELETE)
|
|
1423
|
+
- Stateless operations
|
|
1424
|
+
- HATEOAS for discoverability
|
|
1425
|
+
- Versioning strategy
|
|
1426
|
+
|
|
1427
|
+
### GraphQL
|
|
1428
|
+
- Schema-first design
|
|
1429
|
+
- Resolvers for data fetching
|
|
1430
|
+
- N+1 query optimization
|
|
1431
|
+
- Caching strategies
|
|
1432
|
+
|
|
1433
|
+
### gRPC
|
|
1434
|
+
- Protocol buffers for contracts
|
|
1435
|
+
- Streaming for real-time
|
|
1436
|
+
- Strong typing
|
|
1437
|
+
- Performance optimization
|
|
1438
|
+
|
|
1439
|
+
## Data Architecture
|
|
1440
|
+
|
|
1441
|
+
### Database Design
|
|
1442
|
+
- Normalization vs denormalization
|
|
1443
|
+
- Indexing strategies
|
|
1444
|
+
- Partitioning and sharding
|
|
1445
|
+
- Migration strategies
|
|
1446
|
+
|
|
1447
|
+
### Caching Patterns
|
|
1448
|
+
- Cache-aside pattern
|
|
1449
|
+
- Write-through caching
|
|
1450
|
+
- Cache invalidation strategies
|
|
1451
|
+
- Multi-level caching
|
|
1452
|
+
|
|
1453
|
+
## Security Architecture
|
|
1454
|
+
|
|
1455
|
+
### Authentication
|
|
1456
|
+
- OAuth 2.0 / OpenID Connect
|
|
1457
|
+
- JWT token management
|
|
1458
|
+
- Session management
|
|
1459
|
+
- Multi-factor authentication
|
|
1460
|
+
|
|
1461
|
+
### Authorization
|
|
1462
|
+
- Role-based access control (RBAC)
|
|
1463
|
+
- Attribute-based access control (ABAC)
|
|
1464
|
+
- Principle of least privilege
|
|
1465
|
+
- Defense in depth
|
|
1466
|
+
|
|
1467
|
+
### Data Protection
|
|
1468
|
+
- Encryption at rest and in transit
|
|
1469
|
+
- Secrets management
|
|
1470
|
+
- PII handling and GDPR compliance
|
|
1471
|
+
- Audit logging
|
|
1472
|
+
|
|
1473
|
+
## Reliability Patterns
|
|
1474
|
+
|
|
1475
|
+
### Error Handling
|
|
1476
|
+
- Retry with exponential backoff
|
|
1477
|
+
- Circuit breaker pattern
|
|
1478
|
+
- Bulkhead isolation
|
|
1479
|
+
- Graceful degradation
|
|
1480
|
+
|
|
1481
|
+
### Observability
|
|
1482
|
+
- Structured logging
|
|
1483
|
+
- Distributed tracing
|
|
1484
|
+
- Metrics collection
|
|
1485
|
+
- Health checks
|
|
1486
|
+
|
|
1487
|
+
### Deployment
|
|
1488
|
+
- Blue-green deployments
|
|
1489
|
+
- Canary releases
|
|
1490
|
+
- Feature flags
|
|
1491
|
+
- Rollback strategies
|
|
1492
|
+
|
|
1493
|
+
## Code Organization
|
|
1494
|
+
|
|
1495
|
+
### Project Structure
|
|
1496
|
+
\`\`\`
|
|
1497
|
+
src/
|
|
1498
|
+
domain/ # Business logic, entities
|
|
1499
|
+
application/ # Use cases, services
|
|
1500
|
+
infrastructure/ # External services, databases
|
|
1501
|
+
presentation/ # API, UI, CLI
|
|
1502
|
+
shared/ # Common utilities
|
|
1503
|
+
\`\`\`
|
|
1504
|
+
|
|
1505
|
+
### Module Organization
|
|
1506
|
+
- Feature-based modules
|
|
1507
|
+
- Clear module boundaries
|
|
1508
|
+
- Dependency direction (inner → outer)
|
|
1509
|
+
- Interface segregation
|
|
1510
|
+
|
|
1511
|
+
## Decision Records (ADRs)
|
|
1512
|
+
|
|
1513
|
+
### Format
|
|
1514
|
+
\`\`\`markdown
|
|
1515
|
+
# ADR: [Decision Title]
|
|
1516
|
+
|
|
1517
|
+
## Status
|
|
1518
|
+
[Proposed | Accepted | Deprecated | Superseded]
|
|
1519
|
+
|
|
1520
|
+
## Context
|
|
1521
|
+
[Problem, constraints, forces]
|
|
1522
|
+
|
|
1523
|
+
## Decision
|
|
1524
|
+
[What we decided]
|
|
1525
|
+
|
|
1526
|
+
## Consequences
|
|
1527
|
+
[Positive and negative outcomes]
|
|
1528
|
+
|
|
1529
|
+
## Alternatives Considered
|
|
1530
|
+
- [Alternative 1]: [Why rejected]
|
|
1531
|
+
- [Alternative 2]: [Why rejected]
|
|
1532
|
+
\`\`\`
|
|
1533
|
+
|
|
1534
|
+
### When to Create ADRs
|
|
1535
|
+
- Significant architectural decisions
|
|
1536
|
+
- Technology choices with trade-offs
|
|
1537
|
+
- Pattern adoption or rejection
|
|
1538
|
+
- Major refactoring decisions
|
|
1539
|
+
|
|
1540
|
+
## For All Agents
|
|
1541
|
+
|
|
1542
|
+
### Before Making Architectural Decisions
|
|
1543
|
+
1. Check patterns.md for existing decisions
|
|
1544
|
+
2. Consider established patterns in this project
|
|
1545
|
+
3. Document new decisions in patterns.md
|
|
1546
|
+
4. Update activeContext.md with decision context
|
|
1547
|
+
|
|
1548
|
+
### Consistency Rules
|
|
1549
|
+
- Follow existing patterns unless there's a good reason not to
|
|
1550
|
+
- Document deviations from patterns
|
|
1551
|
+
- Consider migration path for inconsistencies
|
|
1552
|
+
- Update patterns.md when establishing new conventions
|
|
1553
|
+
|
|
1554
|
+
### Common Gotchas
|
|
1555
|
+
- Over-engineering for future requirements
|
|
1556
|
+
- Premature optimization
|
|
1557
|
+
- Ignoring operational concerns
|
|
1558
|
+
- Underestimating complexity
|
|
1559
|
+
- Not considering testing implications
|
|
1560
|
+
|
|
1561
|
+
## Technology Selection
|
|
1562
|
+
|
|
1563
|
+
### Evaluation Criteria
|
|
1564
|
+
- **Fit**: Solves the problem effectively
|
|
1565
|
+
- **Maturity**: Stable, well-tested, production-ready
|
|
1566
|
+
- **Community**: Active development, good ecosystem
|
|
1567
|
+
- **Learning Curve**: Team can become productive
|
|
1568
|
+
- **Cost**: Licensing, hosting, maintenance
|
|
1569
|
+
- **Compatibility**: Integrates with existing stack
|
|
1570
|
+
|
|
1571
|
+
### Decision Process
|
|
1572
|
+
1. Define requirements and constraints
|
|
1573
|
+
2. Research options (use github-research skill)
|
|
1574
|
+
3. Create evaluation matrix
|
|
1575
|
+
4. Proof of concept for top candidates
|
|
1576
|
+
5. Final decision with rationale
|
|
1577
|
+
|
|
1578
|
+
## Performance Patterns
|
|
1579
|
+
|
|
1580
|
+
### Database
|
|
1581
|
+
- Use appropriate indexes
|
|
1582
|
+
- Avoid N+1 queries
|
|
1583
|
+
- Connection pooling
|
|
1584
|
+
- Query optimization
|
|
1585
|
+
|
|
1586
|
+
### Caching
|
|
1587
|
+
- Cache expensive operations
|
|
1588
|
+
- Implement cache invalidation
|
|
1589
|
+
- Consider cache warming
|
|
1590
|
+
- Use appropriate TTLs
|
|
1591
|
+
|
|
1592
|
+
### Async Processing
|
|
1593
|
+
- Queue for long-running tasks
|
|
1594
|
+
- Background job processing
|
|
1595
|
+
- Event-driven communication
|
|
1596
|
+
- Rate limiting
|
|
1597
|
+
|
|
1598
|
+
## Testing Architecture
|
|
1599
|
+
|
|
1600
|
+
### Test Pyramid
|
|
1601
|
+
- Many unit tests (fast, isolated)
|
|
1602
|
+
- Fewer integration tests (component interaction)
|
|
1603
|
+
- Few end-to-end tests (full user journeys)
|
|
1604
|
+
|
|
1605
|
+
### Test Data Management
|
|
1606
|
+
- Fixtures for consistent test data
|
|
1607
|
+
- Database transactions for isolation
|
|
1608
|
+
- Mock external dependencies
|
|
1609
|
+
- Test environment parity
|
|
1610
|
+
|
|
1611
|
+
## Migration Patterns
|
|
1612
|
+
|
|
1613
|
+
### Database Migrations
|
|
1614
|
+
- Versioned migration scripts
|
|
1615
|
+
- Forward and backward compatibility
|
|
1616
|
+
- Zero-downtime migrations
|
|
1617
|
+
- Rollback procedures
|
|
1618
|
+
|
|
1619
|
+
### Code Migrations
|
|
1620
|
+
- Strangler fig pattern for legacy replacement
|
|
1621
|
+
- Feature flags for gradual rollout
|
|
1622
|
+
- Deprecation strategies
|
|
1623
|
+
- Compatibility layers
|
|
1624
|
+
|
|
1625
|
+
## Documentation
|
|
1626
|
+
|
|
1627
|
+
### Architecture Decision Records
|
|
1628
|
+
- Store in docs/architecture/adr-XXX.md
|
|
1629
|
+
- Link from patterns.md
|
|
1630
|
+
- Keep updated with current state
|
|
1631
|
+
|
|
1632
|
+
### API Documentation
|
|
1633
|
+
- OpenAPI/Swagger for REST APIs
|
|
1634
|
+
- GraphQL schema documentation
|
|
1635
|
+
- gRPC proto file comments
|
|
1636
|
+
- Example requests/responses
|
|
1637
|
+
|
|
1638
|
+
### Code Documentation
|
|
1639
|
+
- README for each module
|
|
1640
|
+
- Inline comments for complex logic
|
|
1641
|
+
- Architecture diagrams (mermaid, plantuml)
|
|
1642
|
+
- Deployment guides
|
|
1643
|
+
|
|
1644
|
+
## For component-builder
|
|
1645
|
+
- Follow established architecture patterns
|
|
1646
|
+
- Ask if unsure about architectural approach
|
|
1647
|
+
- Document any deviations from patterns
|
|
1648
|
+
- Update patterns.md with new conventions
|
|
1649
|
+
|
|
1650
|
+
## For planner
|
|
1651
|
+
- Consider architecture in planning phase
|
|
1652
|
+
- Document architectural decisions in plan
|
|
1653
|
+
- Research architectural patterns if needed
|
|
1654
|
+
- Create ADRs for significant decisions
|
|
1655
|
+
|
|
1656
|
+
## For code-reviewer
|
|
1657
|
+
- Check adherence to architectural patterns
|
|
1658
|
+
- Flag architectural violations
|
|
1659
|
+
- Consider consistency with existing code
|
|
1660
|
+
- Suggest pattern improvements
|
|
1661
|
+
|
|
1662
|
+
## Memory Updates
|
|
1663
|
+
When architectural decisions are made:
|
|
1664
|
+
- Add to patterns.md Architecture Decisions section
|
|
1665
|
+
- Reference in activeContext.md Decisions
|
|
1666
|
+
- Create ADR document if significant
|
|
1667
|
+
- Update relevant module documentation`
|
|
1668
|
+
},
|
|
1669
|
+
{
|
|
1670
|
+
name: 'cc10x-frontend-patterns',
|
|
1671
|
+
description: 'Frontend development patterns, accessibility, and UX best practices. Used by all agents for UI/UX work.',
|
|
1672
|
+
license: 'MIT',
|
|
1673
|
+
compatibility: 'opencode',
|
|
1674
|
+
metadata: {
|
|
1675
|
+
audience: 'all-agents',
|
|
1676
|
+
purpose: 'frontend-guidance',
|
|
1677
|
+
required: 'false'
|
|
1678
|
+
},
|
|
1679
|
+
content: `# Frontend Patterns
|
|
1680
|
+
|
|
1681
|
+
**Focus:** User experience, accessibility, performance, and maintainability.
|
|
1682
|
+
|
|
1683
|
+
## UI/UX Principles
|
|
1684
|
+
|
|
1685
|
+
### User-Centered Design
|
|
1686
|
+
- Clear visual hierarchy
|
|
1687
|
+
- Consistent interaction patterns
|
|
1688
|
+
- Immediate feedback for user actions
|
|
1689
|
+
- Error prevention and recovery
|
|
1690
|
+
- Progressive disclosure of complexity
|
|
1691
|
+
|
|
1692
|
+
### Accessibility (WCAG 2.1 AA)
|
|
1693
|
+
- **Perceivable**: Text alternatives, captions, color contrast
|
|
1694
|
+
- **Operable**: Keyboard navigation, sufficient time, no seizures
|
|
1695
|
+
- **Understandable**: Readable text, predictable behavior
|
|
1696
|
+
- **Robust**: Compatible with assistive technologies
|
|
1697
|
+
|
|
1698
|
+
### Performance
|
|
1699
|
+
- First Contentful Paint < 1s
|
|
1700
|
+
- Time to Interactive < 3s
|
|
1701
|
+
- Core Web Vitals optimization
|
|
1702
|
+
- Efficient bundle size
|
|
1703
|
+
- Lazy loading for non-critical resources
|
|
1704
|
+
|
|
1705
|
+
## Component Patterns
|
|
1706
|
+
|
|
1707
|
+
### Atomic Design
|
|
1708
|
+
- **Atoms**: Basic elements (buttons, inputs, labels)
|
|
1709
|
+
- **Molecules**: Simple component combinations
|
|
1710
|
+
- **Organisms**: Complex UI sections
|
|
1711
|
+
- **Templates**: Page layouts
|
|
1712
|
+
- **Pages**: Specific instances with data
|
|
1713
|
+
|
|
1714
|
+
### Component API Design
|
|
1715
|
+
- Clear, consistent props interface
|
|
1716
|
+
- Sensible defaults
|
|
1717
|
+
- Composition over configuration
|
|
1718
|
+
- Prop drilling avoidance (context/state management)
|
|
1719
|
+
- Type safety (TypeScript)
|
|
1720
|
+
|
|
1721
|
+
### State Management
|
|
1722
|
+
- Local state for component-specific data
|
|
1723
|
+
- Shared state for cross-component data
|
|
1724
|
+
- Server state for API data (React Query, SWR)
|
|
1725
|
+
- URL state for shareable links
|
|
1726
|
+
|
|
1727
|
+
## CSS Patterns
|
|
1728
|
+
|
|
1729
|
+
### CSS Architecture
|
|
1730
|
+
- BEM (Block Element Modifier) naming
|
|
1731
|
+
- CSS Modules for scoping
|
|
1732
|
+
- CSS-in-JS for dynamic styles
|
|
1733
|
+
- Utility-first (Tailwind) for consistency
|
|
1734
|
+
|
|
1735
|
+
### Responsive Design
|
|
1736
|
+
- Mobile-first approach
|
|
1737
|
+
- Breakpoint strategy (sm, md, lg, xl)
|
|
1738
|
+
- Fluid typography and spacing
|
|
1739
|
+
- Touch-friendly targets (44x44px minimum)
|
|
1740
|
+
|
|
1741
|
+
### Theming
|
|
1742
|
+
- CSS custom properties for theming
|
|
1743
|
+
- Design tokens for consistency
|
|
1744
|
+
- Dark mode support
|
|
1745
|
+
- Accessibility considerations (high contrast)
|
|
1746
|
+
|
|
1747
|
+
## JavaScript/TypeScript Patterns
|
|
1748
|
+
|
|
1749
|
+
### React Patterns
|
|
1750
|
+
- Functional components with hooks
|
|
1751
|
+
- Custom hooks for reusable logic
|
|
1752
|
+
- Compound components for flexibility
|
|
1753
|
+
- Render props for behavior sharing
|
|
1754
|
+
- Error boundaries for error handling
|
|
1755
|
+
|
|
1756
|
+
### Vue Patterns
|
|
1757
|
+
- Composition API for logic reuse
|
|
1758
|
+
- Provide/inject for dependency injection
|
|
1759
|
+
- Scoped slots for flexibility
|
|
1760
|
+
- Mixins for cross-cutting concerns
|
|
1761
|
+
|
|
1762
|
+
### Angular Patterns
|
|
1763
|
+
- Services for business logic
|
|
1764
|
+
- Dependency injection
|
|
1765
|
+
- RxJS for reactive programming
|
|
1766
|
+
- NgModules for organization
|
|
1767
|
+
|
|
1768
|
+
## Performance Patterns
|
|
1769
|
+
|
|
1770
|
+
### Code Splitting
|
|
1771
|
+
- Route-based splitting
|
|
1772
|
+
- Component-based splitting
|
|
1773
|
+
- Dynamic imports for heavy dependencies
|
|
1774
|
+
- Preloading critical resources
|
|
1775
|
+
|
|
1776
|
+
### Image Optimization
|
|
1777
|
+
- Modern formats (WebP, AVIF)
|
|
1778
|
+
- Responsive images (srcset)
|
|
1779
|
+
- Lazy loading for below-the-fold
|
|
1780
|
+
- Image CDN with optimization
|
|
1781
|
+
|
|
1782
|
+
### Bundle Optimization
|
|
1783
|
+
- Tree shaking for unused code
|
|
1784
|
+
- Code minification and compression
|
|
1785
|
+
- Dependency analysis (webpack-bundle-analyzer)
|
|
1786
|
+
- Vendor chunking for caching
|
|
1787
|
+
|
|
1788
|
+
## Testing Frontend
|
|
1789
|
+
|
|
1790
|
+
### Unit Testing
|
|
1791
|
+
- Component rendering and props
|
|
1792
|
+
- User interactions (click, type, etc.)
|
|
1793
|
+
- State changes and side effects
|
|
1794
|
+
- Utility functions and hooks
|
|
1795
|
+
|
|
1796
|
+
### Integration Testing
|
|
1797
|
+
- Component composition
|
|
1798
|
+
- Data flow between components
|
|
1799
|
+
- API integration with mocks
|
|
1800
|
+
- State management interactions
|
|
1801
|
+
|
|
1802
|
+
### End-to-End Testing
|
|
1803
|
+
- Critical user journeys
|
|
1804
|
+
- Cross-browser compatibility
|
|
1805
|
+
- Mobile responsiveness
|
|
1806
|
+
- Performance budgets
|
|
1807
|
+
|
|
1808
|
+
### Testing Tools
|
|
1809
|
+
- Jest/Vitest for unit tests
|
|
1810
|
+
- React Testing Library/Vue Test Utils
|
|
1811
|
+
- Cypress/Playwright for E2E
|
|
1812
|
+
- Storybook for visual testing
|
|
1813
|
+
|
|
1814
|
+
## Accessibility Patterns
|
|
1815
|
+
|
|
1816
|
+
### Semantic HTML
|
|
1817
|
+
- Proper heading hierarchy (h1-h6)
|
|
1818
|
+
- Landmark elements (nav, main, footer)
|
|
1819
|
+
- Alt text for images
|
|
1820
|
+
- Form labels and descriptions
|
|
1821
|
+
|
|
1822
|
+
### Keyboard Navigation
|
|
1823
|
+
- Logical tab order
|
|
1824
|
+
- Visible focus indicators
|
|
1825
|
+
- Skip links for navigation
|
|
1826
|
+
- Keyboard shortcuts with alternatives
|
|
1827
|
+
|
|
1828
|
+
### Screen Reader Support
|
|
1829
|
+
- ARIA labels and descriptions
|
|
1830
|
+
- Live regions for dynamic content
|
|
1831
|
+
- Proper table markup
|
|
1832
|
+
- Form validation announcements
|
|
1833
|
+
|
|
1834
|
+
### Color and Contrast
|
|
1835
|
+
- Minimum 4.5:1 contrast for normal text
|
|
1836
|
+
- 3:1 for large text
|
|
1837
|
+
- Color not sole information carrier
|
|
1838
|
+
- High contrast mode support
|
|
1839
|
+
|
|
1840
|
+
## Internationalization (i18n)
|
|
1841
|
+
|
|
1842
|
+
### Text Management
|
|
1843
|
+
- Externalize all user-facing strings
|
|
1844
|
+
- Support for right-to-left (RTL) languages
|
|
1845
|
+
- Date, time, number formatting
|
|
1846
|
+
- Currency and unit localization
|
|
1847
|
+
|
|
1848
|
+
### Layout Considerations
|
|
1849
|
+
- Text expansion for translations
|
|
1850
|
+
- Cultural considerations for icons/colors
|
|
1851
|
+
- Localized images and assets
|
|
1852
|
+
- Font support for different scripts
|
|
1853
|
+
|
|
1854
|
+
## Error Handling
|
|
1855
|
+
|
|
1856
|
+
### User-Friendly Errors
|
|
1857
|
+
- Clear, actionable error messages
|
|
1858
|
+
- Appropriate error severity
|
|
1859
|
+
- Recovery suggestions
|
|
1860
|
+
- Technical details in logs, not UI
|
|
1861
|
+
|
|
1862
|
+
### Loading States
|
|
1863
|
+
- Skeleton screens for content
|
|
1864
|
+
- Progress indicators for operations
|
|
1865
|
+
- Timeout handling
|
|
1866
|
+
- Retry mechanisms
|
|
1867
|
+
|
|
1868
|
+
### Form Validation
|
|
1869
|
+
- Real-time validation feedback
|
|
1870
|
+
- Clear error messages
|
|
1871
|
+
- Accessible error announcements
|
|
1872
|
+
- Submission prevention for invalid data
|
|
1873
|
+
|
|
1874
|
+
## Security Patterns
|
|
1875
|
+
|
|
1876
|
+
### XSS Prevention
|
|
1877
|
+
- Input sanitization
|
|
1878
|
+
- Output encoding
|
|
1879
|
+
- Content Security Policy (CSP)
|
|
1880
|
+
- Avoid innerHTML with user data
|
|
1881
|
+
|
|
1882
|
+
### CSRF Protection
|
|
1883
|
+
- Anti-CSRF tokens
|
|
1884
|
+
- SameSite cookies
|
|
1885
|
+
- CORS configuration
|
|
1886
|
+
- State-changing operations require POST
|
|
1887
|
+
|
|
1888
|
+
### Data Protection
|
|
1889
|
+
- No sensitive data in URLs
|
|
1890
|
+
- Secure cookie flags (HttpOnly, Secure)
|
|
1891
|
+
- Client-side encryption for sensitive data
|
|
1892
|
+
- Secure storage (avoid localStorage for tokens)
|
|
1893
|
+
|
|
1894
|
+
## For component-builder
|
|
1895
|
+
- Follow established frontend patterns
|
|
1896
|
+
- Ensure accessibility from the start
|
|
1897
|
+
- Write tests for user interactions
|
|
1898
|
+
- Optimize performance (lazy loading, code splitting)
|
|
1899
|
+
- Use semantic HTML and ARIA when needed
|
|
1900
|
+
|
|
1901
|
+
## For code-reviewer
|
|
1902
|
+
- Check accessibility compliance
|
|
1903
|
+
- Verify performance implications
|
|
1904
|
+
- Review security considerations
|
|
1905
|
+
- Ensure responsive design
|
|
1906
|
+
- Validate error handling
|
|
1907
|
+
|
|
1908
|
+
## Common Frontend Gotchas
|
|
1909
|
+
- ❌ Missing alt text on images
|
|
1910
|
+
- ❌ Poor color contrast
|
|
1911
|
+
- ❌ No keyboard navigation
|
|
1912
|
+
- ❌ Large bundle sizes
|
|
1913
|
+
- ❌ Missing error boundaries
|
|
1914
|
+
- ❌ Unoptimized images
|
|
1915
|
+
- ❌ No loading states
|
|
1916
|
+
- ❌ Inline styles with user data (XSS risk)
|
|
1917
|
+
- ❌ Missing form labels
|
|
1918
|
+
- ❌ Fixed heights causing overflow
|
|
1919
|
+
|
|
1920
|
+
## Memory Updates
|
|
1921
|
+
When frontend patterns are established or discovered:
|
|
1922
|
+
- Add to patterns.md Code Conventions section
|
|
1923
|
+
- Document component patterns and APIs
|
|
1924
|
+
- Record accessibility requirements
|
|
1925
|
+
- Note performance optimization techniques
|
|
1926
|
+
|
|
1927
|
+
## Tools and Libraries
|
|
1928
|
+
- **Frameworks**: React, Vue, Angular, Svelte
|
|
1929
|
+
- **Styling**: Tailwind, CSS Modules, styled-components
|
|
1930
|
+
- **State**: Redux, Zustand, React Query, Pinia
|
|
1931
|
+
- **Testing**: Jest, Vitest, Cypress, Playwright
|
|
1932
|
+
- **Performance**: Lighthouse, WebPageTest, Bundle analyzers
|
|
1933
|
+
- **Accessibility**: axe, Lighthouse, WAVE
|
|
1934
|
+
|
|
1935
|
+
## Browser Support
|
|
1936
|
+
- Define target browsers in project
|
|
1937
|
+
- Use feature detection (Modernizr)
|
|
1938
|
+
- Polyfills for missing features
|
|
1939
|
+
- Graceful degradation strategy
|
|
1940
|
+
|
|
1941
|
+
## Progressive Web Apps
|
|
1942
|
+
- Service workers for offline
|
|
1943
|
+
- Web app manifest
|
|
1944
|
+
- Installability criteria
|
|
1945
|
+
- Push notifications
|
|
1946
|
+
|
|
1947
|
+
## Design Systems
|
|
1948
|
+
- Component library consistency
|
|
1949
|
+
- Design token management
|
|
1950
|
+
- Documentation with Storybook
|
|
1951
|
+
- Versioning and backward compatibility`
|
|
1952
|
+
},
|
|
1953
|
+
{
|
|
1954
|
+
name: 'cc10x-session-memory-opencode',
|
|
1955
|
+
description: 'OpenCode-specific memory persistence patterns and session management. Adapts cc10x memory system to OpenCode context.',
|
|
1956
|
+
license: 'MIT',
|
|
1957
|
+
compatibility: 'opencode',
|
|
1958
|
+
metadata: {
|
|
1959
|
+
audience: 'router, all-agents',
|
|
1960
|
+
purpose: 'opencode-memory-adaptation',
|
|
1961
|
+
required: 'true'
|
|
1962
|
+
},
|
|
1963
|
+
content: `# OpenCode Session Memory Adaptation
|
|
1964
|
+
|
|
1965
|
+
**Purpose:** Adapt cc10x memory system to work with OpenCode's session management.
|
|
1966
|
+
|
|
1967
|
+
## OpenCode Context
|
|
1968
|
+
|
|
1969
|
+
### Session Management
|
|
1970
|
+
- OpenCode manages conversation sessions
|
|
1971
|
+
- Context compaction occurs automatically
|
|
1972
|
+
- Memory must survive compaction
|
|
1973
|
+
- Plugin hooks available for session events
|
|
1974
|
+
|
|
1975
|
+
### File Operations
|
|
1976
|
+
- OpenCode provides Read, Write, Edit tools
|
|
1977
|
+
- Permission system controls access
|
|
1978
|
+
- Some operations are permission-free
|
|
1979
|
+
- Memory operations should be permission-free
|
|
1980
|
+
|
|
1981
|
+
## Adaptation Strategy
|
|
1982
|
+
|
|
1983
|
+
### Memory Location
|
|
1984
|
+
Keep same location for compatibility:
|
|
1985
|
+
- \`.claude/cc10x/activeContext.md\`
|
|
1986
|
+
- \`.claude/cc10x/patterns.md\`
|
|
1987
|
+
- \`.claude/cc10x/progress.md\`
|
|
1988
|
+
|
|
1989
|
+
### Permission-Free Operations
|
|
1990
|
+
Ensure these operations don't ask permission:
|
|
1991
|
+
- Creating memory directory: \`mkdir -p .claude/cc10x\`
|
|
1992
|
+
- Reading memory files: \`Read(file_path="...")\`
|
|
1993
|
+
- Writing new memory files: \`Write(file_path="...", content="...")\`
|
|
1994
|
+
- Editing existing memory: \`Edit(file_path="...", old_string="...", new_string="...")\`
|
|
1995
|
+
|
|
1996
|
+
### Session Hooks
|
|
1997
|
+
Use OpenCode plugin hooks:
|
|
1998
|
+
- \`session.created\` - Initialize memory directory
|
|
1999
|
+
- \`session.compacted\` - Save checkpoint before compaction
|
|
2000
|
+
- \`message.received\` - Load memory for new requests
|
|
2001
|
+
- \`agent.completed\` - Accumulate memory notes
|
|
2002
|
+
|
|
2003
|
+
## OpenCode-Specific Patterns
|
|
2004
|
+
|
|
2005
|
+
### Task Integration
|
|
2006
|
+
- Use OpenCode Task tool for workflow orchestration
|
|
2007
|
+
- Mirror task status in progress.md
|
|
2008
|
+
- Task IDs should be preserved across sessions
|
|
2009
|
+
- Resume workflows from task state
|
|
2010
|
+
|
|
2011
|
+
### Agent Coordination
|
|
2012
|
+
- Primary agents can invoke subagents
|
|
2013
|
+
- Use Task tool for parallel execution
|
|
2014
|
+
- Pass context between agents via task description
|
|
2015
|
+
- Collect results from multiple agents
|
|
2016
|
+
|
|
2017
|
+
### Tool Usage
|
|
2018
|
+
- Prefer Read over Bash(cat) for files
|
|
2019
|
+
- Use Edit not Write for existing files
|
|
2020
|
+
- Separate commands (no && chaining) for permission-free
|
|
2021
|
+
- Capture exit codes for verification
|
|
2022
|
+
|
|
2023
|
+
## Migration from Claude Code
|
|
2024
|
+
|
|
2025
|
+
### Existing Memory Files
|
|
2026
|
+
- Copy .claude/cc10x/ directory to project
|
|
2027
|
+
- Files are compatible as-is
|
|
2028
|
+
- Plugin will auto-heal missing sections
|
|
2029
|
+
- No conversion needed
|
|
2030
|
+
|
|
2031
|
+
### Agent Differences
|
|
2032
|
+
- Claude Code agents vs OpenCode agents
|
|
2033
|
+
- Different tool interfaces
|
|
2034
|
+
- Different permission models
|
|
2035
|
+
- Similar but not identical execution
|
|
2036
|
+
|
|
2037
|
+
### Skill Loading
|
|
2038
|
+
- Claude skills vs OpenCode skills
|
|
2039
|
+
- Different discovery mechanisms
|
|
2040
|
+
- Plugin provides compatibility layer
|
|
2041
|
+
- Skills loaded via plugin registration
|
|
2042
|
+
|
|
2043
|
+
## OpenCode Configuration
|
|
2044
|
+
|
|
2045
|
+
### Required Permissions
|
|
2046
|
+
\`\`\`json
|
|
2047
|
+
{
|
|
2048
|
+
"permission": {
|
|
2049
|
+
"bash": {
|
|
2050
|
+
"mkdir -p .claude/cc10x": "allow",
|
|
2051
|
+
"git status": "allow",
|
|
2052
|
+
"git diff": "allow"
|
|
2053
|
+
},
|
|
2054
|
+
"edit": "allow",
|
|
2055
|
+
"write": "allow"
|
|
2056
|
+
}
|
|
2057
|
+
}
|
|
2058
|
+
\`\`\`
|
|
2059
|
+
|
|
2060
|
+
### Agent Configuration
|
|
2061
|
+
\`\`\`json
|
|
2062
|
+
{
|
|
2063
|
+
"agent": {
|
|
2064
|
+
"cc10x-component-builder": {
|
|
2065
|
+
"color": "green",
|
|
2066
|
+
"temperature": 0.3
|
|
2067
|
+
}
|
|
2068
|
+
}
|
|
2069
|
+
}
|
|
2070
|
+
\`\`\`
|
|
2071
|
+
|
|
2072
|
+
### Plugin Configuration
|
|
2073
|
+
\`\`\`json
|
|
2074
|
+
{
|
|
2075
|
+
"plugin": ["opencode-cc10x"],
|
|
2076
|
+
"permission": {
|
|
2077
|
+
"skill": {
|
|
2078
|
+
"cc10x:*": "allow"
|
|
2079
|
+
}
|
|
2080
|
+
}
|
|
2081
|
+
}
|
|
2082
|
+
\`\`\`
|
|
2083
|
+
|
|
2084
|
+
## Differences from Claude Code
|
|
2085
|
+
|
|
2086
|
+
| Aspect | Claude Code | OpenCode |
|
|
2087
|
+
|--------|-------------|----------|
|
|
2088
|
+
| Plugin format | Marketplace plugin | npm package |
|
|
2089
|
+
| Agent invocation | Custom system | Task tool |
|
|
2090
|
+
| Memory operations | Permission-free by default | Need permission config |
|
|
2091
|
+
| Task system | Claude Code Tasks | OpenCode Task tool |
|
|
2092
|
+
| Skills | Claude skills | OpenCode skills |
|
|
2093
|
+
| Hooks | Not applicable | Plugin hooks available |
|
|
2094
|
+
|
|
2095
|
+
## Troubleshooting
|
|
2096
|
+
|
|
2097
|
+
### Memory Not Persisting
|
|
2098
|
+
- Check directory permissions
|
|
2099
|
+
- Verify Edit tool is permission-free for memory files
|
|
2100
|
+
- Ensure plugin hooks are firing
|
|
2101
|
+
- Check OpenCode logs for errors
|
|
2102
|
+
|
|
2103
|
+
### Agents Not Available
|
|
2104
|
+
- Verify plugin loaded successfully
|
|
2105
|
+
- Check agent configuration in opencode.json
|
|
2106
|
+
- Restart OpenCode after plugin install
|
|
2107
|
+
- Run \`opencode agent list\` to see available agents
|
|
2108
|
+
|
|
2109
|
+
### Permission Prompts
|
|
2110
|
+
- Configure permissions in opencode.json
|
|
2111
|
+
- Use Edit not Write for existing files
|
|
2112
|
+
- Separate commands (no && chaining)
|
|
2113
|
+
- Memory paths must match exactly
|
|
2114
|
+
|
|
2115
|
+
### Task System Issues
|
|
2116
|
+
- Check Task tool permissions
|
|
2117
|
+
- Verify task creation/update calls
|
|
2118
|
+
- Ensure task IDs are preserved
|
|
2119
|
+
- Check task status synchronization
|
|
2120
|
+
|
|
2121
|
+
## Best Practices
|
|
2122
|
+
|
|
2123
|
+
### Memory Operations
|
|
2124
|
+
1. Always use separate tool calls (no chaining)
|
|
2125
|
+
2. Read before Edit to get current content
|
|
2126
|
+
3. Use stable anchors for Edit operations
|
|
2127
|
+
4. Verify changes with Read-back
|
|
2128
|
+
5. Update Last Updated timestamp
|
|
2129
|
+
|
|
2130
|
+
### Agent Communication
|
|
2131
|
+
1. Use task system for coordination
|
|
2132
|
+
2. Pass context via task description
|
|
2133
|
+
3. Update task status appropriately
|
|
2134
|
+
4. Handle parallel execution correctly
|
|
2135
|
+
5. Collect results from multiple agents
|
|
2136
|
+
|
|
2137
|
+
### Error Handling
|
|
2138
|
+
1. Don't let plugin errors crash OpenCode
|
|
2139
|
+
2. Log errors appropriately
|
|
2140
|
+
3. Provide fallback behavior
|
|
2141
|
+
4. Graceful degradation when features unavailable
|
|
2142
|
+
|
|
2143
|
+
## Future Enhancements
|
|
2144
|
+
|
|
2145
|
+
### OpenCode Features
|
|
2146
|
+
- Leverage new OpenCode capabilities as they become available
|
|
2147
|
+
- Integrate with OpenCode's native memory if available
|
|
2148
|
+
- Use OpenCode's agent system more fully
|
|
2149
|
+
- Support OpenCode's permission model improvements
|
|
2150
|
+
|
|
2151
|
+
### Performance
|
|
2152
|
+
- Cache memory reads during workflow
|
|
2153
|
+
- Batch memory updates
|
|
2154
|
+
- Optimize file operations
|
|
2155
|
+
- Reduce plugin overhead
|
|
2156
|
+
|
|
2157
|
+
### Monitoring
|
|
2158
|
+
- Add metrics for workflow execution
|
|
2159
|
+
- Track success/failure rates
|
|
2160
|
+
- Performance monitoring
|
|
2161
|
+
- User feedback collection`
|
|
2162
|
+
},
|
|
2163
|
+
{
|
|
2164
|
+
name: 'cc10x-botanical-garden',
|
|
2165
|
+
description: 'Fresh and organic theme with vibrant garden-inspired colors. For lively presentations.',
|
|
2166
|
+
license: 'MIT',
|
|
2167
|
+
compatibility: 'opencode',
|
|
2168
|
+
metadata: {
|
|
2169
|
+
audience: 'all-users',
|
|
2170
|
+
purpose: 'visual-theme',
|
|
2171
|
+
category: 'theme'
|
|
2172
|
+
},
|
|
2173
|
+
content: `# Botanical Garden Theme
|
|
2174
|
+
|
|
2175
|
+
A fresh and organic theme featuring vibrant garden-inspired colors for lively presentations.
|
|
2176
|
+
|
|
2177
|
+
## Color Palette
|
|
2178
|
+
|
|
2179
|
+
- **Fern Green**: #4a7c59 - Rich natural green
|
|
2180
|
+
- **Marigold**: #f9a620 - Bright floral accent
|
|
2181
|
+
- **Terracotta**: #b7472a - Earthy warm tone
|
|
2182
|
+
- **Cream**: #f5f3ed - Soft neutral backgrounds
|
|
2183
|
+
|
|
2184
|
+
## Typography
|
|
2185
|
+
|
|
2186
|
+
- **Headers**: DejaVu Serif Bold
|
|
2187
|
+
- **Body Text**: DejaVu Sans
|
|
2188
|
+
|
|
2189
|
+
## Best Used For
|
|
2190
|
+
|
|
2191
|
+
Garden centers, food presentations, farm-to-table content, botanical brands, natural products.
|
|
2192
|
+
|
|
2193
|
+
## Usage
|
|
2194
|
+
|
|
2195
|
+
Apply this theme to presentations, documents, and artifacts for a fresh, organic aesthetic.
|
|
2196
|
+
|
|
2197
|
+
## CSS Variables
|
|
2198
|
+
|
|
2199
|
+
\`\`\`css
|
|
2200
|
+
:root {
|
|
2201
|
+
--primary-color: #4a7c59;
|
|
2202
|
+
--accent-color: #f9a620;
|
|
2203
|
+
--secondary-color: #b7472a;
|
|
2204
|
+
--background-color: #f5f3ed;
|
|
2205
|
+
--text-color: #333333;
|
|
2206
|
+
--header-font: 'DejaVu Serif', serif;
|
|
2207
|
+
--body-font: 'DejaVu Sans', sans-serif;
|
|
2208
|
+
}
|
|
2209
|
+
\`\`\`
|
|
2210
|
+
|
|
2211
|
+
## Examples
|
|
2212
|
+
|
|
2213
|
+
Perfect for:
|
|
2214
|
+
- Garden and landscape presentations
|
|
2215
|
+
- Organic food and farm products
|
|
2216
|
+
- Environmental and sustainability content
|
|
2217
|
+
- Natural beauty and wellness brands
|
|
2218
|
+
- Farmers markets and local food scenes`
|
|
2219
|
+
},
|
|
2220
|
+
{
|
|
2221
|
+
name: 'cc10x-midnight-galaxy',
|
|
2222
|
+
description: 'Dramatic and cosmic theme with deep purples and mystical tones for impactful presentations.',
|
|
2223
|
+
license: 'MIT',
|
|
2224
|
+
compatibility: 'opencode',
|
|
2225
|
+
metadata: {
|
|
2226
|
+
audience: 'all-users',
|
|
2227
|
+
purpose: 'visual-theme',
|
|
2228
|
+
category: 'theme'
|
|
2229
|
+
},
|
|
2230
|
+
content: `# Midnight Galaxy Theme
|
|
2231
|
+
|
|
2232
|
+
A dramatic and cosmic theme with deep purples and mystical tones for impactful presentations.
|
|
2233
|
+
|
|
2234
|
+
## Color Palette
|
|
2235
|
+
|
|
2236
|
+
- **Deep Purple**: #2b1e3e - Rich dark base
|
|
2237
|
+
- **Cosmic Blue**: #4a4e8f - Mystical mid-tone
|
|
2238
|
+
- **Lavender**: #a490c2 - Soft accent color
|
|
2239
|
+
- **Silver**: #e6e6fa - Light highlights and text
|
|
2240
|
+
|
|
2241
|
+
## Typography
|
|
2242
|
+
|
|
2243
|
+
- **Headers**: FreeSans Bold
|
|
2244
|
+
- **Body Text**: FreeSans
|
|
2245
|
+
|
|
2246
|
+
## Best Used For
|
|
2247
|
+
|
|
2248
|
+
Entertainment industry, gaming presentations, nightlife venues, luxury brands, creative agencies.
|
|
2249
|
+
|
|
2250
|
+
## Usage
|
|
2251
|
+
|
|
2252
|
+
Apply this theme for dramatic, high-impact presentations with a cosmic aesthetic.
|
|
2253
|
+
|
|
2254
|
+
## CSS Variables
|
|
2255
|
+
|
|
2256
|
+
\`\`\`css
|
|
2257
|
+
:root {
|
|
2258
|
+
--primary-color: #2b1e3e;
|
|
2259
|
+
--accent-color: #4a4e8f;
|
|
2260
|
+
--secondary-color: #a490c2;
|
|
2261
|
+
--background-color: #1a1a2e;
|
|
2262
|
+
--text-color: #e6e6fa;
|
|
2263
|
+
--header-font: 'FreeSans', sans-serif;
|
|
2264
|
+
--body-font: 'FreeSans', sans-serif;
|
|
2265
|
+
}
|
|
2266
|
+
\`\`\`
|
|
2267
|
+
|
|
2268
|
+
## Examples
|
|
2269
|
+
|
|
2270
|
+
Perfect for:
|
|
2271
|
+
- Gaming and entertainment presentations
|
|
2272
|
+
- Nightclub and venue promotions
|
|
2273
|
+
- Luxury brand showcases
|
|
2274
|
+
- Creative agency pitches
|
|
2275
|
+
- Cosmic and space-themed content`
|
|
2276
|
+
},
|
|
2277
|
+
{
|
|
2278
|
+
name: 'cc10x-arctic-frost',
|
|
2279
|
+
description: 'Cool and crisp winter-inspired theme conveying clarity, precision, and professionalism.',
|
|
2280
|
+
license: 'MIT',
|
|
2281
|
+
compatibility: 'opencode',
|
|
2282
|
+
metadata: {
|
|
2283
|
+
audience: 'all-users',
|
|
2284
|
+
purpose: 'visual-theme',
|
|
2285
|
+
category: 'theme'
|
|
2286
|
+
},
|
|
2287
|
+
content: `# Arctic Frost Theme
|
|
2288
|
+
|
|
2289
|
+
A cool and crisp winter-inspired theme that conveys clarity, precision, and professionalism.
|
|
2290
|
+
|
|
2291
|
+
## Color Palette
|
|
2292
|
+
|
|
2293
|
+
- **Ice Blue**: #d4e4f7 - Light backgrounds and highlights
|
|
2294
|
+
- **Steel Blue**: #4a6fa5 - Primary accent color
|
|
2295
|
+
- **Silver**: #c0c0c0 - Metallic accent elements
|
|
2296
|
+
- **Crisp White**: #fafafa - Clean backgrounds and text
|
|
2297
|
+
|
|
2298
|
+
## Typography
|
|
2299
|
+
|
|
2300
|
+
- **Headers**: DejaVu Sans Bold
|
|
2301
|
+
- **Body Text**: DejaVu Sans
|
|
2302
|
+
|
|
2303
|
+
## Best Used For
|
|
2304
|
+
|
|
2305
|
+
Healthcare presentations, technology solutions, winter sports, clean tech, pharmaceutical content.
|
|
2306
|
+
|
|
2307
|
+
## Usage
|
|
2308
|
+
|
|
2309
|
+
Apply this theme for professional, clean presentations with a cool, precise aesthetic.
|
|
2310
|
+
|
|
2311
|
+
## CSS Variables
|
|
2312
|
+
|
|
2313
|
+
\`\`\`css
|
|
2314
|
+
:root {
|
|
2315
|
+
--primary-color: #4a6fa5;
|
|
2316
|
+
--accent-color: #d4e4f7;
|
|
2317
|
+
--secondary-color: #c0c0c0;
|
|
2318
|
+
--background-color: #fafafa;
|
|
2319
|
+
--text-color: #333333;
|
|
2320
|
+
--header-font: 'DejaVu Sans', sans-serif;
|
|
2321
|
+
--body-font: 'DejaVu Sans', sans-serif;
|
|
2322
|
+
}
|
|
2323
|
+
\`\`\`
|
|
2324
|
+
|
|
2325
|
+
## Examples
|
|
2326
|
+
|
|
2327
|
+
Perfect for:
|
|
2328
|
+
- Medical and healthcare presentations
|
|
2329
|
+
- Technology and software solutions
|
|
2330
|
+
- Winter sports and outdoor equipment
|
|
2331
|
+
- Clean technology and sustainability
|
|
2332
|
+
- Pharmaceutical and research content`
|
|
2333
|
+
},
|
|
2334
|
+
{
|
|
2335
|
+
name: 'cc10x-desert-rose',
|
|
2336
|
+
description: 'Soft and sophisticated theme with dusty, muted tones perfect for elegant presentations.',
|
|
2337
|
+
license: 'MIT',
|
|
2338
|
+
compatibility: 'opencode',
|
|
2339
|
+
metadata: {
|
|
2340
|
+
audience: 'all-users',
|
|
2341
|
+
purpose: 'visual-theme',
|
|
2342
|
+
category: 'theme'
|
|
2343
|
+
},
|
|
2344
|
+
content: `# Desert Rose Theme
|
|
2345
|
+
|
|
2346
|
+
A soft and sophisticated theme with dusty, muted tones perfect for elegant presentations.
|
|
2347
|
+
|
|
2348
|
+
## Color Palette
|
|
2349
|
+
|
|
2350
|
+
- **Dusty Rose**: #d4a5a5 - Soft primary color
|
|
2351
|
+
- **Clay**: #b87d6d - Earthy accent
|
|
2352
|
+
- **Sand**: #e8d5c4 - Warm neutral backgrounds
|
|
2353
|
+
- **Deep Burgundy**: #5d2e46 - Rich dark contrast
|
|
2354
|
+
|
|
2355
|
+
## Typography
|
|
2356
|
+
|
|
2357
|
+
- **Headers**: FreeSans Bold
|
|
2358
|
+
- **Body Text**: FreeSans
|
|
2359
|
+
|
|
2360
|
+
## Best Used For
|
|
2361
|
+
|
|
2362
|
+
Fashion presentations, beauty brands, wedding planning, interior design, boutique businesses.
|
|
2363
|
+
|
|
2364
|
+
## Usage
|
|
2365
|
+
|
|
2366
|
+
Apply this theme for elegant, sophisticated presentations with warm, muted colors.
|
|
2367
|
+
|
|
2368
|
+
## CSS Variables
|
|
2369
|
+
|
|
2370
|
+
\`\`\`css
|
|
2371
|
+
:root {
|
|
2372
|
+
--primary-color: #d4a5a5;
|
|
2373
|
+
--accent-color: #b87d6d;
|
|
2374
|
+
--secondary-color: #5d2e46;
|
|
2375
|
+
--background-color: #e8d5c4;
|
|
2376
|
+
--text-color: #5d2e46;
|
|
2377
|
+
--header-font: 'FreeSans', sans-serif;
|
|
2378
|
+
--body-font: 'FreeSans', sans-serif;
|
|
2379
|
+
}
|
|
2380
|
+
\`\`\`
|
|
2381
|
+
|
|
2382
|
+
## Examples
|
|
2383
|
+
|
|
2384
|
+
Perfect for:
|
|
2385
|
+
- Fashion and beauty presentations
|
|
2386
|
+
- Wedding and event planning
|
|
2387
|
+
- Interior design and decor
|
|
2388
|
+
- Boutique and luxury brands
|
|
2389
|
+
- Elegant lifestyle content`
|
|
2390
|
+
},
|
|
2391
|
+
{
|
|
2392
|
+
name: 'cc10x-forest-canopy',
|
|
2393
|
+
description: 'Natural and grounded theme featuring earth tones inspired by dense forest environments.',
|
|
2394
|
+
license: 'MIT',
|
|
2395
|
+
compatibility: 'opencode',
|
|
2396
|
+
metadata: {
|
|
2397
|
+
audience: 'all-users',
|
|
2398
|
+
purpose: 'visual-theme',
|
|
2399
|
+
category: 'theme'
|
|
2400
|
+
},
|
|
2401
|
+
content: `# Forest Canopy Theme
|
|
2402
|
+
|
|
2403
|
+
A natural and grounded theme featuring earth tones inspired by dense forest environments.
|
|
2404
|
+
|
|
2405
|
+
## Color Palette
|
|
2406
|
+
|
|
2407
|
+
- **Forest Green**: #2d4a2b - Primary dark green
|
|
2408
|
+
- **Sage**: #7d8471 - Muted green accent
|
|
2409
|
+
- **Olive**: #a4ac86 - Light accent color
|
|
2410
|
+
- **Ivory**: #faf9f6 - Backgrounds and text
|
|
2411
|
+
|
|
2412
|
+
## Typography
|
|
2413
|
+
|
|
2414
|
+
- **Headers**: FreeSerif Bold
|
|
2415
|
+
- **Body Text**: FreeSans
|
|
2416
|
+
|
|
2417
|
+
## Best Used For
|
|
2418
|
+
|
|
2419
|
+
Environmental presentations, sustainability reports, outdoor brands, wellness content, organic products.
|
|
2420
|
+
|
|
2421
|
+
## Usage
|
|
2422
|
+
|
|
2423
|
+
Apply this theme for natural, earthy presentations with forest-inspired colors.
|
|
2424
|
+
|
|
2425
|
+
## CSS Variables
|
|
2426
|
+
|
|
2427
|
+
\`\`\`css
|
|
2428
|
+
:root {
|
|
2429
|
+
--primary-color: #2d4a2b;
|
|
2430
|
+
--accent-color: #7d8471;
|
|
2431
|
+
--secondary-color: #a4ac86;
|
|
2432
|
+
--background-color: #faf9f6;
|
|
2433
|
+
--text-color: #2d4a2b;
|
|
2434
|
+
--header-font: 'FreeSerif', serif;
|
|
2435
|
+
--body-font: 'FreeSans', sans-serif;
|
|
2436
|
+
}
|
|
2437
|
+
\`\`\`
|
|
2438
|
+
|
|
2439
|
+
## Examples
|
|
2440
|
+
|
|
2441
|
+
Perfect for:
|
|
2442
|
+
- Environmental and conservation presentations
|
|
2443
|
+
- Sustainability and eco-friendly brands
|
|
2444
|
+
- Outdoor and adventure content
|
|
2445
|
+
- Wellness and natural health
|
|
2446
|
+
- Organic and natural products`
|
|
2447
|
+
},
|
|
2448
|
+
{
|
|
2449
|
+
name: 'cc10x-golden-hour',
|
|
2450
|
+
description: 'Rich and warm autumnal palette creating an inviting and sophisticated atmosphere.',
|
|
2451
|
+
license: 'MIT',
|
|
2452
|
+
compatibility: 'opencode',
|
|
2453
|
+
metadata: {
|
|
2454
|
+
audience: 'all-users',
|
|
2455
|
+
purpose: 'visual-theme',
|
|
2456
|
+
category: 'theme'
|
|
2457
|
+
},
|
|
2458
|
+
content: `# Golden Hour Theme
|
|
2459
|
+
|
|
2460
|
+
A rich and warm autumnal palette that creates an inviting and sophisticated atmosphere.
|
|
2461
|
+
|
|
2462
|
+
## Color Palette
|
|
2463
|
+
|
|
2464
|
+
- **Mustard Yellow**: #f4a900 - Bold primary accent
|
|
2465
|
+
- **Terracotta**: #c1666b - Warm secondary color
|
|
2466
|
+
- **Warm Beige**: #d4b896 - Neutral backgrounds
|
|
2467
|
+
- **Chocolate Brown**: #4a403a - Dark text and anchors
|
|
2468
|
+
|
|
2469
|
+
## Typography
|
|
2470
|
+
|
|
2471
|
+
- **Headers**: FreeSans Bold
|
|
2472
|
+
- **Body Text**: FreeSans
|
|
2473
|
+
|
|
2474
|
+
## Best Used For
|
|
2475
|
+
|
|
2476
|
+
Restaurant presentations, hospitality brands, fall campaigns, cozy lifestyle content, artisan products.
|
|
2477
|
+
|
|
2478
|
+
## Usage
|
|
2479
|
+
|
|
2480
|
+
Apply this theme for warm, inviting presentations with rich autumnal colors.
|
|
2481
|
+
|
|
2482
|
+
## CSS Variables
|
|
2483
|
+
|
|
2484
|
+
\`\`\`css
|
|
2485
|
+
:root {
|
|
2486
|
+
--primary-color: #f4a900;
|
|
2487
|
+
--accent-color: #c1666b;
|
|
2488
|
+
--secondary-color: #4a403a;
|
|
2489
|
+
--background-color: #d4b896;
|
|
2490
|
+
--text-color: #4a403a;
|
|
2491
|
+
--header-font: 'FreeSans', sans-serif;
|
|
2492
|
+
--body-font: 'FreeSans', sans-serif;
|
|
2493
|
+
}
|
|
2494
|
+
\`\`\`
|
|
2495
|
+
|
|
2496
|
+
## Examples
|
|
2497
|
+
|
|
2498
|
+
Perfect for:
|
|
2499
|
+
- Restaurant and food presentations
|
|
2500
|
+
- Hospitality and travel brands
|
|
2501
|
+
- Fall and autumn campaigns
|
|
2502
|
+
- Cozy lifestyle content
|
|
2503
|
+
- Artisan and handcrafted products`
|
|
2504
|
+
},
|
|
2505
|
+
{
|
|
2506
|
+
name: 'cc10x-tech-innovation',
|
|
2507
|
+
description: 'Bold and modern theme with high-contrast colors perfect for cutting-edge technology presentations.',
|
|
2508
|
+
license: 'MIT',
|
|
2509
|
+
compatibility: 'opencode',
|
|
2510
|
+
metadata: {
|
|
2511
|
+
audience: 'all-users',
|
|
2512
|
+
purpose: 'visual-theme',
|
|
2513
|
+
category: 'theme'
|
|
2514
|
+
},
|
|
2515
|
+
content: `# Tech Innovation Theme
|
|
2516
|
+
|
|
2517
|
+
A bold and modern theme with high-contrast colors perfect for cutting-edge technology presentations.
|
|
2518
|
+
|
|
2519
|
+
## Color Palette
|
|
2520
|
+
|
|
2521
|
+
- **Electric Blue**: #0066ff - Vibrant primary accent
|
|
2522
|
+
- **Neon Cyan**: #00ffff - Bright highlight color
|
|
2523
|
+
- **Dark Gray**: #1e1e1e - Deep backgrounds
|
|
2524
|
+
- **White**: #ffffff - Clean text and contrast
|
|
2525
|
+
|
|
2526
|
+
## Typography
|
|
2527
|
+
|
|
2528
|
+
- **Headers**: DejaVu Sans Bold
|
|
2529
|
+
- **Body Text**: DejaVu Sans
|
|
2530
|
+
|
|
2531
|
+
## Best Used For
|
|
2532
|
+
|
|
2533
|
+
Tech startups, software launches, innovation showcases, AI/ML presentations, digital transformation content.
|
|
2534
|
+
|
|
2535
|
+
## Usage
|
|
2536
|
+
|
|
2537
|
+
Apply this theme for high-impact technology presentations with bold, modern colors.
|
|
2538
|
+
|
|
2539
|
+
## CSS Variables
|
|
2540
|
+
|
|
2541
|
+
\`\`\`css
|
|
2542
|
+
:root {
|
|
2543
|
+
--primary-color: #0066ff;
|
|
2544
|
+
--accent-color: #00ffff;
|
|
2545
|
+
--background-color: #1e1e1e;
|
|
2546
|
+
--text-color: #ffffff;
|
|
2547
|
+
--header-font: 'DejaVu Sans', sans-serif;
|
|
2548
|
+
--body-font: 'DejaVu Sans', sans-serif;
|
|
2549
|
+
}
|
|
2550
|
+
\`\`\`
|
|
2551
|
+
|
|
2552
|
+
## Examples
|
|
2553
|
+
|
|
2554
|
+
Perfect for:
|
|
2555
|
+
- Technology startup presentations
|
|
2556
|
+
- Software product launches
|
|
2557
|
+
- AI and machine learning showcases
|
|
2558
|
+
- Digital transformation initiatives
|
|
2559
|
+
- Innovation and R&D content`
|
|
2560
|
+
},
|
|
2561
|
+
{
|
|
2562
|
+
name: 'cc10x-ocean-depths',
|
|
2563
|
+
description: 'Professional and calming maritime theme evoking serenity of deep ocean waters.',
|
|
2564
|
+
license: 'MIT',
|
|
2565
|
+
compatibility: 'opencode',
|
|
2566
|
+
metadata: {
|
|
2567
|
+
audience: 'all-users',
|
|
2568
|
+
purpose: 'visual-theme',
|
|
2569
|
+
category: 'theme'
|
|
2570
|
+
},
|
|
2571
|
+
content: `# Ocean Depths Theme
|
|
2572
|
+
|
|
2573
|
+
A professional and calming maritime theme that evokes the serenity of deep ocean waters.
|
|
2574
|
+
|
|
2575
|
+
## Color Palette
|
|
2576
|
+
|
|
2577
|
+
- **Deep Navy**: #1a2332 - Primary background color
|
|
2578
|
+
- **Teal**: #2d8b8b - Accent color for highlights and emphasis
|
|
2579
|
+
- **Seafoam**: #a8dadc - Secondary accent for lighter elements
|
|
2580
|
+
- **Cream**: #f1faee - Text and light backgrounds
|
|
2581
|
+
|
|
2582
|
+
## Typography
|
|
2583
|
+
|
|
2584
|
+
- **Headers**: DejaVu Sans Bold
|
|
2585
|
+
- **Body Text**: DejaVu Sans
|
|
2586
|
+
|
|
2587
|
+
## Best Used For
|
|
2588
|
+
|
|
2589
|
+
Corporate presentations, financial reports, professional consulting decks, trust-building content.
|
|
2590
|
+
|
|
2591
|
+
## Usage
|
|
2592
|
+
|
|
2593
|
+
Apply this theme for professional, trustworthy presentations with maritime-inspired colors.
|
|
2594
|
+
|
|
2595
|
+
## CSS Variables
|
|
2596
|
+
|
|
2597
|
+
\`\`\`css
|
|
2598
|
+
:root {
|
|
2599
|
+
--primary-color: #1a2332;
|
|
2600
|
+
--accent-color: #2d8b8b;
|
|
2601
|
+
--secondary-color: #a8dadc;
|
|
2602
|
+
--background-color: #f1faee;
|
|
2603
|
+
--text-color: #1a2332;
|
|
2604
|
+
--header-font: 'DejaVu Sans', sans-serif;
|
|
2605
|
+
--body-font: 'DejaVu Sans', sans-serif;
|
|
2606
|
+
}
|
|
2607
|
+
\`\`\`
|
|
2608
|
+
|
|
2609
|
+
## Examples
|
|
2610
|
+
|
|
2611
|
+
Perfect for:
|
|
2612
|
+
- Corporate and business presentations
|
|
2613
|
+
- Financial reports and analysis
|
|
2614
|
+
- Consulting and professional services
|
|
2615
|
+
- Trust and security focused content
|
|
2616
|
+
- Maritime and ocean-related themes`
|
|
2617
|
+
},
|
|
2618
|
+
{
|
|
2619
|
+
name: 'cc10x-sunset-boulevard',
|
|
2620
|
+
description: 'Warm and vibrant theme inspired by golden hour sunsets, perfect for energetic and creative presentations.',
|
|
2621
|
+
license: 'MIT',
|
|
2622
|
+
compatibility: 'opencode',
|
|
2623
|
+
metadata: {
|
|
2624
|
+
audience: 'all-users',
|
|
2625
|
+
purpose: 'visual-theme',
|
|
2626
|
+
category: 'theme'
|
|
2627
|
+
},
|
|
2628
|
+
content: `# Sunset Boulevard Theme
|
|
2629
|
+
|
|
2630
|
+
A warm and vibrant theme inspired by golden hour sunsets, perfect for energetic and creative presentations.
|
|
2631
|
+
|
|
2632
|
+
## Color Palette
|
|
2633
|
+
|
|
2634
|
+
- **Burnt Orange**: #e76f51 - Primary accent color
|
|
2635
|
+
- **Coral**: #f4a261 - Secondary warm accent
|
|
2636
|
+
- **Warm Sand**: #e9c46a - Highlighting and backgrounds
|
|
2637
|
+
- **Deep Purple**: #264653 - Dark contrast and text
|
|
2638
|
+
|
|
2639
|
+
## Typography
|
|
2640
|
+
|
|
2641
|
+
- **Headers**: DejaVu Serif Bold
|
|
2642
|
+
- **Body Text**: DejaVu Sans
|
|
2643
|
+
|
|
2644
|
+
## Best Used For
|
|
2645
|
+
|
|
2646
|
+
Creative pitches, marketing presentations, lifestyle brands, event promotions, inspirational content.
|
|
2647
|
+
|
|
2648
|
+
## Usage
|
|
2649
|
+
|
|
2650
|
+
Apply this theme for energetic, creative presentations with warm sunset colors.
|
|
2651
|
+
|
|
2652
|
+
## CSS Variables
|
|
2653
|
+
|
|
2654
|
+
\`\`\`css
|
|
2655
|
+
:root {
|
|
2656
|
+
--primary-color: #e76f51;
|
|
2657
|
+
--accent-color: #f4a261;
|
|
2658
|
+
--secondary-color: #e9c46a;
|
|
2659
|
+
--background-color: #264653;
|
|
2660
|
+
--text-color: #e9c46a;
|
|
2661
|
+
--header-font: 'DejaVu Serif', serif;
|
|
2662
|
+
--body-font: 'DejaVu Sans', sans-serif;
|
|
2663
|
+
}
|
|
2664
|
+
\`\`\`
|
|
2665
|
+
|
|
2666
|
+
## Examples
|
|
2667
|
+
|
|
2668
|
+
Perfect for:
|
|
2669
|
+
- Creative and marketing presentations
|
|
2670
|
+
- Lifestyle and entertainment brands
|
|
2671
|
+
- Event and promotion materials
|
|
2672
|
+
- Inspirational and motivational content
|
|
2673
|
+
- Sunset and warm aesthetic designs`
|
|
2674
|
+
},
|
|
2675
|
+
{
|
|
2676
|
+
name: 'cc10x-modern-minimalist',
|
|
2677
|
+
description: 'Clean and contemporary theme with sophisticated grayscale palette for maximum versatility.',
|
|
2678
|
+
license: 'MIT',
|
|
2679
|
+
compatibility: 'opencode',
|
|
2680
|
+
metadata: {
|
|
2681
|
+
audience: 'all-users',
|
|
2682
|
+
purpose: 'visual-theme',
|
|
2683
|
+
category: 'theme'
|
|
2684
|
+
},
|
|
2685
|
+
content: `# Modern Minimalist Theme
|
|
2686
|
+
|
|
2687
|
+
A clean and contemporary theme with a sophisticated grayscale palette for maximum versatility.
|
|
2688
|
+
|
|
2689
|
+
## Color Palette
|
|
2690
|
+
|
|
2691
|
+
- **Charcoal**: #36454f - Primary dark color
|
|
2692
|
+
- **Slate Gray**: #708090 - Medium gray for accents
|
|
2693
|
+
- **Light Gray**: #d3d3d3 - Backgrounds and dividers
|
|
2694
|
+
- **White**: #ffffff - Text and clean backgrounds
|
|
2695
|
+
|
|
2696
|
+
## Typography
|
|
2697
|
+
|
|
2698
|
+
- **Headers**: DejaVu Sans Bold
|
|
2699
|
+
- **Body Text**: DejaVu Sans
|
|
2700
|
+
|
|
2701
|
+
## Best Used For
|
|
2702
|
+
|
|
2703
|
+
Tech presentations, architecture portfolios, design showcases, modern business proposals, data visualization.
|
|
2704
|
+
|
|
2705
|
+
## Usage
|
|
2706
|
+
|
|
2707
|
+
Apply this theme for clean, professional presentations with timeless grayscale design.
|
|
2708
|
+
|
|
2709
|
+
## CSS Variables
|
|
2710
|
+
|
|
2711
|
+
\`\`\`css
|
|
2712
|
+
:root {
|
|
2713
|
+
--primary-color: #36454f;
|
|
2714
|
+
--accent-color: #708090;
|
|
2715
|
+
--secondary-color: #d3d3d3;
|
|
2716
|
+
--background-color: #ffffff;
|
|
2717
|
+
--text-color: #36454f;
|
|
2718
|
+
--header-font: 'DejaVu Sans', sans-serif;
|
|
2719
|
+
--body-font: 'DejaVu Sans', sans-serif;
|
|
2720
|
+
}
|
|
2721
|
+
\`\`\`
|
|
2722
|
+
|
|
2723
|
+
## Examples
|
|
2724
|
+
|
|
2725
|
+
Perfect for:
|
|
2726
|
+
- Technology and software presentations
|
|
2727
|
+
- Architecture and design portfolios
|
|
2728
|
+
- Business proposals and reports
|
|
2729
|
+
- Data visualization and analytics
|
|
2730
|
+
- Modern and minimalist aesthetic content`
|
|
2731
|
+
},
|
|
2732
|
+
{
|
|
2733
|
+
name: 'cc10x-midnight-galaxy-theme',
|
|
2734
|
+
description: 'Dramatic and cosmic theme with deep purples and mystical tones for impactful presentations.',
|
|
2735
|
+
license: 'MIT',
|
|
2736
|
+
compatibility: 'opencode',
|
|
2737
|
+
metadata: {
|
|
2738
|
+
audience: 'all-users',
|
|
2739
|
+
purpose: 'visual-theme',
|
|
2740
|
+
category: 'theme'
|
|
2741
|
+
},
|
|
2742
|
+
content: `# Midnight Galaxy Theme
|
|
2743
|
+
|
|
2744
|
+
A dramatic and cosmic theme with deep purples and mystical tones for impactful presentations.
|
|
2745
|
+
|
|
2746
|
+
## Color Palette
|
|
2747
|
+
|
|
2748
|
+
- **Deep Purple**: #2b1e3e - Rich dark base
|
|
2749
|
+
- **Cosmic Blue**: #4a4e8f - Mystical mid-tone
|
|
2750
|
+
- **Lavender**: #a490c2 - Soft accent color
|
|
2751
|
+
- **Silver**: #e6e6fa - Light highlights and text
|
|
2752
|
+
|
|
2753
|
+
## Typography
|
|
2754
|
+
|
|
2755
|
+
- **Headers**: FreeSans Bold
|
|
2756
|
+
- **Body Text**: FreeSans
|
|
2757
|
+
|
|
2758
|
+
## Best Used For
|
|
2759
|
+
|
|
2760
|
+
Entertainment industry, gaming presentations, nightlife venues, luxury brands, creative agencies.
|
|
2761
|
+
|
|
2762
|
+
## Usage
|
|
2763
|
+
|
|
2764
|
+
Apply this theme for dramatic, cosmic presentations with deep purple tones.
|
|
2765
|
+
|
|
2766
|
+
## CSS Variables
|
|
2767
|
+
|
|
2768
|
+
\`\`\`css
|
|
2769
|
+
:root {
|
|
2770
|
+
--primary-color: #2b1e3e;
|
|
2771
|
+
--accent-color: #4a4e8f;
|
|
2772
|
+
--secondary-color: #a490c2;
|
|
2773
|
+
--background-color: #1a1a2e;
|
|
2774
|
+
--text-color: #e6e6fa;
|
|
2775
|
+
--header-font: 'FreeSans', sans-serif;
|
|
2776
|
+
--body-font: 'FreeSans', sans-serif;
|
|
2777
|
+
}
|
|
2778
|
+
\`\`\`
|
|
2779
|
+
|
|
2780
|
+
## Examples
|
|
2781
|
+
|
|
2782
|
+
Perfect for:
|
|
2783
|
+
- Gaming and entertainment presentations
|
|
2784
|
+
- Nightclub and venue promotions
|
|
2785
|
+
- Luxury brand showcases
|
|
2786
|
+
- Creative agency pitches
|
|
2787
|
+
- Cosmic and space-themed content`
|
|
2788
|
+
}
|
|
2789
|
+
];
|
|
2790
|
+
//# sourceMappingURL=skills.js.map
|