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.
Files changed (45) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +283 -0
  3. package/bun.lock +20 -0
  4. package/dist/agents.d.ts +3 -0
  5. package/dist/agents.d.ts.map +1 -0
  6. package/dist/agents.js +483 -0
  7. package/dist/agents.js.map +1 -0
  8. package/dist/compatibility-layer.d.ts +18 -0
  9. package/dist/compatibility-layer.d.ts.map +1 -0
  10. package/dist/compatibility-layer.js +150 -0
  11. package/dist/compatibility-layer.js.map +1 -0
  12. package/dist/index.d.ts +4 -0
  13. package/dist/index.d.ts.map +1 -0
  14. package/dist/index.js +1459 -0
  15. package/dist/index.js.map +1 -0
  16. package/dist/intent-detection.d.ts +14 -0
  17. package/dist/intent-detection.d.ts.map +1 -0
  18. package/dist/intent-detection.js +121 -0
  19. package/dist/intent-detection.js.map +1 -0
  20. package/dist/memory.d.ts +41 -0
  21. package/dist/memory.d.ts.map +1 -0
  22. package/dist/memory.js +330 -0
  23. package/dist/memory.js.map +1 -0
  24. package/dist/router.d.ts +15 -0
  25. package/dist/router.d.ts.map +1 -0
  26. package/dist/router.js +208 -0
  27. package/dist/router.js.map +1 -0
  28. package/dist/skills.d.ts +3 -0
  29. package/dist/skills.d.ts.map +1 -0
  30. package/dist/skills.js +2790 -0
  31. package/dist/skills.js.map +1 -0
  32. package/dist/task-orchestrator.d.ts +46 -0
  33. package/dist/task-orchestrator.d.ts.map +1 -0
  34. package/dist/task-orchestrator.js +262 -0
  35. package/dist/task-orchestrator.js.map +1 -0
  36. package/dist/workflow-executor.d.ts +29 -0
  37. package/dist/workflow-executor.d.ts.map +1 -0
  38. package/dist/workflow-executor.js +414 -0
  39. package/dist/workflow-executor.js.map +1 -0
  40. package/install-from-github.mjs +152 -0
  41. package/install-from-github.sh +106 -0
  42. package/install.sh +295 -0
  43. package/opencode.json +118 -0
  44. package/package.json +41 -0
  45. 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