oh-my-customcode 0.97.0 → 0.98.0

package/README.md

@@ -222,7 +222,7 @@ Key rules: R010 (orchestrator never writes files), R009 (parallel execution mand
 
 ---
 
-### Guides (37)
+### Guides (38)
 
 Reference documentation covering best practices, architecture decisions, and integration patterns. Located in `guides/` at project root, covering topics from agent design to CI/CD to observability.
 
@@ -279,7 +279,7 @@ your-project/
 │   ├── specs/                  # Extracted canonical specs
 │   ├── contexts/               # 4 shared context files
 │   └── ontology/               # Knowledge graph for RAG
-└── guides/                     # 37 reference documents
+└── guides/                     # 38 reference documents
 ```
 
 ---

package/dist/cli/index.js

@@ -2334,7 +2334,7 @@ var init_package = __esm(() => {
     workspaces: [
       "packages/*"
     ],
-    version: "0.97.0",
+    version: "0.98.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.97.0",
+  version: "0.98.0",
   description: "Batteries-included agent harness for Claude Code",
   type: "module",
   bin: {

package/package.json

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

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

@@ -311,13 +311,25 @@
         "description": "Log task completion events for Agent Teams coordination"
       }
     ],
+    "PreCompact": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/hooks/scripts/task-state-precompact.sh"
+          }
+        ],
+        "description": "Serialize active task state before compaction — pairs with PostCompact restore (#922)"
+      }
+    ],
     "PostCompact": [
       {
         "matcher": "*",
         "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\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."
+            "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\nTask state restore: if /tmp/.claude-task-state-$PPID.json exists, read it to recover active pipeline, dev stage, and autonomous mode state. This was saved by PreCompact hook.\n\nRe-read CLAUDE.md NOW."
           }
         ],
         "description": "Reinforce enforced rules after context compaction — prevents rule amnesia (v2.1.76+)"

package/templates/.claude/hooks/scripts/task-state-precompact.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+# PreCompact hook: serialize active task state before context compaction
+# Pairs with PostCompact prompt that restores this state
+
+STATE_FILE="/tmp/.claude-task-state-$PPID.json"
+
+collect_state() {
+  local pipeline_state=""
+  local autonomous=""
+  local dev_stage=""
+  local tool_count=""
+  local loop_count=""
+
+  # Pipeline state
+  for f in /tmp/.claude-pipeline-*-$PPID.json; do
+    [ -f "$f" ] && pipeline_state=$(cat "$f" 2>/dev/null | jq -c '.' 2>/dev/null) && break
+  done
+
+  # Autonomous mode
+  [ -f "/tmp/.claude-autonomous-$PPID" ] && autonomous="true"
+
+  # Dev stage (structured-dev-cycle)
+  [ -f "/tmp/.claude-dev-stage" ] && dev_stage=$(cat "/tmp/.claude-dev-stage" 2>/dev/null)
+
+  # Tool call counter
+  [ -f "/tmp/claude-tool-count-$PPID" ] && tool_count=$(cat "/tmp/claude-tool-count-$PPID" 2>/dev/null)
+
+  # Auto-continue loop count
+  [ -f "/tmp/.claude-loop-count-$PPID" ] && loop_count=$(cat "/tmp/.claude-loop-count-$PPID" 2>/dev/null)
+
+  # Build JSON (keep under 500 bytes for context efficiency)
+  jq -n \
+    --arg ts "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
+    --arg pipeline "$pipeline_state" \
+    --arg auto "$autonomous" \
+    --arg stage "$dev_stage" \
+    --arg tools "$tool_count" \
+    --arg loops "$loop_count" \
+    '{
+      captured_at: $ts,
+      pipeline: (if $pipeline != "" then ($pipeline | fromjson? // null) else null end),
+      autonomous_mode: ($auto == "true"),
+      dev_stage: (if $stage != "" then $stage else null end),
+      tool_calls: (if $tools != "" then ($tools | tonumber? // null) else null end),
+      loop_count: (if $loops != "" then ($loops | tonumber? // null) else null end)
+    } | del(.[] | nulls)'
+}
+
+state=$(collect_state 2>/dev/null)
+
+if [ -n "$state" ] && [ "$state" != "{}" ]; then
+  echo "$state" > "$STATE_FILE"
+  echo "[PreCompact] Task state saved to $STATE_FILE" >&2
+else
+  echo "[PreCompact] No active task state to save" >&2
+fi
+
+cat

package/templates/CLAUDE.md

@@ -118,7 +118,7 @@ project/
 |   +-- rules/                   # 전역 규칙 (R000-R022)
 |   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
 |   +-- contexts/                # 컨텍스트 파일 (ecomode)
-+-- guides/                      # 레퍼런스 문서 (37 토픽)
++-- guides/                      # 레퍼런스 문서 (38 토픽)
 ```
 
 ## 오케스트레이션

package/templates/guides/multi-provider-exec/README.md

@@ -0,0 +1,83 @@
+# Multi-Provider Exec
+
+## Overview
+
+Unified reference for executing prompts through external LLM providers via exec skills. Complements the [Multi-Model Routing](../multi-model-routing/README.md) guide (Claude model selection) with cross-provider execution capabilities.
+
+Inspired by OpenHarness's provider profile switching pattern, adapted for oh-my-customcode's skill-based architecture.
+
+## Provider Matrix
+
+| Provider | Skill | CLI Dependency | Model | Strengths |
+|----------|-------|---------------|-------|-----------|
+| OpenAI (Codex) | `codex-exec` | `codex` CLI | GPT-5.4 | Code generation, broad knowledge |
+| Google (Gemini) | `gemini-exec` | `gemini` CLI | Gemini 2.5 Pro | Long context, multimodal |
+| RTK (proxy) | `rtk-exec` | `rtk` CLI | Configurable | Token-optimized output, cost reduction |
+
+## Availability Detection
+
+The `session-env-check.sh` hook (SessionStart) auto-detects available providers:
+
+```
+[SessionStart] Checking external CLI availability...
+  codex: ✓ available
+  gemini: ✗ not found
+  rtk: ✓ available
+```
+
+Providers are opt-in — missing CLIs are silently skipped.
+
+## Usage Patterns
+
+### Direct Invocation
+
+```
+/codex-exec "Review this function for security issues"
+/gemini-exec "Analyze this architecture diagram"
+/rtk-exec "List files matching pattern X"
+```
+
+### Provider Selection Guide
+
+| Task | Recommended Provider | Rationale |
+|------|---------------------|-----------|
+| Second opinion on code review | codex-exec | Independent model reduces confirmation bias |
+| Long document analysis | gemini-exec | 1M+ context window |
+| Token-heavy batch operations | rtk-exec | Compressed output reduces context cost |
+| Security audit cross-check | codex-exec | Different training data catches different patterns |
+| Multi-model verification | All three | `/multi-model-verification` skill orchestrates this |
+
+### Integration with Existing Skills
+
+| Skill | Uses Provider | How |
+|-------|--------------|-----|
+| `multi-model-verification` | codex-exec + gemini-exec | Parallel verification with severity classification |
+| `reasoning-sandwich` | Any exec skill | Pre/post reasoning with different models |
+| `model-escalation` | Claude models only | Internal escalation (haiku→sonnet→opus), not cross-provider |
+
+## Relationship to Multi-Model Routing
+
+| Aspect | Multi-Model Routing | Multi-Provider Exec |
+|--------|--------------------|--------------------|
+| Scope | Claude model selection | Cross-provider execution |
+| Models | haiku / sonnet / opus | GPT-5.4 / Gemini 2.5 / RTK proxy |
+| Mechanism | `model` frontmatter field | Exec skill invocation |
+| Use case | Cost/quality optimization within Claude | Independent verification, specialized tasks |
+| Guide | `guides/multi-model-routing/` | `guides/multi-provider-exec/` |
+
+## Configuration
+
+No global configuration required. Each exec skill reads its own CLI configuration:
+
+| Skill | Config Source |
+|-------|-------------|
+| codex-exec | `~/.codex/config` or CODEX_API_KEY env |
+| gemini-exec | `~/.gemini/config` or GEMINI_API_KEY env |
+| rtk-exec | RTK proxy running on localhost |
+
+## Limitations
+
+- Provider availability depends on user's CLI installations
+- Cross-provider results are advisory — Claude remains the primary execution engine
+- No automatic fallback between providers (by design — explicit selection preferred)
+- Rate limits and costs are provider-specific and not tracked by oh-my-customcode

package/templates/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.97.0",
+  "version": "0.98.0",
   "lastUpdated": "2026-04-18T00:00:00.000Z",
   "components": [
     {
@@ -24,7 +24,7 @@
       "name": "guides",
       "path": "guides",
       "description": "Reference documentation",
-      "files": 37
+      "files": 38
     },
     {
       "name": "hooks",