oh-my-customcode 0.93.0 → 0.95.0

package/dist/cli/index.js

@@ -2334,7 +2334,7 @@ var init_package = __esm(() => {
     workspaces: [
       "packages/*"
     ],
-    version: "0.93.0",
+    version: "0.95.0",
     description: "Batteries-included agent harness for Claude Code",
     type: "module",
     bin: {

package/dist/index.js

@@ -2007,7 +2007,7 @@ var package_default = {
   workspaces: [
     "packages/*"
   ],
-  version: "0.93.0",
+  version: "0.95.0",
   description: "Batteries-included agent harness for Claude Code",
   type: "module",
   bin: {

package/package.json

@@ -3,7 +3,7 @@
   "workspaces": [
     "packages/*"
   ],
-  "version": "0.93.0",
+  "version": "0.95.0",
   "description": "Batteries-included agent harness for Claude Code",
   "type": "module",
   "bin": {

package/templates/.claude/hooks/hooks.json

@@ -317,7 +317,7 @@
         "hooks": [
           {
             "type": "prompt",
-            "prompt": "Context compacted. RULES ACTIVE.\n\nR007: next response MUST start with ┌─ Agent: claude (default) / └─ Task: {task}\nR008: before EVERY tool call → [claude][model] → Tool: Name / Target: path\nR010: write→delegate to subagent; orchestrator read-only (Read/Glob/Grep); git→mgr-gitnerd\nR009: 2+ independent tasks → parallel agents, same message\nR018: 3+ agents OR review cycle → Agent Teams\nR000: user communication in Korean (한국어); code/files in English — NON-NEGOTIABLE\n\nAutonomous mode: if /tmp/.claude-autonomous-$PPID exists → simple git (add/commit/push) may run directly; Write/Edit still delegates.\nbypassPermissions does NOT persist across compaction — re-enable if tasks seem blocked.\n\nRe-read CLAUDE.md NOW."
+            "prompt": "Context compacted. RULES ACTIVE.\n\nR007: next response MUST start with ┌─ Agent: claude (default) / └─ Task: {task}\nR008: before EVERY tool call → [claude][model] → Tool: Name / Target: path\nR010: write→delegate to subagent; orchestrator read-only (Read/Glob/Grep); git→mgr-gitnerd\nR009: 2+ independent tasks → parallel agents, same message\nR018: 3+ agents OR review cycle → Agent Teams\nR000: user communication in Korean (한국어); code/files in English — NON-NEGOTIABLE\nR001: prohibited actions (no secrets, no system files, no rm -rf); stop on violation → preserve state → report → wait\nR002: tool tiers (Read/Grep=free, Write/Edit=notify, Bash=approval); no writes outside project; no .env/.git/config\n\nAutonomous mode: if /tmp/.claude-autonomous-$PPID exists → simple git (add/commit/push) may run directly; Write/Edit still delegates.\nbypassPermissions does NOT persist across compaction — re-enable if tasks seem blocked.\n\nRe-read CLAUDE.md NOW."
           }
         ],
         "description": "Reinforce enforced rules after context compaction — prevents rule amnesia (v2.1.76+)"

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

@@ -65,11 +65,17 @@ disableSkillShellExecution: true  # Disable inline shell execution in skills (v2
 
 > **Note**: When `disableSkillShellExecution` is enabled (v2.1.91+), skills that rely on inline shell execution (e.g., `codex-exec`, `gemini-exec`, `rtk-exec`) will have their shell blocks disabled. This is a security hardening option.
 
-> **Note**: `isolation`, `background`, `maxTurns`, `maxTokens`, `mcpServers`, `hooks`, `permissionMode`, `disallowedTools`, `limitations` are supported in Claude Code v2.1.63+. Hook types `PostCompact`, `Elicitation`, `ElicitationResult` require v2.1.76+. `CwdChanged`, `FileChanged` hook events and `managed-settings.d/` drop-in directory require v2.1.83+. Conditional `if` field for hooks requires v2.1.85+. `PermissionDenied` hook event requires v2.1.88+. `refreshInterval` setting for status line auto-refresh interval added in v2.1.97+. Monitor tool and subprocess sandboxing (`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`, `CLAUDE_CODE_SCRIPT_CAPS`) added in v2.1.98+. Settings resilience (unrecognized hook event names no longer cause settings.json to be ignored) improved in v2.1.101+. PreCompact hook block support (exit 2 / `{"decision":"block"}`) added in v2.1.105+. Skill description listing cap raised from 250 to 1,536 characters in v2.1.105+. Plugin `monitors` manifest key for background monitors added in v2.1.105+. `ENABLE_PROMPT_CACHING_1H` and `FORCE_PROMPT_CACHING_5M` env vars for prompt cache TTL control added in v2.1.108+. Skill tool can now discover and invoke built-in slash commands (`/init`, `/review`, `/security-review`) in v2.1.108+. `/recap` session context feature and `/undo` alias for `/rewind` added in v2.1.108+. `/tui` command and `tui` setting for fullscreen rendering added in v2.1.110+. PushNotification tool for mobile push notifications (Remote Control + config required) added in v2.1.110+. `autoScrollEnabled` config for fullscreen mode added in v2.1.110+. SDK/headless `TRACEPARENT`/`TRACESTATE` distributed trace linking added in v2.1.110+. Bash tool maximum timeout enforcement added in v2.1.110+. Write tool IDE diff feedback (informs model when user edits proposed content) added in v2.1.110+. `--resume`/`--continue` now resurrects unexpired scheduled tasks in v2.1.110+. `/focus` command (separated from Ctrl+O) added in v2.1.110+. `xhigh` effort level for Opus 4.7 (between `high` and `max`; other models fall back to `high`) added in v2.1.111+. `/effort` interactive slider with arrow-key navigation (when called without arguments) added in v2.1.111+. Auto mode no longer requires `--enable-auto-mode` in v2.1.111+. PowerShell tool progressive rollout (`CLAUDE_CODE_USE_POWERSHELL_TOOL` env var) added in v2.1.111+. Read-only bash commands with glob patterns (`ls *.ts`) and `cd <project-dir> &&` prefix no longer trigger permission prompt in v2.1.111+. `/less-permission-prompts` built-in skill for permission allowlist scanning added in v2.1.111+. `/ultrareview` parallel multi-agent cloud code review added in v2.1.111+. `/skills` menu sorting by estimated token count (press `t`) added in v2.1.111+. `OTEL_LOG_RAW_API_BODIES` env var for full API request/response body logging added in v2.1.111+. Plan files named after prompt content (not random words) in v2.1.111+. Plugin error handling improvements (dependency conflict errors, stale version recovery, install recovery) in v2.1.111+.
+> **Note**: Optional frontmatter fields supported since CC v2.1.63+. Version-specific features listed in HTML comment below — access via Read tool.
+
+<!-- DETAIL: CC Version Compatibility History
+`isolation`, `background`, `maxTurns`, `maxTokens`, `mcpServers`, `hooks`, `permissionMode`, `disallowedTools`, `limitations` are supported in Claude Code v2.1.63+. Hook types `PostCompact`, `Elicitation`, `ElicitationResult` require v2.1.76+. `CwdChanged`, `FileChanged` hook events and `managed-settings.d/` drop-in directory require v2.1.83+. Conditional `if` field for hooks requires v2.1.85+. `PermissionDenied` hook event requires v2.1.88+. `refreshInterval` setting for status line auto-refresh interval added in v2.1.97+. Monitor tool and subprocess sandboxing (`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`, `CLAUDE_CODE_SCRIPT_CAPS`) added in v2.1.98+. Settings resilience (unrecognized hook event names no longer cause settings.json to be ignored) improved in v2.1.101+. PreCompact hook block support (exit 2 / `{"decision":"block"}`) added in v2.1.105+. Skill description listing cap raised from 250 to 1,536 characters in v2.1.105+. Plugin `monitors` manifest key for background monitors added in v2.1.105+. `ENABLE_PROMPT_CACHING_1H` and `FORCE_PROMPT_CACHING_5M` env vars for prompt cache TTL control added in v2.1.108+. Skill tool can now discover and invoke built-in slash commands (`/init`, `/review`, `/security-review`) in v2.1.108+. `/recap` session context feature and `/undo` alias for `/rewind` added in v2.1.108+. `/tui` command and `tui` setting for fullscreen rendering added in v2.1.110+. PushNotification tool for mobile push notifications (Remote Control + config required) added in v2.1.110+. `autoScrollEnabled` config for fullscreen mode added in v2.1.110+. SDK/headless `TRACEPARENT`/`TRACESTATE` distributed trace linking added in v2.1.110+. Bash tool maximum timeout enforcement added in v2.1.110+. Write tool IDE diff feedback (informs model when user edits proposed content) added in v2.1.110+. `--resume`/`--continue` now resurrects unexpired scheduled tasks in v2.1.110+. `/focus` command (separated from Ctrl+O) added in v2.1.110+. `xhigh` effort level for Opus 4.7 (between `high` and `max`; other models fall back to `high`) added in v2.1.111+. `/effort` interactive slider with arrow-key navigation (when called without arguments) added in v2.1.111+. Auto mode no longer requires `--enable-auto-mode` in v2.1.111+. PowerShell tool progressive rollout (`CLAUDE_CODE_USE_POWERSHELL_TOOL` env var) added in v2.1.111+. Read-only bash commands with glob patterns (`ls *.ts`) and `cd <project-dir> &&` prefix no longer trigger permission prompt in v2.1.111+. `/less-permission-prompts` built-in skill for permission allowlist scanning added in v2.1.111+. `/ultrareview` parallel multi-agent cloud code review added in v2.1.111+. `/skills` menu sorting by estimated token count (press `t`) added in v2.1.111+. `OTEL_LOG_RAW_API_BODIES` env var for full API request/response body logging added in v2.1.111+. Plan files named after prompt content (not random words) in v2.1.111+. Plugin error handling improvements (dependency conflict errors, stale version recovery, install recovery) in v2.1.111+.
+-->
 
 ## Hook Event Types
 
-All supported hook event types in Claude Code. Agents and skills can reference these in `hooks:` frontmatter.
+20 event types supported: PreToolUse, PostToolUse, PreCompact, PostCompact, Stop, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit, Notification, CwdChanged, FileChanged, Elicitation, ElicitationResult, PostMessage, PermissionDenied, TeammateIdle, TaskCreated, TaskCompleted. 4 handler types: command, prompt, http, agent. See full reference table via Read tool.
+
+<!-- DETAIL: Hook Event Types Full Reference
 
 | Event | Trigger | Data Available | Handler Types | CC Version |
 |-------|---------|---------------|---------------|------------|
@@ -137,6 +143,7 @@ hooks:
 ```
 
 > **v2.1.85+**: `if` field supports permission rule syntax for conditional hook execution. **v2.1.88** extended `if` matching to support compound commands (`ls && git push`) and commands with env-var prefixes (`FOO=bar git push`).
+-->
 
 ## Permission Mode Guidance
 

package/templates/.claude/rules/MUST-completion-verification.md

@@ -28,7 +28,9 @@ Before [Done]: (1) Verify ACTUAL outcome not just attempt — "ran command" ≠
 4. Would I bet $100 this is truly complete? YES: Declare [Done] / NO: Identify uncertain and verify
 -->
 
-## Subagent Self-Report Verification
+## Subagent Self-Report Verification — Verify "pre-existing" claims against base branch before acceptance. See details via Read tool.
+
+<!-- DETAIL: Subagent Self-Report Verification
 
 Subagents often report failures as "pre-existing", "baseline", or "unchanged". These claims MUST be verified against the base branch before acceptance.
 
@@ -40,8 +42,11 @@ Subagents often report failures as "pre-existing", "baseline", or "unchanged". T
 | "Dependency issue not from this PR" | `git show {base}:package.json` compare |
 
 Never accept "pre-existing" without direct base-branch evidence. A false "pre-existing" claim can mask a regression introduced by the current change.
+-->
 
-## Common False Completion Patterns
+## Common False Completion Patterns — 7 anti-patterns including "Command executed" without exit code check, "Waiting for manual publish" when CI auto-publishes. See full table via Read tool.
+
+<!-- DETAIL: Common False Completion Patterns
 
 | Pattern | Reality | Fix |
 |---------|---------|-----|
@@ -52,8 +57,11 @@ Never accept "pre-existing" without direct base-branch evidence. A false "pre-ex
 | "Tests pass" | Only ran subset | Run full test suite |
 | "Waiting for manual publish" | External CI/CD auto-publishes on merge | Check `.github/workflows/` BEFORE assuming manual step |
 | "Subagent said pre-existing" | Claim not verified against base branch | Run test on base branch, compare directly |
+-->
 
-## Completion Contract Format
+## Completion Contract Format — [Contract] + [Done] with criterion/evidence pairs. See template via Read tool.
+
+<!-- DETAIL: Completion Contract Format
 
 For complex tasks, declare completion contract upfront:
 
@@ -72,8 +80,11 @@ Then at completion:
 ├── ✓ Criterion 2: {evidence}
 └── ✓ Criterion N: {evidence}
 ```
+-->
 
-## Autonomous Mode Entry Checklist
+## Autonomous Mode Entry Checklist — 5-step inventory (workflows, runs, publish targets, manual points, cross-reference). See full checklist via Read tool.
+
+<!-- DETAIL: Autonomous Mode Entry Checklist
 
 When entering autonomous mode (user grants extended execution without per-step confirmation), perform this inventory BEFORE first action:
 
@@ -90,6 +101,7 @@ Record findings in session context. Failure to inventory automation is a R020 vi
 Related memory records:
 - `feedback_github_workflows_inventory.md` — original incident (v0.87.2~v0.88.0 session)
 - `feedback_subagent_pre_existing_claims.md` — subagent false-positive pattern
+-->
 
 ## Integration
 

package/templates/.claude/rules/MUST-continuous-improvement.md

@@ -48,18 +48,22 @@ When repeating agent failures or suboptimal routing is detected:
 
 This connects R016's continuous improvement loop with the adaptive-harness skill's learning capability.
 
-## Anti-Patterns
+## Anti-Patterns — 4 patterns: "I'll update later", "one-time exception", "doesn't cover this", "finish task first". See table via Read tool.
 
+<!-- DETAIL: Anti-Patterns
 | Anti-Pattern | Why It's Wrong | Correct Action |
 |-------------|----------------|----------------|
 | "I'll update the rule later" | Deferred fixes are forgotten | Update rule NOW, before continuing |
 | "This is a one-time exception" | Exceptions become patterns | If the rule is wrong, fix it; if it's right, follow it |
 | "The rule doesn't cover this case" | Missing coverage = rule gap | Add the case to the rule immediately |
 | "Let me finish the task first" | Rule violations compound | Fix rule first (5 min), then continue (prevents N future violations) |
+-->
 
-## Timing
+## Timing — Rule updates MUST happen before continuing original task, in the same session.
 
+<!-- DETAIL: Timing
 Rule updates MUST happen:
 - **Before** continuing the original task
 - **In the same session** as the violation
 - **Not** as a separate TODO or follow-up issue
+-->

package/templates/.claude/rules/MUST-enforcement-policy.md

@@ -22,8 +22,9 @@ oh-my-customcode uses an **advisory-first enforcement model**. Most rules are en
 3. **Composability**: External skills and internal rules can coexist without deadlocks
 4. **PostCompact reinforcement**: R007/R008/R009/R010/R018 are re-injected after context compaction
 
-## Hard Enforcement Candidates (Future)
+## Hard Enforcement Candidates — R010 git-delegation-guard (conditional), R007/R008 (conditional). Promoted: rule-deletion-guard.sh (2026-04-08). See details via Read tool.
 
+<!-- DETAIL: Hard Enforcement Candidates (Future)
 If advisory enforcement proves insufficient for specific rules, these are candidates for promotion to hard-block:
 
 | Rule | Candidate Hook | Condition for Promotion |
@@ -38,6 +39,7 @@ Promotion requires: (1) measured violation rate data, (2) user approval, (3) rol
 | Hook | Date | Justification |
 |------|------|---------------|
 | `rule-deletion-guard.sh` | 2026-04-08 | User-requested: rule files must require individual confirmation before deletion. Prevents accidental bulk deletion of project rules. |
+-->
 
 ## Integration
 

package/templates/.claude/rules/MUST-intent-transparency.md

@@ -24,21 +24,24 @@ Display reasoning when routing to agents. Users must always know which agent was
 | 70-89% | Request confirmation, show alternatives |
 | < 70% | List options for user to choose |
 
-## Detection Factors
+## Detection Factors — Weights: Keywords 40%, File patterns 30%, Action verbs 20%, Context 10%. See table via Read tool.
 
+<!-- DETAIL: Detection Factors
 | Factor | Weight | Examples |
 |--------|--------|---------|
 | Keywords | 40% | "Go", "Python", "리뷰" |
 | File patterns | 30% | "*.go", "main.py" |
 | Action verbs | 20% | "review", "create", "fix" |
 | Context | 10% | Previous agent, working directory |
+-->
 
 ## Override
 
 Users can specify agent directly with `@{agent-name} {command}`. Override bypasses detection.
 
-## User Directive Persistence
+## User Directive Persistence — Named tool/skill/workflow preferences persist entire session. Anti-pattern: treating autonomous mode as clean slate. See full spec via Read tool.
 
+<!-- DETAIL: User Directive Persistence
 When a user explicitly names a tool, skill, or workflow (e.g., "use /pipeline auto-dev", "always run tests with bun test"), this preference persists for the entire session — including after autonomous mode transitions.
 
 ### Persistence Triggers
@@ -64,6 +67,7 @@ At the start of every work cycle (issue, task, release, or autonomous sub-loop):
 ### Cross-reference
 
 - Related memory: session v0.87.2~v0.88.0 (issue #869) — `/pipeline auto-dev` preference was lost after autonomous mode transition
+-->
 
 ## Agent Triggers
 

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

@@ -92,6 +92,12 @@ Key violations to avoid (file writes, git commands, bundled operations — all m
 
 ✓ CORRECT: Orchestrator delegates to specialist
    Main conversation → Agent(lang-golang-expert) → Write("src/main.go", content)
+
+❌ WRONG: External skill creates agent/skill/guide via general-purpose agent
+   Skill(brainstorming) → Agent(general-purpose) → Write(".claude/agents/new.md")
+
+✓ CORRECT: Agent/skill/guide creation routed through mgr-creator
+   Skill(brainstorming) → Agent(mgr-creator) → Write(".claude/agents/new.md")
 ```
 
 <!-- DETAIL: Common Violations (extended)
@@ -127,6 +133,17 @@ Key violations to avoid (file writes, git commands, bundled operations — all m
 ✓ CORRECT: Orchestrator delegates to infrastructure specialist
    Main conversation → Agent(infra-docker-expert) → docker compose restart
    Main conversation → Agent(infra-docker-expert) → deploy files to server
+
+❌ WRONG: External skill creates agent/skill/guide via general-purpose agent
+   Skill(brainstorming) → Agent(general-purpose) → Write(".claude/agents/new-agent.md")
+   Skill(any-skill) → Agent(general-purpose) → Write(".claude/skills/new-skill/SKILL.md")
+
+✓ CORRECT: Agent/skill/guide creation always routed through mgr-creator
+   Skill(brainstorming) → Agent(mgr-creator) → Write(".claude/agents/new-agent.md")
+   Skill(any-skill) → Agent(mgr-creator) → Write(".claude/skills/new-skill/SKILL.md")
+
+   The skill defines WHAT to create; mgr-creator handles HOW (R006 validation,
+   skill auto-discovery, frontmatter integrity).
 ```
 -->
 
@@ -219,6 +236,8 @@ After restart/compaction: re-read CLAUDE.md, all delegation rules still apply. N
 | Task Type | Required Agent |
 |-----------|---------------|
 | Create agent | mgr-creator |
+| Create skill | mgr-creator |
+| Create guide | mgr-creator (structure) / arch-documenter (content) |
 | Update external | mgr-updater |
 | Audit dependencies | mgr-supplier |
 | Git operations | mgr-gitnerd |
@@ -243,6 +262,31 @@ After restart/compaction: re-read CLAUDE.md, all delegation rules still apply. N
 - general-purpose only for truly generic tasks (file moves, simple scripts)
 - No exceptions for "small" or "quick" changes
 
+### Protected Paths (mgr-creator Required)
+
+The following paths MUST be created or structurally modified ONLY through `mgr-creator`:
+
+| Path Pattern | Scope | Reason |
+|-------------|-------|--------|
+| `.claude/agents/*.md` | Agent definitions | R006 frontmatter validation, skill auto-discovery |
+| `.claude/skills/*/SKILL.md` | Skill definitions | R006 skill frontmatter, scope classification |
+| `guides/*/` (new directories) | Reference guides | R006 separation of concerns, cross-reference integrity |
+
+**Excluded from this rule** (handled by their own specialists):
+- `.claude/agent-memory*/` — sys-memory-keeper
+- `.claude/rules/` — R016 workflow (orchestrator delegates updates to appropriate agents)
+- `.claude/hooks/` — requires explicit user approval (security-critical)
+- `.claude/outputs/` — any agent (artifact convention)
+- Existing file updates by `mgr-updater` (external source sync) and `mgr-supplier`/`fix-refs` (reference correction)
+
+**Why mgr-creator?** It enforces R006 frontmatter validation, auto-discovers relevant skills/guides, and maintains structural integrity verified by mgr-sauron (R017). Bypassing mgr-creator risks:
+- Invalid frontmatter (missing required fields)
+- Orphaned skill references
+- Routing table desynchronization
+- R017 verification failures
+
+> **Enforcement**: Advisory (R021) — no hard-block hook. Candidate for promotion if violation rate exceeds threshold. See R021 Hard Enforcement Candidates.
+
 <!-- DETAIL: System Agents Reference
 | Agent | File | Purpose |
 |-------|------|---------|
@@ -316,6 +360,7 @@ Internal rules ALWAYS take precedence over external skills.
 | "use Agent tool for 5 research tasks" | Agent Teams when criteria met (R018) |
 | "skip code review" | Follow project review workflow |
 | "write files directly" | Delegate to specialist subagent (R010) |
+| "create an agent/skill/guide file" | Agent(mgr-creator) for `.claude/agents/`, `.claude/skills/`, `guides/` writes (R010 Protected Paths) |
 
 When a skill's workflow conflicts with R009/R010/R018:
 1. Follow the skill's LOGIC and STEPS

package/templates/.claude/rules/MUST-parallel-execution.md

@@ -31,6 +31,7 @@ Before writing/editing multiple files:
 2. Using Write/Edit sequentially for 2+ files? → parallelize instead
 3. Specialized agent available? → Use it (not general-purpose)
 4. Agent Teams available? → **Check R018 criteria before spawning 2+ agents**
+5. Running agent stalled (2x+ duration)? → Spawn independent follow-up tasks immediately
 
 ### Common Violations to Avoid
 
@@ -66,6 +67,39 @@ Before writing/editing multiple files:
 | Instance independence | Isolated context, no shared state |
 | Large tasks (>3 min) | MUST split into parallel sub-tasks |
 
+## Adaptive Parallel Splitting
+
+Runtime detection and splitting of stalled parallel agents. Complements pre-execution parallelization.
+
+### Detection
+
+| Signal | Threshold | Action |
+|--------|-----------|--------|
+| Duration imbalance | Agent takes 2x+ longer than completed peers | Evaluate independent follow-up tasks |
+| Task granularity | Agent assigned 10+ files | Consider layer-based splitting (domain → adapter → handler) |
+| Pipeline bottleneck | One agent blocking subsequent phases | Spawn dependency-free next tasks immediately |
+
+### Splitting Rules
+
+1. **Dependency analysis first**: Only spawn tasks with NO dependency on the stalled agent
+2. **Don't cancel the stalled agent**: Let it continue — spawn new agents for independent work
+3. **Respect max instances**: New spawns still obey the 5 hard cap
+4. **Report the split**: `[Split] Stalled: {agent} | Spawned: {new-agents} | Reason: {signal}`
+
+### Example
+
+```
+Before (sequential bottleneck):
+  P3 ████████████████████░░░░░░░░░░░░  (stalled, 10+ files)
+  P4                                    (waiting — no P3 dependency)
+  P5                                    (waiting — no P3 dependency)
+
+After (adaptive split):
+  P3 ████████████████████████████████  (continuing)
+  P4 ████████████████████████████████  (spawned immediately)
+  P5 ████████████████████████████████  (spawned immediately)
+```
+
 ## Stability Testing Protocol
 
 When testing 5 concurrent agents (above the soft default of 4):
@@ -96,6 +130,26 @@ Must use `[N] {subagent_type}:{model}` format. `[N]` is 1-indexed and MUST match
 
 Single agent spawns do NOT use the `[N]` prefix.
 
+## Narrative Announcement Format (Before Spawn)
+
+When announcing a parallel dispatch in prose text (not the Agent tool call itself), use a markdown list rather than inline comma-separated description:
+
+### Correct
+
+```
+병렬 실행:
+- [1] {agent-a}: {task-a}
+- [2] {agent-b}: {task-b}
+```
+
+### Incorrect
+
+```
+병렬 실행: [1] {agent-a}가 {task-a}, [2] {agent-b}가 {task-b}.
+```
+
+The list form mirrors the tool-call `[N]` prefix pattern and scales better to 3+ concurrent agents.
+
 ## Result Aggregation
 
 ```

package/templates/.claude/rules/MUST-sync-verification.md

@@ -45,7 +45,9 @@ Wiki verification is also enforced by CI (`.github/workflows/wiki-sync.yml`).
 
 ### Phase 6: Push via mgr-gitnerd (only after sauron passes)
 
-## Self-Check Before Commit and Push
+## Self-Check — 6-point commit check + 3-point push check. See full checklist via Read tool.
+
+<!-- DETAIL: Self-Check Before Commit and Push
 
 ```
 ╔══════════════════════════════════════════════════════════════════╗
@@ -73,16 +75,19 @@ Wiki verification is also enforced by CI (`.github/workflows/wiki-sync.yml`).
 ║  Sauron verification is required for all pushes.                 ║
 ╚══════════════════════════════════════════════════════════════════╝
 ```
+-->
 
 ## When Required
 
 Any change to: agents, agent frontmatter, skills, guides, routing patterns, rules, wiki pages.
 
-## Quick Verification Commands
+## Quick Verification Commands — agent/skill/guide/wiki counts via ls/find/wc. See commands via Read tool.
+
+<!-- DETAIL: Quick Verification Commands
 
 Key checks: agent count (`ls .claude/agents/*.md | wc -l`), skill count (`find .claude/skills -name "SKILL.md" | wc -l`), guide count (`find guides -mindepth 1 -maxdepth 1 -type d | wc -l`), wiki page count (`find wiki -name "*.md" ! -name "index.md" ! -name "log.md" | wc -l`).
 
-<!-- DETAIL: Full verification bash scripts
+Full verification bash scripts:
 ```bash
 # Agent count check
 ls .claude/agents/*.md | wc -l

package/templates/.claude/rules/SHOULD-ecomode.md

@@ -36,7 +36,9 @@ Ecomode: `[lang-golang-expert] ✓ src/main.go reviewed: 1 naming issue (handle_
 
 Disable with: "ecomode off", "verbose mode", or "show full details".
 
-## Input Context Pruning
+## Input Context Pruning — Active removal of irrelevant content. See full spec via Read tool.
+
+<!-- DETAIL: Input Context Pruning
 
 Active removal of irrelevant retrieved content from agent context. Complements output compression by managing the input side of token budget.
 
@@ -64,8 +66,11 @@ Active removal of irrelevant retrieved content from agent context. Complements o
 - Prune at document/chunk level, not mid-sentence
 - When in doubt, Summarize rather than Drop
 - Track pruning decisions: `[Pruned] {N} chunks → {M} retained, {K} summarized, {J} dropped`
+-->
+
+## Context Budget Management — Task-type-aware thresholds (research 40%, implementation 50%, review 60%, management 70%, general 80%). See full spec via Read tool.
 
-## Context Budget Management
+<!-- DETAIL: Context Budget Management
 
 Task-type-aware context thresholds that trigger ecomode earlier for context-heavy operations.
 
@@ -103,8 +108,11 @@ The `context-budget-advisor.sh` hook monitors context usage and emits warnings w
 - Does NOT override explicit user settings
 - Advisory only — never blocks operations
 - Context percentage from statusline data when available
+-->
+
+## Token Guardian Coexistence — R013 context budget (usage-based) + cc-token-saver Token Guardian (time-based) can run simultaneously.
 
-## Token Guardian Coexistence (cc-token-saver)
+<!-- DETAIL: Token Guardian Coexistence (cc-token-saver)
 
 | Component | Trigger | Scope |
 |-----------|---------|-------|
@@ -112,3 +120,4 @@ The `context-budget-advisor.sh` hook monitors context usage and emits warnings w
 | Token Guardian (cc-token-saver) | 1h cache TTL idle detection | Cross-session cost |
 
 Both can run simultaneously — different triggers, complementary coverage. R013's context budget is usage-based (approaching limit), Token Guardian is time-based (idle cache expiry).
+-->

package/templates/.claude/rules/SHOULD-interaction.md

@@ -48,8 +48,9 @@
 3. Agent effort level → Map to corresponding style
 4. Default → `balanced`
 
-### Style Examples
+### Style Examples — See concise/balanced/explanatory examples via Read tool.
 
+<!-- DETAIL: Style Examples
 **Concise** (effort: low):
 ```
 ✓ 3 files updated, 0 errors
@@ -73,3 +74,4 @@ Changes:
 
 Trade-offs: RS256 is ~10x slower than HS256 but enables asymmetric key management.
 ```
+-->

package/templates/.claude/rules/SHOULD-wiki-sync.md

@@ -28,8 +28,9 @@ When agents, skills, rules, or guides are created or modified, corresponding wik
 | `/omcustom:wiki lint` | After major structural changes |
 | Automatic (CI) | `.github/workflows/wiki-sync.yml` checks on PR |
 
-## Delegation
+## Delegation — All wiki writes via wiki-curator agent (R010). See workflow via Read tool.
 
+<!-- DETAIL: Delegation
 All wiki writes MUST go through the `wiki-curator` agent (R010). The orchestrator reads wiki pages freely but never writes them directly.
 
 ```
@@ -42,9 +43,11 @@ Orchestrator
 │   └── Updates index.md
 └── Verifies via wiki lint
 ```
+-->
 
-## Integration
+## Integration — Interacts with R010, R017, R020, R006, R021. See table via Read tool.
 
+<!-- DETAIL: Integration
 | Rule | Interaction |
 |------|-------------|
 | R010 | Wiki writes delegated to wiki-curator agent |
@@ -52,16 +55,19 @@ Orchestrator
 | R020 | Wiki-dependent tasks verify wiki is current before [Done] |
 | R006 | Wiki pages follow same separation of concerns as source |
 | R021 | SHOULD priority — advisory enforcement, CI check |
+-->
 
 ## CI Enforcement
 
 `.github/workflows/wiki-sync.yml` checks for missing wiki pages on every PR. Missing pages cause CI failure with guidance to run `/omcustom:wiki`.
 
-## Self-Check
+## Self-Check — 3 checks: wiki pages updated, index refreshed, lint passed. See details via Read tool.
 
+<!-- DETAIL: Self-Check
 Before completing a session that modified agents/skills/rules/guides:
 1. Were wiki pages updated for all changes?
 2. Was index.md refreshed?
 3. Did wiki lint pass?
 
 If any NO → run `/omcustom:wiki ingest` for affected paths.
+-->

package/templates/CLAUDE.md

@@ -95,61 +95,17 @@ oh-my-customcode로 구동됩니다.
 
 ### 슬래시 커맨드 (스킬 기반)
 
-| 커맨드 | 설명 |
-|--------|------|
-| `/omcustom:analysis` | 프로젝트 분석 및 자동 커스터마이징 |
-| `/omcustom:create-agent` | 새 에이전트 생성 |
-| `/omcustom:update-docs` | 프로젝트 구조와 문서 동기화 |
-| `/omcustom:update-external` | 외부 소스에서 에이전트 업데이트 |
-| `/omcustom:audit-agents` | 에이전트 의존성 감사 |
-| `/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` | 공격자 관점 보안 코드 리뷰 |
-| `/omcustom:agora` | Multi-LLM 적대적 합의 루프 (설계/스펙 교차 검증) |
-| `/ambiguity-gate` | 요청 모호성 분석 및 명확화 질문 (ouroboros 패턴) |
-| `/dev-review` | 코드 베스트 프랙티스 리뷰 |
-| `/dev-refactor` | 코드 리팩토링 |
-| `/memory-save` | 세션 컨텍스트를 claude-mem에 저장 |
-| `/memory-recall` | 메모리 검색 및 리콜 |
-| `/omcustom:monitoring-setup` | OTel 콘솔 모니터링 활성화/비활성화 |
-| `/omcustom:npm-publish` | npm 레지스트리에 패키지 배포 |
-| `/omcustom:npm-version` | 시맨틱 버전 관리 |
-| `/omcustom:npm-audit` | 의존성 감사 |
-| `/omcustom-release-notes` | 릴리즈 노트 생성 (git 히스토리 기반) |
-| `/omcustom-feedback` | 사용자 피드백을 GitHub Issue로 등록 |
-| `/codex-exec` | Codex CLI 프롬프트 실행 |
-| `/gemini-exec` | Gemini CLI 프롬프트 실행 |
-| `/rtk-exec` | RTK CLI 프록시 실행 (토큰 압축) |
-| `/optimize-analyze` | 번들 및 성능 분석 |
-| `/optimize-bundle` | 번들 크기 최적화 |
-| `/optimize-report` | 최적화 리포트 생성 |
-| `/research` | 10-team 병렬 딥 분석 및 교차 검증 |
-| `/scout` | 외부 URL 분석 및 프로젝트 적합성 평가 |
-| `/skill-extractor` | 세션 성공 패턴에서 스킬 후보 추출 |
-| `/deep-plan` | 연구 검증 기반 계획 수립 (research → plan → verify) |
-| `/deep-verify` | 다중 관점 릴리즈 품질 검증 |
-| `/harness-synthesizer` | 에이전트 액션 검증용 코드 하네스 합성 (AutoHarness 기반) |
-| `/professor-triage` | 이슈 교차 분석 트리아지 (omc_issue_analyzer 댓글 기반) |
-| `/release-plan` | verify-done 이슈 릴리즈 유닛 계획 생성 |
-| `/pipeline` | YAML 파이프라인 실행 (예: /pipeline auto-dev) |
-| `/pipeline resume` | 중단된 파이프라인 재개 |
-| `/omcustom:sauron-watch` | 전체 R017 검증 |
-| `/sdd-dev` | Spec-Driven Development 워크플로우 (sdd/ 폴더 기반) |
-| `/structured-dev-cycle` | 6단계 구조적 개발 사이클 (Plan → Verify → Implement → Verify → Compound → Done) |
-| `/omcustom:loop` | 백그라운드 에이전트 자동 계속 실행 |
-| `/omcustom:lists` | 모든 사용 가능한 커맨드 표시 |
-| `/omcustom:status` | 시스템 상태 표시 |
-| `/omcustom-web` | 내장 Web UI 제어 및 검사 |
-| `/skills-sh-search` | skills.sh 마켓플레이스 스킬 검색 및 설치 |
-| `/vercel-deploy` | Vercel 배포 자동화 |
-| `/omcustom:help` | 도움말 표시 |
+| 카테고리 | 대표 커맨드 | 설명 |
+|----------|------------|------|
+| 프로젝트 관리 | `/omcustom:analysis`, `/omcustom:create-agent`, `/omcustom:audit-agents` | 분석, 에이전트/스킬 생성, 감사 |
+| 개발 | `/dev-review`, `/dev-refactor`, `/sdd-dev`, `/structured-dev-cycle` | 코드 리뷰, 리팩토링, SDD |
+| 검증 | `/omcustom:sauron-watch`, `/deep-verify`, `/adversarial-review` | R017 검증, 릴리즈 품질, 보안 리뷰 |
+| 릴리즈 | `/pipeline auto-dev`, `/omcustom-release-notes`, `/release-plan` | 자동 개발, 릴리즈 노트 |
+| 리서치 | `/research`, `/scout`, `/deep-plan`, `/omcustom:agora` | 병렬 분석, URL 평가, 연구 계획 |
+| 메모리 | `/memory-save`, `/memory-recall` | 세션 메모리 관리 |
+| 시스템 | `/omcustom:lists`, `/omcustom:status`, `/omcustom:help` | 전체 목록, 상태, 도움말 |
+
+> 전체 커맨드 목록 (60+ 커맨드): `/omcustom:lists` 실행
 
 ## 프로젝트 구조
 

package/templates/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.93.0",
+  "version": "0.95.0",
   "lastUpdated": "2026-04-18T00:00:00.000Z",
   "components": [
     {