oh-my-customcode 0.1.0

package/templates/commands/supplier/fix.md

@@ -0,0 +1,121 @@
+# Command: supplier:fix
+
+> Fix broken references
+
+## Usage
+
+```
+supplier:fix
+supplier:fix <agent-name>
+supplier:fix --all
+```
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| target | string | no | Specific agent to fix |
+
+## Options
+
+```
+--all, -a        Fix all agents
+--dry-run        Show what would be fixed
+--verbose, -v    Show detailed actions
+```
+
+## Workflow
+
+```
+1. Run supplier:audit to identify issues
+
+2. Fix issues:
+   ├── Missing symlinks → Create
+   ├── Broken symlinks → Recreate
+   ├── Missing index entries → Add
+   └── Orphan refs → Remove
+
+3. Validate fixes
+   └── Re-run supplier:audit
+```
+
+## Fixable Issues
+
+| Issue | Action |
+|-------|--------|
+| Missing symlink | Create symlink in refs/ |
+| Broken symlink | Delete and recreate |
+| Missing skill ref | Add to index.yaml |
+| Missing guide ref | Add to index.yaml |
+| Orphan symlink | Remove from refs/ |
+| Path mismatch | Update path in index.yaml |
+
+## Output
+
+### Dry Run
+
+```
+[supplier:fix kotlin-expert --dry-run]
+
+Analyzing: kotlin-expert
+
+Issues found:
+  1. Missing symlink: refs/kotlin → ../../../guides/kotlin/
+
+Proposed fixes:
+  1. Create symlink:
+     cd agents/sw-engineer/kotlin-expert/refs/
+     ln -s ../../../../guides/kotlin kotlin
+
+No changes made (dry-run mode).
+Run without --dry-run to apply fixes.
+```
+
+### Fix Mode
+
+```
+[supplier:fix kotlin-expert]
+
+Fixing: kotlin-expert
+
+[1/2] Fixing missing symlink...
+  Creating: refs/kotlin → ../../../../guides/kotlin
+  ✓ Symlink created
+
+[2/2] Validating...
+  Running supplier:audit...
+  ✓ All dependencies valid
+
+Summary:
+  Fixed: 1 issue
+  Status: HEALTHY
+
+Agent kotlin-expert is now healthy.
+```
+
+### Fix All
+
+```
+[supplier:fix --all]
+
+Scanning all agents for issues...
+
+Found issues in 2 agents:
+  - kotlin-expert: 1 issue
+  - new-agent: 2 issues
+
+Fixing kotlin-expert...
+  ✓ Created symlink: refs/kotlin
+
+Fixing new-agent...
+  ✓ Created symlink: refs/skill-a
+  ✓ Updated index.yaml: added skill-b path
+
+Validating all agents...
+  ✓ supplier:audit --all passed
+
+Summary:
+  Agents fixed: 2
+  Issues resolved: 3
+  All agents healthy.
+```

package/templates/commands/sync/agents.yaml

@@ -0,0 +1,4 @@
+name: agents
+agent: sync-checker
+description: Check agent registry sync
+usage: sync:agents

package/templates/commands/sync/check.yaml

@@ -0,0 +1,4 @@
+name: check
+agent: sync-checker
+description: Run full synchronization check
+usage: sync:check

package/templates/commands/sync/commands.yaml

@@ -0,0 +1,4 @@
+name: commands
+agent: sync-checker
+description: Check command registry sync
+usage: sync:commands

package/templates/commands/sync/docs.yaml

@@ -0,0 +1,4 @@
+name: docs
+agent: sync-checker
+description: Check documentation sync
+usage: sync:docs

package/templates/commands/sync/fix.yaml

@@ -0,0 +1,4 @@
+name: fix
+agent: sync-checker
+description: Auto-fix simple inconsistencies
+usage: sync:fix

package/templates/commands/system/help.md

@@ -0,0 +1,137 @@
+# Command: help
+
+> Show help information
+
+## Usage
+
+```
+help
+help <command>
+help --agents
+```
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| topic | string | no | Command or topic to get help for |
+
+## Options
+
+```
+--agents, -a     List all available agents
+--commands, -c   List all commands (same as 'lists')
+--rules, -r      List all rules
+```
+
+## Output
+
+### Default Help
+
+```
+Baekgom Agents - Help
+
+Usage: {command} [arguments] [options]
+
+Quick Start:
+  lists              Show all available commands
+  status             Show system status
+  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
+
+Use "lists" to see all available commands.
+Use "help <command>" for detailed help.
+```
+
+### Command Help
+
+```
+help updater:docs
+
+Command: updater: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>
+
+Options:
+  --check, -c      Check only, don't modify
+  --verbose, -v    Show detailed changes
+  --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
+```
+
+### Agent List
+
+```
+help --agents
+
+Available Agents:
+
+Orchestrator:
+  secretary        Manages manager agents
+
+Manager:
+  creator          Creates new agents
+  updater          Updates external sources and docs
+  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)
+
+Backend Engineer:
+  fastapi-expert      FastAPI (Python async)
+  springboot-expert   Spring Boot (Java)
+  go-backend-expert   Go backend (Uber style)
+
+Infra Engineer:
+  docker-expert       Docker containerization
+  aws-expert          AWS architecture
+
+Total: 15 agents
+```
+
+### Rules List
+
+```
+help --rules
+
+Global Rules:
+
+MUST (Never violate):
+  R000  Language Policy      Korean I/O, English files
+  R001  Safety Rules         Prohibited actions
+  R002  Permission Rules     Tool tiers, file access
+  R006  Agent Design         Structure, separation
+
+SHOULD (Strongly recommended):
+  R003  Interaction Rules    Response format
+  R004  Error Handling       Error levels, recovery
+  R007  Agent Identification Display agent in responses
+  R008  Tool Identification  Display agent when using tools
+
+MAY (Optional):
+  R005  Optimization         Efficiency guidelines
+  R009  Parallel Execution   Max 4 parallel instances
+
+Total: 10 rules
+```

package/templates/commands/system/lists.md

@@ -0,0 +1,86 @@
+# Command: lists
+
+> Show all available commands
+
+## Usage
+
+```
+lists
+lists --category <category>
+lists --verbose
+```
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| category | string | no | Filter by category (system, creator, updater, supplier, dev) |
+
+## Options
+
+```
+--verbose, -v    Show detailed descriptions
+--category, -c   Filter by category
+```
+
+## Output
+
+```
+Baekgom Agents - Available Commands
+
+System:
+  lists              Show all available commands
+  status             Show system status
+  help               Show help information
+
+Manager:
+  creator:agent      Create a new agent
+  updater:docs       Sync documentation with project structure
+  updater:external   Update agents from external sources
+  supplier:audit     Audit agent dependencies
+  supplier:fix       Fix broken references
+
+Dev:
+  dev:review         Review code for best practices
+  dev:refactor       Refactor code
+
+Use "<command> --help" for detailed information.
+```
+
+## Verbose Output
+
+```
+lists --verbose
+
+Baekgom Agents - Available Commands (Detailed)
+
+System Commands:
+┌─────────┬──────────────────────────────────────────────┐
+│ Command │ Description                                  │
+├─────────┼──────────────────────────────────────────────┤
+│ lists   │ Show all available commands                  │
+│ status  │ Show system status and health checks         │
+│ help    │ Show help for commands and agents            │
+└─────────┴──────────────────────────────────────────────┘
+
+Manager Commands:
+┌──────────────────┬──────────────────────────────────────┐
+│ Command          │ Description                          │
+├──────────────────┼──────────────────────────────────────┤
+│ creator:agent    │ Create a new agent with structure    │
+│ updater:docs     │ Sync all docs with project state     │
+│ updater:external │ Update from external sources         │
+│ supplier:audit   │ Check dependencies and refs          │
+│ supplier:fix     │ Auto-fix broken references           │
+└──────────────────┴──────────────────────────────────────┘
+
+Dev Commands:
+┌──────────────┬────────────────────────────────────────┐
+│ Command      │ Description                            │
+├──────────────┼────────────────────────────────────────┤
+│ dev:review   │ Review code against best practices     │
+│ dev:refactor │ Suggest and apply refactoring          │
+└──────────────┴────────────────────────────────────────┘
+
+Total: 10 commands available
+```

package/templates/commands/system/status.md

@@ -0,0 +1,163 @@
+# Command: status
+
+> Show system status
+
+## Usage
+
+```
+status
+status --verbose
+status --health
+```
+
+## Options
+
+```
+--verbose, -v    Detailed status
+--health, -h     Health checks only
+```
+
+## Output
+
+### Default Status
+
+```
+Baekgom Agents - Status
+
+System:
+  Rules: 10 loaded (R000-R009)
+
+Agents:
+  Orchestrator:     1 (secretary)
+  Manager:          3 (creator, updater, supplier)
+  SW Engineer:      6
+  Backend Engineer: 3
+  Infra Engineer:   2
+  Total:           15 agents
+
+Skills:
+  Development:     8
+  Backend:         3
+  Infrastructure:  2
+  Total:          13 skills
+
+Guides:            12 loaded
+Commands:          10 available
+
+Health: ✓ OK
+```
+
+### Verbose Status
+
+```
+status --verbose
+
+Baekgom Agents - Detailed Status
+
+Rules:
+  MUST:
+    ✓ R000 language-policy
+    ✓ R001 safety
+    ✓ R002 permissions
+    ✓ R006 agent-design
+
+  SHOULD:
+    ✓ R003 interaction
+    ✓ R004 error-handling
+    ✓ R007 agent-identification
+    ✓ R008 tool-identification
+
+  MAY:
+    ✓ R005 optimization
+    ✓ R009 parallel-execution
+
+Agents:
+  orchestrator/
+    ✓ secretary (internal)
+
+  manager/
+    ✓ creator (internal)
+    ✓ updater (internal)
+    ✓ supplier (internal)
+
+  sw-engineer/
+    ✓ golang-expert (internal)
+    ✓ python-expert (internal)
+    ✓ rust-expert (internal)
+    ✓ kotlin-expert (internal)
+    ✓ typescript-expert (internal)
+    ✓ vercel-agent (external v1.0.0)
+
+  sw-engineer/backend/
+    ✓ fastapi-expert (internal)
+    ✓ springboot-expert (internal)
+    ✓ go-backend-expert (internal)
+
+  infra-engineer/
+    ✓ docker-expert (internal)
+    ✓ aws-expert (internal)
+
+Skills:
+  development/
+    ✓ go-best-practices
+    ✓ python-best-practices
+    ✓ rust-best-practices
+    ✓ kotlin-best-practices
+    ✓ typescript-best-practices
+    ✓ react-best-practices
+    ✓ web-design-guidelines
+    ✓ vercel-deploy
+
+  backend/
+    ✓ fastapi-best-practices
+    ✓ springboot-best-practices
+    ✓ go-backend-best-practices
+
+  infrastructure/
+    ✓ docker-best-practices
+    ✓ aws-best-practices
+
+Guides:
+  ✓ claude-code, web-design
+  ✓ golang, python, rust, kotlin, typescript
+  ✓ fastapi, springboot, go-backend
+  ✓ docker, aws
+
+Commands:
+  system:    lists, status, help
+  creator:   agent
+  updater:   docs, external
+  supplier:  audit, fix
+  dev:       review, refactor
+
+All systems operational.
+```
+
+### Health Check
+
+```
+status --health
+
+Health Checks:
+
+Agents:
+  ✓ 15/15 agents valid
+  ✓ All paths exist
+  ✓ All index.yaml valid
+
+Dependencies:
+  ✓ All skill references valid
+  ✓ All guide references valid
+  ✓ No broken symlinks
+
+External Sources:
+  ✓ vercel-agent (github: reachable)
+
+Documentation:
+  ✓ CLAUDE.md in sync
+  ✓ agents/index.yaml in sync
+  ✓ skills/index.yaml in sync
+  ✓ guides/index.yaml in sync
+
+Result: HEALTHY
+```

package/templates/commands/updater/docs.md

@@ -0,0 +1,165 @@
+# Command: updater:docs
+
+> Sync documentation with project structure
+
+## Purpose
+
+Ensures all documentation (AGENT.md, SKILL.md, index.yaml, CLAUDE.md) accurately reflects the current project state and that agents work together organically.
+
+## Usage
+
+```
+updater:docs
+updater:docs --check
+updater:docs --target <path>
+```
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| target | string | no | Specific path to update |
+
+## Options
+
+```
+--check, -c      Check only, don't modify
+--verbose, -v    Show detailed changes
+--target, -t     Specific target to update
+```
+
+## Workflow
+
+```
+1. Scan project structure
+   ├── agents/
+   ├── skills/
+   ├── guides/
+   └── commands/
+
+2. Validate consistency
+   ├── Check agent index.yaml matches folder structure
+   ├── Check skill references exist
+   ├── Check guide references exist
+   └── Check command definitions match files
+
+3. Update documentation
+   ├── Sync agents/index.yaml
+   ├── Sync skills/index.yaml
+   ├── Sync guides/index.yaml
+   ├── Update CLAUDE.md summary
+   └── Update inter-agent references
+
+4. Ensure organic integration
+   ├── Verify agent → skill mappings
+   ├── Verify agent → guide mappings
+   ├── Verify command → agent mappings
+   └── Check for orphaned resources
+```
+
+## Output
+
+### Check Mode
+
+```
+[updater:docs --check]
+
+Scanning project structure...
+
+agents/index.yaml:
+  ✓ 15 agents declared
+  ✓ All paths valid
+  ✗ Missing: agents/sw-engineer/java-expert (declared but not found)
+
+skills/index.yaml:
+  ✓ 13 skills declared
+  ✓ All paths valid
+
+guides/index.yaml:
+  ✓ 12 guides declared
+  ✗ Orphan: guides/old-guide/ (exists but not declared)
+
+CLAUDE.md:
+  ✗ Agent count outdated (shows 14, actual 15)
+
+Issues Found: 3
+Run "updater:docs" to fix.
+```
+
+### Update Mode
+
+```
+[updater:docs]
+
+Syncing documentation with project structure...
+
+[1/4] Updating agents/index.yaml
+  - Removed: java-expert (not found)
+  ✓ 15 → 14 agents
+
+[2/4] Updating skills/index.yaml
+  ✓ No changes needed
+
+[3/4] Updating guides/index.yaml
+  - Added: old-guide (found in filesystem)
+  ✓ 12 → 13 guides
+
+[4/4] Updating CLAUDE.md
+  - Updated agent count: 14 → 15
+  - Updated summary table
+  ✓ Synced
+
+Summary:
+  Modified: 3 files
+  Added: 1 entry
+  Removed: 1 entry
+
+All documentation synced successfully.
+```
+
+## What Gets Updated
+
+### agents/index.yaml
+- Agent list matches actual folders
+- Paths are correct
+- Metadata is consistent
+
+### skills/index.yaml
+- Skill categories reflect actual structure
+- All skills in folders are listed
+- References are valid
+
+### guides/index.yaml
+- All guide folders are listed
+- Sources are documented
+- Cross-references work
+
+### CLAUDE.md
+- Project structure diagram
+- Agent/skill/guide counts
+- Command list
+- Summary tables
+
+### Individual Agent/Skill Files
+- Skill references in agent index.yaml
+- Guide references in agent index.yaml
+- Cross-agent references
+
+## Organic Integration Checks
+
+```yaml
+agent_skill_mapping:
+  - Each agent declares valid skills
+  - Skills are in correct category
+  - No duplicate skill declarations
+
+agent_guide_mapping:
+  - Each agent declares valid guides
+  - Guides exist in guides/
+  - Paths are relative and correct
+
+command_agent_mapping:
+  - Commands reference valid agents
+  - Agent capabilities match commands
+  - Workflow is documented
+```