claude-code-conductor 2.15.0__tar.gz → 2.15.2__tar.gz

claude_code_conductor-2.15.2/.claude/docs/parallel-agents-setup.md

@@ -0,0 +1,152 @@
+# parallel-agents 推奨個人設定
+
+C3 の `parallel-agents` skill（`/develop` から間接起動）を快適に使うための、
+**Claude Code バージョン要件と個人設定の推奨値**をまとめる。
+
+> 本ドキュメントは **C3 利用者（人間）向け** のリファレンス。
+> LLM 向けの skill 動作指針は `.claude/skills/parallel-agents/SKILL.md` を参照。
+
+---
+
+## 概要
+
+`parallel-agents` skill は Claude Code 公式の `isolation: "worktree"` 機構を使い、
+`.claude/worktrees/agent-<id>/` 配下に独立した git worktree を作成して並列実行する。
+このとき以下 2 点で **利用者環境への期待** が発生する。
+
+| 項目 | 推奨値 | 既定との差 |
+|---|---|---|
+| Claude Code バージョン | **2.1.150 以降** | 古いと auto-cleanup 不在 |
+| `worktree.baseRef` | **`"head"`** | 既定は `"fresh"` (= `origin/<default>` から作成) |
+
+設定しなくても skill 自体は動くが、以下の問題に遭遇しやすくなる:
+
+- 古い CC: 各 wave 終了時に `git worktree remove` が走らず `.claude/worktrees/` に
+  dead worktree が積もる
+- `baseRef: fresh`: push 前のローカルコミットが worktree から見えず、agent が
+  「ファイルが存在しない」と誤判定して fresh create に走る等の事故が起きる
+
+---
+
+## 推奨個人設定
+
+`~/.claude/settings.json` (グローバル個人設定) に以下を追加する:
+
+```json
+{
+  "worktree": {
+    "baseRef": "head"
+  }
+}
+```
+
+既存の `~/.claude/settings.json` がある場合はマージする。例:
+
+```json
+{
+  "permissions": {
+    "defaultMode": "auto"
+  },
+  "model": "sonnet",
+  "worktree": {
+    "baseRef": "head"
+  }
+}
+```
+
+### なぜプロジェクト設定 (`.claude/settings.json`) ではなく個人設定か
+
+`worktree.baseRef` は **Claude Code 公式機能の動作モード切替** であり、C3 固有の
+設定ではない。C3 が利用者の Claude Code 設定全体を書き換える形になると
+「C3 は `.claude/` 内に収まるフレームワーク」という設計思想と矛盾するため、
+C3 配布物には含めず利用者個人の判断で適用する形にしている。
+
+### worktree.baseRef: "head" の意味
+
+| 値 | base 元 |
+|---|---|
+| `"fresh"` (既定) | `origin/<default-branch>` (例: `origin/main`) |
+| `"head"` | 現在の local HEAD |
+
+`"head"` にすると、push 前のローカルコミットが worktree にも含まれる。
+parallel-agents は「直近の修正を反映した worktree で並列実装させる」ことが目的のため、
+`"head"` の方が C3 のワークフローと整合する。
+
+### 副作用
+
+- 作業中のローカル HEAD がコミットされていない（dirty）状態だと、その dirty も
+  worktree に持ち込まれる。これは通常のメリット（ローカル変更を反映）と表裏一体
+- 壊れた HEAD から worktree を作ると、worktree も壊れる。コミット前にビルドが
+  通っているかは利用者が確認する責任
+
+---
+
+## Claude Code バージョン要件
+
+### 2.1.150 以降を推奨する理由
+
+`isolation: "worktree"` 付き Agent が **完了時に worktree を auto-cleanup** する
+挙動が安定したのが 2.1.150 系。これにより:
+
+- `.claude/worktrees/` 配下に dead worktree が残らない
+- `worktree-agent-<id>` ブランチも自動削除される
+- 親 Claude が明示的に `git worktree remove` を呼ぶ必要がない
+
+2.1.150 未満の場合、SKILL.md Step 2-F-3 のフォールバック手順
+（`git worktree remove -f -f` + `git branch -D worktree-agent-<id>`）が
+**毎回必要** になる。dead worktree が積み重なるとパフォーマンス・容量への
+影響もあるため、可能ならアップグレードを推奨する。
+
+### auto-cleanup の信頼度
+
+検証実績 (2026-05-23 〜 2026-05-24):
+
+- foreground / background / 並列 / 失敗 (exit 1) の全パターンで 10/10 cleanup 確認
+- ごく稀に **外部要因による一時的ファイルロック** で cleanup が失敗するケースを
+  1 件観測 (約 1/11 以下)。原因は未特定（アンチウィルス・バックアップソフト・
+  その他常駐プロセスのいずれかの可能性）
+- SKILL.md Step 2-F-3 の残留チェック + `git worktree prune` フォールバックで
+  実害なく吸収される設計
+
+---
+
+## 設定後の動作確認
+
+1. 設定追加後、Claude Code を再起動する（または `/config` で反映）
+2. C3 で wt_tester を 1 件起動するだけの軽量タスクを実行（最も簡単な検証）:
+   - `/start` → 「直接指示する」→ 「wt_tester を 1 個 isolation:worktree で pwd だけ実行して」
+3. 完了通知後、`git worktree list --porcelain` と `ls .claude/worktrees/` で
+   両方 main 以外が無い状態を確認
+
+### baseRef 適用の確認
+
+ローカルだけにある commit がある状態で wt_tester を起動し、worktree 内で
+`git log -1` が **その commit を指していれば** baseRef: "head" が効いている。
+`origin/main` の commit を指していれば既定（`fresh`）のまま。
+
+---
+
+## トラブルシューティング
+
+### Q. worktree が cleanup されず残る
+
+A. 以下の順に対処:
+
+1. `git worktree list --porcelain` で main 以外の登録があるか確認
+2. 登録があれば `git worktree remove -f -f <path>` で削除
+3. 物理 dir だけ残っていれば `rm -rf .claude/worktrees/agent-*`
+4. ブランチが残っていれば `git branch -d worktree-agent-<id>` (force 必要なら `-D`)
+
+これらは parallel-agents SKILL.md Step 2-F-3 のフォールバック手順そのもの。
+auto-cleanup が動いている環境ではほぼ no-op になる。
+
+### Q. wt_developer / wt_tester が「ファイルが存在しない」と言う
+
+A. `worktree.baseRef` が `"fresh"` (既定) のまま、かつローカルに push 前の
+コミットでそのファイルを追加しているケースが典型。`worktree.baseRef: "head"` を
+設定するか、対象 commit を push してから再実行する。
+
+### Q. 設定変更しても効かない
+
+A. Claude Code の設定読み込みはセッション開始時。`/config` で再読み込みするか、
+Claude Code を再起動する。

{claude_code_conductor-2.15.0 → claude_code_conductor-2.15.2}/.claude/skills/codex-review/SKILL.md

@@ -202,10 +202,10 @@ AskUserQuestion で確認する:
     "options": [
       { "label": "確認完了", "description": "レポートを確認した" },
       { "label": "別ファイルも続けてレビューする", "description": "Step 1 から再実行する" },
-      { "label": "C3 レビューフローへ引き継ぐ", "description": "code-review スキルへ引き継いでフェーズ E を実行する" }
+      { "label": "C3 レビューフローへ引き継ぐ", "description": "review-phase スキルへ引き継いでフェーズ E を実行する" }
     ]
   }]
 }
 ```
 
-「C3 レビューフローへ引き継ぐ」が選択された場合は Skill ツールで `code-review` を呼び出す。
+「C3 レビューフローへ引き継ぐ」が選択された場合は Skill ツールで `review-phase` を呼び出す。

{claude_code_conductor-2.15.0 → claude_code_conductor-2.15.2}/.claude/skills/dev-workflow/SKILL.md

@@ -1,5 +1,5 @@
 ---
-description: ヒアリング→設計→計画→実装→レビューの全フェーズワークフロー。/start・/develop・/code-review スキルが内部参照する。
+description: ヒアリング→設計→計画→実装→レビューの全フェーズワークフロー。/start・/develop・/review-phase スキルが内部参照する。
 disable-model-invocation: false
 user-invocable: false
 ---

{claude_code_conductor-2.15.0 → claude_code_conductor-2.15.2}/.claude/skills/extract-lib/SKILL.md

@@ -293,5 +293,5 @@ Agent ツールでスケルトンコード生成を行う:
 次のステップ:
 1. レポートの設計案を確認し、必要に応じて調整する
 2. 各プロジェクトの該当箇所をライブラリに置き換える
-3. /code-review でライブラリのコードレビューを実施する
+3. /review-phase でライブラリのコードレビューを実施する
 ```

{claude_code_conductor-2.15.0 → claude_code_conductor-2.15.2}/.claude/skills/parallel-agents/SKILL.md

@@ -41,7 +41,7 @@ Claude Code のサブエージェントは **更にサブエージェントを s
 
 - plan-report が `.claude/reports/plan-report-*.md` の形式で配置され、YAML フロントマターを持つこと
 - フロントマターが無ければ `.claude/skills/dev-workflow/SKILL.md` の D-1〜D-5 ceremony へフォールバック
-- Claude Code の Agent ツールが `isolation: "worktree"` パラメータをサポートしていること（v2.1.x 以降）
+- Claude Code の Agent ツールが `isolation: "worktree"` パラメータをサポートしていること（v2.1.x 以降）。v2.1.150 未満では Agent 完了時の worktree auto-cleanup が動作しないため、2-F-3 のフォールバック手順が毎回必要になる挙動差がある（利用者向け推奨設定は [`.claude/docs/parallel-agents-setup.md`](../../docs/parallel-agents-setup.md) を参照）
 
 ---
 
@@ -208,7 +208,7 @@ worktree path は Agent ツール返り値の `<worktree><worktreePath>...</work
 }
 ```
 
-- 「リトライ」 → 失敗タスクのみ 2-C を再実行（成功 worktree はそのまま残し、失敗 worktree は事前に `git worktree remove -f -f` で削除）
+- 「リトライ」 → 失敗タスクのみ 2-C を再実行（失敗 worktree は auto-cleanup 済みのことが多いが、2-F-3 の残留チェックを実施してから再開すること。残留があった場合のみ事前に `git worktree remove -f -f` で削除）
 - 「スキップして次の wave へ」 → 失敗内容をセッションファイルの `## 試みたが失敗したアプローチ` に追記して次の wave へ
 - 「中断」 → セッションファイルの該当 wave 行は `- [ ]` のままにしてスキル終了
 
@@ -241,15 +241,29 @@ git commit -m "Wave {N}: {要約}"
 
 メッセージには各タスクの目的を簡潔にまとめる（例: 「Wave 1: auth ログイン/ログアウト実装」）。
 
-#### 2-F-3: worktree クリーンアップ
+#### 2-F-3: worktree クリーンアップ（残留チェックのみ）
 
-各 worktree を削除する。**`-f -f` フラグが必須**（Claude Code が worktree を `claude agent` lock で残すため）:
+Claude Code 2.1.x（少なくとも 2.1.150 で実測確認、2026-05-23）以降、`isolation:"worktree"` 付き Agent は完了時に **物理ディレクトリ・worktree 登録・`worktree-agent-*` ブランチが自動削除** される（foreground / background / 並列 / 失敗ケース全パターンで検証済み。詳細: `.claude/reports/worktree-cleanup-verification-20260523-234110.md`）。
+
+そのため明示的な `git worktree remove` は **不要**。auto-cleanup が race や障害でスキップされた場合のセーフティとして残留チェックのみ行う:
 
 ```bash
-git worktree remove -f -f .claude/worktrees/agent-{id}
-git worktree remove -f -f .claude/worktrees/agent-{id2}
+# 念のため worktree 登録の残留を確認、あれば prune（物理ディレクトリも片付く）
+git worktree list --porcelain
 git worktree prune
-git branch -D worktree-agent-{id} worktree-agent-{id2}
+
+# 念のため worktree-agent-* ブランチの残留チェック（あれば手動削除を検討）
+# Windows PowerShell では grep 未インストール時に動作しないため、代替として
+# `git branch --list "worktree-agent-*"` を使う:
+git branch -a | grep -E "worktree-agent-" || true
+# Windows 代替: git branch --list "worktree-agent-*"
+```
+
+残留があった場合のみ手動 cleanup（古い Claude Code バージョン互換 or auto-cleanup 失敗ケース）:
+
+```bash
+git worktree remove -f -f .claude/worktrees/agent-{id}  # -f -f は claude agent lock 残留対策
+git branch -D worktree-agent-{id}
 ```
 
 #### 2-F-4: セッション記録
@@ -285,5 +299,5 @@ checkpoint の summary には KEEP ルール（設計判断・決定事項・解
 - 並列実行で **特定パターンが詰まりがち** と気付いたら、セッションファイルの `## 試みたが失敗したアプローチ` に追記し `patterns` に登録する
 - 並列度を増やして race の兆候が出た場合は本 skill の上限値 15 を見直す（PoC では 15 並列まで 0 失敗確認済み）
 - agent ツール並列起動の `<task-notification>` の到着順序は保証されないため、結果集約の表は task_id でソートして提示する
-- worktree クリーンアップを忘れると `.claude/worktrees/` に dead worktree が積もる。`-f -f` フラグの必要性は PoC で実証済み
+- Claude Code 2.1.x 以降は Agent 完了時に worktree auto-cleanup されるため、明示的な `git worktree remove` は基本不要（2-F-3 参照）。`.claude/worktrees/` に dead worktree が残る場合は古い Claude Code バージョンで作成された残骸の可能性が高い
 

{claude_code_conductor-2.15.0/.claude/skills/code-review → claude_code_conductor-2.15.2/.claude/skills/review-phase}/SKILL.md

@@ -2,7 +2,7 @@
 description: 実装済みコードの code-reviewer・security-reviewer によるレビュー（フェーズ E）を実行する。
 ---
 
-# code-review
+# review-phase
 
 実装済みコードのレビューを行う。
 

{claude_code_conductor-2.15.0 → claude_code_conductor-2.15.2}/.gitignore

@@ -60,6 +60,7 @@ site/
 .claude/docs/ruflo_research_result.md
 .claude/docs/C3_hnsw_機能追加詳細設計.md
 .claude/docs/C3_利用状況可視化.md
+.claude/docs/C3_tier_routing_cost_integration_設計.md
 .claude/docs/grill-me機能を実装する際の考慮点とC3との相性や超えるべき壁.md
 .claude/docs/C3のconfig_policyとversion_upgradeの考慮点と超えるべき壁.md
 

{claude_code_conductor-2.15.0 → claude_code_conductor-2.15.2}/CHANGELOG.md

@@ -1,5 +1,71 @@
 # Changelog
 
+## v2.15.2 (2026-05-24)
+
+### 改善
+
+- **parallel-agents skill Step 2-F-3 を縮小**: Claude Code 2.1.150 で
+  `isolation:"worktree"` 付き Agent 完了時の worktree auto-cleanup 動作を
+  4 シナリオ (foreground / background / 並列 / 失敗 exit 1) で確定検証。
+  従来の「親 Claude が `git worktree remove -f -f` を毎回実行」を
+  「残留チェック + `git worktree prune` のみ」に縮小。
+  古い Claude Code バージョン (< 2.1.150) や稀な外部要因による cleanup
+  失敗時のフォールバック手順は残置。
+- Step 2-E (リトライ) と 知識蓄積セクションも同方針に整合化。
+
+### 追加
+
+- **`.claude/docs/parallel-agents-setup.md` 新規**: parallel-agents
+  利用者向けの推奨個人設定リファレンス。`worktree.baseRef: "head"` /
+  Claude Code バージョン要件 / トラブルシュート手順を集約。
+- **README.md に「推奨個人設定」セクション**: 最小設定例と詳細 docs への
+  リンクを `parallel-agents` 紹介の直後に追加。
+
+### 回帰防御
+
+- `tests/test_db.py` 新規 (4 + 1 件): `locate_c3_db` の env 優先 /
+  C3_PO_DB_PATH legacy fallback / 親遡り / 無効 env fallback /
+  ディレクトリ指定 fallback の各経路を契約として固定。
+- `tests/test_worktree_guard.py` に env gate 未設定時の no-op テスト
+  追加 (PO_WORKTREE_GUARD env 廃止移行を機械検出する番犬テスト)。
+- 合計 5 件追加で 928 → 934 PASS (回帰なし)。
+
+### 配布
+
+- `.claude/docs/C3_tier_routing_cost_integration_設計.md` (個人作業ノート)
+  を 3 ファイル同期 (.gitignore / `_excludes.py` / `hatch_build.py`) で
+  配布除外。
+
+### 内部整理
+
+- SKILL.md (LLM 向け) と人間向け推奨ドキュメントの責務を文書ヒエラルキー
+  思想 (SKILL.md = LLM 行動指針 / docs = 人間リファレンス) に従って分離。
+
+---
+
+## v2.15.1 (2026-05-22)
+
+### 変更
+- C3 `/code-review` skill を `/review-phase` にリネーム。
+  Claude Code v2.1.147 で Built-in `/code-review` が新規追加され、
+  コマンド名が完全衝突したため。
+
+### 配布先での手動クリーンアップ手順（必須）
+
+`c3 update` は配布物の削除を検出しないため、配布先プロジェクトで以下を手動実行:
+
+**bash / macOS / Linux:**
+```bash
+rm -rf .claude/skills/code-review/
+```
+
+**PowerShell (Windows):**
+```powershell
+Remove-Item -Recurse -Force .claude\skills\code-review\
+```
+
+---
+
 ## v2.15.0 (2026-05-22)
 
 ### 変更

{claude_code_conductor-2.15.0 → claude_code_conductor-2.15.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-conductor
-Version: 2.15.0
+Version: 2.15.2
 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
@@ -64,7 +64,7 @@ Claude Code Conductor（C3）は「親 Claude が複数の専門エージェン
 
 ```
 ユーザー
-    ↓ /start, /develop, /code-review, /doc, /mcp-config, /extract-lib ...
+    ↓ /start, /develop, /review-phase, /doc, /mcp-config, /extract-lib ...
 親 Claude（オーケストレーター）
     ├─ interviewer       ← ヒアリング
     ├─ architect         ← 設計
@@ -174,7 +174,7 @@ C3 のスラッシュコマンドはすべてスキル（`skills/{name}/SKILL.md
 | `/setup` | コーディング規約の設定（coding-standards・project-conventions 生成） |
 | `/start` | 開発ワークフローの入口（ヒアリング/設計/計画/実装 から選択） |
 | `/develop` | TDD フェーズから直接開始 |
-| `/code-review` | レビューフェーズから直接開始（code-reviewer + security-reviewer） |
+| `/review-phase` | レビューフェーズから直接開始（code-reviewer + security-reviewer） |
 | `/promote-pattern` | 蓄積されたパターンを rules/ または skills/ に昇格 |
 
 ### ユーティリティ
@@ -212,7 +212,7 @@ C3 のスラッシュコマンドはすべてスキル（`skills/{name}/SKILL.md
 
 `/start` 実行後は、各フェーズの承認を進めるだけで最後まで自動的に流れます。
 
-> **公式コマンドとの名前衝突について:** C3 のスキル名は Claude Code 公式コマンドと重複しないよう設計されています。`/code-review`（≠ 公式 `/review`）、`/mcp-config`（≠ 公式 `/mcp`）はこの方針に基づく命名です。
+> **公式コマンドとの名前衝突について:** C3 のスキル名は Claude Code 公式コマンドと重複しないよう設計しています。`/review-phase`（≠ 公式 `/code-review` / `/review`）、`/mcp-config`（≠ 公式 `/mcp`）はこの方針に基づく命名です。公式コマンドが追加された場合は衝突回避のために本フレームワークの skill 名を変更することがあります（v2.15.1 で `/code-review` → `/review-phase` に変更しました）。
 
 ---
 
@@ -375,6 +375,27 @@ Copy-Item -Recurse claude-code-conductor\.claude your-project\
 
 TDD を伴う機能実装は、planner が「test- → impl- → confirm-」の 3 タスクペアに分解し、各 wave 内で独立機能間で並列起動されます。並列実行時は worktree 専用の `wt_tester` / `wt_developer` / `wt_systematic-debugger` agent が使用され、レポートは `task_id` ベースのファイル名で出力されます。
 
+### 推奨個人設定 (`~/.claude/settings.json`)
+
+`parallel-agents` を快適に使うため、以下 2 点を **個人設定として** 推奨します（C3 配布物には含めません）:
+
+| 項目 | 推奨値 | 理由 |
+|---|---|---|
+| Claude Code バージョン | 2.1.150 以降 | worktree auto-cleanup の安定動作 |
+| `worktree.baseRef` | `"head"` | push 前のローカルコミットを worktree に含める |
+
+最小設定例:
+
+```json
+{
+  "worktree": {
+    "baseRef": "head"
+  }
+}
+```
+
+詳細（背景・副作用・トラブルシュート）は [`.claude/docs/parallel-agents-setup.md`](./.claude/docs/parallel-agents-setup.md) を参照してください。
+
 ---
 
 ## セッション管理

{claude_code_conductor-2.15.0 → claude_code_conductor-2.15.2}/README.md

@@ -17,7 +17,7 @@ Claude Code Conductor（C3）は「親 Claude が複数の専門エージェン
 
 ```
 ユーザー
-    ↓ /start, /develop, /code-review, /doc, /mcp-config, /extract-lib ...
+    ↓ /start, /develop, /review-phase, /doc, /mcp-config, /extract-lib ...
 親 Claude（オーケストレーター）
     ├─ interviewer       ← ヒアリング
     ├─ architect         ← 設計
@@ -127,7 +127,7 @@ C3 のスラッシュコマンドはすべてスキル（`skills/{name}/SKILL.md
 | `/setup` | コーディング規約の設定（coding-standards・project-conventions 生成） |
 | `/start` | 開発ワークフローの入口（ヒアリング/設計/計画/実装 から選択） |
 | `/develop` | TDD フェーズから直接開始 |
-| `/code-review` | レビューフェーズから直接開始（code-reviewer + security-reviewer） |
+| `/review-phase` | レビューフェーズから直接開始（code-reviewer + security-reviewer） |
 | `/promote-pattern` | 蓄積されたパターンを rules/ または skills/ に昇格 |
 
 ### ユーティリティ
@@ -165,7 +165,7 @@ C3 のスラッシュコマンドはすべてスキル（`skills/{name}/SKILL.md
 
 `/start` 実行後は、各フェーズの承認を進めるだけで最後まで自動的に流れます。
 
-> **公式コマンドとの名前衝突について:** C3 のスキル名は Claude Code 公式コマンドと重複しないよう設計されています。`/code-review`（≠ 公式 `/review`）、`/mcp-config`（≠ 公式 `/mcp`）はこの方針に基づく命名です。
+> **公式コマンドとの名前衝突について:** C3 のスキル名は Claude Code 公式コマンドと重複しないよう設計しています。`/review-phase`（≠ 公式 `/code-review` / `/review`）、`/mcp-config`（≠ 公式 `/mcp`）はこの方針に基づく命名です。公式コマンドが追加された場合は衝突回避のために本フレームワークの skill 名を変更することがあります（v2.15.1 で `/code-review` → `/review-phase` に変更しました）。
 
 ---
 
@@ -328,6 +328,27 @@ Copy-Item -Recurse claude-code-conductor\.claude your-project\
 
 TDD を伴う機能実装は、planner が「test- → impl- → confirm-」の 3 タスクペアに分解し、各 wave 内で独立機能間で並列起動されます。並列実行時は worktree 専用の `wt_tester` / `wt_developer` / `wt_systematic-debugger` agent が使用され、レポートは `task_id` ベースのファイル名で出力されます。
 
+### 推奨個人設定 (`~/.claude/settings.json`)
+
+`parallel-agents` を快適に使うため、以下 2 点を **個人設定として** 推奨します（C3 配布物には含めません）:
+
+| 項目 | 推奨値 | 理由 |
+|---|---|---|
+| Claude Code バージョン | 2.1.150 以降 | worktree auto-cleanup の安定動作 |
+| `worktree.baseRef` | `"head"` | push 前のローカルコミットを worktree に含める |
+
+最小設定例:
+
+```json
+{
+  "worktree": {
+    "baseRef": "head"
+  }
+}
+```
+
+詳細（背景・副作用・トラブルシュート）は [`.claude/docs/parallel-agents-setup.md`](./.claude/docs/parallel-agents-setup.md) を参照してください。
+
 ---
 
 ## セッション管理

{claude_code_conductor-2.15.0 → claude_code_conductor-2.15.2}/hatch_build.py

@@ -39,6 +39,7 @@ EXCLUDE_PATTERNS: tuple[str, ...] = (
     "docs/ruflo_research_result.md",
     "docs/C3_hnsw_機能追加詳細設計.md",
     "docs/C3_利用状況可視化.md",
+    "docs/C3_tier_routing_cost_integration_設計.md",
     "docs/grill-me機能を実装する際の考慮点とC3との相性や超えるべき壁.md",
     "docs/C3のconfig_policyとversion_upgradeの考慮点と超えるべき壁.md",
     "docs/codex対応/*",

{claude_code_conductor-2.15.0 → claude_code_conductor-2.15.2}/src/c3/__init__.py

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

{claude_code_conductor-2.15.0 → claude_code_conductor-2.15.2}/src/c3/_excludes.py

@@ -36,6 +36,7 @@ EXCLUDE_PATTERNS: tuple[str, ...] = (
     "docs/ruflo_research_result.md",
     "docs/C3_hnsw_機能追加詳細設計.md",
     "docs/C3_利用状況可視化.md",
+    "docs/C3_tier_routing_cost_integration_設計.md",
     "docs/grill-me機能を実装する際の考慮点とC3との相性や超えるべき壁.md",
     "docs/C3のconfig_policyとversion_upgradeの考慮点と超えるべき壁.md",
     "docs/codex対応/*",

{claude_code_conductor-2.15.0 → claude_code_conductor-2.15.2}/src/c3/cli_update.py

@@ -13,6 +13,13 @@ from c3.adapters import print_adapter_actions, scaffold_adapters
 from c3.paths import templates_dir
 from c3.platforms import PLATFORM_CHOICES, expand_platforms
 
+# 廃止済み skill パス（リリース履歴）。
+# `c3 update` 完了時に配布先で残存していたら警告を stderr に表示する。
+# 削除はしない（`c3 update` の "削除を検出しない" 設計を尊重）。
+DEPRECATED_PATHS: tuple[tuple[str, str], ...] = (
+    (".claude/skills/code-review", "v2.15.1 で /review-phase にリネーム（Built-in /code-review と衝突回避）"),
+)
+
 
 def register(subparsers: argparse._SubParsersAction) -> None:
     parser = subparsers.add_parser(
@@ -97,9 +104,35 @@ def handle(args: argparse.Namespace) -> int:
         print("up to date")
     elif not args.dry_run:
         print(f"{changed} file(s) updated")
+    _warn_deprecated_paths(target_root)
     return 0
 
 
+def _warn_deprecated_paths(dest_root: Path) -> None:
+    """配布先で廃止済み skill パスが残っていたら stderr に警告を出力。
+
+    DEPRECATED_PATHS の各エントリ (rel_path, reason) について
+    dest_root / rel_path の存在を確認し、見つかれば warning メッセージを stderr に出す。
+
+    本関数は読み取り専用（exists() チェックと stderr 出力のみ）で副作用がないため、
+    `--dry-run` 時にも常に実行される。削除は行わない（手動クリーンアップを促すのみ）。
+    `c3 update` の "削除を検出しない" 設計を尊重した実装。
+    """
+    found = []
+    for rel_path, reason in DEPRECATED_PATHS:
+        candidate = dest_root / Path(rel_path)
+        if candidate.exists():
+            found.append((rel_path, reason))
+    if not found:
+        return
+    print("", file=sys.stderr)
+    print("warning: deprecated path(s) detected (manual cleanup recommended):", file=sys.stderr)
+    for rel_path, reason in found:
+        print(f"  - {rel_path}: {reason}", file=sys.stderr)
+    print("", file=sys.stderr)
+    print("  c3 update does not delete files. Remove the path(s) manually.", file=sys.stderr)
+
+
 def _walk_diff(template: Path, dest: Path):
     """Yield (action, absolute_dest_path) tuples for files that differ.
 

claude_code_conductor-2.15.2/tests/test_cli_update.py

@@ -0,0 +1,41 @@
+"""src/c3/cli_update.py の _warn_deprecated_paths と DEPRECATED_PATHS のテスト。"""
+from __future__ import annotations
+
+from pathlib import Path
+
+import pytest
+
+from c3.cli_update import DEPRECATED_PATHS, _warn_deprecated_paths
+
+
+def test_deprecated_paths_constant_is_tuple_of_pairs():
+    """DEPRECATED_PATHS は tuple であり、各要素は (rel_path, reason) の 2 要素タプル。"""
+    assert isinstance(DEPRECATED_PATHS, tuple)
+    for entry in DEPRECATED_PATHS:
+        assert isinstance(entry, tuple)
+        assert len(entry) == 2
+        rel_path, reason = entry
+        assert isinstance(rel_path, str)
+        assert isinstance(reason, str)
+
+
+def test_no_warning_when_deprecated_path_absent(tmp_path: Path, capsys: pytest.CaptureFixture[str]):
+    """dest_root 配下に廃止パスが存在しない場合、stderr に何も出力しない。"""
+    _warn_deprecated_paths(tmp_path)
+    captured = capsys.readouterr()
+    assert captured.err == ""
+
+
+def test_warning_when_deprecated_path_present(tmp_path: Path, capsys: pytest.CaptureFixture[str]):
+    """dest_root 配下に廃止パスが残存していたら stderr に warning を出力する。"""
+    if not DEPRECATED_PATHS:
+        pytest.skip("DEPRECATED_PATHS が空")
+    rel_path, _ = DEPRECATED_PATHS[0]
+    target = tmp_path / rel_path
+    target.mkdir(parents=True, exist_ok=True)
+    _warn_deprecated_paths(tmp_path)
+    captured = capsys.readouterr()
+    assert "deprecated" in captured.err.lower()
+    assert rel_path in captured.err
+    assert "manual" in captured.err.lower()
+    assert "remove" in captured.err.lower()