oh-my-customcode 0.1.0

package/templates/commands/COMMANDS.md

@@ -0,0 +1,136 @@
+# Commands System
+
+> Command structure for Baekgom Agents
+
+## Command Format
+
+```
+{agent}:{action} [arguments]
+```
+
+### Examples
+
+```
+lists                          # Show all commands
+updater:docs                   # Sync documentation
+updater:external               # Update external agents
+supplier:audit golang-expert   # Audit specific agent
+creator:agent my-agent         # Create new agent
+dev:review src/main.go         # Review code
+memory:save                    # Save session context
+memory:recall auth             # Search memories for "auth"
+pipeline:run code-review       # Execute code-review pipeline
+pipeline:list                  # List available pipelines
+intent:explain                 # Explain intent detection
+naggy:add "Fix login bug"      # Add TODO item
+naggy:done 3                   # Mark task #3 complete
+git:commit                     # Create commit
+git:branch feature/auth        # Create feature branch
+```
+
+## Available Commands
+
+### System Commands
+
+| Command | Description |
+|---------|-------------|
+| `lists` | Show all available commands |
+| `status` | Show system status |
+| `help` | Show help information |
+
+### Manager Commands
+
+| Command | Description |
+|---------|-------------|
+| `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 Commands
+
+| Command | Description |
+|---------|-------------|
+| `dev:review` | Review code for best practices |
+| `dev:refactor` | Refactor code |
+
+### Memory Commands
+
+| Command | Description |
+|---------|-------------|
+| `memory:save` | Save session context to claude-mem |
+| `memory:recall` | Search and recall memories |
+
+### Pipeline Commands
+
+| Command | Description |
+|---------|-------------|
+| `pipeline:run <name>` | Execute a defined pipeline |
+| `pipeline:list` | List available pipelines |
+
+### Intent Commands
+
+| Command | Description |
+|---------|-------------|
+| `intent:explain` | Explain intent detection system |
+
+### Naggy Commands (TODO Management)
+
+| Command | Description |
+|---------|-------------|
+| `naggy:list` | List all pending TODOs |
+| `naggy:add <task>` | Add new TODO item |
+| `naggy:done <id>` | Mark task as complete |
+| `naggy:priority <id> <level>` | Set task priority (high/medium/low) |
+| `naggy:remind` | Show overdue tasks |
+
+### Git Commands (Git Operations)
+
+| Command | Description |
+|---------|-------------|
+| `git:commit` | Create a proper commit with conventional message |
+| `git:branch <name>` | Create feature branch |
+| `git:pr` | Create pull request |
+| `git:sync` | Sync with remote repository |
+| `git:status` | Show detailed git status |
+
+### Sync Commands (Documentation Synchronization)
+
+| Command | Description |
+|---------|-------------|
+| `sync:check` | Run full synchronization check |
+| `sync:agents` | Check agent registry sync |
+| `sync:commands` | Check command registry sync |
+| `sync:docs` | Check documentation sync |
+| `sync:fix` | Auto-fix simple inconsistencies |
+
+## Command Workflow
+
+```
+User Input: "updater:docs"
+    │
+    ▼
+Secretary (orchestrator)
+    │
+    ├── Parse command → updater:docs
+    │
+    ├── Route to → updater (manager)
+    │
+    └── Execute → docs action
+```
+
+## Adding New Commands
+
+1. Create command file in `commands/{agent}/{action}.md`
+2. Add entry to `commands/index.yaml`
+3. Document parameters and workflow
+
+## Command vs Agent
+
+| Aspect | Command | Agent |
+|--------|---------|-------|
+| Purpose | User-invoked action | Worker/Manager |
+| Format | `{agent}:{action}` | `{type}/{name}` |
+| Scope | Single operation | Multiple capabilities |
+| Example | `updater:docs` | `updater` agent |

package/templates/commands/creator/agent.md

@@ -0,0 +1,121 @@
+# Command: creator:agent
+
+> Create a new agent
+
+## Usage
+
+```
+creator:agent <name> --type <type>
+creator:agent <name> --type <type> --source <url>
+```
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| name | string | yes | Agent name (kebab-case) |
+
+## Options
+
+```
+--type, -t       Agent type (required)
+                 Values: sw-engineer, sw-engineer/backend, infra-engineer, manager
+--source, -s     External source URL (for external agents)
+--desc, -d       Description
+--skills         Comma-separated skills to include
+```
+
+## Workflow
+
+```
+1. Validate input
+   ├── Name is unique
+   ├── Name is kebab-case
+   └── Type is valid
+
+2. Create structure
+   ├── agents/{type}/{name}/
+   ├── AGENT.md
+   ├── index.yaml
+   └── refs/
+
+3. Register agent
+   └── Update agents/index.yaml
+
+4. Validate
+   └── Run supplier:audit
+```
+
+## Output
+
+```
+[creator:agent golang-expert --type sw-engineer]
+
+Creating agent: golang-expert
+
+[1/4] Validating...
+  ✓ Name available
+  ✓ Type valid: sw-engineer
+
+[2/4] Creating structure...
+  ✓ agents/sw-engineer/golang-expert/
+  ✓ agents/sw-engineer/golang-expert/AGENT.md
+  ✓ agents/sw-engineer/golang-expert/index.yaml
+  ✓ agents/sw-engineer/golang-expert/refs/
+
+[3/4] Registering...
+  ✓ Updated agents/index.yaml
+
+[4/4] Validating...
+  ✓ supplier:audit passed
+
+Agent created successfully: agents/sw-engineer/golang-expert/
+```
+
+## Templates
+
+Generated AGENT.md:
+
+```markdown
+# {Name} Agent
+
+> **Type**: {Type}
+> **Source**: Internal
+
+## Purpose
+
+{Description}
+
+## Capabilities
+
+1.
+2.
+
+## Skills
+
+| Skill | Purpose |
+|-------|---------|
+
+## Guides
+
+| Guide | Purpose |
+|-------|---------|
+```
+
+Generated index.yaml:
+
+```yaml
+metadata:
+  name: {name}
+  type: {type}
+  description: {description}
+
+source:
+  type: internal
+
+capabilities: []
+
+skills: []
+
+guides: []
+```

package/templates/commands/dev/refactor.md

@@ -0,0 +1,126 @@
+# Command: dev:refactor
+
+> Refactor code for better structure
+
+## Usage
+
+```
+dev:refactor <file-or-directory>
+dev:refactor <path> --lang <language>
+```
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| path | string | yes | File or directory to refactor |
+
+## Options
+
+```
+--lang, -l       Language (auto-detected if not specified)
+                 Values: go, python, rust, kotlin, typescript, java
+--focus, -f      Focus area (structure, naming, patterns, all)
+--dry-run        Show proposed changes without applying
+--verbose, -v    Detailed output
+```
+
+## Workflow
+
+```
+1. Detect language (or use --lang)
+2. Select appropriate expert agent
+3. Load language-specific skill
+4. Analyze code structure
+5. Propose refactoring changes
+6. Apply changes (if not --dry-run)
+```
+
+## Agent Selection
+
+| 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 |
+
+## Refactoring Categories
+
+| Category | Description |
+|----------|-------------|
+| structure | File/module organization, package structure |
+| naming | Variable, function, type naming conventions |
+| patterns | Design patterns, idiomatic code |
+| duplication | Extract common code, reduce repetition |
+| complexity | Simplify complex functions, reduce nesting |
+
+## Output
+
+### Dry Run
+
+```
+[dev:refactor src/utils.go --dry-run]
+
+┌─ Agent: golang-expert (sw-engineer)
+├─ Skill: go-best-practices
+└─ File: src/utils.go
+
+Analysis:
+
+[Structure] Lines 10-45
+  Issue: Function too long (35 lines)
+  Suggest: Extract helper functions
+
+[Naming] Line 12
+  Issue: Abbreviation in function name
+  Found: func procData()
+  Suggest: func processData()
+
+[Patterns] Lines 20-30
+  Issue: Repeated error handling pattern
+  Suggest: Create handleError() helper
+
+Proposed Changes:
+  1. Extract lines 15-25 into validateInput()
+  2. Rename procData → processData
+  3. Create handleError() helper function
+
+No changes made (dry-run mode).
+Run without --dry-run to apply changes.
+```
+
+### Apply Changes
+
+```
+[dev:refactor src/utils.go]
+
+┌─ Agent: golang-expert (sw-engineer)
+├─ Skill: go-best-practices
+└─ File: src/utils.go
+
+Refactoring:
+
+[1/3] Extracting validateInput()...
+  ✓ Created function at line 50
+  ✓ Updated calls at lines 15, 22
+
+[2/3] Renaming procData → processData...
+  ✓ Renamed function definition
+  ✓ Updated 3 call sites
+
+[3/3] Creating handleError() helper...
+  ✓ Created function at line 60
+  ✓ Replaced 5 error handling blocks
+
+Summary:
+  Changes applied: 3
+  Lines modified: 28
+  Functions added: 2
+  Functions renamed: 1
+
+Recommendation: Run tests to verify changes.
+```

package/templates/commands/dev/review.md

@@ -0,0 +1,82 @@
+# Command: dev:review
+
+> Review code for best practices
+
+## Usage
+
+```
+dev:review <file-or-directory>
+dev:review <path> --lang <language>
+```
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| path | string | yes | File or directory to review |
+
+## Options
+
+```
+--lang, -l       Language (auto-detected if not specified)
+                 Values: go, python, rust, kotlin, typescript, java
+--focus, -f      Focus area (style, performance, security, all)
+--verbose, -v    Detailed output
+```
+
+## Workflow
+
+```
+1. Detect language (or use --lang)
+2. Select appropriate expert agent
+3. Load language-specific skill
+4. Analyze code against best practices
+5. Generate review report
+```
+
+## Agent Selection
+
+| 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 |
+
+## Output
+
+```
+[dev:review src/main.go]
+
+┌─ Agent: golang-expert (sw-engineer)
+├─ Skill: go-best-practices
+└─ File: src/main.go
+
+Review Results:
+
+[Style] Line 15
+  Issue: Variable name should be camelCase
+  Found: user_name
+  Suggest: userName
+
+[Error Handling] Line 42
+  Issue: Error not checked
+  Found: file.Close()
+  Suggest: if err := file.Close(); err != nil { ... }
+
+[Performance] Line 78
+  Issue: Inefficient string concatenation in loop
+  Found: str += item
+  Suggest: Use strings.Builder
+
+Summary:
+  Style: 1 issue
+  Error Handling: 1 issue
+  Performance: 1 issue
+  Total: 3 issues
+
+Recommendation: Fix error handling issues first.
+```

package/templates/commands/git/branch.yaml

@@ -0,0 +1,8 @@
+name: branch
+agent: gitnerd
+description: Create a feature branch following naming conventions
+usage: git:branch <name>
+arguments:
+  - name: name
+    required: true
+    description: Branch name (will be prefixed with feature/ if needed)

package/templates/commands/git/commit.yaml

@@ -0,0 +1,4 @@
+name: commit
+agent: gitnerd
+description: Create a proper commit with conventional message format
+usage: git:commit

package/templates/commands/git/pr.yaml

@@ -0,0 +1,4 @@
+name: pr
+agent: gitnerd
+description: Create a pull request with proper description
+usage: git:pr

package/templates/commands/git/status.yaml

@@ -0,0 +1,4 @@
+name: status
+agent: gitnerd
+description: Show detailed git status including branch info and changes
+usage: git:status

package/templates/commands/git/sync.yaml

@@ -0,0 +1,4 @@
+name: sync
+agent: gitnerd
+description: Sync local branch with remote (fetch and rebase)
+usage: git:sync