oh-my-customcode 0.1.4 → 0.2.1

package/templates/.claude/skills/dev-lead-routing/SKILL.md

@@ -0,0 +1,238 @@
+---
+name: dev-lead-routing
+description: Routes development tasks to the correct language or framework expert agent. Use when user requests code review, implementation, refactoring, or debugging.
+user-invocable: false
+---
+
+# Dev Lead Routing Skill
+
+## Purpose
+
+Routes development tasks to appropriate language and framework expert agents. This skill contains the coordination logic for orchestrating sw-engineer agents across language, frontend, backend, and tooling specializations.
+
+## Engineers Under Management
+
+| Type | Agents | Purpose |
+|------|--------|---------|
+| sw-engineer/language | lang-golang-expert, lang-python-expert, lang-rust-expert, lang-kotlin-expert, lang-typescript-expert, lang-java21-expert | Language expertise |
+| sw-engineer/frontend | fe-vercel-agent, fe-vuejs-agent, fe-svelte-agent | Frontend frameworks |
+| sw-engineer/backend | be-fastapi-expert, be-springboot-expert, be-go-backend-expert, be-nestjs-expert, be-express-expert | Backend frameworks |
+| sw-engineer/tooling | tool-npm-expert, tool-optimizer, tool-bun-expert | Build tools and optimization |
+
+## Language/Framework Detection
+
+### File Extension Mapping
+
+| Extension | Agent | Language/Framework |
+|-----------|-------|-------------------|
+| `.go` | lang-golang-expert | Go |
+| `.py` | lang-python-expert | Python |
+| `.rs` | lang-rust-expert | Rust |
+| `.kt`, `.kts` | lang-kotlin-expert | Kotlin |
+| `.ts`, `.tsx` | lang-typescript-expert | TypeScript |
+| `.java` | lang-java21-expert | Java |
+| `.js`, `.jsx` (React) | fe-vercel-agent | React/Next.js |
+| `.vue` | fe-vuejs-agent | Vue.js |
+| `.svelte` | fe-svelte-agent | Svelte |
+
+### Keyword Mapping
+
+| Keyword | Agent |
+|---------|-------|
+| "go", "golang" | lang-golang-expert |
+| "python", "py" | lang-python-expert |
+| "rust" | lang-rust-expert |
+| "kotlin" | lang-kotlin-expert |
+| "typescript", "ts" | lang-typescript-expert |
+| "java" | lang-java21-expert |
+| "react", "next.js", "vercel" | fe-vercel-agent |
+| "vue" | fe-vuejs-agent |
+| "svelte" | fe-svelte-agent |
+| "fastapi" | be-fastapi-expert |
+| "spring", "springboot" | be-springboot-expert |
+| "nestjs" | be-nestjs-expert |
+| "express" | be-express-expert |
+| "npm" | tool-npm-expert |
+| "optimize", "bundle" | tool-optimizer |
+| "bun" | tool-bun-expert |
+
+## Command Routing
+
+```
+Development Request → Detection → Expert Agent
+
+Go code     → lang-golang-expert
+Python code → lang-python-expert
+TypeScript  → lang-typescript-expert
+FastAPI     → be-fastapi-expert
+Multi-lang  → Multiple experts (parallel)
+```
+
+## Routing Rules
+
+### 1. Code Review Workflow
+
+```
+1. Receive review request
+2. Identify file types and languages:
+   - Use Glob to find files
+   - Parse file extensions
+   - Detect framework (package.json, go.mod, etc.)
+3. Select appropriate experts
+4. Distribute files to experts (parallel if 2+ languages)
+5. Aggregate review findings
+6. Present unified report
+```
+
+Example:
+```
+User: "Review src/*.go src/*.py src/*.ts"
+
+Detection:
+  - src/*.go → lang-golang-expert
+  - src/*.py → lang-python-expert
+  - src/*.ts → lang-typescript-expert
+
+Route (parallel):
+  Task(lang-golang-expert role → review src/*.go, model: "sonnet")
+  Task(lang-python-expert role → review src/*.py, model: "sonnet")
+  Task(lang-typescript-expert role → review src/*.ts, model: "sonnet")
+
+Aggregate:
+  Go: 2 issues found
+  Python: Clean
+  TypeScript: 5 suggestions
+```
+
+### 2. Feature Implementation Workflow
+
+```
+1. Analyze feature requirements
+2. Identify affected components:
+   - Backend API → backend expert
+   - Frontend UI → frontend expert
+   - Multiple layers → multiple experts
+3. Select required experts
+4. Coordinate implementation (sequential if dependent, parallel if independent)
+5. Ensure consistency across languages
+6. Report completion status
+```
+
+### 3. Multi-Language Projects
+
+For projects with multiple languages:
+
+```
+1. Detect all languages in project
+2. Identify primary language (most files)
+3. Route to appropriate experts:
+   - If task spans multiple languages → parallel experts
+   - If task is language-specific → single expert
+4. Coordinate cross-language consistency
+```
+
+## Sub-agent Model Selection
+
+### Model Mapping by Task Type
+
+| Task Type | Recommended Model | Reason |
+|-----------|-------------------|--------|
+| Architecture analysis | `opus` | Deep reasoning required |
+| Code review | `sonnet` | Balanced quality judgment |
+| Code implementation | `sonnet` | Standard code generation |
+| Refactoring | `sonnet` | Balanced transformation |
+| Quick validation | `haiku` | Fast response |
+| File search | `haiku` | Simple operation |
+
+### Model Mapping by Agent
+
+| Agent Type | Default Model | Alternative |
+|------------|---------------|-------------|
+| Language experts | `sonnet` | `opus` for architecture |
+| Frontend experts | `sonnet` | `haiku` for quick checks |
+| Backend experts | `sonnet` | `opus` for API design |
+| Tooling experts | `haiku` | `sonnet` for complex configs |
+
+### Task Call Examples
+
+```
+# Complex architecture analysis
+Task(
+  subagent_type: "general-purpose",
+  prompt: "Analyze module dependencies and suggest improvements for src/",
+  model: "opus"
+)
+
+# Standard code review
+Task(
+  subagent_type: "general-purpose",
+  prompt: "Review Go code in src/handlers/ following lang-golang-expert guidelines",
+  model: "sonnet"
+)
+
+# Quick file search
+Task(
+  subagent_type: "Explore",
+  prompt: "Find all files importing auth package",
+  model: "haiku"
+)
+```
+
+## Parallel Execution
+
+Following R009:
+- Maximum 4 parallel instances
+- Only worker agents (sw-engineer/*)
+- Independent file/module reviews
+- Coordinate cross-expert consistency
+
+Example:
+```
+User: "Review all backend APIs"
+
+Detection:
+  - src/api/go/ → lang-golang-expert
+  - src/api/python/ → lang-python-expert
+  - src/api/kotlin/ → lang-kotlin-expert
+
+Route (parallel):
+  Task(lang-golang-expert role → review src/api/go/, model: "sonnet")
+  Task(lang-python-expert role → review src/api/python/, model: "sonnet")
+  Task(lang-kotlin-expert role → review src/api/kotlin/, model: "sonnet")
+```
+
+## Display Format
+
+```
+[Analyzing] Detected: Go, Python, TypeScript
+
+[Delegating] lang-golang-expert:sonnet → 5 Go files
+[Delegating] lang-python-expert:sonnet → 3 Python files
+[Delegating] lang-typescript-expert:sonnet → 8 TypeScript files
+
+[Progress] ███████████░ 2/3 experts completed
+
+[Summary]
+  Go: 2 issues found
+  Python: Clean
+  TypeScript: 5 suggestions
+
+Review completed.
+```
+
+## Integration with Other Agents
+
+- Receives requirements from arch-speckit-agent (sw-architect)
+- Reports to qa-lead for quality assurance
+- Coordinates with tooling experts (tool-npm-expert, tool-optimizer) for build/deploy
+
+## Usage
+
+This skill is NOT user-invocable. It should be automatically triggered when the main conversation detects development intent.
+
+Detection criteria:
+- User requests code review
+- User mentions language/framework name
+- User provides file paths for review
+- User requests refactoring/implementation
+- User uses dev:* commands

package/templates/{commands/dev/refactor.md → .claude/skills/dev-refactor/SKILL.md}

@@ -1,13 +1,12 @@
-# Command: dev:refactor
+---
+name: dev-refactor
+description: Refactor code for better structure and patterns
+argument-hint: "<file-or-directory> [--lang <language>]"
+---
 
-> Refactor code for better structure
+# Code Refactoring Skill
 
-## Usage
-
-```
-dev:refactor <file-or-directory>
-dev:refactor <path> --lang <language>
-```
+Refactor code for better structure, naming, and patterns using language-specific expert agents.
 
 ## Parameters
 
@@ -40,13 +39,13 @@ dev:refactor <path> --lang <language>
 
 | File Extension | Agent | Skill |
 |----------------|-------|-------|
-| .go | golang-expert | go-best-practices |
-| .py | python-expert | python-best-practices |
-| .rs | rust-expert | rust-best-practices |
-| .kt | kotlin-expert | kotlin-best-practices |
-| .ts, .tsx | typescript-expert | typescript-best-practices |
-| .java | springboot-expert | springboot-best-practices |
-| .jsx, .js (React) | vercel-agent | react-best-practices |
+| .go | lang-golang-expert | go-best-practices |
+| .py | lang-python-expert | python-best-practices |
+| .rs | lang-rust-expert | rust-best-practices |
+| .kt | lang-kotlin-expert | kotlin-best-practices |
+| .ts, .tsx | lang-typescript-expert | typescript-best-practices |
+| .java | be-springboot-expert | springboot-best-practices |
+| .jsx, .js (React) | fe-vercel-agent | react-best-practices |
 
 ## Refactoring Categories
 
@@ -58,14 +57,13 @@ dev:refactor <path> --lang <language>
 | duplication | Extract common code, reduce repetition |
 | complexity | Simplify complex functions, reduce nesting |
 
-## Output
+## Output Format
 
 ### Dry Run
-
 ```
 [dev:refactor src/utils.go --dry-run]
 
-┌─ Agent: golang-expert (sw-engineer)
+┌─ Agent: lang-golang-expert (sw-engineer)
 ├─ Skill: go-best-practices
 └─ File: src/utils.go
 
@@ -94,11 +92,10 @@ Run without --dry-run to apply changes.
 ```
 
 ### Apply Changes
-
 ```
 [dev:refactor src/utils.go]
 
-┌─ Agent: golang-expert (sw-engineer)
+┌─ Agent: lang-golang-expert (sw-engineer)
 ├─ Skill: go-best-practices
 └─ File: src/utils.go
 

package/templates/{commands/dev/review.md → .claude/skills/dev-review/SKILL.md}

@@ -1,13 +1,12 @@
-# Command: dev:review
+---
+name: dev-review
+description: Review code against language-specific best practices
+argument-hint: "<file-or-directory> [--lang <language>]"
+---
 
-> Review code for best practices
+# Code Review Skill
 
-## Usage
-
-```
-dev:review <file-or-directory>
-dev:review <path> --lang <language>
-```
+Review code for best practices using language-specific expert agents.
 
 ## Parameters
 
@@ -38,20 +37,20 @@ dev:review <path> --lang <language>
 
 | File Extension | Agent | Skill |
 |----------------|-------|-------|
-| .go | golang-expert | go-best-practices |
-| .py | python-expert | python-best-practices |
-| .rs | rust-expert | rust-best-practices |
-| .kt | kotlin-expert | kotlin-best-practices |
-| .ts, .tsx | typescript-expert | typescript-best-practices |
-| .java | springboot-expert | springboot-best-practices |
-| .jsx, .js (React) | vercel-agent | react-best-practices |
+| .go | lang-golang-expert | go-best-practices |
+| .py | lang-python-expert | python-best-practices |
+| .rs | lang-rust-expert | rust-best-practices |
+| .kt | lang-kotlin-expert | kotlin-best-practices |
+| .ts, .tsx | lang-typescript-expert | typescript-best-practices |
+| .java | be-springboot-expert | springboot-best-practices |
+| .jsx, .js (React) | fe-vercel-agent | react-best-practices |
 
-## Output
+## Output Format
 
 ```
 [dev:review src/main.go]
 
-┌─ Agent: golang-expert (sw-engineer)
+┌─ Agent: lang-golang-expert (sw-engineer)
 ├─ Skill: go-best-practices
 └─ File: src/main.go
 

package/templates/{agents/manager/supplier/refs/skills/infrastructure → .claude/skills}/docker-best-practices/SKILL.md

@@ -1,7 +1,7 @@
-# Docker Best Practices Skill
-
-> **Category**: Infrastructure
-> **Source**: Internal (based on Docker Official Documentation)
+---
+name: docker-best-practices
+description: Docker patterns for optimized containerization
+---
 
 ## Purpose
 

package/templates/{agents/manager/supplier/refs/skills/backend → .claude/skills}/fastapi-best-practices/SKILL.md

@@ -1,7 +1,7 @@
-# FastAPI Best Practices Skill
-
-> **Category**: Backend
-> **Source**: Internal (based on FastAPI docs and community patterns)
+---
+name: fastapi-best-practices
+description: FastAPI patterns for high-performance async APIs
+---
 
 ## Purpose
 

package/templates/.claude/skills/fix-refs/SKILL.md

@@ -0,0 +1,107 @@
+---
+name: fix-refs
+description: Fix broken agent references and symlinks
+argument-hint: "[agent-name] [--all] [--dry-run]"
+disable-model-invocation: true
+---
+
+# Fix References Skill
+
+Fix broken references, missing symlinks, and other agent dependency issues.
+
+## Options
+
+```
+--all, -a        Fix all agents
+--dry-run        Show what would be fixed
+--verbose, -v    Show detailed actions
+```
+
+## Workflow
+
+```
+1. Run mgr-supplier:audit to identify issues
+
+2. Fix issues:
+   ├── Missing skill references → Add
+   ├── Missing guide references → Add
+   ├── Broken paths → Update
+   └── Invalid references → Remove
+
+3. Validate fixes
+   └── Re-run mgr-supplier:audit
+```
+
+## Fixable Issues
+
+| Issue | Action |
+|-------|--------|
+| Missing skill ref | Add to agent .md file |
+| Missing guide ref | Add to agent .md file |
+| Broken path | Update path in agent .md file |
+| Invalid reference | Remove from agent .md file |
+
+## Output Format
+
+### Dry Run
+```
+[mgr-supplier:fix lang-kotlin-expert --dry-run]
+
+Analyzing: lang-kotlin-expert
+
+Issues found:
+  1. Missing guide reference: kotlin
+
+Proposed fixes:
+  1. Add guide reference to .claude/agents/lang-kotlin-expert.md
+
+No changes made (dry-run mode).
+Run without --dry-run to apply fixes.
+```
+
+### Fix Mode
+```
+[mgr-supplier:fix lang-kotlin-expert]
+
+Fixing: lang-kotlin-expert
+
+[1/2] Adding missing reference...
+  Updating: .claude/agents/lang-kotlin-expert.md
+  ✓ Guide reference added
+
+[2/2] Validating...
+  Running mgr-supplier:audit...
+  ✓ All dependencies valid
+
+Summary:
+  Fixed: 1 issue
+  Status: HEALTHY
+
+Agent lang-kotlin-expert is now healthy.
+```
+
+### Fix All
+```
+[mgr-supplier:fix --all]
+
+Scanning all agents for issues...
+
+Found issues in 2 agents:
+  - lang-kotlin-expert: 1 issue
+  - new-agent: 2 issues
+
+Fixing lang-kotlin-expert...
+  ✓ Added guide reference: kotlin
+
+Fixing new-agent...
+  ✓ Added skill reference: skill-a
+  ✓ Added skill reference: skill-b
+
+Validating all agents...
+  ✓ mgr-supplier:audit --all passed
+
+Summary:
+  Agents fixed: 2
+  Issues resolved: 3
+  All agents healthy.
+```

package/templates/{agents/manager/supplier/refs/skills/backend → .claude/skills}/go-backend-best-practices/SKILL.md

@@ -1,7 +1,7 @@
-# Go Backend Best Practices Skill
-
-> **Category**: Backend
-> **Source**: Internal (based on Uber Go Style Guide and Standard Layout)
+---
+name: go-backend-best-practices
+description: Go backend patterns from Uber style and standard layout
+---
 
 ## Purpose
 

package/templates/{skills/development → .claude/skills}/go-best-practices/SKILL.md

@@ -1,7 +1,7 @@
-# Go Best Practices Skill
-
-> **Category**: Development
-> **Source**: Internal (based on Effective Go)
+---
+name: go-best-practices
+description: Idiomatic Go patterns from Effective Go
+---
 
 ## Purpose
 

package/templates/{commands/system/help.md → .claude/skills/help/SKILL.md}

@@ -1,20 +1,12 @@
-# Command: help
+---
+name: help
+description: Show help information for commands and system
+argument-hint: "[command] [--agents] [--rules]"
+---
 
-> Show help information
+# Help Skill
 
-## Usage
-
-```
-help
-help <command>
-help --agents
-```
-
-## Parameters
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| topic | string | no | Command or topic to get help for |
+Show help information for commands, agents, and system rules.
 
 ## Options
 
@@ -24,10 +16,9 @@ help --agents
 --rules, -r      List all rules
 ```
 
-## Output
+## Output Format
 
 ### Default Help
-
 ```
 Baekgom Agents - Help
 
@@ -39,30 +30,29 @@ Quick Start:
   help <command>     Get help for a specific command
 
 Common Commands:
-  updater:docs       Sync documentation with project
-  updater:external   Update external agents
-  supplier:audit     Check agent dependencies
-  creator:agent      Create a new agent
+  /update-docs       Sync documentation with project
+  /update-external   Update external agents
+  /audit-agents      Check agent dependencies
+  /create-agent      Create a new agent
 
 Use "lists" to see all available commands.
 Use "help <command>" for detailed help.
 ```
 
 ### Command Help
-
 ```
-help updater:docs
+help /update-docs
 
-Command: updater:docs
+Command: /update-docs
 
 Description:
   Sync documentation with project structure. Ensures all
   documentation accurately reflects the current project state.
 
 Usage:
-  updater:docs
-  updater:docs --check
-  updater:docs --target <path>
+  /update-docs
+  /update-docs --check
+  /update-docs --target <path>
 
 Options:
   --check, -c      Check only, don't modify
@@ -70,13 +60,12 @@ Options:
   --target, -t     Specific target to update
 
 Examples:
-  updater:docs                 # Update all documentation
-  updater:docs --check         # Check for issues
-  updater:docs --target agents # Update agents only
+  /update-docs                 # Update all documentation
+  /update-docs --check         # Check for issues
+  /update-docs --target agents # Update agents only
 ```
 
 ### Agent List
-
 ```
 help --agents
 
@@ -86,32 +75,31 @@ Orchestrator:
   secretary        Manages manager agents
 
 Manager:
-  creator          Creates new agents
-  updater          Updates external sources and docs
-  supplier         Validates dependencies
+  mgr-creator          Creates new agents
+  mgr-updater          Updates external sources and docs
+  mgr-supplier         Validates dependencies
 
 SW Engineer:
-  golang-expert       Go development (Effective Go)
-  python-expert       Python development (PEP 8)
-  rust-expert         Rust development (API Guidelines)
-  kotlin-expert       Kotlin development (JetBrains)
-  typescript-expert   TypeScript development (Google)
-  vercel-agent  React/Next.js (Vercel)
+  lang-golang-expert       Go development (Effective Go)
+  lang-python-expert       Python development (PEP 8)
+  lang-rust-expert         Rust development (API Guidelines)
+  lang-kotlin-expert       Kotlin development (JetBrains)
+  lang-typescript-expert   TypeScript development (Google)
+  fe-vercel-agent  React/Next.js (Vercel)
 
 Backend Engineer:
-  fastapi-expert      FastAPI (Python async)
-  springboot-expert   Spring Boot (Java)
-  go-backend-expert   Go backend (Uber style)
+  be-fastapi-expert      FastAPI (Python async)
+  be-springboot-expert   Spring Boot (Java)
+  be-go-backend-expert   Go backend (Uber style)
 
 Infra Engineer:
-  docker-expert       Docker containerization
-  aws-expert          AWS architecture
+  infra-docker-expert       Docker containerization
+  infra-aws-expert          AWS architecture
 
 Total: 15 agents
 ```
 
 ### Rules List
-
 ```
 help --rules