oh-my-customcode 0.5.0 → 0.6.0

package/README.md

@@ -138,7 +138,7 @@ Comprehensive reference documentation covering:
 - Best practices and patterns
 - Sub-agent orchestration
 
-### Rules (17)
+### Rules (18)
 
 | Priority | Count | Purpose |
 |----------|-------|---------|
@@ -170,7 +170,7 @@ After `omcustom init`:
 your-project/
 ├── CLAUDE.md              # Entry point for Claude
 └── .claude/
-    ├── rules/             # Behavior rules (17 total)
+    ├── rules/             # Behavior rules (18 total)
     ├── hooks/             # Event hooks
     ├── contexts/          # Context files
     ├── agents/            # All agents (flat structure, 34 total)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-customcode",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Batteries-included agent harness for Claude Code",
   "type": "module",
   "bin": {

package/templates/.claude/rules/MUST-orchestrator-coordination.md

@@ -426,36 +426,33 @@ CORRECT:
 ╚══════════════════════════════════════════════════════════════════╝
 ```
 
-## Experimental: Agent Teams (Research Preview)
+## Agent Teams Integration
 
 ```
 ╔══════════════════════════════════════════════════════════════════╗
-║  AGENT TEAMS (EXPERIMENTAL - NOT FOR PRODUCTION USE)             ║
+║  AGENT TEAMS (ACTIVE WHEN ENABLED)                               ║
 ║                                                                   ║
-║  Claude Code provides native Agent Teams feature:                ║
-║    CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1                        ║
+║  When CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 is set:             ║
+║    → Actively use Agent Teams for qualifying tasks               ║
+║    → See R018 (SHOULD-agent-teams.md) for decision matrix        ║
 ║                                                                   ║
 ║  Agent Teams enable:                                              ║
 ║  - Peer-to-peer messaging between agents                        ║
 ║  - Shared task lists                                              ║
 ║  - Complex collaborative workflows                               ║
 ║                                                                   ║
-║  CURRENT STATUS:                                                  ║
-║  - Research preview (NOT production ready)                       ║
-║  - Higher cost than Task tool approach                           ║
-║  - This system uses Task tool + routing skills (STABLE)       ║
+║  WHEN Agent Teams IS ENABLED:                                    ║
+║  - Use for research, review, debugging tasks (3+ agents)        ║
+║  - Use for tasks requiring inter-agent communication             ║
+║  - Use for shared state management                               ║
 ║                                                                   ║
-║  WHEN TO CONSIDER Agent Teams:                                    ║
-║  - Complex multi-agent collaboration needed                      ║
-║  - Agents need to communicate with each other                    ║
-║  - Shared state management required                              ║
-║                                                                   ║
-║  WHEN TO KEEP Task tool (DEFAULT):                               ║
+║  WHEN Agent Teams IS NOT ENABLED (or for simple tasks):          ║
+║  - Use Task tool + routing skills (stable default)               ║
 ║  - Focused, independent sub-tasks                                ║
 ║  - Cost-sensitive operations                                     ║
-║  - Predictable execution flow                                    ║
 ║                                                                   ║
-║  See: GitHub Issue #5 for migration tracking                     ║
+║  Both approaches coexist. Agent Teams adds coordination          ║
+║  richness, not replacement of Task tool.                         ║
 ╚══════════════════════════════════════════════════════════════════╝
 ```
 

package/templates/.claude/rules/SHOULD-agent-teams.md

@@ -0,0 +1,137 @@
+# [SHOULD] Agent Teams Rules
+
+> **Priority**: SHOULD - Actively use when available
+> **ID**: R018
+> **Condition**: Agent Teams feature is enabled locally
+
+## Purpose
+
+When Claude Code's Agent Teams feature is enabled on the local machine, actively leverage it for tasks that benefit from multi-agent collaboration, shared state, and peer-to-peer communication.
+
+## Detection
+
+Agent Teams availability is determined by:
+- Environment variable: `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`
+- The presence of TeamCreate, SendMessage, TaskCreate/TaskList (team variants) tools
+
+When detected, Agent Teams becomes the **preferred coordination method** for qualifying tasks.
+
+## Decision Matrix
+
+| Scenario | Task Tool | Agent Teams | Preferred |
+|----------|-----------|-------------|-----------|
+| Simple independent subtasks | Low cost | Overkill | **Task Tool** |
+| Multi-step with shared state | Limited | Native support | **Agent Teams** |
+| Research requiring discussion | No peer comm | Peer messaging | **Agent Teams** |
+| Cost-sensitive batch ops | Lower tokens | Higher tokens | **Task Tool** |
+| Complex debugging across modules | Isolated context | Shared context | **Agent Teams** |
+| Code review + fix cycle | Sequential | Collaborative | **Agent Teams** |
+| Single file operations | Fast | Overhead | **Task Tool** |
+
+## When to Use Agent Teams
+
+### SHOULD Use Agent Teams For
+
+```
+Tasks requiring 3+ agents that need to coordinate
+Research tasks where agents need to share findings
+Debugging sessions spanning multiple modules
+Review + implementation cycles
+Any task where inter-agent communication adds value
+```
+
+### SHOULD Keep Task Tool For
+
+```
+Independent parallel subtasks (no shared state)
+Single-agent delegations
+Cost-sensitive batch operations
+Simple file operations
+When Agent Teams is not available
+```
+
+## Team Composition Guidelines
+
+### Standard Team Patterns
+
+#### Research Team
+```
+TeamCreate("research-team")
++-- researcher-1: Explore codebase area A
++-- researcher-2: Explore codebase area B
++-- synthesizer: Aggregate findings
+```
+
+#### Development Team
+```
+TeamCreate("dev-team")
++-- implementer: Write code
++-- reviewer: Review changes
++-- tester: Validate changes
+```
+
+#### Debug Team
+```
+TeamCreate("debug-team")
++-- investigator-1: Trace issue in module A
++-- investigator-2: Trace issue in module B
++-- fixer: Apply fixes based on findings
+```
+
+### Team Lifecycle
+
+```
+1. TeamCreate        -> Create team with purpose
+2. TaskCreate        -> Define tasks for team members
+3. Task(team_name)   -> Spawn team members
+4. SendMessage       -> Coordinate between members
+5. TaskUpdate        -> Track progress
+6. SendMessage(shutdown_request) -> Graceful shutdown
+7. TeamDelete        -> Cleanup
+```
+
+## Fallback Behavior
+
+When Agent Teams is NOT available:
+- All team-qualifying tasks fall back to Task tool
+- R009 (Parallel Execution) governs parallel spawning
+- R010 (Orchestrator Coordination) governs delegation
+- No degradation in capability, only in coordination richness
+
+```
++------------------------------------------------------------------+
+|  GRACEFUL DEGRADATION                                            |
+|                                                                  |
+|  Agent Teams Available:                                          |
+|    Complex task -> TeamCreate -> coordinated agents              |
+|                                                                  |
+|  Agent Teams NOT Available:                                      |
+|    Complex task -> Task tool -> parallel independent agents      |
+|                                                                  |
+|  Both approaches produce results.                                |
+|  Agent Teams adds coordination, not capability.                  |
++------------------------------------------------------------------+
+```
+
+## Integration with Existing Rules
+
+| Rule | Integration |
+|------|-------------|
+| R009 (Parallel) | Task tool parallel = fallback when no Agent Teams |
+| R010 (Orchestrator) | Agent Teams = alternative coordination model |
+| R012 (HUD) | Team status displayed in HUD |
+| R013 (Ecomode) | Team communications respect ecomode |
+
+## Cost Awareness
+
+Agent Teams consume more tokens due to:
+- Full context per team member
+- Inter-agent message passing
+- Shared task list overhead
+
+```
+Rule of thumb:
+  If task takes < 3 minutes with Task tool -> Use Task tool
+  If task needs inter-agent communication  -> Use Agent Teams
+  If unsure -> Start with Task tool, escalate to Agent Teams if needed
+```

package/templates/.claude/rules/index.yaml

@@ -24,49 +24,26 @@ rules:
     priority: MUST
     scope: all
 
-  # SHOULD - Strongly recommended
-  - id: R003
-    name: interaction
-    title: Interaction Rules
-    path: ./SHOULD-interaction.md
-    priority: SHOULD
-    scope: all
-
-  - id: R004
-    name: error-handling
-    title: Error Handling Rules
-    path: ./SHOULD-error-handling.md
-    priority: SHOULD
-    scope: all
-
   - id: R007
     name: agent-identification
     title: Agent Identification Rules
-    path: ./SHOULD-agent-identification.md
-    priority: SHOULD
+    path: ./MUST-agent-identification.md
+    priority: MUST
     scope: all
 
   - id: R008
     name: tool-identification
     title: Tool Usage Identification Rules
-    path: ./SHOULD-tool-identification.md
-    priority: SHOULD
-    scope: all
-
-  # MAY - Optional
-  - id: R005
-    name: optimization
-    title: Optimization Guide
-    path: ./MAY-optimization.md
-    priority: MAY
+    path: ./MUST-tool-identification.md
+    priority: MUST
     scope: all
 
   - id: R009
     name: parallel-execution
     title: Parallel Execution Rules
-    path: ./MAY-parallel-execution.md
-    priority: MAY
-    scope: agents
+    path: ./MUST-parallel-execution.md
+    priority: MUST
+    scope: all
 
   # Agent Design - MUST
   - id: R006
@@ -84,6 +61,45 @@ rules:
     priority: MUST
     scope: agents
 
+  # Intent Transparency - MUST
+  - id: R015
+    name: intent-transparency
+    title: Intent Transparency Rules
+    path: ./MUST-intent-transparency.md
+    priority: MUST
+    scope: orchestrator
+
+  # Continuous Improvement - MUST
+  - id: R016
+    name: continuous-improvement
+    title: Continuous Improvement Rules
+    path: ./MUST-continuous-improvement.md
+    priority: MUST
+    scope: all
+
+  # Sync Verification - MUST
+  - id: R017
+    name: sync-verification
+    title: Sync Verification Rules
+    path: ./MUST-sync-verification.md
+    priority: MUST
+    scope: all
+
+  # SHOULD - Strongly recommended
+  - id: R003
+    name: interaction
+    title: Interaction Rules
+    path: ./SHOULD-interaction.md
+    priority: SHOULD
+    scope: all
+
+  - id: R004
+    name: error-handling
+    title: Error Handling Rules
+    path: ./SHOULD-error-handling.md
+    priority: SHOULD
+    scope: all
+
   # Memory Integration - SHOULD
   - id: R011
     name: memory-integration
@@ -108,10 +124,18 @@ rules:
     priority: SHOULD
     scope: all
 
-  # Intent Transparency - MUST
-  - id: R015
-    name: intent-transparency
-    title: Intent Transparency Rules
-    path: ./MUST-intent-transparency.md
-    priority: MUST
+  # Agent Teams - SHOULD
+  - id: R018
+    name: agent-teams
+    title: Agent Teams Rules
+    path: ./SHOULD-agent-teams.md
+    priority: SHOULD
     scope: orchestrator
+
+  # MAY - Optional
+  - id: R005
+    name: optimization
+    title: Optimization Guide
+    path: ./MAY-optimization.md
+    priority: MAY
+    scope: all

package/templates/CLAUDE.md.en

@@ -129,6 +129,7 @@ Flow:
 | R012 | HUD Statusline | Real-time status display |
 | R013 | Ecomode | Token efficiency for batch ops |
 | R015 | Intent Transparency | **MUST** - Transparent agent routing |
+| R018 | Agent Teams | Active use of Agent Teams when enabled |
 
 ### MAY (Optional)
 | ID | Rule | Description |
@@ -169,7 +170,7 @@ project/
 +-- .claude/
 |   +-- agents/                  # Subagent definitions (34 files)
 |   +-- skills/                  # Skills (41 directories)
-|   +-- rules/                   # Global rules (R000-R017)
+|   +-- rules/                   # Global rules (R000-R018)
 |   +-- hooks/                   # Hook scripts (memory, HUD)
 |   +-- contexts/                # Context files (ecomode)
 +-- guides/                      # Reference docs (13 topics)
@@ -200,6 +201,21 @@ The main conversation acts as the sole orchestrator. Subagents cannot spawn othe
 | System | 2 | sys-memory-keeper, sys-naggy |
 | **Total** | **34** | |
 
+## Agent Teams
+
+When Claude Code's Agent Teams feature is enabled (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`), actively use it for qualifying tasks.
+
+| Feature | Subagents (Default) | Agent Teams |
+|---------|---------------------|-------------|
+| Communication | Results to caller only | Peer-to-peer mailbox |
+| Coordination | Orchestrator manages | Shared task list |
+| Best for | Focused tasks | Research, review, debugging |
+| Token cost | Lower | Higher |
+
+**When enabled, actively use Agent Teams for complex collaborative tasks.**
+See R018 (SHOULD-agent-teams.md) for the decision matrix.
+Task tool + routing skills remain the fallback for simple/cost-sensitive tasks.
+
 ## Quick Reference
 
 ```bash

package/templates/CLAUDE.md.ko

@@ -129,6 +129,7 @@ oh-my-customcode로 구동됩니다.
 | R012 | HUD 상태줄 | 실시간 상태 표시 |
 | R013 | Ecomode | 배치 작업 토큰 효율성 |
 | R015 | 의도 투명성 | **필수** - 투명한 에이전트 라우팅 |
+| R018 | Agent Teams | 활성화 시 Agent Teams 적극 사용 |
 
 ### MAY (선택)
 | ID | 규칙 | 설명 |
@@ -169,7 +170,7 @@ project/
 +-- .claude/
 |   +-- agents/                  # 서브에이전트 정의 (34 파일)
 |   +-- skills/                  # 스킬 (41 디렉토리)
-|   +-- rules/                   # 전역 규칙 (R000-R017)
+|   +-- rules/                   # 전역 규칙 (R000-R018)
 |   +-- hooks/                   # 훅 스크립트 (메모리, HUD)
 |   +-- contexts/                # 컨텍스트 파일 (ecomode)
 +-- guides/                      # 레퍼런스 문서 (13 토픽)
@@ -200,6 +201,21 @@ project/
 | System | 2 | sys-memory-keeper, sys-naggy |
 | **총계** | **34** | |
 
+## Agent Teams
+
+Claude Code의 Agent Teams 기능이 활성화되어 있으면 (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`), 적격한 작업에 적극적으로 사용합니다.
+
+| 기능 | 서브에이전트 (기본) | Agent Teams |
+|------|---------------------|-------------|
+| 통신 | 호출자에게 결과만 반환 | 피어 투 피어 메시지 |
+| 조율 | 오케스트레이터가 관리 | 공유 작업 목록 |
+| 적합한 작업 | 집중된 작업 | 리서치, 리뷰, 디버깅 |
+| 토큰 비용 | 낮음 | 높음 |
+
+**활성화 시, 복잡한 협업 작업에 Agent Teams를 적극 사용합니다.**
+결정 매트릭스는 R018 (SHOULD-agent-teams.md)을 참조하세요.
+단순/비용 민감 작업에는 Task tool + 라우팅 스킬이 폴백으로 유지됩니다.
+
 ## 빠른 참조
 
 ```bash

package/templates/manifest.json

@@ -1,12 +1,12 @@
 {
   "version": "0.2.0",
-  "lastUpdated": "2026-02-06T06:06:08.847Z",
+  "lastUpdated": "2026-02-08T07:00:00.000Z",
   "components": [
     {
       "name": "rules",
       "path": ".claude/rules",
       "description": "Agent behavior rules and guidelines",
-      "files": 18
+      "files": 19
     },
     {
       "name": "agents",