codingbuddy-rules 2.4.2 → 3.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/.ai-rules/CHANGELOG.md +122 -0
  2. package/.ai-rules/agents/README.md +527 -11
  3. package/.ai-rules/agents/accessibility-specialist.json +0 -1
  4. package/.ai-rules/agents/act-mode.json +0 -1
  5. package/.ai-rules/agents/agent-architect.json +0 -1
  6. package/.ai-rules/agents/ai-ml-engineer.json +0 -1
  7. package/.ai-rules/agents/architecture-specialist.json +14 -2
  8. package/.ai-rules/agents/backend-developer.json +14 -2
  9. package/.ai-rules/agents/code-quality-specialist.json +0 -1
  10. package/.ai-rules/agents/data-engineer.json +0 -1
  11. package/.ai-rules/agents/devops-engineer.json +24 -2
  12. package/.ai-rules/agents/documentation-specialist.json +0 -1
  13. package/.ai-rules/agents/eval-mode.json +0 -1
  14. package/.ai-rules/agents/event-architecture-specialist.json +719 -0
  15. package/.ai-rules/agents/frontend-developer.json +14 -2
  16. package/.ai-rules/agents/i18n-specialist.json +0 -1
  17. package/.ai-rules/agents/integration-specialist.json +11 -1
  18. package/.ai-rules/agents/migration-specialist.json +676 -0
  19. package/.ai-rules/agents/mobile-developer.json +0 -1
  20. package/.ai-rules/agents/observability-specialist.json +747 -0
  21. package/.ai-rules/agents/performance-specialist.json +24 -2
  22. package/.ai-rules/agents/plan-mode.json +0 -1
  23. package/.ai-rules/agents/platform-engineer.json +0 -1
  24. package/.ai-rules/agents/security-specialist.json +27 -16
  25. package/.ai-rules/agents/seo-specialist.json +0 -1
  26. package/.ai-rules/agents/solution-architect.json +0 -1
  27. package/.ai-rules/agents/technical-planner.json +0 -1
  28. package/.ai-rules/agents/test-strategy-specialist.json +14 -2
  29. package/.ai-rules/agents/ui-ux-designer.json +0 -1
  30. package/.ai-rules/rules/core.md +25 -0
  31. package/.ai-rules/skills/README.md +35 -0
  32. package/.ai-rules/skills/database-migration/SKILL.md +531 -0
  33. package/.ai-rules/skills/database-migration/expand-contract-patterns.md +314 -0
  34. package/.ai-rules/skills/database-migration/large-scale-migration.md +414 -0
  35. package/.ai-rules/skills/database-migration/rollback-strategies.md +359 -0
  36. package/.ai-rules/skills/database-migration/validation-procedures.md +428 -0
  37. package/.ai-rules/skills/dependency-management/SKILL.md +381 -0
  38. package/.ai-rules/skills/dependency-management/license-compliance.md +282 -0
  39. package/.ai-rules/skills/dependency-management/lock-file-management.md +437 -0
  40. package/.ai-rules/skills/dependency-management/major-upgrade-guide.md +292 -0
  41. package/.ai-rules/skills/dependency-management/security-vulnerability-response.md +230 -0
  42. package/.ai-rules/skills/incident-response/SKILL.md +373 -0
  43. package/.ai-rules/skills/incident-response/communication-templates.md +322 -0
  44. package/.ai-rules/skills/incident-response/escalation-matrix.md +347 -0
  45. package/.ai-rules/skills/incident-response/postmortem-template.md +351 -0
  46. package/.ai-rules/skills/incident-response/severity-classification.md +256 -0
  47. package/.ai-rules/skills/performance-optimization/CREATION-LOG.md +87 -0
  48. package/.ai-rules/skills/performance-optimization/SKILL.md +76 -0
  49. package/.ai-rules/skills/performance-optimization/documentation-template.md +70 -0
  50. package/.ai-rules/skills/pr-review/SKILL.md +768 -0
  51. package/.ai-rules/skills/refactoring/SKILL.md +192 -0
  52. package/.ai-rules/skills/refactoring/refactoring-catalog.md +1377 -0
  53. package/package.json +1 -1
@@ -24,7 +24,30 @@
24
24
  "Plan and assess image optimization",
25
25
  "Plan and identify memory leaks",
26
26
  "Plan and optimize network requests"
27
- ]
27
+ ],
28
+ "delegation_rules": {
29
+ "to_event_architecture_specialist": [
30
+ "When message queue throughput needs optimization analysis",
31
+ "When event processing latency impacts application performance",
32
+ "When consumer group scaling affects system resources",
33
+ "When event batching strategy needs performance tuning"
34
+ ],
35
+ "from_event_architecture_specialist": [
36
+ "When event handlers cause memory leaks or excessive CPU usage",
37
+ "When WebSocket connections impact Core Web Vitals",
38
+ "When real-time event rendering causes performance bottlenecks"
39
+ ],
40
+ "to_observability_specialist": [
41
+ "When observability infrastructure for performance metrics is needed",
42
+ "When custom metric collection for performance analysis is required",
43
+ "When latency tracing across services is needed"
44
+ ],
45
+ "from_observability_specialist": [
46
+ "When performance optimization requires metric analysis",
47
+ "When Core Web Vitals monitoring integration is needed",
48
+ "When application profiling beyond observability is required"
49
+ ]
50
+ }
28
51
  },
29
52
  "context_files": [
30
53
  ".ai-rules/rules/core.md",
@@ -509,7 +532,6 @@
509
532
  }
510
533
  },
511
534
  "communication": {
512
- "language": "en",
513
535
  "approach": [
514
536
  "Start by understanding performance context (planning/implementation/evaluation)",
515
537
  "Plan/analyze bundle size and rendering",
@@ -89,7 +89,6 @@
89
89
  },
90
90
 
91
91
  "communication": {
92
- "language": "en",
93
92
  "style": "Systematic approach focused on planning",
94
93
  "format": "Clear section separation in structured markdown format"
95
94
  },
@@ -1197,7 +1197,6 @@
1197
1197
  },
1198
1198
 
1199
1199
  "communication": {
1200
- "language": "en",
1201
1200
  "approach": [
1202
1201
  "Start by understanding current infrastructure state",
1203
1202
  "Review existing IaC before making changes",
@@ -5,20 +5,6 @@
5
5
  "preferred": "claude-sonnet-4-20250514",
6
6
  "reason": "Suitable model for security analysis"
7
7
  },
8
- "delegation_rules": {
9
- "to_integration_specialist": [
10
- "When security review identifies external API integration concerns",
11
- "When OAuth flow implementation details need verification beyond security scope",
12
- "When webhook signature verification implementation is needed",
13
- "When circuit breaker or retry pattern implementation is required"
14
- ],
15
- "from_integration_specialist": [
16
- "When OAuth implementation requires vulnerability assessment or penetration testing",
17
- "When authentication/authorization architecture needs security audit",
18
- "When XSS/CSRF/SQL injection prevention review is needed beyond integration scope",
19
- "When secrets management requires security policy review"
20
- ]
21
- },
22
8
  "role": {
23
9
  "title": "Security Engineer",
24
10
  "expertise": [
@@ -37,7 +23,33 @@
37
23
  "Plan and validate JWT token management and storage",
38
24
  "Plan and ensure CSRF/XSS protection mechanisms",
39
25
  "Plan and review rate limiting and input validation"
40
- ]
26
+ ],
27
+ "delegation_rules": {
28
+ "to_integration_specialist": [
29
+ "When security review identifies external API integration concerns",
30
+ "When OAuth flow implementation details need verification beyond security scope",
31
+ "When webhook signature verification implementation is needed",
32
+ "When circuit breaker or retry pattern implementation is required"
33
+ ],
34
+ "from_integration_specialist": [
35
+ "When OAuth implementation requires vulnerability assessment or penetration testing",
36
+ "When authentication/authorization architecture needs security audit",
37
+ "When XSS/CSRF/SQL injection prevention review is needed beyond integration scope",
38
+ "When secrets management requires security policy review"
39
+ ],
40
+ "to_observability_specialist": [
41
+ "When security audit trails need observability infrastructure design",
42
+ "When security event logging requires structured logging patterns",
43
+ "When security metrics (failed logins, blocked requests) need monitoring setup",
44
+ "When security alerting thresholds and SLOs need definition"
45
+ ],
46
+ "from_observability_specialist": [
47
+ "When observability infrastructure needs security review (log access, PII in traces)",
48
+ "When metrics endpoints require authentication/authorization",
49
+ "When tracing data contains sensitive information needing protection",
50
+ "When log retention policies require compliance review"
51
+ ]
52
+ }
41
53
  },
42
54
  "context_files": [
43
55
  ".ai-rules/rules/core.md",
@@ -460,7 +472,6 @@
460
472
  }
461
473
  },
462
474
  "communication": {
463
- "language": "en",
464
475
  "approach": [
465
476
  "Start by understanding security context (planning/implementation/evaluation)",
466
477
  "Plan/verify authentication implementation",
@@ -407,7 +407,6 @@
407
407
  }
408
408
  },
409
409
  "communication": {
410
- "language": "en",
411
410
  "approach": [
412
411
  "Start by understanding SEO context (planning/implementation/evaluation)",
413
412
  "Plan/review metadata implementation",
@@ -162,7 +162,6 @@
162
162
  },
163
163
 
164
164
  "communication": {
165
- "language": "en",
166
165
  "style": "Systematic and clear approach, option-oriented design",
167
166
  "approach": [
168
167
  "Start with brainstorming skill",
@@ -198,7 +198,6 @@
198
198
  },
199
199
 
200
200
  "communication": {
201
- "language": "en",
202
201
  "style": "Detailed and actionable plans, TDD-focused",
203
202
  "approach": [
204
203
  "Start with writing-plans skill",
@@ -24,7 +24,20 @@
24
24
  "Plan and verify edge case testing",
25
25
  "Plan and verify test organization",
26
26
  "Plan and verify no mocking approach"
27
- ]
27
+ ],
28
+ "delegation_rules": {
29
+ "to_event_architecture_specialist": [
30
+ "When saga pattern tests need choreography/orchestration verification",
31
+ "When event schema contract tests need compatibility validation",
32
+ "When event replay tests need idempotency verification",
33
+ "When distributed transaction tests need compensation logic testing"
34
+ ],
35
+ "from_event_architecture_specialist": [
36
+ "When event consumer test coverage falls below 90%",
37
+ "When saga test structure needs TDD guidance",
38
+ "When contract test organization needs standardization"
39
+ ]
40
+ }
28
41
  },
29
42
  "context_files": [
30
43
  ".ai-rules/rules/core.md",
@@ -523,7 +536,6 @@
523
536
  }
524
537
  },
525
538
  "communication": {
526
- "language": "en",
527
539
  "approach": [
528
540
  "Start by understanding test context (planning/implementation/evaluation)",
529
541
  "Plan/verify TDD vs Test-After approach",
@@ -493,7 +493,6 @@
493
493
  },
494
494
 
495
495
  "communication": {
496
- "language": "en",
497
496
  "approach": [
498
497
  "Start by understanding user goals and context",
499
498
  "Apply universal design principles (not system-specific)",
@@ -182,6 +182,15 @@ See `.ai-rules/rules/clarification-guide.md` for detailed question guidelines.
182
182
  - [Input validation planning]
183
183
  - [XSS/CSRF protection planning]
184
184
 
185
+ ## 📨 Event Architecture Planning
186
+ (When event-driven architecture, message queues, or distributed transactions planning is needed)
187
+ - Use Event Architecture Specialist Agent framework (`.ai-rules/agents/event-architecture-specialist.json`) modes.planning for comprehensive event architecture planning
188
+ - [Message broker selection (Kafka, RabbitMQ, SQS)]
189
+ - [Event schema and versioning planning]
190
+ - [Delivery guarantees and idempotency planning]
191
+ - [Saga pattern design (Choreography vs Orchestration)]
192
+ - [Real-time communication planning (WebSocket, SSE)]
193
+
185
194
  ## ♿ Accessibility Planning
186
195
  (When accessibility planning is needed)
187
196
  - Use Accessibility Specialist Agent framework (`.ai-rules/agents/accessibility-specialist.json`) modes.planning for comprehensive accessibility planning
@@ -353,6 +362,14 @@ Execute implementation following TDD cycle, augmented coding principles, and qua
353
362
  - [Input validation verification]
354
363
  - [XSS/CSRF protection verification]
355
364
 
365
+ ## 📨 Event Architecture Implementation Verification
366
+ (When event-driven architecture implementation verification is needed)
367
+ - Use Event Architecture Specialist Agent framework (`.ai-rules/agents/event-architecture-specialist.json`) modes.implementation for comprehensive event architecture implementation verification
368
+ - [Producer/consumer implementation verification]
369
+ - [Idempotency and retry configuration verification]
370
+ - [DLQ and error handling verification]
371
+ - [Correlation ID tracking verification]
372
+
356
373
  ## ♿ Accessibility Implementation Verification
357
374
  (When accessibility implementation verification is needed)
358
375
  - Use Accessibility Specialist Agent framework (`.ai-rules/agents/accessibility-specialist.json`) modes.implementation for comprehensive accessibility implementation verification
@@ -591,6 +608,14 @@ Self-improvement through iterative refinement
591
608
  - [CSRF/XSS protection verification]
592
609
  - [Security vulnerabilities with risk assessment (Critical/High/Medium/Low)]
593
610
 
611
+ ## 📨 Event Architecture Assessment
612
+ (When event-driven architecture or message queue code is present)
613
+ - Use Event Architecture Specialist Agent framework (`.ai-rules/agents/event-architecture-specialist.json`) modes.evaluation for comprehensive event architecture review
614
+ - [Reliability and delivery guarantees audit]
615
+ - [Consistency and saga pattern verification]
616
+ - [Scalability and partitioning assessment]
617
+ - [Observability and correlation ID verification]
618
+
594
619
  ## ♿ Accessibility Assessment
595
620
  (When UI components are present)
596
621
  - Use Accessibility Specialist Agent framework (`.ai-rules/agents/accessibility-specialist.json`) for comprehensive accessibility review
@@ -6,13 +6,20 @@ Reusable workflows for consistent development practices.
6
6
 
7
7
  | Skill | Description | When to Use |
8
8
  |-------|-------------|-------------|
9
+ | api-design | REST/GraphQL API design with OpenAPI spec, versioning, and documentation | Designing new APIs |
9
10
  | brainstorming | Explores user intent, requirements and design before implementation | Before any creative work |
11
+ | database-migration | Zero-downtime schema changes, large-scale data migrations, rollback planning | Schema changes, data migrations, production database modifications |
12
+ | dependency-management | Systematic dependency updates, CVE response, and license compliance | Security vulnerabilities, major upgrades, license audits |
10
13
  | dispatching-parallel-agents | Handle 2+ independent tasks without shared state | Parallel task execution |
11
14
  | executing-plans | Execute implementation plans with review checkpoints | Following written plans |
12
15
  | frontend-design | Create distinctive, production-grade frontend interfaces | Building web components/pages |
16
+ | incident-response | Systematic organizational response to production incidents | Production incidents, alerts, service degradation |
17
+ | pr-review | Systematic, evidence-based PR review with anti-sycophancy principles | Conducting manual PR reviews |
18
+ | refactoring | Structured, test-driven refactoring workflow with Tidy First principles | Improving code structure without changing behavior |
13
19
  | subagent-driven-development | Execute plans with independent tasks in current session | In-session plan execution |
14
20
  | systematic-debugging | Systematic approach before proposing fixes | Encountering bugs or failures |
15
21
  | test-driven-development | Write tests first, then minimal code to pass | Before implementing features |
22
+ | performance-optimization | Profiling-first performance optimization workflow | Performance issues, bottleneck analysis, optimization |
16
23
  | writing-plans | Create implementation plans before coding | Multi-step tasks with specs |
17
24
 
18
25
  ## Skill Format
@@ -93,14 +100,42 @@ EOF
93
100
  ```
94
101
  .ai-rules/skills/
95
102
  ├── README.md # This file
103
+ ├── api-design/
104
+ │ └── SKILL.md
96
105
  ├── brainstorming/
97
106
  │ └── SKILL.md
107
+ ├── database-migration/
108
+ │ ├── SKILL.md
109
+ │ ├── expand-contract-patterns.md
110
+ │ ├── large-scale-migration.md
111
+ │ ├── rollback-strategies.md
112
+ │ └── validation-procedures.md
113
+ ├── dependency-management/
114
+ │ ├── SKILL.md
115
+ │ ├── security-vulnerability-response.md
116
+ │ ├── major-upgrade-guide.md
117
+ │ ├── lock-file-management.md
118
+ │ └── license-compliance.md
98
119
  ├── dispatching-parallel-agents/
99
120
  │ └── SKILL.md
100
121
  ├── executing-plans/
101
122
  │ └── SKILL.md
102
123
  ├── frontend-design/
103
124
  │ └── SKILL.md
125
+ ├── incident-response/
126
+ │ ├── SKILL.md
127
+ │ ├── communication-templates.md
128
+ │ ├── escalation-matrix.md
129
+ │ ├── postmortem-template.md
130
+ │ └── severity-classification.md
131
+ ├── performance-optimization/
132
+ │ ├── SKILL.md
133
+ │ └── documentation-template.md
134
+ ├── pr-review/
135
+ │ └── SKILL.md
136
+ ├── refactoring/
137
+ │ ├── SKILL.md
138
+ │ └── refactoring-catalog.md
104
139
  ├── subagent-driven-development/
105
140
  │ └── SKILL.md
106
141
  ├── systematic-debugging/