oh-my-customcode 0.80.0 → 0.82.0

package/templates/.github/workflows/wiki-sync.yml

@@ -0,0 +1,132 @@
+name: Wiki Sync
+
+on:
+  push:
+    branches:
+      - develop
+    paths:
+      - '.claude/agents/**'
+      - '.claude/skills/**'
+      - '.claude/rules/**'
+      - 'guides/**'
+      - 'wiki/**'
+  pull_request:
+    branches:
+      - develop
+    paths:
+      - '.claude/agents/**'
+      - '.claude/skills/**'
+      - '.claude/rules/**'
+      - 'guides/**'
+      - 'wiki/**'
+
+concurrency:
+  group: wiki-sync-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  wiki-staleness-check:
+    name: Wiki Staleness Check
+    runs-on: macos-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - name: Check wiki directory exists
+        run: |
+          if [ ! -d "wiki" ]; then
+            echo "::error::wiki/ directory does not exist"
+            echo ""
+            echo "The wiki/ directory is required for this project."
+            echo "Fix: run '/omcustom:wiki' to generate the initial wiki"
+            exit 1
+          fi
+
+      - name: Check for missing wiki pages
+        run: |
+          #!/bin/bash
+          ERRORS=0
+          STALE=0
+          MISSING=0
+
+          # Check agents
+          for src in .claude/agents/*.md; do
+            name=$(basename "$src" .md)
+            wiki_page="wiki/agents/${name}.md"
+            if [ ! -f "$wiki_page" ]; then
+              echo "::error::Missing wiki page: $wiki_page (source: $src)"
+              MISSING=$((MISSING + 1))
+              ERRORS=$((ERRORS + 1))
+            fi
+          done
+
+          # Check skills
+          for src in $(find .claude/skills -name "SKILL.md"); do
+            name=$(basename $(dirname "$src"))
+            wiki_page="wiki/skills/${name}.md"
+            if [ ! -f "$wiki_page" ]; then
+              echo "::error::Missing wiki page: $wiki_page (source: $src)"
+              MISSING=$((MISSING + 1))
+              ERRORS=$((ERRORS + 1))
+            fi
+          done
+
+          # Check rules
+          for src in .claude/rules/*.md; do
+            # Extract rule ID (R000, R007, etc.) from content
+            rule_id=$(grep -oE 'ID\*\*: R[0-9]+' "$src" | grep -oE '[0-9]+' | head -1)
+            if [ -n "$rule_id" ]; then
+              wiki_page="wiki/rules/r$(printf '%03d' "$((10#$rule_id))").md"
+              if [ ! -f "$wiki_page" ]; then
+                echo "::error::Missing wiki page: $wiki_page (source: $src)"
+                MISSING=$((MISSING + 1))
+                ERRORS=$((ERRORS + 1))
+              fi
+            fi
+          done
+
+          # Check guides
+          for src in $(find guides -mindepth 1 -maxdepth 1 -type d); do
+            name=$(basename "$src")
+            wiki_page="wiki/guides/${name}.md"
+            if [ ! -f "$wiki_page" ]; then
+              echo "::error::Missing wiki page: $wiki_page (source: $src)"
+              MISSING=$((MISSING + 1))
+              ERRORS=$((ERRORS + 1))
+            fi
+          done
+
+          # Check index.md exists
+          if [ ! -f "wiki/index.yaml" ]; then
+            echo "::error::Missing wiki/index.yaml"
+            ERRORS=$((ERRORS + 1))
+          fi
+
+          # Summary
+          TOTAL_WIKI=$(find wiki -name "*.md" ! -name "index.md" ! -name "log.md" 2>/dev/null | wc -l | tr -d ' ')
+          echo "Wiki pages: $TOTAL_WIKI"
+          echo "Missing pages: $MISSING"
+
+          if [ "$ERRORS" -gt 0 ]; then
+            echo ""
+            echo "Fix: run '/omcustom:wiki' to regenerate wiki pages"
+            exit 1
+          fi
+
+          echo "Wiki sync check passed"
+
+      - name: Report results
+        if: success()
+        run: |
+          TOTAL_AGENTS=$(ls .claude/agents/*.md 2>/dev/null | wc -l | tr -d ' ')
+          TOTAL_SKILLS=$(find .claude/skills -name "SKILL.md" 2>/dev/null | wc -l | tr -d ' ')
+          TOTAL_RULES=$(ls .claude/rules/*.md 2>/dev/null | wc -l | tr -d ' ')
+          TOTAL_GUIDES=$(find guides -mindepth 1 -maxdepth 1 -type d 2>/dev/null | wc -l | tr -d ' ')
+          TOTAL_WIKI=$(find wiki -name "*.md" ! -name "index.md" ! -name "log.md" 2>/dev/null | wc -l | tr -d ' ')
+
+          echo "Source entities: agents=$TOTAL_AGENTS skills=$TOTAL_SKILLS rules=$TOTAL_RULES guides=$TOTAL_GUIDES"
+          echo "Wiki pages: $TOTAL_WIKI"
+          echo "All wiki pages present — sync OK"

package/templates/CLAUDE.md

@@ -84,6 +84,7 @@ oh-my-customcode로 구동됩니다.
 | R012 | HUD 상태줄 | 실시간 상태 표시 |
 | R013 | Ecomode | 배치 작업 토큰 효율성 |
 | R019 | Ontology-RAG 라우팅 | 라우팅 스킬의 ontology-RAG enrichment |
+| R022 | Wiki 동기화 | 에이전트/스킬/룰/가이드 변경 시 위키 자동 동기화 |
 
 ### MAY (선택)
 | ID | 규칙 | 설명 |
@@ -104,7 +105,10 @@ oh-my-customcode로 구동됩니다.
 | `/omcustom:fix-refs` | 깨진 참조 수정 |
 | `/omcustom:harness-eval` | 15 SE task 구조적 벤치마크 평가 |
 | `/omcustom:auto-improve` | 개선 사항 자동 적용 워크플로우 |
+| `/omcustom:adaptive-harness` | 프로젝트 컨텍스트 기반 하네스 자동 최적화 |
 | `/omcustom:claude-native` | Claude Code 릴리즈 모니터링 및 이슈 자동 생성 |
+| `/omcustom:wiki` | 코드베이스 위키 생성/유지 (Karpathy LLM Wiki 패턴) |
+| `/omcustom:wiki-rag` | 위키 기반 코드베이스 질의응답 (RAG) |
 | `/omcustom:improve-report` | eval-core 기반 개선 현황 리포트 |
 | `/omcustom-takeover` | 기존 에이전트/스킬에서 canonical spec 추출 |
 | `/adversarial-review` | 공격자 관점 보안 코드 리뷰 |
@@ -128,6 +132,7 @@ oh-my-customcode로 구동됩니다.
 | `/optimize-report` | 최적화 리포트 생성 |
 | `/research` | 10-team 병렬 딥 분석 및 교차 검증 |
 | `/scout` | 외부 URL 분석 및 프로젝트 적합성 평가 |
+| `/skill-extractor` | 세션 성공 패턴에서 스킬 후보 추출 |
 | `/deep-plan` | 연구 검증 기반 계획 수립 (research → plan → verify) |
 | `/deep-verify` | 다중 관점 릴리즈 품질 검증 |
 | `/professor-triage` | 이슈 교차 분석 트리아지 (omc_issue_analyzer 댓글 기반) |
@@ -151,12 +156,12 @@ oh-my-customcode로 구동됩니다.
 project/
 +-- CLAUDE.md                    # 진입점
 +-- .claude/
-|   +-- agents/                  # 서브에이전트 정의 (47 파일)
-|   +-- skills/                  # 스킬 (101 디렉토리)
-|   +-- rules/                   # 전역 규칙 (R000-R021)
+|   +-- agents/                  # 서브에이전트 정의 (48 파일)
+|   +-- skills/                  # 스킬 (104 디렉토리)
+|   +-- rules/                   # 전역 규칙 (R000-R022)
 |   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
 |   +-- contexts/                # 컨텍스트 파일 (ecomode)
-+-- guides/                      # 레퍼런스 문서 (33 토픽)
++-- guides/                      # 레퍼런스 문서 (36 토픽)
 ```
 
 ## 오케스트레이션
@@ -210,8 +215,8 @@ oh-my-customcode는 소프트웨어 컴파일과 동일한 구조를 따릅니
 | Infra Engineer | 2 | infra-docker-expert, infra-aws-expert |
 | QA Team | 3 | qa-planner, qa-writer, qa-engineer |
 | Manager | 6 | mgr-creator, mgr-updater, mgr-supplier, mgr-gitnerd, mgr-sauron, mgr-claude-code-bible |
-| System | 2 | sys-memory-keeper, sys-naggy |
-| **총계** | **47** | |
+| System | 3 | sys-memory-keeper, sys-naggy, wiki-curator |
+| **총계** | **48** | |
 
 ## Agent Teams (MUST when enabled)
 
@@ -292,4 +297,4 @@ claude-mem setup
 
 <!-- omcustom:git-workflow -->
 
-<!-- omcustom:end -->
+<!-- omcustom:end -->

package/templates/guides/agents-md-quality/README.md

@@ -0,0 +1,110 @@
+# Agent Definition Quality Standards
+
+## Overview
+
+Quality criteria for `.claude/agents/*.md` files. Adapted from ETH Zurich research on LLM-generated agent configurations, modified to fit oh-my-customcode's "create, connect, use" philosophy.
+
+## Core Principle: LLM Generation + Human Verification
+
+> ETH Zurich finding: Purely LLM-generated AGENTS.md files perform worse than human-crafted ones.
+>
+> oh-my-customcode adaptation: LLM generation is the core workflow (via mgr-creator), but **verification is mandatory**. The creation tool generates; the verification process validates.
+
+| Approach | Status |
+|----------|--------|
+| Pure LLM generation without review | Not recommended |
+| LLM generation + mgr-sauron verification | Required (current workflow) |
+| Human-crafted from scratch | Acceptable but not required |
+
+## Four-Section Structure
+
+Every agent file SHOULD contain these conceptual sections:
+
+### 1. STYLE — How the agent communicates
+
+```yaml
+# In frontmatter or body
+# - Output format preferences
+# - Verbosity level (maps to effort: low/medium/high)
+# - Language conventions
+```
+
+### 2. GOTCHAS — Known pitfalls and edge cases
+
+```markdown
+## Known Issues
+- This agent cannot handle files larger than X
+- Requires MCP server Y to be running
+- Output format changes when ecomode is active
+```
+
+### 3. ARCH_DECISIONS — Why this agent exists this way
+
+```markdown
+## Design Decisions
+- Uses sonnet (not opus) because task complexity is moderate
+- Skills X and Y are included because they cover the primary workflow
+- Memory scope is project (not user) because knowledge is repo-specific
+```
+
+### 4. TEST_STRATEGY — How to verify the agent works
+
+```markdown
+## Verification
+- Run with sample input: `Agent(subagent_type: "this-agent", prompt: "test task")`
+- Expected: output matches format X
+- Edge case: empty input should return guidance, not error
+```
+
+## Frontmatter Quality Checklist
+
+| Field | Required | Quality Check |
+|-------|----------|---------------|
+| `name` | Yes | Matches filename (kebab-case) |
+| `description` | Yes | One line, specific (not generic "handles X") |
+| `model` | Yes | Justified by task complexity |
+| `tools` | Yes | Minimal set needed (no unnecessary tools) |
+| `skills` | No | Referenced skills must exist |
+| `domain` | No | Matches actual specialization |
+| `limitations` | No | Honest about what agent cannot do |
+
+## Anti-Patterns
+
+| Anti-Pattern | Problem | Fix |
+|-------------|---------|-----|
+| Kitchen-sink tools | `tools: [Read, Write, Edit, Bash, Agent, ...]` | Minimal tool set for the role |
+| Vague description | "Handles various tasks" | Specific: "Reviews Go code for idiomatic patterns" |
+| Copy-paste body | Duplicates guide content | Reference guide, don't copy |
+| Missing limitations | Sets unrealistic expectations | Declare what agent cannot do |
+| Orphaned skill refs | References non-existent skills | mgr-supplier audit catches this |
+| Excessive instructions | 500+ line body with detailed how-to | Move details to skills, keep agent body focused |
+
+## Verification Workflow
+
+```
+mgr-creator generates agent
+  → mgr-sauron verifies (R017)
+    → Frontmatter valid?
+    → Skills exist?
+    → Tools minimal?
+    → Description specific?
+  → Human reviews (optional but recommended for complex agents)
+  → Agent deployed
+```
+
+## Quality Metrics
+
+| Metric | Target |
+|--------|--------|
+| Body length | 50-200 lines (excluding frontmatter) |
+| Tool count | 3-8 (role-appropriate) |
+| Skill references | All resolvable |
+| Description length | 10-80 characters |
+| Limitations declared | At least 1 for complex agents |
+
+## Related
+
+- R006 — Agent design rules (frontmatter format, separation of concerns)
+- R017 — Sync verification (mgr-sauron validation)
+- `mgr-creator` — Agent creation workflow
+- `mgr-supplier` — Dependency audit

package/templates/guides/index.yaml

@@ -244,3 +244,22 @@ guides:
     path: ./web-scraping/
     source:
       type: internal
+
+  # Agent Operations
+  - name: worktree-lifecycle
+    description: Worktree lifecycle automation aliases (agent-spin/merge/clean) for AI agent workflows
+    path: ./worktree-lifecycle/
+    source:
+      type: internal
+
+  - name: multi-model-routing
+    description: Role-based model selection strategy for AI agent workflows
+    path: ./multi-model-routing/
+    source:
+      type: internal
+
+  - name: agents-md-quality
+    description: Agent definition quality standards adapted from ETH Zurich research
+    path: ./agents-md-quality/
+    source:
+      type: internal

package/templates/guides/multi-model-routing/README.md

@@ -0,0 +1,101 @@
+# Multi-Model Routing
+
+## Overview
+
+Role-based model selection strategy for AI agent workflows. Consolidates model routing conventions from R006 (agent design), R008 (tool identification), and agent frontmatter into a single reference.
+
+## Model Aliases
+
+| Alias | Full ID | Cost | Speed | Use Case |
+|-------|---------|------|-------|----------|
+| `haiku` | claude-haiku-4-5 | $ | Fast | Search, simple edits, file discovery |
+| `sonnet` | claude-sonnet-4-6 | $$ | Moderate | Code generation, general tasks (default) |
+| `opus` | claude-opus-4-6 | $$$ | Slower | Complex reasoning, architecture, planning |
+| `opusplan` | claude-opus-4-6 + plan mode | $$$ | Slower | Architecture with approval gates |
+
+Extended context: `[1m]` suffix enables 1M token context (e.g., `claude-opus-4-6[1m]`).
+
+## Role-Based Routing Table
+
+| Role | Recommended Model | Rationale |
+|------|------------------|-----------|
+| Code search / file discovery | haiku | Fast, cheap, sufficient for retrieval |
+| Code review | sonnet | Needs understanding, not deep reasoning |
+| Code generation | sonnet | Good balance of quality and speed |
+| Bug fix (simple) | sonnet | Pattern recognition sufficient |
+| Bug fix (complex) | opus | Needs deep reasoning across modules |
+| Architecture design | opus / opusplan | Requires holistic thinking |
+| Test generation | sonnet | Template-driven, moderate complexity |
+| Documentation | sonnet | Straightforward generation |
+| Release verification | opus | Cross-cutting validation |
+| Orchestration | opus | Routing decisions need broad context |
+
+## Cost-Quality Tradeoff Matrix
+
+```
+Quality ▲
+        │  ┌─────────┐
+        │  │  opus    │ Complex reasoning
+        │  └────┬────┘
+        │       │
+        │  ┌────┴────┐
+        │  │ sonnet   │ General purpose (default)
+        │  └────┬────┘
+        │       │
+        │  ┌────┴────┐
+        │  │  haiku   │ Retrieval, simple tasks
+        │  └─────────┘
+        └──────────────────────► Cost
+```
+
+## MODEL_ROUTING.md Convention
+
+Projects can declare a `MODEL_ROUTING.md` file to override default routing:
+
+```markdown
+# Model Routing
+
+| Agent Pattern | Model | Override Reason |
+|---------------|-------|-----------------|
+| lang-*-expert | sonnet | Default sufficient for code generation |
+| mgr-sauron | opus | Verification requires deep analysis |
+| Explore | haiku | Search-only, no generation needed |
+```
+
+Place in project root or `.claude/` directory.
+
+## Agent Frontmatter Integration
+
+```yaml
+# .claude/agents/example.md
+name: example-agent
+model: sonnet  # Use alias from table above
+```
+
+The `model` field in agent frontmatter sets the default. The Agent tool's `model` parameter overrides at spawn time.
+
+## Escalation Pattern
+
+When a task fails at a lower model tier, escalate:
+
+```
+haiku → sonnet → opus
+```
+
+Configuration in agent frontmatter:
+```yaml
+escalation:
+  enabled: true
+  path: haiku → sonnet → opus
+  threshold: 2  # failures before escalation advisory
+```
+
+## Fast Mode Interaction
+
+Fast Mode (`/fast` toggle) uses the same model with faster output (~2.5x). It does NOT change the model — it reduces reasoning depth while maintaining the configured model tier.
+
+## Related
+
+- R006 — Agent design rules (model aliases, frontmatter format)
+- R008 — Tool identification (model in agent:model format)
+- `guides/skill-bundle-design/` — Skill architecture patterns

package/templates/guides/worktree-lifecycle/README.md

@@ -0,0 +1,104 @@
+# Worktree Lifecycle Automation
+
+## Overview
+
+Three shell aliases for managing git worktree lifecycle in AI agent workflows: **spin** (create), **merge** (integrate), **clean** (remove). Builds on basic worktree knowledge from `guides/git-worktree-workflow/`.
+
+## Aliases
+
+### agent-spin — Create worktree for agent work
+
+```bash
+agent-spin() {
+  local branch="$1"
+  local base="${2:-develop}"
+  local repo_name=$(basename "$(git rev-parse --show-toplevel)")
+  local worktree_dir="../${repo_name}-${branch}"
+
+  git fetch origin "$base"
+  git worktree add -b "$branch" "$worktree_dir" "origin/$base"
+  echo "Worktree ready: $worktree_dir (branch: $branch, base: $base)"
+}
+```
+
+**Usage**: `agent-spin feature/session-autofix develop`
+
+### agent-merge — Integrate worktree branch
+
+```bash
+agent-merge() {
+  local branch="$1"
+  local target="${2:-develop}"
+  local repo_name=$(basename "$(git rev-parse --show-toplevel)")
+  local worktree_dir="../${repo_name}-${branch}"
+
+  # Switch to main worktree
+  cd "$(git worktree list | head -1 | awk '{print $1}')"
+
+  git checkout "$target"
+  git merge --no-ff "$branch" -m "Merge branch '$branch' into $target"
+
+  echo "Merged $branch into $target"
+}
+```
+
+**Usage**: `agent-merge feature/session-autofix develop`
+
+### agent-clean — Remove worktree and branch
+
+```bash
+agent-clean() {
+  local branch="$1"
+  local repo_name=$(basename "$(git rev-parse --show-toplevel)")
+  local worktree_dir="../${repo_name}-${branch}"
+
+  git worktree remove "$worktree_dir" --force
+  git branch -d "$branch"
+
+  echo "Cleaned: worktree $worktree_dir, branch $branch"
+}
+```
+
+**Usage**: `agent-clean feature/session-autofix`
+
+## Setup
+
+Add to `~/.zshrc` or `~/.bashrc`:
+
+```bash
+# Agent worktree lifecycle
+source ~/dotfiles/agent-worktree.sh  # or inline the functions above
+```
+
+## Claude Code Integration
+
+Claude Code's `EnterWorktree` / `ExitWorktree` tools provide built-in worktree support for subagents. The aliases above complement this for manual or hook-driven workflows.
+
+| Method | Use Case |
+|--------|----------|
+| `EnterWorktree` tool | Agent-managed isolation (automatic) |
+| `agent-spin` alias | Manual or hook-triggered worktree creation |
+| Agent frontmatter `isolation: worktree` | Declarative per-agent isolation |
+
+## Lifecycle Flow
+
+```
+agent-spin feature/x develop
+  └── Work in isolated worktree
+      └── Tests pass
+          └── agent-merge feature/x develop
+              └── agent-clean feature/x
+```
+
+## Best Practices
+
+- Always base worktrees on `origin/develop` (not local) to avoid stale base
+- Run tests in the worktree before merge
+- Clean up worktrees promptly — orphaned worktrees accumulate disk usage
+- For CI-driven flows, `agent-clean` should be in the finally/cleanup step
+
+## Related
+
+- `guides/git-worktree-workflow/` — Basic worktree commands and directory structure
+- R006 `isolation: worktree` — Agent frontmatter isolation setting
+- Claude Code `EnterWorktree` / `ExitWorktree` — Built-in tool support

package/templates/manifest.json

@@ -1,30 +1,30 @@
 {
-  "version": "0.80.0",
-  "lastUpdated": "2026-03-24T00:00:00.000Z",
+  "version": "0.82.0",
+  "lastUpdated": "2026-04-12T00:00:00.000Z",
   "components": [
     {
       "name": "rules",
       "path": ".claude/rules",
       "description": "Agent behavior rules and guidelines",
-      "files": 21
+      "files": 22
     },
     {
       "name": "agents",
       "path": ".claude/agents",
       "description": "AI agent definitions (flat .md files with prefixes)",
-      "files": 47
+      "files": 48
     },
     {
       "name": "skills",
       "path": ".claude/skills",
       "description": "Reusable skill modules (includes slash commands)",
-      "files": 101
+      "files": 104
     },
     {
       "name": "guides",
       "path": "guides",
       "description": "Reference documentation",
-      "files": 33
+      "files": 36
     },
     {
       "name": "hooks",