oh-my-customcode 0.44.6 → 0.45.0

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.
@@ -0,0 +1,106 @@
1
+ # Domain Skill Bundle Design Guide
2
+
3
+ ## Overview
4
+
5
+ Domain skill bundles package related skills, agents, and guides for a specific technology or framework. This guide defines the standard pattern based on the Author/Test/Troubleshoot tri-pattern (inspired by Microsoft Copilot Studio Skills).
6
+
7
+ ## The Author/Test/Troubleshoot Pattern
8
+
9
+ Every domain skill bundle should provide three capability axes:
10
+
11
+ ### Author (Create & Edit)
12
+ Skills and agents that help CREATE artifacts in the domain.
13
+
14
+ | Component | Example (Spring Boot) | Example (Airflow) |
15
+ |-----------|----------------------|-------------------|
16
+ | Best practices skill | springboot-best-practices | airflow-best-practices |
17
+ | Expert agent | be-springboot-expert | de-airflow-expert |
18
+ | Code generation | Scaffold, boilerplate | DAG authoring |
19
+
20
+ ### Test (Verify & Validate)
21
+ Skills and agents that help VERIFY correctness.
22
+
23
+ | Component | Example (Spring Boot) | Example (Airflow) |
24
+ |-----------|----------------------|-------------------|
25
+ | Review skill | dev-review | dev-review |
26
+ | QA workflow | qa-lead-routing | qa-lead-routing |
27
+ | Domain-specific checks | Spring actuator health | DAG validation |
28
+
29
+ ### Troubleshoot (Debug & Fix)
30
+ Skills and agents that help DIAGNOSE and FIX issues.
31
+
32
+ | Component | Example (Spring Boot) | Example (Airflow) |
33
+ |-----------|----------------------|-------------------|
34
+ | Debugging skill | systematic-debugging | systematic-debugging |
35
+ | Domain diagnostics | Spring Boot Actuator | Airflow log analysis |
36
+ | Fix patterns | Common Spring errors | DAG failure patterns |
37
+
38
+ ## Existing Bundle Inventory
39
+
40
+ Map existing oh-my-customcode skills/agents to the tri-pattern:
41
+
42
+ | Domain | Author | Test | Troubleshoot | Completeness |
43
+ |--------|--------|------|-------------|-------------|
44
+ | Spring Boot | springboot-best-practices, be-springboot-expert | dev-review | systematic-debugging | ★★★ |
45
+ | FastAPI | fastapi-best-practices, be-fastapi-expert | dev-review | systematic-debugging | ★★★ |
46
+ | Go | go-best-practices, lang-golang-expert, be-go-backend-expert | dev-review | systematic-debugging | ★★★ |
47
+ | Airflow | airflow-best-practices, de-airflow-expert | dev-review | systematic-debugging | ★★★ |
48
+ | React/Next.js | react-best-practices, fe-vercel-agent | web-design-guidelines | systematic-debugging | ★★★ |
49
+ | PostgreSQL | postgres-best-practices, db-postgres-expert | dev-review | systematic-debugging | ★★★ |
50
+ | Docker | docker-best-practices, infra-docker-expert | dev-review | systematic-debugging | ★★☆ |
51
+ | Kafka | kafka-best-practices, de-kafka-expert | dev-review | systematic-debugging | ★★☆ |
52
+ | Redis | redis-best-practices, db-redis-expert | dev-review | systematic-debugging | ★★☆ |
53
+
54
+ ## Creating a New Bundle
55
+
56
+ ### Checklist
57
+
58
+ 1. **Author axis**:
59
+ - [ ] Best practices skill (`.claude/skills/{domain}-best-practices/SKILL.md`)
60
+ - [ ] Expert agent (`.claude/agents/{type}-{domain}-expert.md`)
61
+ - [ ] Reference guide (`guides/{domain}/`)
62
+
63
+ 2. **Test axis**:
64
+ - [ ] Domain-specific test patterns documented in best practices skill
65
+ - [ ] Integration with qa-lead-routing or dev-review
66
+
67
+ 3. **Troubleshoot axis**:
68
+ - [ ] Common error patterns documented in best practices skill
69
+ - [ ] Integration with systematic-debugging
70
+
71
+ ### Minimum Viable Bundle
72
+
73
+ At minimum, a domain bundle needs:
74
+ - 1 best practices skill (Author)
75
+ - 1 expert agent (Author + Troubleshoot)
76
+ - Integration with dev-review (Test)
77
+
78
+ ### Template
79
+
80
+ ```
81
+ guides/{domain}/
82
+ ├── README.md # Domain overview and quick reference
83
+ ├── patterns.md # Common patterns and anti-patterns
84
+ └── troubleshooting.md # Common errors and solutions
85
+
86
+ .claude/skills/{domain}-best-practices/
87
+ └── SKILL.md # Best practices skill
88
+
89
+ .claude/agents/{type}-{domain}-expert.md # Expert agent
90
+ ```
91
+
92
+ ## Relationship to Other Skills
93
+
94
+ | Skill | Role in Bundle Pattern |
95
+ |-------|----------------------|
96
+ | dev-review | Universal Test axis |
97
+ | systematic-debugging | Universal Troubleshoot axis |
98
+ | adversarial-review | Advanced Test axis (security) |
99
+ | qa-lead-routing | Test orchestration |
100
+ | mgr-creator | Bundle creation automation |
101
+
102
+ ## References
103
+
104
+ - Microsoft Copilot Studio Skills: Author/Test/Troubleshoot pattern
105
+ - oh-my-customcode R006: Agent Design (separation of concerns)
106
+ - oh-my-customcode compilation metaphor: skills = source, agents = build artifacts
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "0.44.6",
2
+ "version": "0.45.0",
3
3
  "lastUpdated": "2026-03-16T00:00:00.000Z",
4
4
  "components": [
5
5
  {
@@ -18,13 +18,13 @@
18
18
  "name": "skills",
19
19
  "path": ".claude/skills",
20
20
  "description": "Reusable skill modules (includes slash commands)",
21
- "files": 77
21
+ "files": 82
22
22
  },
23
23
  {
24
24
  "name": "guides",
25
25
  "path": "guides",
26
26
  "description": "Reference documentation",
27
- "files": 26
27
+ "files": 28
28
28
  },
29
29
  {
30
30
  "name": "hooks",