oh-my-customcode 0.12.0 → 0.12.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.
- package/README.md +4 -8
- package/dist/cli/index.js +382 -308
- package/dist/index.js +99 -260
- package/package.json +2 -4
- package/templates/.codex/agents/arch-documenter.md +0 -33
- package/templates/.codex/agents/arch-speckit-agent.md +0 -47
- package/templates/.codex/agents/be-express-expert.md +0 -30
- package/templates/.codex/agents/be-fastapi-expert.md +0 -43
- package/templates/.codex/agents/be-go-backend-expert.md +0 -43
- package/templates/.codex/agents/be-nestjs-expert.md +0 -28
- package/templates/.codex/agents/be-springboot-expert.md +0 -40
- package/templates/.codex/agents/db-postgres-expert.md +0 -36
- package/templates/.codex/agents/db-redis-expert.md +0 -36
- package/templates/.codex/agents/db-supabase-expert.md +0 -35
- package/templates/.codex/agents/de-airflow-expert.md +0 -34
- package/templates/.codex/agents/de-dbt-expert.md +0 -34
- package/templates/.codex/agents/de-kafka-expert.md +0 -81
- package/templates/.codex/agents/de-pipeline-expert.md +0 -32
- package/templates/.codex/agents/de-snowflake-expert.md +0 -36
- package/templates/.codex/agents/de-spark-expert.md +0 -36
- package/templates/.codex/agents/fe-svelte-agent.md +0 -29
- package/templates/.codex/agents/fe-vercel-agent.md +0 -37
- package/templates/.codex/agents/fe-vuejs-agent.md +0 -30
- package/templates/.codex/agents/infra-aws-expert.md +0 -47
- package/templates/.codex/agents/infra-docker-expert.md +0 -47
- package/templates/.codex/agents/lang-golang-expert.md +0 -43
- package/templates/.codex/agents/lang-java21-expert.md +0 -39
- package/templates/.codex/agents/lang-kotlin-expert.md +0 -43
- package/templates/.codex/agents/lang-python-expert.md +0 -43
- package/templates/.codex/agents/lang-rust-expert.md +0 -43
- package/templates/.codex/agents/lang-typescript-expert.md +0 -43
- package/templates/.codex/agents/mgr-claude-code-bible.md +0 -61
- package/templates/.codex/agents/mgr-creator.md +0 -39
- package/templates/.codex/agents/mgr-gitnerd.md +0 -45
- package/templates/.codex/agents/mgr-sauron.md +0 -161
- package/templates/.codex/agents/mgr-supplier.md +0 -35
- package/templates/.codex/agents/mgr-sync-checker.md +0 -38
- package/templates/.codex/agents/mgr-updater.md +0 -33
- package/templates/.codex/agents/qa-engineer.md +0 -32
- package/templates/.codex/agents/qa-planner.md +0 -73
- package/templates/.codex/agents/qa-writer.md +0 -27
- package/templates/.codex/agents/sys-memory-keeper.md +0 -43
- package/templates/.codex/agents/sys-naggy.md +0 -37
- package/templates/.codex/agents/tool-bun-expert.md +0 -26
- package/templates/.codex/agents/tool-npm-expert.md +0 -30
- package/templates/.codex/agents/tool-optimizer.md +0 -34
- package/templates/.codex/codex-native-hash.txt +0 -1
- package/templates/.codex/contexts/dev.md +0 -20
- package/templates/.codex/contexts/ecomode.md +0 -63
- package/templates/.codex/contexts/index.yaml +0 -41
- package/templates/.codex/contexts/research.md +0 -28
- package/templates/.codex/contexts/review.md +0 -23
- package/templates/.codex/hooks/hooks.json +0 -151
- package/templates/.codex/install-hooks.sh +0 -100
- package/templates/.codex/rules/MAY-optimization.md +0 -29
- package/templates/.codex/rules/MUST-agent-design.md +0 -57
- package/templates/.codex/rules/MUST-agent-identification.md +0 -29
- package/templates/.codex/rules/MUST-continuous-improvement.md +0 -25
- package/templates/.codex/rules/MUST-intent-transparency.md +0 -42
- package/templates/.codex/rules/MUST-language-policy.md +0 -27
- package/templates/.codex/rules/MUST-orchestrator-coordination.md +0 -128
- package/templates/.codex/rules/MUST-parallel-execution.md +0 -97
- package/templates/.codex/rules/MUST-permissions.md +0 -30
- package/templates/.codex/rules/MUST-safety.md +0 -23
- package/templates/.codex/rules/MUST-sync-verification.md +0 -125
- package/templates/.codex/rules/MUST-tool-identification.md +0 -82
- package/templates/.codex/rules/SHOULD-agent-teams.md +0 -39
- package/templates/.codex/rules/SHOULD-ecomode.md +0 -37
- package/templates/.codex/rules/SHOULD-error-handling.md +0 -33
- package/templates/.codex/rules/SHOULD-hud-statusline.md +0 -32
- package/templates/.codex/rules/SHOULD-interaction.md +0 -34
- package/templates/.codex/rules/SHOULD-memory-integration.md +0 -39
- package/templates/.codex/rules/index.yaml +0 -141
- package/templates/.codex/skills/airflow-best-practices/SKILL.md +0 -56
- package/templates/.codex/skills/audit-agents/SKILL.md +0 -116
- package/templates/.codex/skills/aws-best-practices/SKILL.md +0 -280
- package/templates/.codex/skills/claude-code-bible/SKILL.md +0 -180
- package/templates/.codex/skills/claude-code-bible/scripts/fetch-docs.js +0 -244
- package/templates/.codex/skills/create-agent/SKILL.md +0 -91
- package/templates/.codex/skills/dbt-best-practices/SKILL.md +0 -54
- package/templates/.codex/skills/de-lead-routing/SKILL.md +0 -243
- package/templates/.codex/skills/dev-lead-routing/SKILL.md +0 -94
- package/templates/.codex/skills/dev-refactor/SKILL.md +0 -123
- package/templates/.codex/skills/dev-review/SKILL.md +0 -81
- package/templates/.codex/skills/docker-best-practices/SKILL.md +0 -275
- package/templates/.codex/skills/fastapi-best-practices/SKILL.md +0 -270
- package/templates/.codex/skills/fix-refs/SKILL.md +0 -107
- package/templates/.codex/skills/go-backend-best-practices/SKILL.md +0 -338
- package/templates/.codex/skills/go-best-practices/CLAUDE.md +0 -9
- package/templates/.codex/skills/go-best-practices/SKILL.md +0 -203
- package/templates/.codex/skills/help/SKILL.md +0 -125
- package/templates/.codex/skills/intent-detection/SKILL.md +0 -215
- package/templates/.codex/skills/intent-detection/patterns/agent-triggers.yaml +0 -349
- package/templates/.codex/skills/kafka-best-practices/SKILL.md +0 -52
- package/templates/.codex/skills/kotlin-best-practices/SKILL.md +0 -256
- package/templates/.codex/skills/lists/SKILL.md +0 -78
- package/templates/.codex/skills/memory-management/SKILL.md +0 -195
- package/templates/.codex/skills/memory-recall/SKILL.md +0 -152
- package/templates/.codex/skills/memory-save/SKILL.md +0 -126
- package/templates/.codex/skills/monitoring-setup/SKILL.md +0 -115
- package/templates/.codex/skills/npm-audit/SKILL.md +0 -72
- package/templates/.codex/skills/npm-publish/SKILL.md +0 -63
- package/templates/.codex/skills/npm-version/SKILL.md +0 -75
- package/templates/.codex/skills/optimize-analyze/SKILL.md +0 -55
- package/templates/.codex/skills/optimize-bundle/SKILL.md +0 -67
- package/templates/.codex/skills/optimize-report/SKILL.md +0 -74
- package/templates/.codex/skills/pipeline-architecture-patterns/SKILL.md +0 -83
- package/templates/.codex/skills/postgres-best-practices/SKILL.md +0 -66
- package/templates/.codex/skills/python-best-practices/SKILL.md +0 -222
- package/templates/.codex/skills/qa-lead-routing/SKILL.md +0 -290
- package/templates/.codex/skills/react-best-practices/SKILL.md +0 -101
- package/templates/.codex/skills/redis-best-practices/SKILL.md +0 -83
- package/templates/.codex/skills/result-aggregation/SKILL.md +0 -164
- package/templates/.codex/skills/rust-best-practices/SKILL.md +0 -267
- package/templates/.codex/skills/sauron-watch/SKILL.md +0 -144
- package/templates/.codex/skills/secretary-routing/SKILL.md +0 -203
- package/templates/.codex/skills/snowflake-best-practices/SKILL.md +0 -65
- package/templates/.codex/skills/spark-best-practices/SKILL.md +0 -52
- package/templates/.codex/skills/springboot-best-practices/SKILL.md +0 -218
- package/templates/.codex/skills/status/SKILL.md +0 -153
- package/templates/.codex/skills/supabase-postgres-best-practices/SKILL.md +0 -99
- package/templates/.codex/skills/typescript-best-practices/SKILL.md +0 -321
- package/templates/.codex/skills/update-docs/SKILL.md +0 -140
- package/templates/.codex/skills/update-external/SKILL.md +0 -149
- package/templates/.codex/skills/vercel-deploy/SKILL.md +0 -73
- package/templates/.codex/skills/web-design-guidelines/SKILL.md +0 -118
- package/templates/.codex/skills/writing-clearly-and-concisely/SKILL.md +0 -64
- package/templates/.codex/uninstall-hooks.sh +0 -52
- package/templates/AGENTS.md.en +0 -39
- package/templates/AGENTS.md.ko +0 -39
- package/templates/manifest.codex.json +0 -43
|
@@ -1,243 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: de-lead-routing
|
|
3
|
-
description: Routes data engineering tasks to the correct DE expert agent. Use when user requests data pipeline design, DAG authoring, SQL modeling, stream processing, or warehouse optimization.
|
|
4
|
-
user-invocable: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# DE Lead Routing Skill
|
|
8
|
-
|
|
9
|
-
## Purpose
|
|
10
|
-
|
|
11
|
-
Routes data engineering tasks to appropriate DE expert agents. This skill contains the coordination logic for orchestrating data engineering agents across orchestration, modeling, processing, streaming, and warehouse specializations.
|
|
12
|
-
|
|
13
|
-
## Engineers Under Management
|
|
14
|
-
|
|
15
|
-
| Type | Agents | Purpose |
|
|
16
|
-
|------|--------|---------|
|
|
17
|
-
| de/orchestration | de-airflow-expert | DAG authoring, scheduling, testing |
|
|
18
|
-
| de/modeling | de-dbt-expert | SQL modeling, testing, documentation |
|
|
19
|
-
| de/processing | de-spark-expert | Distributed data processing |
|
|
20
|
-
| de/streaming | de-kafka-expert | Event streaming, topic design |
|
|
21
|
-
| de/warehouse | de-snowflake-expert | Cloud DWH, query optimization |
|
|
22
|
-
| de/architecture | de-pipeline-expert | Pipeline design, cross-tool patterns |
|
|
23
|
-
|
|
24
|
-
## Tool/Framework Detection
|
|
25
|
-
|
|
26
|
-
### Keyword Mapping
|
|
27
|
-
|
|
28
|
-
| Keyword | Agent |
|
|
29
|
-
|---------|-------|
|
|
30
|
-
| "airflow", "dag", "scheduling", "orchestration" | de-airflow-expert |
|
|
31
|
-
| "dbt", "modeling", "sql model", "analytics engineering" | de-dbt-expert |
|
|
32
|
-
| "spark", "pyspark", "distributed processing", "distributed" | de-spark-expert |
|
|
33
|
-
| "kafka", "streaming", "event", "consumer", "producer" | de-kafka-expert |
|
|
34
|
-
| "snowflake", "warehouse", "clustering key" | de-snowflake-expert |
|
|
35
|
-
| "pipeline", "ETL", "ELT", "data quality", "lineage" | de-pipeline-expert |
|
|
36
|
-
| "iceberg", "table format" | de-snowflake-expert or de-pipeline-expert |
|
|
37
|
-
|
|
38
|
-
### File Pattern Mapping
|
|
39
|
-
|
|
40
|
-
| Pattern | Agent |
|
|
41
|
-
|---------|-------|
|
|
42
|
-
| `dags/*.py`, `airflow.cfg`, `airflow_settings.yaml` | de-airflow-expert |
|
|
43
|
-
| `models/**/*.sql`, `dbt_project.yml`, `schema.yml` | de-dbt-expert |
|
|
44
|
-
| Spark job files, `spark-submit` configs | de-spark-expert |
|
|
45
|
-
| Kafka configs, `*.properties` (Kafka), `streams/*.java` | de-kafka-expert |
|
|
46
|
-
| Snowflake SQL, warehouse DDL | de-snowflake-expert |
|
|
47
|
-
|
|
48
|
-
## Command Routing
|
|
49
|
-
|
|
50
|
-
```
|
|
51
|
-
DE Request → Detection → Expert Agent
|
|
52
|
-
|
|
53
|
-
Airflow DAG → de-airflow-expert
|
|
54
|
-
dbt model → de-dbt-expert
|
|
55
|
-
Spark job → de-spark-expert
|
|
56
|
-
Kafka topic → de-kafka-expert
|
|
57
|
-
Snowflake → de-snowflake-expert
|
|
58
|
-
Pipeline → de-pipeline-expert
|
|
59
|
-
Multi-tool → Multiple experts (parallel)
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
## Routing Rules
|
|
63
|
-
|
|
64
|
-
### 1. Pipeline Development Workflow
|
|
65
|
-
|
|
66
|
-
```
|
|
67
|
-
1. Receive pipeline task request
|
|
68
|
-
2. Identify tools and components:
|
|
69
|
-
- DAG orchestration → de-airflow-expert
|
|
70
|
-
- SQL transformations → de-dbt-expert
|
|
71
|
-
- Distributed processing → de-spark-expert
|
|
72
|
-
- Event streaming → de-kafka-expert
|
|
73
|
-
- Warehouse operations → de-snowflake-expert
|
|
74
|
-
- Architecture decisions → de-pipeline-expert
|
|
75
|
-
3. Select appropriate experts
|
|
76
|
-
4. Distribute tasks (parallel if 2+ tools)
|
|
77
|
-
5. Aggregate results
|
|
78
|
-
6. Present unified report
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
Example:
|
|
82
|
-
```
|
|
83
|
-
User: "Design a pipeline that runs dbt models from Airflow and loads into Snowflake"
|
|
84
|
-
|
|
85
|
-
Detection:
|
|
86
|
-
- Airflow DAG → de-airflow-expert
|
|
87
|
-
- dbt model → de-dbt-expert
|
|
88
|
-
- Snowflake loading → de-snowflake-expert
|
|
89
|
-
- Pipeline architecture → de-pipeline-expert
|
|
90
|
-
|
|
91
|
-
Route (parallel where independent):
|
|
92
|
-
Task(de-pipeline-expert → overall architecture design)
|
|
93
|
-
Task(de-airflow-expert → DAG structure)
|
|
94
|
-
Task(de-dbt-expert → model design)
|
|
95
|
-
Task(de-snowflake-expert → warehouse setup)
|
|
96
|
-
|
|
97
|
-
Aggregate:
|
|
98
|
-
Pipeline architecture defined
|
|
99
|
-
Airflow DAG: 5 tasks designed
|
|
100
|
-
dbt: 12 models structured
|
|
101
|
-
Snowflake: warehouse + schema configured
|
|
102
|
-
```
|
|
103
|
-
|
|
104
|
-
### 2. Data Quality Workflow
|
|
105
|
-
|
|
106
|
-
```
|
|
107
|
-
1. Analyze data quality requirements
|
|
108
|
-
2. Route to appropriate experts:
|
|
109
|
-
- dbt tests → de-dbt-expert
|
|
110
|
-
- Pipeline validation → de-pipeline-expert
|
|
111
|
-
- Source freshness → de-airflow-expert
|
|
112
|
-
3. Coordinate cross-tool quality strategy
|
|
113
|
-
```
|
|
114
|
-
|
|
115
|
-
### 3. Multi-Tool Projects
|
|
116
|
-
|
|
117
|
-
For projects spanning multiple DE tools:
|
|
118
|
-
|
|
119
|
-
```
|
|
120
|
-
1. Detect all DE tools in project
|
|
121
|
-
2. Identify primary tool (most files/configs)
|
|
122
|
-
3. Route to appropriate experts:
|
|
123
|
-
- If task spans multiple tools → parallel experts
|
|
124
|
-
- If task is tool-specific → single expert
|
|
125
|
-
4. Coordinate cross-tool consistency
|
|
126
|
-
```
|
|
127
|
-
|
|
128
|
-
## Sub-agent Model Selection
|
|
129
|
-
|
|
130
|
-
### Model Mapping by Task Type
|
|
131
|
-
|
|
132
|
-
| Task Type | Recommended Model | Reason |
|
|
133
|
-
|-----------|-------------------|--------|
|
|
134
|
-
| Pipeline architecture | `opus` | Deep reasoning required |
|
|
135
|
-
| DAG/model review | `sonnet` | Balanced quality judgment |
|
|
136
|
-
| Implementation | `sonnet` | Standard code generation |
|
|
137
|
-
| Quick validation | `haiku` | Fast response |
|
|
138
|
-
|
|
139
|
-
### Model Mapping by Agent
|
|
140
|
-
|
|
141
|
-
| Agent | Default Model | Alternative |
|
|
142
|
-
|-------|---------------|-------------|
|
|
143
|
-
| de-pipeline-expert | `sonnet` | `opus` for architecture |
|
|
144
|
-
| de-airflow-expert | `sonnet` | `haiku` for DAG validation |
|
|
145
|
-
| de-dbt-expert | `sonnet` | `haiku` for test checks |
|
|
146
|
-
| de-spark-expert | `sonnet` | `opus` for optimization |
|
|
147
|
-
| de-kafka-expert | `sonnet` | `opus` for topology design |
|
|
148
|
-
| de-snowflake-expert | `sonnet` | `opus` for warehouse design |
|
|
149
|
-
|
|
150
|
-
### Task Call Examples
|
|
151
|
-
|
|
152
|
-
```
|
|
153
|
-
# Complex pipeline architecture
|
|
154
|
-
Task(
|
|
155
|
-
subagent_type: "general-purpose",
|
|
156
|
-
prompt: "Design end-to-end pipeline architecture following de-pipeline-expert guidelines",
|
|
157
|
-
model: "opus"
|
|
158
|
-
)
|
|
159
|
-
|
|
160
|
-
# Standard DAG review
|
|
161
|
-
Task(
|
|
162
|
-
subagent_type: "general-purpose",
|
|
163
|
-
prompt: "Review Airflow DAGs in dags/ following de-airflow-expert guidelines",
|
|
164
|
-
model: "sonnet"
|
|
165
|
-
)
|
|
166
|
-
|
|
167
|
-
# Quick dbt test validation
|
|
168
|
-
Task(
|
|
169
|
-
subagent_type: "Explore",
|
|
170
|
-
prompt: "Find all dbt models missing schema tests",
|
|
171
|
-
model: "haiku"
|
|
172
|
-
)
|
|
173
|
-
```
|
|
174
|
-
|
|
175
|
-
## Parallel Execution
|
|
176
|
-
|
|
177
|
-
Following R009:
|
|
178
|
-
- Maximum 4 parallel instances
|
|
179
|
-
- Independent tool/module operations
|
|
180
|
-
- Coordinate cross-tool consistency
|
|
181
|
-
|
|
182
|
-
Example:
|
|
183
|
-
```
|
|
184
|
-
User: "Review all DE configs"
|
|
185
|
-
|
|
186
|
-
Detection:
|
|
187
|
-
- dags/ → de-airflow-expert
|
|
188
|
-
- models/ → de-dbt-expert
|
|
189
|
-
- kafka/ → de-kafka-expert
|
|
190
|
-
|
|
191
|
-
Route (parallel):
|
|
192
|
-
Task(de-airflow-expert role → review dags/, model: "sonnet")
|
|
193
|
-
Task(de-dbt-expert role → review models/, model: "sonnet")
|
|
194
|
-
Task(de-kafka-expert role → review kafka/, model: "sonnet")
|
|
195
|
-
```
|
|
196
|
-
|
|
197
|
-
## Display Format
|
|
198
|
-
|
|
199
|
-
```
|
|
200
|
-
[Analyzing] Detected: Airflow, dbt, Snowflake
|
|
201
|
-
|
|
202
|
-
[Delegating] de-airflow-expert:sonnet → DAG design
|
|
203
|
-
[Delegating] de-dbt-expert:sonnet → Model structure
|
|
204
|
-
[Delegating] de-snowflake-expert:sonnet → Warehouse config
|
|
205
|
-
|
|
206
|
-
[Progress] ███████████░ 2/3 experts completed
|
|
207
|
-
|
|
208
|
-
[Summary]
|
|
209
|
-
Airflow: DAG with 5 tasks designed
|
|
210
|
-
dbt: 12 models across 3 layers
|
|
211
|
-
Snowflake: Warehouse + schema configured
|
|
212
|
-
|
|
213
|
-
Pipeline design completed.
|
|
214
|
-
```
|
|
215
|
-
|
|
216
|
-
## Integration with Other Routing Skills
|
|
217
|
-
|
|
218
|
-
- **dev-lead-routing**: Hands off to DE lead when data engineering keywords detected
|
|
219
|
-
- **secretary-routing**: DE agents accessible through secretary for management tasks
|
|
220
|
-
- **qa-lead-routing**: Coordinates with QA for data quality testing
|
|
221
|
-
|
|
222
|
-
## Agent Teams Awareness
|
|
223
|
-
|
|
224
|
-
Before routing via Task tool, check if Agent Teams is available (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` or TeamCreate/SendMessage tools present).
|
|
225
|
-
|
|
226
|
-
**Self-check:** Does this task need 3+ agents, shared state, or inter-agent communication? If yes, prefer Agent Teams over Task tool. See R018 for the full decision matrix.
|
|
227
|
-
|
|
228
|
-
| Scenario | Preferred |
|
|
229
|
-
|----------|-----------|
|
|
230
|
-
| Single-tool DE task | Task Tool |
|
|
231
|
-
| Multi-tool pipeline design (3+ tools) | Agent Teams |
|
|
232
|
-
| Cross-tool data quality analysis | Agent Teams |
|
|
233
|
-
| Quick DAG/model validation | Task Tool |
|
|
234
|
-
|
|
235
|
-
## Usage
|
|
236
|
-
|
|
237
|
-
This skill is NOT user-invocable. It should be automatically triggered when the main conversation detects data engineering intent.
|
|
238
|
-
|
|
239
|
-
Detection criteria:
|
|
240
|
-
- User requests pipeline design or data engineering
|
|
241
|
-
- User mentions DE tool names (Airflow, dbt, Spark, Kafka, Snowflake)
|
|
242
|
-
- User provides DE-related file paths (dags/, models/, etc.)
|
|
243
|
-
- User requests data quality or lineage work
|
|
@@ -1,94 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: dev-lead-routing
|
|
3
|
-
description: Routes development tasks to the correct language or framework expert agent. Use when user requests code review, implementation, refactoring, or debugging.
|
|
4
|
-
user-invocable: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Dev Lead Routing
|
|
8
|
-
|
|
9
|
-
## Engineers
|
|
10
|
-
|
|
11
|
-
| Type | Agents |
|
|
12
|
-
|------|--------|
|
|
13
|
-
| Language | lang-golang-expert, lang-python-expert, lang-rust-expert, lang-kotlin-expert, lang-typescript-expert, lang-java21-expert |
|
|
14
|
-
| Frontend | fe-vercel-agent, fe-vuejs-agent, fe-svelte-agent |
|
|
15
|
-
| Backend | be-fastapi-expert, be-springboot-expert, be-go-backend-expert, be-nestjs-expert, be-express-expert |
|
|
16
|
-
| Tooling | tool-npm-expert, tool-optimizer, tool-bun-expert |
|
|
17
|
-
| Database | db-supabase-expert, db-postgres-expert, db-redis-expert |
|
|
18
|
-
| Architect | arch-documenter, arch-speckit-agent |
|
|
19
|
-
| Infra | infra-docker-expert, infra-aws-expert |
|
|
20
|
-
|
|
21
|
-
## File Extension Mapping
|
|
22
|
-
|
|
23
|
-
| Extension | Agent |
|
|
24
|
-
|-----------|-------|
|
|
25
|
-
| `.go` | lang-golang-expert |
|
|
26
|
-
| `.py` | lang-python-expert |
|
|
27
|
-
| `.rs` | lang-rust-expert |
|
|
28
|
-
| `.kt`, `.kts` | lang-kotlin-expert |
|
|
29
|
-
| `.ts`, `.tsx` | lang-typescript-expert |
|
|
30
|
-
| `.java` | lang-java21-expert |
|
|
31
|
-
| `.js/.jsx` (React) | fe-vercel-agent |
|
|
32
|
-
| `.vue` | fe-vuejs-agent |
|
|
33
|
-
| `.svelte` | fe-svelte-agent |
|
|
34
|
-
| `.sql` (PG) | db-postgres-expert |
|
|
35
|
-
| `.sql` (Supabase) | db-supabase-expert |
|
|
36
|
-
| `Dockerfile`, `*.dockerfile` | infra-docker-expert |
|
|
37
|
-
| `*.tf`, `*.tfvars` | infra-aws-expert |
|
|
38
|
-
| `*.yaml`, `*.yml` (CloudFormation) | infra-aws-expert |
|
|
39
|
-
|
|
40
|
-
## Keyword Mapping
|
|
41
|
-
|
|
42
|
-
| Keywords | Agent |
|
|
43
|
-
|----------|-------|
|
|
44
|
-
| go, golang | lang-golang-expert |
|
|
45
|
-
| python, py | lang-python-expert |
|
|
46
|
-
| rust | lang-rust-expert |
|
|
47
|
-
| kotlin | lang-kotlin-expert |
|
|
48
|
-
| typescript, ts | lang-typescript-expert |
|
|
49
|
-
| java | lang-java21-expert |
|
|
50
|
-
| react, next.js, vercel | fe-vercel-agent |
|
|
51
|
-
| vue | fe-vuejs-agent |
|
|
52
|
-
| svelte | fe-svelte-agent |
|
|
53
|
-
| fastapi | be-fastapi-expert |
|
|
54
|
-
| spring, springboot | be-springboot-expert |
|
|
55
|
-
| nestjs | be-nestjs-expert |
|
|
56
|
-
| express | be-express-expert |
|
|
57
|
-
| npm | tool-npm-expert |
|
|
58
|
-
| optimize, bundle | tool-optimizer |
|
|
59
|
-
| bun | tool-bun-expert |
|
|
60
|
-
| postgres, postgresql, psql, pg_stat | db-postgres-expert |
|
|
61
|
-
| redis, cache, pub/sub, sorted set | db-redis-expert |
|
|
62
|
-
| supabase, rls, edge function | db-supabase-expert |
|
|
63
|
-
| docker, dockerfile, container, compose | infra-docker-expert |
|
|
64
|
-
| aws, cloudformation, vpc, iam, s3, lambda, cdk, terraform | infra-aws-expert |
|
|
65
|
-
| architecture, adr, openapi, swagger, diagram | arch-documenter |
|
|
66
|
-
| spec, specification, tdd, requirements | arch-speckit-agent |
|
|
67
|
-
|
|
68
|
-
## Model Selection
|
|
69
|
-
|
|
70
|
-
| Task | Model |
|
|
71
|
-
|------|-------|
|
|
72
|
-
| Architecture analysis | opus |
|
|
73
|
-
| Code review/implementation | sonnet |
|
|
74
|
-
| Quick validation/search | haiku |
|
|
75
|
-
|
|
76
|
-
## Routing Rules
|
|
77
|
-
|
|
78
|
-
Multi-language: detect all languages, route to parallel experts (max 4). Single-language: route to matching expert. Cross-layer (frontend + backend): multiple experts in parallel.
|
|
79
|
-
|
|
80
|
-
## Agent Teams Awareness
|
|
81
|
-
|
|
82
|
-
Before routing via Task tool, check if Agent Teams is available (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` or TeamCreate/SendMessage tools present).
|
|
83
|
-
|
|
84
|
-
**Self-check:** Does this task need 3+ agents, shared state, or inter-agent communication? If yes, prefer Agent Teams over Task tool. See R018 for the full decision matrix.
|
|
85
|
-
|
|
86
|
-
| Scenario | Preferred |
|
|
87
|
-
|----------|-----------|
|
|
88
|
-
| Single-language review | Task Tool |
|
|
89
|
-
| Multi-language code review (3+) | Agent Teams |
|
|
90
|
-
| Code review + fix cycle | Agent Teams |
|
|
91
|
-
| Cross-layer debugging (FE + BE + DB) | Agent Teams |
|
|
92
|
-
| Simple file search/validation | Task Tool |
|
|
93
|
-
|
|
94
|
-
Not user-invocable. Auto-triggered on development intent.
|
|
@@ -1,123 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: dev-refactor
|
|
3
|
-
description: Refactor code for better structure and patterns
|
|
4
|
-
argument-hint: "<file-or-directory> [--lang <language>]"
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Code Refactoring Skill
|
|
8
|
-
|
|
9
|
-
Refactor code for better structure, naming, and patterns using language-specific expert agents.
|
|
10
|
-
|
|
11
|
-
## Parameters
|
|
12
|
-
|
|
13
|
-
| Name | Type | Required | Description |
|
|
14
|
-
|------|------|----------|-------------|
|
|
15
|
-
| path | string | yes | File or directory to refactor |
|
|
16
|
-
|
|
17
|
-
## Options
|
|
18
|
-
|
|
19
|
-
```
|
|
20
|
-
--lang, -l Language (auto-detected if not specified)
|
|
21
|
-
Values: go, python, rust, kotlin, typescript, java
|
|
22
|
-
--focus, -f Focus area (structure, naming, patterns, all)
|
|
23
|
-
--dry-run Show proposed changes without applying
|
|
24
|
-
--verbose, -v Detailed output
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
## Workflow
|
|
28
|
-
|
|
29
|
-
```
|
|
30
|
-
1. Detect language (or use --lang)
|
|
31
|
-
2. Select appropriate expert agent
|
|
32
|
-
3. Load language-specific skill
|
|
33
|
-
4. Analyze code structure
|
|
34
|
-
5. Propose refactoring changes
|
|
35
|
-
6. Apply changes (if not --dry-run)
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
## Agent Selection
|
|
39
|
-
|
|
40
|
-
| File Extension | Agent | Skill |
|
|
41
|
-
|----------------|-------|-------|
|
|
42
|
-
| .go | lang-golang-expert | go-best-practices |
|
|
43
|
-
| .py | lang-python-expert | python-best-practices |
|
|
44
|
-
| .rs | lang-rust-expert | rust-best-practices |
|
|
45
|
-
| .kt | lang-kotlin-expert | kotlin-best-practices |
|
|
46
|
-
| .ts, .tsx | lang-typescript-expert | typescript-best-practices |
|
|
47
|
-
| .java | be-springboot-expert | springboot-best-practices |
|
|
48
|
-
| .jsx, .js (React) | fe-vercel-agent | react-best-practices |
|
|
49
|
-
|
|
50
|
-
## Refactoring Categories
|
|
51
|
-
|
|
52
|
-
| Category | Description |
|
|
53
|
-
|----------|-------------|
|
|
54
|
-
| structure | File/module organization, package structure |
|
|
55
|
-
| naming | Variable, function, type naming conventions |
|
|
56
|
-
| patterns | Design patterns, idiomatic code |
|
|
57
|
-
| duplication | Extract common code, reduce repetition |
|
|
58
|
-
| complexity | Simplify complex functions, reduce nesting |
|
|
59
|
-
|
|
60
|
-
## Output Format
|
|
61
|
-
|
|
62
|
-
### Dry Run
|
|
63
|
-
```
|
|
64
|
-
[dev:refactor src/utils.go --dry-run]
|
|
65
|
-
|
|
66
|
-
┌─ Agent: lang-golang-expert (sw-engineer)
|
|
67
|
-
├─ Skill: go-best-practices
|
|
68
|
-
└─ File: src/utils.go
|
|
69
|
-
|
|
70
|
-
Analysis:
|
|
71
|
-
|
|
72
|
-
[Structure] Lines 10-45
|
|
73
|
-
Issue: Function too long (35 lines)
|
|
74
|
-
Suggest: Extract helper functions
|
|
75
|
-
|
|
76
|
-
[Naming] Line 12
|
|
77
|
-
Issue: Abbreviation in function name
|
|
78
|
-
Found: func procData()
|
|
79
|
-
Suggest: func processData()
|
|
80
|
-
|
|
81
|
-
[Patterns] Lines 20-30
|
|
82
|
-
Issue: Repeated error handling pattern
|
|
83
|
-
Suggest: Create handleError() helper
|
|
84
|
-
|
|
85
|
-
Proposed Changes:
|
|
86
|
-
1. Extract lines 15-25 into validateInput()
|
|
87
|
-
2. Rename procData → processData
|
|
88
|
-
3. Create handleError() helper function
|
|
89
|
-
|
|
90
|
-
No changes made (dry-run mode).
|
|
91
|
-
Run without --dry-run to apply changes.
|
|
92
|
-
```
|
|
93
|
-
|
|
94
|
-
### Apply Changes
|
|
95
|
-
```
|
|
96
|
-
[dev:refactor src/utils.go]
|
|
97
|
-
|
|
98
|
-
┌─ Agent: lang-golang-expert (sw-engineer)
|
|
99
|
-
├─ Skill: go-best-practices
|
|
100
|
-
└─ File: src/utils.go
|
|
101
|
-
|
|
102
|
-
Refactoring:
|
|
103
|
-
|
|
104
|
-
[1/3] Extracting validateInput()...
|
|
105
|
-
✓ Created function at line 50
|
|
106
|
-
✓ Updated calls at lines 15, 22
|
|
107
|
-
|
|
108
|
-
[2/3] Renaming procData → processData...
|
|
109
|
-
✓ Renamed function definition
|
|
110
|
-
✓ Updated 3 call sites
|
|
111
|
-
|
|
112
|
-
[3/3] Creating handleError() helper...
|
|
113
|
-
✓ Created function at line 60
|
|
114
|
-
✓ Replaced 5 error handling blocks
|
|
115
|
-
|
|
116
|
-
Summary:
|
|
117
|
-
Changes applied: 3
|
|
118
|
-
Lines modified: 28
|
|
119
|
-
Functions added: 2
|
|
120
|
-
Functions renamed: 1
|
|
121
|
-
|
|
122
|
-
Recommendation: Run tests to verify changes.
|
|
123
|
-
```
|
|
@@ -1,81 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: dev-review
|
|
3
|
-
description: Review code against language-specific best practices
|
|
4
|
-
argument-hint: "<file-or-directory> [--lang <language>]"
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Code Review Skill
|
|
8
|
-
|
|
9
|
-
Review code for best practices using language-specific expert agents.
|
|
10
|
-
|
|
11
|
-
## Parameters
|
|
12
|
-
|
|
13
|
-
| Name | Type | Required | Description |
|
|
14
|
-
|------|------|----------|-------------|
|
|
15
|
-
| path | string | yes | File or directory to review |
|
|
16
|
-
|
|
17
|
-
## Options
|
|
18
|
-
|
|
19
|
-
```
|
|
20
|
-
--lang, -l Language (auto-detected if not specified)
|
|
21
|
-
Values: go, python, rust, kotlin, typescript, java
|
|
22
|
-
--focus, -f Focus area (style, performance, security, all)
|
|
23
|
-
--verbose, -v Detailed output
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## Workflow
|
|
27
|
-
|
|
28
|
-
```
|
|
29
|
-
1. Detect language (or use --lang)
|
|
30
|
-
2. Select appropriate expert agent
|
|
31
|
-
3. Load language-specific skill
|
|
32
|
-
4. Analyze code against best practices
|
|
33
|
-
5. Generate review report
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
## Agent Selection
|
|
37
|
-
|
|
38
|
-
| File Extension | Agent | Skill |
|
|
39
|
-
|----------------|-------|-------|
|
|
40
|
-
| .go | lang-golang-expert | go-best-practices |
|
|
41
|
-
| .py | lang-python-expert | python-best-practices |
|
|
42
|
-
| .rs | lang-rust-expert | rust-best-practices |
|
|
43
|
-
| .kt | lang-kotlin-expert | kotlin-best-practices |
|
|
44
|
-
| .ts, .tsx | lang-typescript-expert | typescript-best-practices |
|
|
45
|
-
| .java | be-springboot-expert | springboot-best-practices |
|
|
46
|
-
| .jsx, .js (React) | fe-vercel-agent | react-best-practices |
|
|
47
|
-
|
|
48
|
-
## Output Format
|
|
49
|
-
|
|
50
|
-
```
|
|
51
|
-
[dev:review src/main.go]
|
|
52
|
-
|
|
53
|
-
┌─ Agent: lang-golang-expert (sw-engineer)
|
|
54
|
-
├─ Skill: go-best-practices
|
|
55
|
-
└─ File: src/main.go
|
|
56
|
-
|
|
57
|
-
Review Results:
|
|
58
|
-
|
|
59
|
-
[Style] Line 15
|
|
60
|
-
Issue: Variable name should be camelCase
|
|
61
|
-
Found: user_name
|
|
62
|
-
Suggest: userName
|
|
63
|
-
|
|
64
|
-
[Error Handling] Line 42
|
|
65
|
-
Issue: Error not checked
|
|
66
|
-
Found: file.Close()
|
|
67
|
-
Suggest: if err := file.Close(); err != nil { ... }
|
|
68
|
-
|
|
69
|
-
[Performance] Line 78
|
|
70
|
-
Issue: Inefficient string concatenation in loop
|
|
71
|
-
Found: str += item
|
|
72
|
-
Suggest: Use strings.Builder
|
|
73
|
-
|
|
74
|
-
Summary:
|
|
75
|
-
Style: 1 issue
|
|
76
|
-
Error Handling: 1 issue
|
|
77
|
-
Performance: 1 issue
|
|
78
|
-
Total: 3 issues
|
|
79
|
-
|
|
80
|
-
Recommendation: Fix error handling issues first.
|
|
81
|
-
```
|