claude-code-conductor 2.80.0__tar.gz → 2.81.0__tar.gz

{claude_code_conductor-2.80.0 → claude_code_conductor-2.81.0}/.claude/agents/developer.md

@@ -10,11 +10,6 @@ tools:
   - Bash
   - Glob
   - Grep
-  - TodoWrite
-  - TaskCreate
-  - TaskUpdate
-  - TaskList
-  - TaskGet
   - Skill
 ---
 

{claude_code_conductor-2.80.0 → claude_code_conductor-2.81.0}/.claude/agents/wt_developer.md

@@ -11,11 +11,6 @@ tools:
   - Bash
   - Glob
   - Grep
-  - TodoWrite
-  - TaskCreate
-  - TaskUpdate
-  - TaskList
-  - TaskGet
   - Skill
 ---
 

{claude_code_conductor-2.80.0 → claude_code_conductor-2.81.0}/.claude/docs/parallel-agents-setup.md

@@ -16,7 +16,7 @@ C3 の `parallel-agents` skill（`/develop` から間接起動）を快適に使
 
 | 項目 | 推奨値 | 既定との差 |
 |---|---|---|
-| Claude Code バージョン | **2.1.150 以降** | 古いと auto-cleanup 不在 |
+| Claude Code バージョン | **2.1.295 以降**（C3 全体の下限。README の「前提条件」を参照。worktree auto-cleanup が安定するのは 2.1.150 以降で、下限を満たせばこちらも満たす） | 2.1.150 未満だと auto-cleanup 不在 |
 | `worktree.baseRef` | **`"head"`** | 既定は `"fresh"` (= `origin/<default>` から作成) |
 
 設定しなくても skill 自体は動くが、以下の問題に遭遇しやすくなる:
@@ -83,7 +83,11 @@ parallel-agents は「直近の修正を反映した worktree で並列実装さ
 
 ## Claude Code バージョン要件
 
-### 2.1.150 以降を推奨する理由
+### 2.1.150 以降が必要な理由（worktree auto-cleanup）
+
+C3 全体の下限は 2.1.295 であり（README の「前提条件」を参照）、下限を満たす環境では
+以下の 2.1.150 条件も常に満たされる。ここでは parallel-agents に関わる 2.1.150 の
+意味だけを説明する。
 
 `isolation: "worktree"` 付き Agent が **完了時に worktree を auto-cleanup** する
 挙動が安定したのが 2.1.150 系。これにより:
@@ -95,7 +99,7 @@ parallel-agents は「直近の修正を反映した worktree で並列実装さ
 2.1.150 未満の場合、SKILL.md Step 2-F-3 のフォールバック手順
 （`git worktree remove -f -f` + `git branch -D worktree-agent-<id>`）が
 **毎回必要** になる。dead worktree が積み重なるとパフォーマンス・容量への
-影響もあるため、可能ならアップグレードを推奨する。
+影響もあるため、アップグレードを推奨する（C3 の下限 2.1.295 を満たせば不要）。
 
 ### auto-cleanup の信頼度
 

{claude_code_conductor-2.80.0 → claude_code_conductor-2.81.0}/.claude/docs/settings.json.md

@@ -190,6 +190,7 @@ Claude Code のイベントに対してフックを登録する。マッチし
 | `hooks[].type` | フックの種類（下記参照） |
 | `hooks[].if` | フックレベルの追加フィルタ。許可ルール構文（`Bash(git *)`、`Edit(*.ts)` 等）。ツールイベントのみ有効 |
 | `hooks[].timeout` | タイムアウト秒数。デフォルト 600秒（10分） |
+| `hooks[].onFailure` | hook 自体の失敗時の扱い。`"continue"`（既定）/ `"block"`。command / http hook で使える。Claude Code 2.1.295 以降（下記 `command` と「終了コードによる動作」を参照） |
 
 ---
 
@@ -203,6 +204,21 @@ Claude Code のイベントに対してフックを登録する。マッチし
 { "type": "command", "command": "python script.py" }
 ```
 
+| フィールド | 説明 |
+|---|---|
+| `command` | 実行するコマンド |
+| `args` | 引数の配列。指定すると `command` をシェルを介さず実行する（exec 形式。C3 の登録はすべてこの形式） |
+| `onFailure` | hook 自体が失敗したとき（起動できない・タイムアウト・0 と 2 以外の終了コード）の扱い。`"continue"`（既定）は失敗を通知して続行する。`"block"` は exit 2 と同じ扱いでアクションをブロックする。Claude Code 2.1.295 以降 |
+
+```json
+{
+  "type": "command",
+  "command": "c3",
+  "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/pre_tool.py"],
+  "onFailure": "block"
+}
+```
+
 #### `http`
 
 イベントデータを HTTP エンドポイントに POST する。
@@ -252,8 +268,32 @@ Claude Code のイベントに対してフックを登録する。マッチし
 | `2` | アクションをブロック。stderr の内容が Claude へのフィードバックになる。ブロック不可イベントでは stderr をユーザーに表示し続行 |
 | その他 | 続行。トランスクリプトに `<hook name> hook error` 通知 + stderr 1行目を表示 |
 
+> **`onFailure: "block"` のエントリ**: 0 と 2 以外の終了コード・起動失敗・タイムアウトは exit 2 と同じ扱い（アクションをブロックし、stderr が Claude へのフィードバックになる）。このときエラーには `PreToolUse:Bash hook error: [<hook のコマンド>]: failed; blocking because onFailure is "block"` のように、イベント名・ツール名・失敗した hook のコマンドが出る。onFailure 未指定（`"continue"`）では上表「その他」のとおり続行する。
+
 > **注意**: exit 2 と JSON 出力を混在させないこと。Claude Code は exit 2 時に JSON を無視する。
 
+### C3 の `onFailure` 方針
+
+(i) **onFailure: "block" を付けている hook**（`.claude/settings.json` の PreToolUse・7 エントリ）:
+
+| hook | matcher |
+|---|---|
+| `pre_tool.py` | `Bash` |
+| `worktree_guard.py` | `Write` / `Edit` |
+| `patterns_guard.py` | `Write` / `Edit` |
+| `report_path_guard.py` | `Write` |
+| `check_agent_invocation.py` | `Agent` |
+
+(ii) **判断基準**: 安全境界（破壊的コマンド・secret・書き込み先・reviewer の起動条件などの関所）の PreToolUse hook に付ける。hook 自体が失敗したときに関所を素通りさせないため。利便用の hook（例: `tier_autoapply.py`）や、失敗時に全操作を止めてしまう hook（UserPromptSubmit 系など）には付けない。PostToolUse は実行後のため、Stop 系は効果が無いため付けない。対象外の hook には `"continue"` も書かず、キー自体を省略する。
+
+(ii-a) **onFailure が拾う範囲**: 拾うのは hook 自体の失敗（起動不能・0 と 2 以外の終了コード・タイムアウト・不正な JSON 出力）である。hook が意図して exit 0 で通す入力（stdin の JSON の解析失敗など）は失敗ではないため対象外で、そのまま通過する。
+
+(ii-b) **block 対象に hook を加えるときの確認**: block 時は stderr 全文が Claude に渡るため、その hook が例外時に stderr へ機密（トークン・環境変数・ファイル内容など）を出さないことを確認する。
+
+(iii) **自分の hook に付けるかの指針**: `settings.local.json` 等に登録した自分の PreToolUse hook が「失敗時に通すと困る関所」なら `"block"` を付け、「失敗しても作業を続けたい補助」なら付けない。
+
+分類の正本は C3 開発リポジトリの `tests/test_settings_hooks_registration.py`（配布物には含まれない）にある閉じた分類表で、配布元が `.claude/settings.json` の PreToolUse の全 hook を「block 対象」か「非対象」に分類して機械検査している。`c3 run` で起動される hook は、`c3` が見つからない（venv が activate されていない等）と起動に失敗するため、上記の hook が付いたツール（Bash / Write / Edit / Agent）がブロックされる。対処は README の「前提条件」を参照。
+
 ---
 
 ### 構造化 JSON 出力（exit 0 + stdout）

{claude_code_conductor-2.80.0 → claude_code_conductor-2.81.0}/.claude/settings.json

@@ -70,7 +70,8 @@
           {
             "type": "command",
             "command": "c3",
-            "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/pre_tool.py"]
+            "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/pre_tool.py"],
+            "onFailure": "block"
           }
         ]
       },
@@ -80,17 +81,20 @@
           {
             "type": "command",
             "command": "c3",
-            "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/worktree_guard.py"]
+            "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/worktree_guard.py"],
+            "onFailure": "block"
           },
           {
             "type": "command",
             "command": "c3",
-            "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/patterns_guard.py"]
+            "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/patterns_guard.py"],
+            "onFailure": "block"
           },
           {
             "type": "command",
             "command": "c3",
-            "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/report_path_guard.py"]
+            "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/report_path_guard.py"],
+            "onFailure": "block"
           }
         ]
       },
@@ -100,12 +104,14 @@
           {
             "type": "command",
             "command": "c3",
-            "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/worktree_guard.py"]
+            "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/worktree_guard.py"],
+            "onFailure": "block"
           },
           {
             "type": "command",
             "command": "c3",
-            "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/patterns_guard.py"]
+            "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/patterns_guard.py"],
+            "onFailure": "block"
           }
         ]
       },
@@ -115,7 +121,8 @@
           {
             "type": "command",
             "command": "c3",
-            "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/check_agent_invocation.py"]
+            "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/check_agent_invocation.py"],
+            "onFailure": "block"
           },
           {
             "type": "command",

{claude_code_conductor-2.80.0 → claude_code_conductor-2.81.0}/ARCHITECTURE.md

@@ -112,11 +112,11 @@ A ヒアリング → B 設計 → C 計画 → D 実装(TDD) → E レビュー
 | `SessionStart` | （全て） | `session_start.py` | file-history クリア・sandbox 有効化・`c3.db` 初期化 |
 | `UserPromptSubmit` | （全て） | `select_tier.py` | 複雑度判定 → Tier ルーティング推奨（[§4](#4-知能基盤)） |
 | `UserPromptSubmit` | （全て） | `recall_inject.py` | 過去類似情報を意味検索しコンテキスト注入（[§4](#4-知能基盤)） |
-| `PreToolUse` | `Bash` | `pre_tool.py` | 破壊的コマンド（`rm -rf` 等）ブロック・secret スキャン |
-| `PreToolUse` | `Write` / `Edit` | `worktree_guard.py` | worktree 外への書き込み禁止（`PO_WORKTREE_GUARD=1` 設定時のみ作動。parallel-agents が並列実行時に有効化） |
-| `PreToolUse` | `Write` / `Edit` | `patterns_guard.py` | patterns.json への直接編集を block（許可フラグ TTL 600 秒・C3_PATTERNS_GUARD_DISABLE=1 で無効化） |
-| `PreToolUse` | `Write` | `report_path_guard.py` | レポート 9 prefix の書き先を検査し逸脱を block（封じ込め: `.claude/reports/` 直下の二層判定 / 上書き: タイムスタンプ形式の既存ファイル / 形式: strict-4 の非タイムスタンプ命名。`C3_REPORT_GUARD_DISABLE=1` で無効化） |
-| `PreToolUse` | `Agent` | `check_agent_invocation.py` | エージェント起動の検査 |
+| `PreToolUse` | `Bash` | `pre_tool.py` | 破壊的コマンド（`rm -rf` 等）ブロック・secret スキャン（`onFailure: "block"`: hook 自体の失敗時もブロックに倒す） |
+| `PreToolUse` | `Write` / `Edit` | `worktree_guard.py` | worktree 外への書き込み禁止（`PO_WORKTREE_GUARD=1` 設定時のみ作動。parallel-agents が並列実行時に有効化）（`onFailure: "block"`: hook 自体の失敗時もブロックに倒す） |
+| `PreToolUse` | `Write` / `Edit` | `patterns_guard.py` | patterns.json への直接編集を block（許可フラグ TTL 600 秒・C3_PATTERNS_GUARD_DISABLE=1 で無効化）（`onFailure: "block"`: hook 自体の失敗時もブロックに倒す） |
+| `PreToolUse` | `Write` | `report_path_guard.py` | レポート 9 prefix の書き先を検査し逸脱を block（封じ込め: `.claude/reports/` 直下の二層判定 / 上書き: タイムスタンプ形式の既存ファイル / 形式: strict-4 の非タイムスタンプ命名。`C3_REPORT_GUARD_DISABLE=1` で無効化）（`onFailure: "block"`: hook 自体の失敗時もブロックに倒す） |
+| `PreToolUse` | `Agent` | `check_agent_invocation.py` | エージェント起動の検査（`onFailure: "block"`: hook 自体の失敗時もブロックに倒す） |
 | `PreToolUse` | `Agent` | `tier_autoapply.py` | 推奨 Tier の `model:` 自動注入（既存登録の表への追随・乖離是正） |
 | `PostToolUse` | `Write` / `Edit` | `post_tool.py` | skills 変更通知・品質パターン（TODO 等）スキャン |
 | `PostToolUse` | `Write` / `Edit` | `planner_check.py` | plan-report の YAML/タイムスタンプ/reviewer 規約検査 |
@@ -137,7 +137,8 @@ A ヒアリング → B 設計 → C 計画 → D 実装(TDD) → E レビュー
 ### 設計原則
 
 - **非ブロッキング**: 観測系 hook は失敗しても `exit 0` でセッションを止めない（DB 不在・index 不在でも本体は動く）。
-- **`exit 2` は自己修正用**: PostToolUse の `exit 2` は LLM の system reminder に block error として surface される（「自動修正させたい違反」は exit 2、「ログだけ」は exit 0 + stderr で書き分ける）。例は配布元専用 `.dev/hooks/_planner_check.py` の R3。なお PreToolUse の `exit 2`（`check_agent_invocation.py` の R5 等）は動作をブロックするが LLM コンテキストへは注入されず、設計が異なる。
+- **安全境界はブロックに倒す**: 安全境界の PreToolUse hook は、hook 自体の失敗時（起動できない・タイムアウト・想定外の終了コード）に `onFailure: "block"` でブロックに倒す（対象は上表の注記の 5 本・7 エントリ）。
+- **`exit 2` は stderr を Claude に渡す**: PreToolUse の `exit 2`（`check_agent_invocation.py` の R5 等）は動作をブロックし、stderr がイベント名・ツール名・hook のコマンドを前置したツールのエラーとして Claude に渡る。PostToolUse の `exit 2` はツールの実行後に stderr を Claude に渡す（実行自体は取り消せない）。どちらも「Claude に読ませて直させたい違反」は exit 2、「ログだけ」は exit 0 + stderr で書き分ける。PostToolUse の例は配布元専用 `.dev/hooks/_planner_check.py` の R3。
 - **配布元専用 hook** は `.dev/hooks/` に分離（`settings.local.json` で登録・配布されない）: `_template_guard.py` / `_sync_check.py` / `_pip_reinstall_reminder.py` / `_planner_check.py`。
 
 ---

{claude_code_conductor-2.80.0 → claude_code_conductor-2.81.0}/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [2.81.0] - 2026-10-25
+
+### 変更
+
+- **安全境界の PreToolUse hook 5 本に `onFailure: "block"` を付けた**。対象は `.claude/settings.json` の
+  `pre_tool.py`（Bash）・`worktree_guard.py`（Write / Edit）・`patterns_guard.py`（Write / Edit）・
+  `report_path_guard.py`（Write）・`check_agent_invocation.py`（Agent）の 7 エントリ。これまでは hook 自体が
+  失敗したとき（起動できない・タイムアウト・想定外の終了コード）にツール呼び出しがそのまま通っていたが、
+  exit 2 と同じ扱いでブロックされるようになる。`tier_autoapply.py` と PreToolUse 以外の hook には付けていない。
+  この設定には **Claude Code 2.1.295 以降が必要**（README の「前提条件」に追記した）。venv を activate して
+  いないシェルから Claude Code を起動するなど `c3` を起動できない環境では、Bash / Write / Edit / Agent の
+  呼び出しがブロックされる（README・`docs/getting-started.md` に症状と対処を記載した）。
+  `.claude/docs/settings.json.md` に `onFailure` の仕様と C3 の方針を、`ARCHITECTURE.md` の設計原則に
+  安全境界の原則を追記し、PreToolUse の `exit 2` の stderr が Claude に渡らないとしていた誤った記述を直した
+- **developer / wt_developer の tools から、提供されないツールを外した**。Claude Code v2.1.268 以降、
+  TodoWrite と Task 系ツール（TaskCreate / TaskUpdate / TaskList / TaskGet）は Opus 4.7 以前・Sonnet 4.6 以前・
+  Haiku 4.5 でしか提供されず、developer を opus（claude-opus-5-5）と haiku（claude-haiku-5-5）で起動して
+  確認したところ 5 本とも提供されていなかった。TodoWrite は v2.80.0 以前から記載していたもの、
+  TaskCreate / TaskUpdate / TaskList / TaskGet は v2.80.0 で追加したもの。agent 本文はこれらのツールに
+  依存しておらず、挙動は変わらない
+
 ## [2.80.0] - 2026-09-29
 
 ### 破壊的変更

{claude_code_conductor-2.80.0 → claude_code_conductor-2.81.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: claude-code-conductor
-Version: 2.80.0
+Version: 2.81.0
 Summary: Multi-agent orchestration framework for Claude Code with Codex/Cursor adapters (C3)
 Project-URL: Homepage, https://github.com/satoh-y-0323/claude-code-conductor
 Project-URL: Repository, https://github.com/satoh-y-0323/claude-code-conductor
@@ -264,6 +264,7 @@ C3 の `.claude/` はプロジェクトコードに一切触れません。既
 ### 前提条件
 
 - [Claude Code](https://claude.ai/code) がインストール済みでログインしていること
+- Claude Code **2.1.295 以降**であること（C3 は安全境界の hook に `onFailure` を指定しており、この設定はこの版以降で使えます）
 - Python 3.10 以上がインストール済みであること
 
 **仮想環境（venv）の準備（推奨）**
@@ -286,7 +287,7 @@ source .venv/bin/activate
 
 venv に入れた場合の注意:
 
-- C3 の hook は `c3 run` で起動されるため、**Claude Code を起動するシェルでも同じ venv を activate してください**。activate されていないシェルから Claude Code を起動すると `c3` が見つからず、hook が動作しません
+- C3 の hook は `c3 run` で起動されるため、**Claude Code を起動するシェルでも同じ venv を activate してください**。activate されていないシェルから Claude Code を起動すると `c3` が見つかりません。このとき安全境界の hook（一覧は `.claude/docs/settings.json.md` の「C3 の `onFailure` 方針」を参照）は起動に失敗し、`onFailure: "block"` の設定によりツール呼び出しをブロックします。Bash / Write / Edit / Agent が使えなくなり、エラーには `PreToolUse:Bash hook error: [<hook のコマンド>]: failed; blocking because onFailure is "block"` のように、イベント名・ツール名・失敗した hook のコマンドが表示されます（それ以外の hook は動作しないまま処理が続きます）。この症状が出たら Claude Code を終了し、venv を activate したシェルで `c3 doctor` を実行して `c3` が解決されることを確認してから、そのシェルで Claude Code を起動し直してください
 - venv を使わずグローバルに使いたい場合は [pipx](https://pipx.pypa.io/) が代替になります: `pipx install claude-code-conductor`
 - インストール後は、**Claude Code を起動するのと同じシェルで** `c3 doctor` を実行し、`c3` が PATH で解決されることを確認してください（`c3 doctor` が検査するのは実行中シェルの PATH です。別のシェルで実行しても、Claude Code の hook が起動される文脈は再現できません）
 
@@ -298,7 +299,11 @@ venv に入れた場合の注意:
 pip install claude-code-conductor
 ```
 
-> このコマンドが PEP 668（externally-managed-environment）で拒否される場合や、インストール後に hook が動作しない場合は、[前提条件](#前提条件)の venv 手順（activate するシェルの注意点を含む）を参照してください。
+> 次のいずれかの場合は、[前提条件](#前提条件)の venv 手順（activate するシェルの注意点を含む）を参照してください。
+>
+> - このコマンドが PEP 668（externally-managed-environment）で拒否される
+> - インストール後に hook が動作しない
+> - Bash / Write / Edit / Agent の呼び出しが `blocking because onFailure is "block"` を含むエラーでブロックされる
 
 **2. プロジェクトに `.claude/` を展開する**
 
@@ -487,7 +492,7 @@ TDD を伴う機能実装は、planner が「test- → impl- → confirm-」の
 
 | 項目 | 推奨値 | 理由 |
 |---|---|---|
-| Claude Code バージョン | 2.1.150 以降 | worktree auto-cleanup の安定動作 |
+| Claude Code バージョン | 2.1.295 以降（C3 全体の下限。[前提条件](#前提条件)を参照） | 下限は `onFailure` の利用に必要。うち worktree auto-cleanup が安定するのは 2.1.150 以降で、2.1.295 以降ならこの条件も満たす |
 | `worktree.baseRef` | `"head"` | push 前のローカルコミットを worktree に含める |
 
 最小設定例:

{claude_code_conductor-2.80.0 → claude_code_conductor-2.81.0}/README.md

@@ -219,6 +219,7 @@ C3 の `.claude/` はプロジェクトコードに一切触れません。既
 ### 前提条件
 
 - [Claude Code](https://claude.ai/code) がインストール済みでログインしていること
+- Claude Code **2.1.295 以降**であること（C3 は安全境界の hook に `onFailure` を指定しており、この設定はこの版以降で使えます）
 - Python 3.10 以上がインストール済みであること
 
 **仮想環境（venv）の準備（推奨）**
@@ -241,7 +242,7 @@ source .venv/bin/activate
 
 venv に入れた場合の注意:
 
-- C3 の hook は `c3 run` で起動されるため、**Claude Code を起動するシェルでも同じ venv を activate してください**。activate されていないシェルから Claude Code を起動すると `c3` が見つからず、hook が動作しません
+- C3 の hook は `c3 run` で起動されるため、**Claude Code を起動するシェルでも同じ venv を activate してください**。activate されていないシェルから Claude Code を起動すると `c3` が見つかりません。このとき安全境界の hook（一覧は `.claude/docs/settings.json.md` の「C3 の `onFailure` 方針」を参照）は起動に失敗し、`onFailure: "block"` の設定によりツール呼び出しをブロックします。Bash / Write / Edit / Agent が使えなくなり、エラーには `PreToolUse:Bash hook error: [<hook のコマンド>]: failed; blocking because onFailure is "block"` のように、イベント名・ツール名・失敗した hook のコマンドが表示されます（それ以外の hook は動作しないまま処理が続きます）。この症状が出たら Claude Code を終了し、venv を activate したシェルで `c3 doctor` を実行して `c3` が解決されることを確認してから、そのシェルで Claude Code を起動し直してください
 - venv を使わずグローバルに使いたい場合は [pipx](https://pipx.pypa.io/) が代替になります: `pipx install claude-code-conductor`
 - インストール後は、**Claude Code を起動するのと同じシェルで** `c3 doctor` を実行し、`c3` が PATH で解決されることを確認してください（`c3 doctor` が検査するのは実行中シェルの PATH です。別のシェルで実行しても、Claude Code の hook が起動される文脈は再現できません）
 
@@ -253,7 +254,11 @@ venv に入れた場合の注意:
 pip install claude-code-conductor
 ```
 
-> このコマンドが PEP 668（externally-managed-environment）で拒否される場合や、インストール後に hook が動作しない場合は、[前提条件](#前提条件)の venv 手順（activate するシェルの注意点を含む）を参照してください。
+> 次のいずれかの場合は、[前提条件](#前提条件)の venv 手順（activate するシェルの注意点を含む）を参照してください。
+>
+> - このコマンドが PEP 668（externally-managed-environment）で拒否される
+> - インストール後に hook が動作しない
+> - Bash / Write / Edit / Agent の呼び出しが `blocking because onFailure is "block"` を含むエラーでブロックされる
 
 **2. プロジェクトに `.claude/` を展開する**
 
@@ -442,7 +447,7 @@ TDD を伴う機能実装は、planner が「test- → impl- → confirm-」の
 
 | 項目 | 推奨値 | 理由 |
 |---|---|---|
-| Claude Code バージョン | 2.1.150 以降 | worktree auto-cleanup の安定動作 |
+| Claude Code バージョン | 2.1.295 以降（C3 全体の下限。[前提条件](#前提条件)を参照） | 下限は `onFailure` の利用に必要。うち worktree auto-cleanup が安定するのは 2.1.150 以降で、2.1.295 以降ならこの条件も満たす |
 | `worktree.baseRef` | `"head"` | push 前のローカルコミットを worktree に含める |
 
 最小設定例:

{claude_code_conductor-2.80.0 → claude_code_conductor-2.81.0}/src/c3/__init__.py

@@ -1,3 +1,3 @@
 """Claude Code Conductor (C3) - multi-agent orchestration framework for Claude Code."""
 
-__version__ = "2.80.0"
+__version__ = "2.81.0"