oh-my-customcode 0.33.1 → 0.34.0

package/README.md

@@ -21,7 +21,7 @@ Like oh-my-zsh transformed shell customization, oh-my-customcode makes personali
 
 | Feature | Description |
 |---------|-------------|
-| **Batteries Included** | 44 agents, 70 skills, 25 guides, 19 rules, 1 hook, 4 contexts, ontology graph - ready to use out of the box |
+| **Batteries Included** | 44 agents, 71 skills, 25 guides, 19 rules, 1 hook, 4 contexts, ontology graph - ready to use out of the box |
 | **Sub-Agent Model** | Supports hierarchical agent orchestration with specialized roles |
 | **Dead Simple Customization** | Create a folder + markdown file = new agent or skill |
 | **Mix and Match** | Use built-in components, create your own, or combine both |
@@ -101,7 +101,7 @@ All commands are invoked inside the Claude Code conversation.
 
 | Command | Description |
 |---------|-------------|
-| `/analysis` | Analyze project and auto-configure agents, skills, rules |
+| `/omcustom:analysis` | Analyze project and auto-configure agents, skills, rules |
 | `/research` | 10-team parallel deep analysis with cross-verification |
 
 #### Development
@@ -115,11 +115,11 @@ All commands are invoked inside the Claude Code conversation.
 
 | Command | Description |
 |---------|-------------|
-| `/create-agent` | Create new agent |
-| `/update-docs` | Sync project structure and documentation |
-| `/update-external` | Update agents from external sources |
-| `/audit-agents` | Audit agent dependencies |
-| `/fix-refs` | Fix broken references |
+| `/omcustom:create-agent` | Create new agent |
+| `/omcustom:update-docs` | Sync project structure and documentation |
+| `/omcustom:update-external` | Update agents from external sources |
+| `/omcustom:audit-agents` | Audit agent dependencies |
+| `/omcustom:fix-refs` | Fix broken references |
 
 #### Memory
 
@@ -128,13 +128,13 @@ All commands are invoked inside the Claude Code conversation.
 | `/memory-save` | Save session context to claude-mem |
 | `/memory-recall` | Search and recall memories |
 
-#### DevOps & Publishing
+#### DevOps & Package Management
 
 | Command | Description |
 |---------|-------------|
-| `/npm-publish` | Publish package to npm registry |
-| `/npm-version` | Semantic version management |
-| `/npm-audit` | Dependency security audit |
+| `/omcustom:npm-publish` | Publish package to npm registry |
+| `/omcustom:npm-version` | Semantic version management |
+| `/omcustom:npm-audit` | Dependency security audit |
 
 #### Optimization
 
@@ -148,14 +148,14 @@ All commands are invoked inside the Claude Code conversation.
 
 | Command | Description |
 |---------|-------------|
-| `/sauron-watch` | Full R017 sync verification |
-| `/monitoring-setup` | OTel console monitoring enable/disable |
+| `/omcustom:sauron-watch` | Full R017 sync verification |
+| `/omcustom:monitoring-setup` | OTel console monitoring enable/disable |
 | `/codex-exec` | Execute Codex CLI prompt |
 | `/deep-plan` | Research-validated planning (research → plan → verify) |
 | `/structured-dev-cycle` | 6-phase structured development cycle |
-| `/lists` | Show all available commands |
-| `/status` | System status and health checks |
-| `/help` | Help information |
+| `/omcustom:lists` | Show all available commands |
+| `/omcustom:status` | System status and health checks |
+| `/omcustom:help` | Help information |
 
 ---
 
@@ -179,7 +179,7 @@ All commands are invoked inside the Claude Code conversation.
 | **Security** | 1 | sec-codeql-expert |
 | **Total** | **44** | |
 
-### Skills (70)
+### Skills (71)
 
 | Category | Count | Skills |
 |----------|-------|--------|
@@ -192,7 +192,7 @@ All commands are invoked inside the Claude Code conversation.
 | **Package Management** | 3 | npm-publish, npm-version, npm-audit |
 | **Operations** | 7 | update-docs, update-external, audit-agents, fix-refs, sauron-watch, monitoring-setup, claude-code-bible |
 | **Utilities** | 5 | lists, help, status, result-aggregation, writing-clearly-and-concisely |
-| **Quality & Workflow** | 10 | multi-model-verification, structured-dev-cycle, model-escalation, stuck-recovery, dag-orchestration, task-decomposition, worker-reviewer-pipeline, pr-auto-improve, pipeline-guards, deep-plan |
+| **Quality & Workflow** | 11 | multi-model-verification, structured-dev-cycle, model-escalation, stuck-recovery, dag-orchestration, task-decomposition, worker-reviewer-pipeline, pr-auto-improve, pipeline-guards, deep-plan, evaluator-optimizer |
 | **Security** | 2 | cve-triage, jinja2-prompts |
 | **Research** | 1 | research |
 | **Deploy** | 2 | vercel-deploy, codex-exec |
@@ -281,7 +281,7 @@ your-project/
 │   │   ├── be-fastapi-expert.md
 │   │   ├── mgr-creator.md
 │   │   └── ...
-│   ├── skills/            # Skill modules (70 directories, each with SKILL.md)
+│   ├── skills/            # Skill modules (71 directories, each with SKILL.md)
 │   │   ├── go-best-practices/
 │   │   ├── react-best-practices/
 │   │   ├── secretary-routing/

package/package.json

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

package/templates/.claude/hooks/scripts/stuck-detector.sh

@@ -4,7 +4,12 @@ set -euo pipefail
 # Stuck Detector Hook
 # Trigger: PostToolUse, tool matches "Edit|Write|Bash|Task|Agent"
 # Purpose: Detect repetitive failure loops and advise recovery
-# Protocol: stdin JSON -> process -> stdout pass-through, exit 0 always
+# Protocol: stdin JSON -> process -> stdout pass-through
+#   - exit 0: advisory (normal cases, < HARD_BLOCK_THRESHOLD repetitions)
+#   - exit 1: hard block (extreme stuck loops, >= HARD_BLOCK_THRESHOLD repetitions)
+
+# Hard block threshold: consecutive identical operations before blocking
+HARD_BLOCK_THRESHOLD=5
 
 input=$(cat)
 
@@ -120,6 +125,61 @@ if [ "$stuck_detected" = true ]; then
   echo "----------------------------------------" >&2
 fi
 
+# --- Hard Block Detection (extreme stuck loops) ---
+# Check if the same operation has been repeated HARD_BLOCK_THRESHOLD+ times consecutively.
+# This catches cases where advisory warnings are being ignored.
+
+hard_block=false
+hard_block_reason=""
+
+if [ -f "$HISTORY_FILE" ]; then
+  last_n=$(tail -"$HARD_BLOCK_THRESHOLD" "$HISTORY_FILE" 2>/dev/null)
+  last_n_count=$(echo "$last_n" | wc -l | tr -d ' ')
+
+  if [ "$last_n_count" -ge "$HARD_BLOCK_THRESHOLD" ]; then
+    # Check 1: Same file edited HARD_BLOCK_THRESHOLD+ times consecutively
+    if [ -n "$file_path" ]; then
+      escaped_path=$(echo "$file_path" | sed 's/[.[\*^$()+?{|]/\\&/g')
+      consecutive_file=$(echo "$last_n" | grep -c "\"path\":\"${escaped_path}\"" 2>/dev/null || echo "0")
+      if [ "$consecutive_file" -ge "$HARD_BLOCK_THRESHOLD" ]; then
+        hard_block=true
+        hard_block_reason="Same file ($(basename "$file_path")) edited ${consecutive_file} consecutive times"
+      fi
+    fi
+
+    # Check 2: Same error repeated HARD_BLOCK_THRESHOLD+ times consecutively
+    if [ "$hard_block" = false ] && [ "$is_error" = "true" ] && [ -n "$error_hash" ]; then
+      consecutive_error=$(echo "$last_n" | grep -c "\"error_hash\":\"${error_hash}\"" 2>/dev/null || echo "0")
+      if [ "$consecutive_error" -ge "$HARD_BLOCK_THRESHOLD" ]; then
+        hard_block=true
+        hard_block_reason="Same error repeated ${consecutive_error} consecutive times"
+      fi
+    fi
+
+    # Check 3: Same tool+target combination HARD_BLOCK_THRESHOLD+ times consecutively
+    if [ "$hard_block" = false ] && [ -n "$file_path" ]; then
+      escaped_path=$(echo "$file_path" | sed 's/[.[\*^$()+?{|]/\\&/g')
+      consecutive_tool_target=$(echo "$last_n" | grep "\"tool\":\"${tool_name}\"" | grep -c "\"path\":\"${escaped_path}\"" 2>/dev/null || echo "0")
+      if [ "$consecutive_tool_target" -ge "$HARD_BLOCK_THRESHOLD" ]; then
+        hard_block=true
+        hard_block_reason="${tool_name} called on $(basename "$file_path") ${consecutive_tool_target} consecutive times"
+      fi
+    fi
+  fi
+fi
+
+if [ "$hard_block" = true ]; then
+  echo "" >&2
+  echo "=== [Stuck Detection] HARD BLOCK ===" >&2
+  echo "  ${hard_block_reason}" >&2
+  echo "  Threshold: ${HARD_BLOCK_THRESHOLD} consecutive identical operations" >&2
+  echo "  Action: Blocking this tool call to break the stuck loop." >&2
+  echo "  Recovery: Step back, re-read the error, and try a fundamentally different approach." >&2
+  echo "=====================================" >&2
+  echo "$input"
+  exit 1
+fi
+
 # Pass through
 echo "$input"
 exit 0

package/templates/.claude/hooks/scripts/task-outcome-recorder.sh

@@ -34,9 +34,10 @@ entry=$(jq -n \
   --arg agent "$agent_type" \
   --arg model "$model" \
   --arg outcome "$outcome" \
+  --arg pattern "unknown" \
   --arg desc "$description" \
   --arg err "$error_summary" \
-  '{timestamp: $ts, agent_type: $agent, model: $model, outcome: $outcome, description: $desc, error_summary: $err}')
+  '{timestamp: $ts, agent_type: $agent, model: $model, outcome: $outcome, pattern_used: $pattern, description: $desc, error_summary: $err}')
 
 echo "$entry" >> "$OUTCOME_FILE"
 

package/templates/.claude/rules/MUST-agent-design.md

@@ -165,10 +165,10 @@ Use `context: fork` for skills that orchestrate multi-agent workflows. Cap at **
 | Multi-agent coordination patterns | Single-agent reference skills |
 | Task decomposition/planning | External tool integrations |
 
-Current skills with `context: fork` (8/10 cap):
+Current skills with `context: fork` (9/10 cap):
 - secretary-routing, dev-lead-routing, de-lead-routing, qa-lead-routing
 - dag-orchestration, task-decomposition, worker-reviewer-pipeline
-- pipeline-guards
+- pipeline-guards, deep-plan
 
 ## Naming
 

package/templates/.claude/skills/analysis/SKILL.md

@@ -1,7 +1,7 @@
 ---
-name: analysis
+name: omcustom:analysis
 description: Analyze project and auto-configure agents, skills, rules, and guides
-scope: core
+scope: harness
 argument-hint: "[--dry-run] [--verbose]"
 ---
 

package/templates/.claude/skills/audit-agents/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: audit-agents
+name: omcustom:audit-agents
 description: Audit agent dependencies and references
 scope: harness
 argument-hint: "[agent-name] [--all] [--fix]"

package/templates/.claude/skills/create-agent/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: create-agent
+name: omcustom:create-agent
 description: Create a new agent with complete structure
 scope: harness
 argument-hint: "<name> --type <type>"

package/templates/.claude/skills/dev-refactor/SKILL.md

@@ -9,6 +9,17 @@ argument-hint: "<file-or-directory> [--lang <language>]"
 
 Refactor code for better structure, naming, and patterns using language-specific expert agents.
 
+## When NOT to Use
+
+| Scenario | Better Alternative |
+|----------|--------------------|
+| Renaming only (no structural change) | IDE rename refactoring or `sed` |
+| Formatting cleanup | Run formatter (`prettier`, `gofmt`, `black`) |
+| No test coverage for target code | Write tests first (`/structured-dev-cycle`) |
+| Moving files between directories | `git mv` via mgr-gitnerd |
+
+**Pre-execution check**: Verify test coverage exists for the refactoring target. Refactoring without tests risks silent regressions.
+
 ## Parameters
 
 | Name | Type | Required | Description |

package/templates/.claude/skills/dev-review/SKILL.md

@@ -9,6 +9,17 @@ argument-hint: "<file-or-directory> [--lang <language>]"
 
 Review code for best practices using language-specific expert agents.
 
+## When NOT to Use
+
+| Scenario | Better Alternative |
+|----------|--------------------|
+| Formatting/style issues only | Run linter or formatter directly (`prettier`, `gofmt`, `black`) |
+| Single syntax error | IDE/LSP diagnostics |
+| Auto-generated code | Skip — generated code follows its own conventions |
+| Pre-commit quick check | Git hooks with linter integration |
+
+**Pre-execution check**: If the issue is purely formatting, run the appropriate formatter first.
+
 ## Parameters
 
 | Name | Type | Required | Description |

package/templates/.claude/skills/evaluator-optimizer/SKILL.md

@@ -0,0 +1,256 @@
+---
+name: evaluator-optimizer
+description: Parameterized evaluator-optimizer loop for quality-critical output with configurable rubrics
+scope: core
+user-invocable: false
+---
+
+# Evaluator-Optimizer Skill
+
+## Purpose
+
+General-purpose iterative refinement loop. A generator agent produces output, an evaluator agent scores it against a configurable rubric, and the loop continues until the quality gate is met or max iterations are reached.
+
+This skill generalizes the worker-reviewer-pipeline pattern beyond code review to any domain requiring quality-critical output: documentation, architecture decisions, test plans, configurations, and more.
+
+## Configuration Schema
+
+```yaml
+evaluator-optimizer:
+  generator:
+    agent: {subagent_type}       # Agent that produces output
+    model: sonnet                 # Default model
+  evaluator:
+    agent: {subagent_type}       # Agent that reviews output
+    model: opus                   # Evaluator benefits from stronger reasoning
+  rubric:
+    - criterion: {name}
+      weight: {0.0-1.0}
+      description: {what to evaluate}
+  quality_gate:
+    type: all_pass | majority_pass | score_threshold
+    threshold: 0.8                # For score_threshold type
+  max_iterations: 3               # Default, hard cap: 5
+```
+
+### Parameter Details
+
+| Parameter | Required | Default | Description |
+|-----------|----------|---------|-------------|
+| `generator.agent` | Yes | — | Subagent type that produces output |
+| `generator.model` | No | `sonnet` | Model for generation |
+| `evaluator.agent` | Yes | — | Subagent type that evaluates output |
+| `evaluator.model` | No | `opus` | Model for evaluation (stronger reasoning preferred) |
+| `rubric` | Yes | — | List of evaluation criteria with weights |
+| `quality_gate.type` | No | `score_threshold` | Gate strategy |
+| `quality_gate.threshold` | No | `0.8` | Score threshold (for `score_threshold` type) |
+| `max_iterations` | No | `3` | Max refinement loops (hard cap: 5) |
+
+## Quality Gate Types
+
+| Type | Behavior |
+|------|----------|
+| `all_pass` | Every rubric criterion must pass |
+| `majority_pass` | >50% of weighted criteria pass |
+| `score_threshold` | Weighted average score >= threshold |
+
+### Gate Evaluation Logic
+
+- **all_pass**: Each criterion scored individually. All must receive `pass: true`.
+- **majority_pass**: Sum weights of passing criteria. If > 0.5 of total weight, gate passes.
+- **score_threshold**: Compute weighted average: `sum(score_i * weight_i) / sum(weight_i)`. Compare against threshold.
+
+## Workflow
+
+```
+1. Generator produces output
+   → Orchestrator spawns generator agent with task prompt
+   → Generator returns output artifact
+
+2. Evaluator scores against rubric
+   → Orchestrator spawns evaluator agent with:
+     - The output artifact
+     - The rubric criteria
+     - Instructions to produce verdict JSON
+   → Evaluator returns structured verdict
+
+3. Quality gate check:
+   - PASS → return output + final verdict
+   - FAIL → extract feedback, append to generator prompt → iteration N+1
+
+4. Max iterations reached → return best output + warning
+   → "Best" = output from iteration with highest weighted score
+```
+
+### Iteration Flow Diagram
+
+```
+┌─────────────────────────────────────────────────┐
+│                  Orchestrator                    │
+│                                                  │
+│  ┌──────────┐    ┌──────────┐    ┌──────────┐  │
+│  │ Generate  │───→│ Evaluate │───→│  Gate    │  │
+│  │ (iter N)  │    │          │    │  Check   │  │
+│  └──────────┘    └──────────┘    └────┬─────┘  │
+│       ↑                               │         │
+│       │         ┌──────────┐    FAIL  │  PASS   │
+│       └─────────│ Feedback │←────────┘    │     │
+│                 └──────────┘              ↓     │
+│                                     Return      │
+└─────────────────────────────────────────────────┘
+```
+
+## Stopping Criteria Display
+
+```
+[Evaluator-Optimizer]
+├── Generator: {agent}:{model}
+├── Evaluator: {agent}:{model}
+├── Max iterations: {max_iterations} (hard cap: 5)
+├── Quality gate: {type} (threshold: {threshold})
+└── Rubric: {N} criteria
+```
+
+Display this at the start of the loop to provide transparency into the refinement configuration.
+
+## Verdict Format
+
+The evaluator MUST return a structured verdict in this format:
+
+```json
+{
+  "status": "pass | fail",
+  "iteration": 2,
+  "score": 0.85,
+  "rubric_results": [
+    {"criterion": "clarity", "pass": true, "score": 0.9, "feedback": "Clear structure and logical flow"},
+    {"criterion": "accuracy", "pass": true, "score": 0.8, "feedback": "All facts verified, one minor imprecision in section 3"}
+  ],
+  "improvement_summary": "Section 3 terminology tightened. Examples added to section 2."
+}
+```
+
+### Verdict Fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `status` | `pass` or `fail` | Overall quality gate result |
+| `iteration` | number | Current iteration number (1-indexed) |
+| `score` | number (0.0-1.0) | Weighted average score across all criteria |
+| `rubric_results` | array | Per-criterion evaluation details |
+| `improvement_summary` | string | Summary of changes from previous iteration (empty on iteration 1) |
+
+## Domain Examples
+
+| Domain | Generator | Evaluator | Rubric Focus |
+|--------|-----------|-----------|--------------|
+| Code review | `lang-*-expert` | opus reviewer | Correctness, style, security |
+| Documentation | `arch-documenter` | opus reviewer | Completeness, clarity, accuracy |
+| Architecture | Plan agent | opus reviewer | No SPOFs, no circular deps |
+| Test plans | `qa-planner` | `qa-engineer` | Coverage, edge cases, feasibility |
+| Agent creation | `mgr-creator` | opus reviewer | Frontmatter validity, R006 compliance |
+| Security audit | `sec-codeql-expert` | opus reviewer | Vulnerability coverage, false positive rate |
+
+### Example: Documentation Review
+
+```yaml
+evaluator-optimizer:
+  generator:
+    agent: arch-documenter
+    model: sonnet
+  evaluator:
+    agent: general-purpose
+    model: opus
+  rubric:
+    - criterion: completeness
+      weight: 0.3
+      description: All sections present, no gaps in coverage
+    - criterion: clarity
+      weight: 0.3
+      description: Clear language, no ambiguity, proper examples
+    - criterion: accuracy
+      weight: 0.25
+      description: All technical details correct and verifiable
+    - criterion: consistency
+      weight: 0.15
+      description: Consistent terminology, formatting, and style
+  quality_gate:
+    type: score_threshold
+    threshold: 0.8
+  max_iterations: 3
+```
+
+### Example: Code Implementation
+
+```yaml
+evaluator-optimizer:
+  generator:
+    agent: lang-typescript-expert
+    model: sonnet
+  evaluator:
+    agent: general-purpose
+    model: opus
+  rubric:
+    - criterion: correctness
+      weight: 0.35
+      description: Code compiles, logic is correct, edge cases handled
+    - criterion: style
+      weight: 0.2
+      description: Follows project conventions, clean and readable
+    - criterion: security
+      weight: 0.25
+      description: No injection risks, proper input validation
+    - criterion: performance
+      weight: 0.2
+      description: No unnecessary allocations, efficient algorithms
+  quality_gate:
+    type: all_pass
+  max_iterations: 3
+```
+
+## Integration
+
+| Rule | Integration |
+|------|-------------|
+| R009 | Generator and evaluator run sequentially (dependent — evaluator needs generator output) |
+| R010 | Orchestrator configures and invokes the loop; generator and evaluator agents execute via Agent tool |
+| R007 | Each iteration displays agent identification for both generator and evaluator |
+| R008 | Tool calls within generator/evaluator follow tool identification rules |
+| R013 | Ecomode: return verdict summary only, skip per-criterion details |
+| R015 | Display configuration block at loop start for intent transparency |
+
+## Ecomode Behavior
+
+When ecomode is active (R013), compress output:
+
+**Normal mode:**
+```
+[Evaluator-Optimizer] Iteration 2/3
+├── Generator: lang-typescript-expert:sonnet → produced 45-line module
+├── Evaluator: general-purpose:opus → scored 0.85
+├── Rubric: correctness ✓(0.9), style ✓(0.8), security ✓(0.85), performance ✓(0.8)
+└── Gate: score_threshold(0.8) → PASS
+```
+
+**Ecomode:**
+```
+[EO] iter 2/3 → 0.85 → PASS
+```
+
+## Error Handling
+
+| Scenario | Action |
+|----------|--------|
+| Generator fails to produce output | Retry once with simplified prompt; if still fails, abort with error |
+| Evaluator returns malformed verdict | Retry once; if still malformed, treat as fail with score 0.0 |
+| Max iterations reached without passing | Return best-scored output with warning: "Quality gate not met after {N} iterations" |
+| Rubric has zero total weight | Reject configuration, report error before starting loop |
+| Hard cap exceeded in config | Clamp `max_iterations` to 5, emit warning |
+
+## Constraints
+
+- This skill does NOT use `context: fork` — it operates within the caller's context
+- Generator and evaluator MUST be different agent invocations (no self-review)
+- The evaluator prompt MUST include the full rubric to ensure consistent scoring
+- Iteration state (best score, best output) is tracked by the orchestrator
+- The hard cap of 5 iterations prevents runaway refinement loops

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

@@ -1,5 +1,5 @@
 ---
-name: fix-refs
+name: omcustom:fix-refs
 description: Fix broken agent references and symlinks
 scope: harness
 argument-hint: "[agent-name] [--all] [--dry-run]"

package/templates/.claude/skills/help/SKILL.md

@@ -1,7 +1,7 @@
 ---
-name: help
+name: omcustom:help
 description: Show help information for commands and system
-scope: core
+scope: harness
 argument-hint: "[command] [--agents] [--rules]"
 ---
 

package/templates/.claude/skills/lists/SKILL.md

@@ -1,7 +1,7 @@
 ---
-name: lists
+name: omcustom:lists
 description: Show all available commands
-scope: core
+scope: harness
 argument-hint: "[--category <category>] [--verbose]"
 ---
 

package/templates/.claude/skills/monitoring-setup/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: monitoring-setup
+name: omcustom:monitoring-setup
 description: Enable/disable OpenTelemetry console monitoring for Claude Code usage tracking
 scope: package
 argument-hint: "[enable|disable|status]"

package/templates/.claude/skills/npm-audit/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: npm-audit
+name: omcustom:npm-audit
 description: Audit npm dependencies for security and updates
 scope: package
 argument-hint: "[--fix] [--production]"

package/templates/.claude/skills/npm-publish/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: npm-publish
+name: omcustom:npm-publish
 description: Publish package to npm registry with pre-checks
 scope: package
 argument-hint: "[--tag <tag>] [--dry-run]"

package/templates/.claude/skills/npm-version/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: npm-version
+name: omcustom:npm-version
 description: Manage semantic versions for npm packages
 scope: package
 argument-hint: "<major|minor|patch> [--no-tag] [--no-commit]"

package/templates/.claude/skills/research/SKILL.md

@@ -20,6 +20,17 @@ Orchestrates 10 parallel research teams for comprehensive deep analysis of any t
 /research Rust async runtime comparison
 ```
 
+## When NOT to Use
+
+| Scenario | Better Alternative |
+|----------|--------------------|
+| Simple factual question | Direct answer or single WebSearch |
+| Single-file code review | `/dev-review` with specific file |
+| Known solution implementation | `/structured-dev-cycle` |
+| Topic with < 3 comparison dimensions | Single Explore agent |
+
+**Pre-execution check**: If the query can be answered with < 3 sources, skip 10-team research.
+
 ## Architecture — 4 Phases
 
 ### Phase 1: Parallel Research (10 teams, batched per R009)
@@ -258,6 +269,8 @@ Before execution:
 └── Phase 4: Report + GitHub issue
 
 Estimated: {time} | Teams: 10 | Models: sonnet → opus → codex
+Stopping: max 30 verification rounds, convergence at 0 contradictions
+Cost: ~$8-15 (10 teams × sonnet + opus verification)
 Execute? [Y/n]
 ```
 

package/templates/.claude/skills/sauron-watch/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: sauron-watch
+name: omcustom:sauron-watch
 description: Full R017 verification (5+3 rounds) before commit
 scope: harness
 disable-model-invocation: true

package/templates/.claude/skills/status/SKILL.md

@@ -1,7 +1,7 @@
 ---
-name: status
+name: omcustom:status
 description: Show system status and health checks
-scope: core
+scope: harness
 argument-hint: "[--verbose] [--health]"
 ---
 

package/templates/.claude/skills/task-decomposition/SKILL.md

@@ -20,6 +20,19 @@ Decomposition is **recommended** when any of these thresholds are met:
 | Domains involved | > 2 domains | Requires multiple specialists |
 | Agent types needed | > 2 types | Cross-specialty coordination |
 
+### Step 0: Pattern Selection
+
+Before decomposing, select the appropriate workflow pattern:
+
+| Pattern | When to Use | Primitive |
+|---------|-------------|-----------|
+| Sequential | Steps must execute in order, each depends on previous | dag-orchestration (linear) |
+| Parallel | Independent subtasks with no shared state | Agent tool (R009) or Agent Teams (R018) |
+| Evaluator-Optimizer | Quality-critical output needing iterative refinement | worker-reviewer-pipeline |
+| Orchestrator | Complex multi-step with dynamic routing | Routing skills (secretary/dev-lead/de-lead/qa-lead) |
+
+**Decision**: If task has independent subtasks → Parallel. If quality-critical → add EO review cycle. If multi-step with dependencies → Sequential/Orchestrator.
+
 ## Decomposition Process
 
 ```

package/templates/.claude/skills/update-docs/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: update-docs
+name: omcustom:update-docs
 description: Sync documentation with project structure
 scope: harness
 argument-hint: "[--check] [--target <path>]"

package/templates/.claude/skills/update-external/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: update-external
+name: omcustom:update-external
 description: Update agents from external sources (GitHub, docs, etc.)
 scope: harness
 argument-hint: "[agent-name] [--check] [--force]"

package/templates/.claude/skills/worker-reviewer-pipeline/SKILL.md

@@ -98,6 +98,16 @@ When Agent Teams is NOT available, falls back to sequential Agent tool calls:
 Agent(worker) → result → Agent(reviewer) → verdict → Agent(worker) → ...
 ```
 
+## Stopping Criteria Display
+
+Before execution, display:
+```
+[Worker-Reviewer Pipeline]
+├── Max iterations: {max_iterations} (default: 3, hard cap: 5)
+├── Quality gate: {pass_threshold}% approval required
+└── Early stop: All reviewers approve → stop immediately
+```
+
 ## Display Format
 
 ```

package/templates/CLAUDE.md.en

@@ -151,31 +151,31 @@ Violation = immediate correction. No exception for "small changes".
 
 | Command | Description |
 |---------|-------------|
-| `/analysis` | Analyze project and auto-configure customizations |
-| `/create-agent` | Create a new agent |
-| `/update-docs` | Sync documentation with project structure |
-| `/update-external` | Update agents from external sources |
-| `/audit-agents` | Audit agent dependencies |
-| `/fix-refs` | Fix broken references |
+| `/omcustom:analysis` | Analyze project and auto-configure customizations |
+| `/omcustom:create-agent` | Create a new agent |
+| `/omcustom:update-docs` | Sync documentation with project structure |
+| `/omcustom:update-external` | Update agents from external sources |
+| `/omcustom:audit-agents` | Audit agent dependencies |
+| `/omcustom:fix-refs` | Fix broken references |
 | `/dev-review` | Review code for best practices |
 | `/dev-refactor` | Refactor code |
 | `/memory-save` | Save session context to claude-mem |
 | `/memory-recall` | Search and recall memories |
-| `/monitoring-setup` | Enable/disable OTel console monitoring |
-| `/npm-publish` | Publish package to npm registry |
-| `/npm-version` | Manage semantic versions |
-| `/npm-audit` | Audit dependencies |
+| `/omcustom:monitoring-setup` | Enable/disable OTel console monitoring |
+| `/omcustom:npm-publish` | Publish package to npm registry |
+| `/omcustom:npm-version` | Manage semantic versions |
+| `/omcustom:npm-audit` | Audit dependencies |
 | `/codex-exec` | Execute Codex CLI prompts |
 | `/optimize-analyze` | Analyze bundle and performance |
 | `/optimize-bundle` | Optimize bundle size |
 | `/optimize-report` | Generate optimization report |
 | `/research` | 10-team parallel deep analysis and cross-verification |
 | `/deep-plan` | Research-validated planning (research → plan → verify) |
-| `/sauron-watch` | Full R017 verification |
+| `/omcustom:sauron-watch` | Full R017 verification |
 | `/structured-dev-cycle` | 6-stage structured development cycle (Plan → Verify → Implement → Verify → Compound → Done) |
-| `/lists` | Show all available commands |
-| `/status` | Show system status |
-| `/help` | Show help information |
+| `/omcustom:lists` | Show all available commands |
+| `/omcustom:status` | Show system status |
+| `/omcustom:help` | Show help information |
 
 ## Project Structure
 
@@ -184,7 +184,7 @@ project/
 +-- CLAUDE.md                    # Entry point
 +-- .claude/
 |   +-- agents/                  # Subagent definitions (44 files)
-|   +-- skills/                  # Skills (70 directories)
+|   +-- skills/                  # Skills (71 directories)
 |   +-- rules/                   # Global rules (R000-R019)
 |   +-- hooks/                   # Hook scripts (memory, HUD)
 |   +-- contexts/                # Context files (ecomode)
@@ -250,15 +250,15 @@ Task tool + routing skills remain the fallback for simple/cost-sensitive tasks.
 
 ```bash
 # Project analysis
-/analysis
+/omcustom:analysis
 
 # Show all commands
-/lists
+/omcustom:lists
 
 # Agent management
-/create-agent my-agent
-/update-docs
-/audit-agents
+/omcustom:create-agent my-agent
+/omcustom:update-docs
+/omcustom:audit-agents
 
 # Code review
 /dev-review src/main.go
@@ -268,7 +268,7 @@ Task tool + routing skills remain the fallback for simple/cost-sensitive tasks.
 /memory-recall authentication
 
 # Verification
-/sauron-watch
+/omcustom:sauron-watch
 ```
 
 ## External Dependencies

package/templates/CLAUDE.md.ko

@@ -151,31 +151,31 @@ oh-my-customcode로 구동됩니다.
 
 | 커맨드 | 설명 |
 |--------|------|
-| `/analysis` | 프로젝트 분석 및 자동 커스터마이징 |
-| `/create-agent` | 새 에이전트 생성 |
-| `/update-docs` | 프로젝트 구조와 문서 동기화 |
-| `/update-external` | 외부 소스에서 에이전트 업데이트 |
-| `/audit-agents` | 에이전트 의존성 감사 |
-| `/fix-refs` | 깨진 참조 수정 |
+| `/omcustom:analysis` | 프로젝트 분석 및 자동 커스터마이징 |
+| `/omcustom:create-agent` | 새 에이전트 생성 |
+| `/omcustom:update-docs` | 프로젝트 구조와 문서 동기화 |
+| `/omcustom:update-external` | 외부 소스에서 에이전트 업데이트 |
+| `/omcustom:audit-agents` | 에이전트 의존성 감사 |
+| `/omcustom:fix-refs` | 깨진 참조 수정 |
 | `/dev-review` | 코드 베스트 프랙티스 리뷰 |
 | `/dev-refactor` | 코드 리팩토링 |
 | `/memory-save` | 세션 컨텍스트를 claude-mem에 저장 |
 | `/memory-recall` | 메모리 검색 및 리콜 |
-| `/monitoring-setup` | OTel 콘솔 모니터링 활성화/비활성화 |
-| `/npm-publish` | npm 레지스트리에 패키지 배포 |
-| `/npm-version` | 시맨틱 버전 관리 |
-| `/npm-audit` | 의존성 감사 |
+| `/omcustom:monitoring-setup` | OTel 콘솔 모니터링 활성화/비활성화 |
+| `/omcustom:npm-publish` | npm 레지스트리에 패키지 배포 |
+| `/omcustom:npm-version` | 시맨틱 버전 관리 |
+| `/omcustom:npm-audit` | 의존성 감사 |
 | `/codex-exec` | Codex CLI 프롬프트 실행 |
 | `/optimize-analyze` | 번들 및 성능 분석 |
 | `/optimize-bundle` | 번들 크기 최적화 |
 | `/optimize-report` | 최적화 리포트 생성 |
 | `/research` | 10-team 병렬 딥 분석 및 교차 검증 |
 | `/deep-plan` | 연구 검증 기반 계획 수립 (research → plan → verify) |
-| `/sauron-watch` | 전체 R017 검증 |
+| `/omcustom:sauron-watch` | 전체 R017 검증 |
 | `/structured-dev-cycle` | 6단계 구조적 개발 사이클 (Plan → Verify → Implement → Verify → Compound → Done) |
-| `/lists` | 모든 사용 가능한 커맨드 표시 |
-| `/status` | 시스템 상태 표시 |
-| `/help` | 도움말 표시 |
+| `/omcustom:lists` | 모든 사용 가능한 커맨드 표시 |
+| `/omcustom:status` | 시스템 상태 표시 |
+| `/omcustom:help` | 도움말 표시 |
 
 ## 프로젝트 구조
 
@@ -184,7 +184,7 @@ project/
 +-- CLAUDE.md                    # 진입점
 +-- .claude/
 |   +-- agents/                  # 서브에이전트 정의 (44 파일)
-|   +-- skills/                  # 스킬 (70 디렉토리)
+|   +-- skills/                  # 스킬 (71 디렉토리)
 |   +-- rules/                   # 전역 규칙 (R000-R019)
 |   +-- hooks/                   # 훅 스크립트 (메모리, HUD)
 |   +-- contexts/                # 컨텍스트 파일 (ecomode)
@@ -250,15 +250,15 @@ Claude Code의 Agent Teams 기능이 활성화되어 있으면 (`CLAUDE_CODE_EXP
 
 ```bash
 # 프로젝트 분석
-/analysis
+/omcustom:analysis
 
 # 모든 커맨드 표시
-/lists
+/omcustom:lists
 
 # 에이전트 관리
-/create-agent my-agent
-/update-docs
-/audit-agents
+/omcustom:create-agent my-agent
+/omcustom:update-docs
+/omcustom:audit-agents
 
 # 코드 리뷰
 /dev-review src/main.go
@@ -268,7 +268,7 @@ Claude Code의 Agent Teams 기능이 활성화되어 있으면 (`CLAUDE_CODE_EXP
 /memory-recall authentication
 
 # 검증
-/sauron-watch
+/omcustom:sauron-watch
 ```
 
 ## 외부 의존성

package/templates/guides/claude-code/12-workflow-patterns.md

@@ -0,0 +1,182 @@
+# 워크플로우 패턴
+
+AI 에이전트 작업에 적합한 워크플로우 패턴 선택 가이드
+
+## 패턴 분류
+
+### 1. 순차 체인 (Sequential Chain)
+
+**사용 시점**: 각 단계가 이전 출력에 의존하는 순서대로 실행해야 할 때
+**프리미티브**: dag-orchestration (선형 모드)
+**예시**: 입력 파싱 → 변환 → 검증 → 출력
+
+```
+[단계 1] 입력 파싱
+    ↓
+[단계 2] 데이터 변환
+    ↓
+[단계 3] 결과 검증
+    ↓
+[단계 4] 출력 생성
+```
+
+**적합한 경우**:
+- 이전 단계 결과가 다음 단계 입력이 될 때
+- 실패 시 롤백이 필요한 다단계 배포
+- 순서가 보장되어야 하는 데이터 파이프라인
+
+### 2. 병렬 팬아웃 (Parallel Fan-Out)
+
+**사용 시점**: 공유 상태가 없는 독립적인 하위 작업들
+**프리미티브**: Agent 도구 (R009) 또는 Agent Teams (R018)
+**예시**: 4개 파일 동시 리뷰, 10개 주제 병렬 리서치
+
+```
+                [오케스트레이터]
+               /       |        \
+    [에이전트 1] [에이전트 2] [에이전트 3]
+               \       |        /
+                [결과 집계]
+```
+
+**적합한 경우**:
+- 파일 간 의존성이 없는 멀티파일 코드 리뷰
+- 여러 주제의 병렬 리서치
+- 독립적인 컴포넌트 생성
+
+**에이전트 수에 따른 선택**:
+
+| 에이전트 수 | 권장 방법 |
+|------------|---------|
+| 1-2개 | Agent 도구 (R009) |
+| 3개 이상 | Agent Teams (R018) |
+| 리뷰 사이클 포함 | Agent Teams (R018) |
+
+### 3. 평가자-최적화기 (Evaluator-Optimizer)
+
+**사용 시점**: 반복적인 개선이 필요한 품질 중요 출력
+**프리미티브**: worker-reviewer-pipeline, evaluator-optimizer
+**예시**: 코드 리뷰 → 수정 → 재리뷰 사이클
+
+```
+[구현자] → 초안 생성
+    ↓
+[리뷰어] → 이슈 발견
+    ↓
+[구현자] → 수정 적용
+    ↓
+[리뷰어] → 품질 검증 통과?
+    ├─ NO  → 재수정 (max_iterations 까지)
+    └─ YES → 완료
+```
+
+**적합한 경우**:
+- 품질 기준이 명확한 코드 생성
+- 문서 초안 작성 및 개선
+- 반복적인 검증이 필요한 설계 결정
+
+**필수 설정**: `max_iterations` 항상 지정 (무한 루프 방지)
+
+### 4. 오케스트레이터-워커 (Orchestrator-Workers)
+
+**사용 시점**: 중간 결과에 따라 동적 라우팅이 필요한 복잡한 다단계 작업
+**프리미티브**: 라우팅 스킬 (secretary/dev-lead/de-lead/qa-lead)
+**예시**: 사용자 요청 → 의도 감지 → 전문가 라우팅 → 결과 집계
+
+```
+[사용자 요청]
+    ↓
+[오케스트레이터]
+    ├─ secretary-routing → mgr-*, sys-*
+    ├─ dev-lead-routing  → lang-*, be-*, fe-*
+    ├─ de-lead-routing   → de-*
+    └─ qa-lead-routing   → qa-*
+         ↓
+[전문가 에이전트 실행]
+    ↓
+[결과 집계 → 사용자]
+```
+
+**적합한 경우**:
+- 도메인 전문 지식이 필요한 작업
+- 사전에 필요한 에이전트를 알 수 없는 동적 작업
+- 여러 전문 분야에 걸친 복합 작업
+
+## 패턴 선택 결정 트리
+
+```
+작업 수신
+├── 단일 단계, 반복 불필요?
+│   └── YES → 직접 실행 (패턴 불필요)
+├── 독립적인 하위 작업 여러 개?
+│   ├── YES, 1-2 에이전트 → 병렬 팬아웃 (Agent 도구)
+│   └── YES, 3+ 에이전트 → 병렬 팬아웃 (Agent Teams)
+├── 품질 중요 출력?
+│   └── YES → 평가자-최적화기
+├── 단계들이 서로 의존?
+│   ├── 선형 의존 → 순차 체인
+│   └── 복잡한 의존 → 오케스트레이터-워커
+└── 동적 라우팅 필요?
+    └── YES → 오케스트레이터-워커
+```
+
+## 패턴 조합
+
+복잡한 작업은 여러 패턴을 조합하여 구성할 수 있습니다.
+
+| 조합 | 예시 |
+|------|------|
+| 병렬 + 평가자-최적화기 | 여러 파일 리뷰, 각각에 리뷰 사이클 적용 |
+| 순차 + 병렬 | 파싱 → 병렬 처리 팬아웃 → 집계 |
+| 오케스트레이터 + 평가자-최적화기 | 전문가 라우팅 → 전문가가 리뷰 사이클 사용 |
+| 병렬 + 순차 | 독립 리서치 팀 → 순차 보고서 합성 |
+
+## 안티패턴
+
+| 안티패턴 | 문제점 | 수정 방법 |
+|----------|--------|----------|
+| 병렬화 가능한 작업을 순차 실행 | 시간 낭비 | R009 독립성 기준 확인 |
+| 단순 쿼리에 10팀 리서치 적용 | 과도한 토큰 소비 | research "사용 금지 시점" 확인 |
+| 종료 기준 없는 평가자-최적화기 루프 | 무한 반복 위험 | 항상 max_iterations 설정 |
+| 결과 집계 없는 병렬 실행 | 결과 손실 | result-aggregation 스킬 사용 |
+| 전문가가 있는데 general-purpose 사용 | 품질 저하 | R010 위임 규칙 확인 |
+| 오케스트레이터가 직접 파일 수정 | R010 위반 | 전문 에이전트에 위임 |
+
+## 비용 고려사항
+
+| 패턴 | 상대 비용 | 적합한 시점 |
+|------|----------|------------|
+| 직접 실행 | $ | 단순 작업 |
+| 순차 체인 | $$ | 의존적인 단계들 |
+| 병렬 (2-4 에이전트) | $$$ | 시간 중요 독립 작업 |
+| 평가자-최적화기 (3-5회 반복) | $$$$ | 품질 중요 결과물 |
+| 전체 리서치 (10팀) | $$$$$ | 포괄적 커버리지가 필요한 복잡한 분석 |
+
+### 비용 최적화 원칙
+
+```
+탐색 → haiku  (파일 검색, 구조 파악)
+구현 → sonnet (코딩, 문서 작성)
+판단 → opus   (아키텍처 결정, 복잡한 리뷰)
+```
+
+## oh-my-customcode 패턴 매핑
+
+| 패턴 | oh-my-customcode 프리미티브 | 규칙 |
+|------|---------------------------|------|
+| 순차 체인 | dag-orchestration (linear) | R010 |
+| 병렬 팬아웃 (소규모) | Agent 도구 | R009 |
+| 병렬 팬아웃 (대규모) | Agent Teams | R018 |
+| 평가자-최적화기 | worker-reviewer-pipeline | R009, R018 |
+| 오케스트레이터-워커 | Routing 스킬 | R010, R015 |
+| 리서치 | /research (10팀 병렬) | R009, R018 |
+| 계획 수립 | /deep-plan (research → plan → verify) | R009, R018 |
+
+## 참고 문서
+
+- R009: Parallel Execution Rules
+- R010: Orchestrator Coordination Rules
+- R018: Agent Teams Rules
+- `.claude/skills/dag-orchestration/SKILL.md`
+- `.claude/skills/worker-reviewer-pipeline/SKILL.md`
+- `.claude/skills/task-decomposition/SKILL.md`

package/templates/manifest.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.33.1",
-  "lastUpdated": "2026-03-13T00:00:00.000Z",
+  "version": "0.34.0",
+  "lastUpdated": "2026-03-14T00:00:00.000Z",
   "components": [
     {
       "name": "rules",
@@ -18,7 +18,7 @@
       "name": "skills",
       "path": ".claude/skills",
       "description": "Reusable skill modules (includes slash commands)",
-      "files": 70
+      "files": 71
     },
     {
       "name": "guides",