claude-code-conductor 2.16.0__tar.gz → 2.18.0__tar.gz

{claude_code_conductor-2.16.0 → claude_code_conductor-2.18.0}/.claude/CLAUDE.md

@@ -49,6 +49,7 @@
 
 `.claude/docs/` は人間向けリファレンスのためエージェントは読まなくてよい。
 詳細は `.claude/docs/taxonomy.md` を参照。
+設定の優先順位・配布判断は `.claude/docs/config-policy.md` を参照。
 
 ## Platform Compatibility
 

claude_code_conductor-2.18.0/.claude/deletions.txt

@@ -0,0 +1,39 @@
+# C3 c3 update 削除リスト
+# このファイルに記載されたパスは `c3 update` 実行時に
+# 利用先の .claude/ から削除候補として扱われる。
+#
+# 仕様:
+# - 1 行 1 パス、.claude/ 相対表記
+# - # で始まる行はコメント、空行はスキップ
+# - 絶対パス / ../ を含むパス / シンボリックリンク は無視
+# - ディレクトリは削除しない（ファイルのみ）
+#
+# 詳細は .claude/docs/config-policy.md §3 #13 と §7 落とし穴 5 を参照。
+
+# ---- v2.1.0: tdd-develop / worktree-tdd-workflow 廃止 ----
+agents/tdd-develop.md
+skills/worktree-tdd-workflow/SKILL.md
+
+# ---- v2.11.0: summarize-memory 廃止 ----
+agents/summarize-memory.md
+skills/summarize-memory/SKILL.md
+
+# ---- v2.12.0: タクソノミー棚卸（hooks/ → skills/dev-workflow/scripts/ へ移動） ----
+hooks/record_review_decision.py
+hooks/record_tier_outcome.py
+hooks/review_hint_inject.py
+hooks/subagent_log.py
+
+# ---- (v2.x): task-routing skill 廃止 ----
+skills/task-routing/SKILL.md
+
+# ---- v2.15.1: /code-review skill を /review-phase にリネーム ----
+skills/code-review/SKILL.md
+
+# ---- 短期 revert（一時配布された可能性あり） ----
+skills/phase-a-requirements/SKILL.md
+skills/phase-b-architecture/SKILL.md
+skills/phase-c-plan/SKILL.md
+skills/phase-d-implement/SKILL.md
+skills/phase-debug/SKILL.md
+skills/phase-e-review/SKILL.md

claude_code_conductor-2.18.0/.claude/docs/config-policy.md

@@ -0,0 +1,331 @@
+# C3 Config Policy — 設定階層・配布判断の公式リファレンス
+
+**バージョン**: v2.17.0
+**対象読者**: C3 利用先ユーザー / C3 自体をフォーク・拡張する開発者
+**canonical 宣言**: 設定優先順位・配布判断に関しては本ドキュメントが唯一の公式情報源。
+他ファイル（`CLAUDE.md` / `_excludes.py` docstring）から本ドキュメントへの参照リンクが張られている場合、
+詳細は常に本ドキュメントを参照すること。
+
+---
+
+## 1. 設定ファイル一覧（所在マップ）
+
+### 1-1. 配布元リポジトリ（C3 開発者向け）
+
+```
+/CLAUDE.md                             配布元専用（.gitignore で除外）
+.claude/CLAUDE.md                      配布元・配布先共通（常時注入）
+.claude/settings.json                  プロジェクト共通設定（配布される）
+.claude/settings.local.json            個人 override（配布されない）
+.claude/permission_rules.json          C3 独自の自動承認パターン（配布される）
+.claude/rules/                         C3 配布デフォルトルール（配布される）
+.claude/rules/promoted/                プロジェクト固有昇格ルール（配布される、update は触らない）
+.claude/hooks/                         Claude Code lifecycle hooks（配布される）
+.dev/hooks/                            配布元専用 hook（配布されない）
+src/c3/_excludes.py                    wheel 除外パターン（配布元のビルド制御）
+hatch_build.py                         _excludes.py の重複定義（ビルド時専用）
+```
+
+### 1-2. 利用先プロジェクト（C3 ユーザー向け）
+
+```
+.claude/CLAUDE.md                      c3 init で配置・c3 update で更新
+.claude/settings.json                  c3 init で配置・c3 update で更新
+.claude/settings.local.json            ユーザーが個別作成（c3 は触らない）
+.claude/permission_rules.json          c3 init で配置・c3 update で更新
+.claude/rules/                         c3 init で配置・c3 update で更新
+.claude/rules/promoted/index.md        c3 init で空雛形のみ配置（c3 update は触らない）
+.claude/hooks/                         c3 init で配置・c3 update で更新
+.claude/state/                         実行時生成（gitignore 推奨）
+.claude/memory/                        実行時生成
+.claude/agent-memory/                  実行時生成
+.claude/reports/                       実行時生成（gitignore 推奨）
+.claude/worktrees/                     並列実行時一時生成
+.claude/logs/                          実行時生成
+```
+
+### 1-3. ディレクトリの命名・配置チート
+
+各ディレクトリの **命名・役割・配置判断** は `.claude/docs/taxonomy.md` を参照。
+本ドキュメントは配布判断・優先順位に特化しており、taxonomy と住み分けている。
+
+---
+
+## 2. 設定優先順位と書き込み権限
+
+設定は性質の異なる **3 つのレイヤー** に分かれる。1 列に並べると誤解を生むため分離して記述する。
+
+### レイヤー A: ツール権限（Claude Code 公式）
+
+同じキー（`permissions.allow` など）が複数ファイルで定義されている場合、
+**上位ファイルが下位ファイルを上書き**する（高 → 低の順）:
+
+1. `.claude/settings.local.json` — 個人 override（`.gitignore` 推奨。c3 update の対象外）
+2. `.claude/settings.json` — プロジェクト共通設定（git 管理）
+3. `~/.claude/settings.json` — グローバル個人設定（マシンローカル）
+
+> **重要**: `hooks` セクションのみ「マージしない・完全上書き」挙動。
+> `settings.local.json` に `hooks` を書くと `settings.json` の `hooks` が **すべて無効化** される。
+> 詳細は §7「既知の落とし穴」を参照。
+> キー仕様の詳細は `.claude/docs/settings.json.md` を参照。
+
+### レイヤー B: 自動承認パターン（C3 独自拡張）
+
+- `.claude/permission_rules.json` の `auto_allow` 配列
+- `permission_handler.py`（`PermissionRequest` hook）が読み込んで、パターンにマッチすれば自動承認
+- レイヤー A で `deny` 判定されたものを覆すことはできない（hook の決定権の範囲内）
+- `notify_on_auto: false` で通知を抑止できる
+
+> **注意**: `permission_rules.json` は Claude Code 公式の `permissions.allow` とは **独立した別レイヤー**。
+> 同列に並べると「どちらが優先されるか」で誤解が生じる。レイヤー A と B は並立している。
+
+> **注意**: `auto_allow` パターンは最小限に留めること。広範なパターン（例: `Bash(*)`）は C3 の意図する動作範囲を超えた危険コマンドも自動承認する可能性がある。
+
+### レイヤー C: LLM 指示・知識（CLAUDE.md / rules）
+
+- `.claude/CLAUDE.md` — 常時注入されるプロジェクト指示
+- `.claude/rules/*.md` — `paths:` フロントマターがあればパスマッチ時のみ、なければ常時注入
+- `.claude/rules/promoted/index.md` — `@rules/promoted/index.md` で CLAUDE.md から include される
+  （`/promote-pattern` skill が追記する **ユーザー所有領域**）
+
+「優先順位」という概念は厳密には適用されない（全文ロードされる）が、
+**`rules/promoted/` は c3 update が触らない**点が肝となる。
+
+### 書き込み権限マトリクス
+
+| ファイル | c3 init が初期配置 | c3 update が上書き | ユーザーが編集してよい |
+|---|---|---|---|
+| `.claude/settings.json` | ○ | ○ | △（チーム合意のもと） |
+| `.claude/settings.local.json` | × | × | ○（個人 override / 秘匿情報） |
+| `.claude/permission_rules.json` | ○ | ○ | △（ファイル全体を上書き編集する場合は注意） |
+| `.claude/CLAUDE.md` | ○ | ○ | △（c3 update で上書きされる前提で） |
+| `.claude/rules/*.md` | ○ | ○ | △（同上） |
+| `.claude/rules/promoted/index.md` | ○（空雛形のみ） | × | ○（`/promote-pattern` が追記、手動編集も可） |
+
+---
+
+## 3. 配布判断マトリクス（13 カテゴリ）
+
+`_excludes.py` の `EXCLUDE_PATTERNS` / `KEEP_PATTERNS` を実装照合した結果。
+各カテゴリに配布有無・c3 update の更新有無・理由を明示する。
+
+| # | カテゴリ | 配布 | c3 update が更新 | 理由 |
+|---|---|---|---|---|
+| 1 | `.claude/hooks/*.py` | ○ | ○ | Claude Code lifecycle hook の実体。配布先で動作する。例外: `subagent_log.py` のみ除外（個人デバッグ用） |
+| 2 | `.claude/agents/*.md` | ○ | ○ | ペルソナ定義。配布先で読まれる。例外: `tdd-develop.md` のみ除外（v2.1.0 廃止） |
+| 3 | `.claude/skills/*/` | ○ | ○ | オーケストレーション/ユーティリティ skill 定義（`scripts/` / `templates/` 等サブディレクトリ含む）。例外: `worktree-tdd-workflow/*` のみ除外（v2.1.0 廃止） |
+| 4 | `.claude/rules/*.md` | ○ | ○ | C3 配布デフォルトルール（常時注入対象） |
+| 5 | `.claude/rules/promoted/*` | ○ | × | プロジェクト固有昇格ルール。配布元の `promoted/index.md` は空雛形のみ配布。利用先で `/promote-pattern` が追記する **ユーザー所有領域**。c3 update が触ると昇格内容が失われる |
+| 6 | `.claude/docs/*.md` | △（一部のみ） | ○ | 利用先向けリファレンス。配布対象は `platform-adapters.md` / `settings.json.md` / `parallel-agents-setup.md` / `config-policy.md`（本ドキュメント）の 4 ファイル。配布元固有の設計メモ等は `_excludes.py` で個別除外。`taxonomy.md` は tracked（GitHub 公開）だが EXCLUDE 対象のため wheel 非配布（詳細は §7 落とし穴 2 参照）。 |
+| 7 | `.claude/CLAUDE.md` | ○ | ○ | 配布先で常時注入される共通ルール |
+| 8 | `.claude/settings.json` | ○ | ○ | プロジェクト共通設定（hooks 登録・permissions など） |
+| 9 | `.claude/permission_rules.json` | ○ | ○ | C3 独自の自動承認パターン（PermissionRequest hook が参照） |
+| 10 | `.claude/settings.local.json` | × | — | 個人 override・秘匿情報。`_excludes.py` でも除外、`.gitignore` でも除外、c3 update も触らない |
+| 11 | `.claude/reports/*` / `memory/*` / `agent-memory/*` / `state/*` / `tmp/*` / `worktrees/*` / `logs/*` | × （`.gitkeep` のみ ○） | — | 実行時生成領域。空ディレクトリのみ `KEEP_PATTERNS` の `.gitkeep` で配布。データ本体は除外 |
+| 12 | `.dev/*` / `/CLAUDE.md` / `/AGENTS.md` / `/.codex/` / `/.cursor/` / `/.agents/` | × | — | 配布元専用または adapter 生成物。wheel には構造的に含まれない（`src/c3/_template/.claude/` 配下のみ同梱）が、配布元 `.gitignore` で commit 混入も防ぐ |
+| 13 | `.claude/deletions.txt` | ○ | ○ | `c3 update` が読み込み、利用先 `.claude/` から該当ファイルを削除候補として扱う。配布元の `.claude/deletions.txt` に追記したエントリは次回 pip install → `c3 update` で利用先に伝播。`KEEP_PATTERNS` で明示配布。`c3 update` 自体は本ファイルを削除しない（§7 落とし穴 5 参照） |
+
+> **注意 (カテゴリ #6)**: `taxonomy.md` は `_excludes.py` の EXCLUDE 対象だが、`.gitignore` では tracked 状態（GitHub に公開済み）。
+> **wheel には含まれない**点に注意。gitignore と wheel 配布は別レイヤーであり、
+> 「tracked = 配布される」ではない。
+
+---
+
+## 4. settings.local.json 運用の原則
+
+`settings.local.json` は以下の **3 原則**で運用する:
+
+### 原則 1: 個人 override / 秘匿情報はここに書く
+
+- 個人の `permissions.allow` 追加（チーム全員には不要なもの）
+- API キー・個人トークン等の秘匿情報（`env` セクションに記述）
+- 個人的な `mcpServers` 設定
+
+`.gitignore` に含まれているため、通常の `git add` では staging されずリモートに上がらない（ただし `git status` で確認を推奨）。
+
+> **注意**: `git add -f` の強制オプションを使うと `.gitignore` が無効化されるため、秘匿情報が誤ってコミットされるリスクがある。CI/CD パイプラインでの自動 `add` 設定にも注意すること。
+
+> **注意**: `c3 init` はプロジェクトルートの `.gitignore` を自動編集しない。`settings.local.json` を新規作成する場合は、ユーザー自身が `.gitignore` に `.claude/settings.local.json` を追加すること。
+
+### 原則 2: c3 update は触らない
+
+`settings.local.json` は `c3 init` も `c3 update` も作成・上書きしない。
+個人設定を安全に保ちつつ、C3 のアップデートを受け取れる設計。
+
+### 原則 3: `hooks` セクションは書かない
+
+**最重要の落とし穴**。`settings.local.json` に `hooks` セクションを追記すると、
+`settings.json` の `hooks` エントリが **すべて無効化** される（マージではなく完全上書き）。
+
+C3 の lifecycle hook（`permission_handler.py` 等）が動かなくなるため、
+`hooks` のカスタマイズは必ず `settings.json` 側に行う（チーム合意を経て）。
+
+詳細は §7「既知の落とし穴」の項目 1 を参照。
+
+---
+
+## 5. プラットフォーム別 config 整合（canonical 宣言）
+
+### canonical は `.claude/` に置く
+
+C3 の設定・ルール・スキルの **唯一の公式ソース** は `.claude/` ディレクトリ。
+Codex / Cursor 向けの adapter 生成物は **派生生成物** であり、primary source ではない。
+
+| プラットフォーム | 設定参照経路 | 生成コマンド |
+|---|---|---|
+| Claude Code | `.claude/settings.json` / `.claude/CLAUDE.md` | — |
+| Codex | `.codex/` / `/AGENTS.md` | `c3 init --platform codex` |
+| Cursor | `.cursor/rules/c3-core.mdc` | `c3 init --platform cursor` |
+
+### adapter 生成物の位置付け
+
+- `.codex/` / `/AGENTS.md` / `/.cursor/` / `/.agents/` は **c3 init が生成する派生物**
+- これらを直接編集すると `c3 init --platform` の再実行で上書きされる
+- 配布元リポジトリでは `.gitignore` に含まれる（配布対象外）
+
+### 複数プラットフォームを切り替える場合
+
+同じプロジェクトで Claude Code / Codex / Cursor を切り替えて使う場合、
+設定の変更は必ず `.claude/` 側に行い、必要に応じて `c3 init --platform` で adapter を再生成する。
+
+詳細は `.claude/docs/platform-adapters.md` を参照。
+
+---
+
+## 6. 3 ファイル同期ルール
+
+### なぜ 3 ファイルが同期されなければならないか
+
+C3 の wheel 配布除外パターンは **3 つのファイルに分散して定義** されている:
+
+| ファイル | 役割 | 変更が必要な場面 |
+|---|---|---|
+| `.gitignore` | git 追跡から除外（配布元リポジトリの個人作業ファイルを管理外に） | 配布元で新たに除外すべきファイルが増えた時 |
+| `src/c3/_excludes.py` | `c3 init` / `c3 update` 時の除外判断（Python 実装） | 配布先への配布/非配布を変更する時 |
+| `hatch_build.py` | wheel ビルド時の除外判断（`_excludes.py` の重複定義） | `_excludes.py` を変更した時（必ず同期） |
+
+`hatch_build.py` の重複が必要な理由: hatch build hook はパッケージ import 前に走るため、
+`_excludes.py` を import できない。2 ファイルの完全一致が必須。
+
+### 同期確認の方法
+
+`.dev/hooks/_sync_check.py`（PostToolUse hook）が、3 ファイルのいずれかを変更した時に
+残り 2 ファイルの同期を `stderr` で警告する。警告が出たら必ず対応する。
+
+### 変更手順
+
+1. `.gitignore` / `_excludes.py` / `hatch_build.py` のいずれかを変更
+2. `_sync_check.py` の警告を確認
+3. 残り 2 ファイルに同じパターンを追加（または削除）
+4. `python -m build --wheel` で wheel を再生成して実体検証
+
+### 過去の同期漏れ defect
+
+| バージョン | 内容 | カテゴリ #（§3 参照） |
+|---|---|---|
+| v1.1.0 | `state/tier_selection.json` が wheel に混入した | #11 |
+| v2.14.1 | `worktrees/` 配下ファイルが wheel に混入した | #11 |
+
+いずれも `_excludes.py` / `hatch_build.py` の同期漏れが原因。
+
+---
+
+## 7. 既知の落とし穴
+
+**ここを読まないと事故る**ポイントを集約。症状が出たらまず確認すること。
+
+### 落とし穴 1: `hooks` セクションが `settings.local.json` で完全上書きされる
+
+**症状**: `permission_handler.py` 等の C3 hook が突然動かなくなる。
+
+**原因**: Claude Code の `settings.json` 系では、`hooks` セクションのみマージではなく
+**完全上書き**の挙動を取る（`permissions.allow` 等他のキーはマージ）。
+`settings.local.json` に `hooks: []` や任意の hook 定義を書くと、
+`settings.json` の `hooks` エントリが全て無効化される。
+
+**対処**: `settings.local.json` の `hooks` セクションを削除し、`settings.json` 側に移す。
+カスタム hook を追加したい場合はチームで `settings.json` を編集する（git 管理）。
+
+### 落とし穴 2: `taxonomy.md` は tracked だが wheel 配布されない
+
+**症状**: `_excludes.py` で除外されているはずの `taxonomy.md` が GitHub に公開されている、
+または「なぜ `.gitignore` に入っていないのか」と疑問に思う。
+
+**原因**: `taxonomy.md` は `.gitignore` では tracked（GitHub に公開済み）だが、
+`_excludes.py` の `EXCLUDE_PATTERNS` で除外されているため **wheel には含まれない**。
+「git tracked = 配布される」ではない。wheel 配布と git 追跡は独立したレイヤー。
+
+**対処**: 混乱した場合は §3 のカテゴリ #6 の注意書きを参照。
+`config-policy.md`（本ドキュメント）は wheel に含まれる設計になっている（`_excludes.py` に除外パターンなし）。
+
+### 落とし穴 3: `rules/promoted/` を `c3 update` が上書きしない
+
+**症状**: `c3 update` 後に `/promote-pattern` で追加したルールが消えている（実際には消えないが消えると思って不安）、
+または「なぜ promoted/ は更新されないのか」と疑問に思う。
+
+**原因**: `.claude/rules/promoted/index.md` は **ユーザー所有領域**。
+c3 update が上書きすると利用先で `/promote-pattern` が追記したルールが消失するため、意図的に除外している（§3 カテゴリ #5 参照）。
+
+**対処**: `promoted/` への変更は `c3 update` に委ねず、手動または `/promote-pattern` skill で管理する。
+C3 side で `promoted/` の雛形を更新した場合は、リリースノートで手動マージ手順を案内する。
+
+### 落とし穴 4: `deletions.txt` 自身は削除されない・絶対パスは無視される
+
+**症状**: `deletions.txt` が利用先に残り続ける / 絶対パスを書いたのに削除されない / `..` 含みパスが効かない。
+
+**原因**:
+- `deletions.txt` は **`c3 update` が読み取るための指示書** であり、削除対象として
+  `deletions.txt` 自身を含めても無視される（自分自身を削除すると次回 update で
+  ブートストラップが効かなくなるため）
+- セーフガードにより以下は **silent ではなく warning を出して無視** される:
+  - 絶対パス（先頭 `/`、`~`、Windows ドライブレター `C:`）
+  - `..` または `.` を含むパス
+  - `.claude/` プレフィックス（`.claude/agents/x.md` は不可、`agents/x.md` と書く）
+  - シンボリックリンク経由のパス
+  - ディレクトリ（ファイルのみサポート）
+  - `\` （バックスラッシュ）を含むパス
+
+**対処**:
+- 削除候補に書くパスは「.claude/ からの相対 POSIX パス」のみ（例: `agents/foo.md`）
+- ディレクトリを丸ごと削除したい場合は、配下のファイルを 1 つずつ列挙
+- `c3 update --dry-run` で warning が出ていないか確認
+- `deletions.txt` 自身を更新したい場合は通常の `c3 update` の add/update ロジックが処理する
+
+### 落とし穴 5: `permission_rules.json` は `settings.json.permissions.deny` を覆せない（要検証）
+
+**現状**: `permission_handler.py` の実装を読む限り、`PermissionRequest` hook は
+Claude Code 側で `deny` 判定が出た後に発火するため、`permission_rules.json` の `auto_allow` で
+`deny` を覆すことはできないはず。ただし Claude Code 公式仕様に明記なし。
+
+**残課題**: v2.18.0 以降の検証タスクとして記録。現時点では「覆せない前提で設計する」ことを推奨。
+
+---
+
+## 8. 参照先
+
+### 一次資料
+
+| 資料 | 場所 | 内容 |
+|---|---|---|
+| 配布元ルール | `/CLAUDE.md` | 3 ファイル同期・wheel 実体検証手順（配布元開発者向け） |
+| 共通ルール | `.claude/CLAUDE.md` | LLM 行動規範・承認フロー |
+| 設定キー仕様 | `.claude/docs/settings.json.md` | settings.json の各キー詳細仕様 |
+| ディレクトリ命名 | `.claude/docs/taxonomy.md` | ディレクトリの命名・役割・配置判断 |
+| プラットフォーム別 | `.claude/docs/platform-adapters.md` | Codex / Cursor adapter の生成物と参照経路 |
+| 背景・設計判断 | `.claude/docs/C3のconfig_policyとversion_upgradeの考慮点と超えるべき壁.md` | 本ドキュメント作成の背景・version upgrade の残課題 |
+
+### 実装ファイル
+
+| ファイル | 場所 | 内容 |
+|---|---|---|
+| 除外パターン定義 | `src/c3/_excludes.py` | `EXCLUDE_PATTERNS` / `KEEP_PATTERNS` 定数 + `should_skip()` |
+| ビルド時除外 | `hatch_build.py` | `_excludes.py` の重複定義（ビルドフック用） |
+| 同期確認 hook | `.dev/hooks/_sync_check.py` | 3 ファイル変更時の警告（配布元専用） |
+| 自動承認 hook | `.claude/hooks/permission_handler.py` | `permission_rules.json` を読んで自動承認 |
+
+### 残課題リンク（v2.18.0 以降）
+
+- `permission_rules.json` の `auto_allow` が `settings.json.permissions.deny` を覆せるか検証
+- `~/.claude/settings.json` のグローバル設定と `.claude/settings.json` の同キー競合時のマージ範囲確認
+- ~~`c3 update` の削除検出（`deletions.txt` 方式、v2.18.0 予定）~~ → v2.18.0 で実装
+- `c3 update` 時の Breaking changes 警告（v2.19.0 予定）

{claude_code_conductor-2.16.0 → claude_code_conductor-2.18.0}/CHANGELOG.md

@@ -1,5 +1,125 @@
 # Changelog
 
+## v2.18.0 (2026-05-24)
+
+**基盤整備リリース第 2 弾**: `c3 update` の削除検出を `deletions.txt` 方式で導入する。
+v2.0.0 以来の `c3_update_no_delete_detection` defect（リリースで廃止した
+skill / hook / agent が利用先に残り続ける問題）を構造的に解消する。
+
+### 追加
+
+- **`.claude/deletions.txt`**（新規）: 利用先で削除すべきファイルパス一覧。
+  1 行 1 パス、`#` でコメント、`.claude/` 相対 POSIX パス。v2.1.0 / v2.11.0 /
+  v2.12.0 / v2.15.1 までの過去廃止 16 ファイルを初期エントリとして同梱。
+- **`c3 update` の自動削除機能**: `_template/.claude/deletions.txt` を読み、
+  利用先の該当ファイルを削除候補として扱う。`--dry-run` で予告のみ、通常実行は
+  確認プロンプト `y/N`、`--yes` / `-y` フラグでプロンプトスキップ可。
+- **`--yes` / `-y` フラグ**（新規）: 削除確認プロンプトをスキップする。
+  **CI / 自動化ワークフロー専用**。対話環境での常用は推奨しない。
+  `--dry-run` と同時指定しても効果なし。
+- **13 段セーフガード**: 削除対象パスに対する 13 種類の事前検査
+  - 文字列レベル: 空パス / 絶対パス / `~` / バックスラッシュ / Windows ドライブレター /
+    `.claude/` プレフィックス禁止 / ANSI エスケープシーケンス検出（ECMA-48 §5.4 全網羅）
+  - 構造レベル: `..` `.` 含み / null byte / `Path.is_symlink()` でシンボリックリンク拒否 /
+    `Path.resolve()` で `.claude/` 配下確認 / `Path.is_dir()` でディレクトリ拒否 /
+    `deletions.txt` 自身の自己削除拒否（Windows NTFS case-insensitive 対応）
+- **新規テスト 35 件**: `tests/test_cli_update_deletions.py` に A: ユニット 14 件 /
+  B: 結合 8 件 / C: 攻撃 10 件 / D: CLI 4 件 = 計 36 件（既存 DEPRECATED_PATHS
+  テスト 3 件削除 → 純増 32 件）
+
+### 撤去
+
+- **`cli_update.py` の `DEPRECATED_PATHS` 定数 + `_warn_deprecated_paths()`
+  関数**: v2.15.1 で導入した「stderr 警告のみ・削除しない」方式を完全撤去し、
+  `deletions.txt` 方式に一元化。
+
+### ドキュメント
+
+- **`.claude/docs/config-policy.md`**:
+  - §3 配布判断マトリクス 12 → 13 カテゴリ（`deletions.txt` 追加）
+  - §7「既知の落とし穴」5 項目目「`deletions.txt` 自身は削除されない・
+    絶対パスは無視される」追加
+  - §8 残課題から「v2.18.0 予定」を完了化
+
+### セキュリティ
+
+- パストラバーサル / 絶対パス / Home (`~`) / Windows ドライブレター /
+  バックスラッシュ / `.claude/` プレフィックス / 親遡り / シンボリックリンク経由 /
+  ディレクトリ削除 / Windows case-insensitive バイパス / ANSI CSI シーケンス /
+  null byte / `deletions.txt` 自身 — 計 12 種の攻撃面を構造的に防御
+- Round 1 + Round 2 + Round 3 で計 17 件のレビュー指摘（CR 10 + SR 7）全件対応
+
+### 次リリース予告
+
+- **v2.19.0**（予定）: Breaking changes 警告 + バージョン checkpoint。
+  `c3 update` 実行時に前回バージョンとの diff から breaking changes 一覧を表示する。
+
+### 影響
+
+- **既存利用先**: `c3 update` 実行時に過去廃止 16 ファイルの削除候補が表示される。
+  デフォルトは確認プロンプト（`N`）のため、誤削除事故は発生しない。
+- **CI / 自動化環境**: `--yes` フラグを明示しない限り従来通り（プロンプトで止まる）。
+- **既存テスト**: 944 → 979 PASS（純増 35 件）、API 互換性完全維持。
+
+---
+
+## v2.17.0 (2026-05-24)
+
+**基盤整備リリース第 1 弾**: 設定階層と配布判断ルールを canonical 化する。
+コード変更は最小（docstring 追記のみ）、API 互換性完全維持、利用先への影響なし。
+
+### 追加
+
+- **`.claude/docs/config-policy.md` を新規作成（308 行）**: 設定階層と配布判断ルールを
+  canonical 化する。主要構成は以下:
+  - §1 設定ファイル所在マップ（配布元と利用先での所在を一覧化）
+  - §2 設定優先順位（3 レイヤー: ツール権限 / 自動承認パターン / LLM 指示）と書き込み権限マトリクス
+  - §3 配布判断マトリクス（12 カテゴリ、`_excludes.py` の `EXCLUDE_PATTERNS` / `KEEP_PATTERNS`
+    と完全照合済み）
+  - §4 `settings.local.json` 運用の原則（`git add -f` リスク警告 / `c3 init` は `.gitignore`
+    を自動編集しないため手動追記が必要な点を明記）
+  - §5 プラットフォーム別 config 整合（canonical は `.claude/`、`.codex/` / `.cursor/` /
+    `.agents/` は adapter 生成物）
+  - §6 3 ファイル同期ルール（`.gitignore` / `_excludes.py` / `hatch_build.py`）
+  - §7 既知の落とし穴（`hooks` セクションの完全上書き / `taxonomy.md` の特殊扱い /
+    `rules/promoted/` を `c3 update` が触らない / `permission_rules.json` の `auto_allow`
+    過度設定リスク）
+  - §8 参照先
+- **`src/c3/_excludes.py` / `hatch_build.py` の docstring**:
+  両ファイル冒頭の docstring 末尾に「See `.claude/docs/config-policy.md`」参照を
+  完全一致 1 文で追記（3 ファイル同期の精神に則る）。定数 `EXCLUDE_PATTERNS` /
+  `KEEP_PATTERNS` は変更なし。
+- **`.claude/CLAUDE.md`**: Directory Structure セクション末尾に config-policy.md
+  への参照を 1 行追加。
+
+### 背景・経緯
+
+`.claude/docs/C3のconfig_policyとversion_upgradeの考慮点と超えるべき壁.md`（2026-05-22
+作成、配布元専用）で整理された「基盤整備 3 連発」のうち、規模「小 × 2」の高優先項目
+を 1 リリースで完結させた。アーキテクト段階の実装照合で以下 3 点を初期素案から
+訂正:
+- 配布判断マトリクス 10 → 12 カテゴリ（`permission_rules.json` 独立追加、例外 3 件明示）
+- 章数 7 → 8（§7「既知の落とし穴」追加）
+- 「5 段優先順位」→「3 レイヤー」（実装と乖離していたため修正）
+
+### 次リリース予告
+
+- **v2.18.0** (予定): `c3 update` が削除を検出しない問題（`c3_update_no_delete_detection`
+  パターン）の解消。`deletions.txt` 方式で配布物に削除すべきパス一覧を含める。
+- **v2.19.0** (予定): Breaking changes 警告 + バージョン checkpoint。`c3 update`
+  実行時に前回バージョンとの diff から breaking changes 一覧を表示する。
+
+### 影響
+
+- 既存利用先: なし。doc 追加 + docstring 追記のみで、コード挙動・CLI 挙動・wheel
+  配布物の構造（`_template/.claude/docs/` 配下に `config-policy.md` 追加のみ）に
+  破壊的変更はない。
+- 既存テスト: 944 PASS / 4 skip 維持。
+- レビュー対応: Round 1 code-review 4 件（M-01 / M-02 / L-01 / L-02）+ Round 2
+  security-review 3 件（SR-M-01 / SR-L-01 / SR-L-02）を計 3 ラウンドで全件解消。
+
+---
+
 ## v2.16.0 (2026-05-24)
 
 ### 修正

{claude_code_conductor-2.16.0 → claude_code_conductor-2.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-conductor
-Version: 2.16.0
+Version: 2.18.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

{claude_code_conductor-2.16.0 → claude_code_conductor-2.18.0}/hatch_build.py

@@ -6,6 +6,9 @@ than rely on ``[tool.hatch.build] exclude`` patterns - which do not propagate
 into ``force-include`` sources - we copy the wanted subset into a staging
 location during ``initialize()`` and the wheel target packages that staged tree
 verbatim.
+
+See ``.claude/docs/config-policy.md`` for the distribution decision matrix
+and the rationale behind each excluded pattern.
 """
 
 from __future__ import annotations
@@ -65,6 +68,7 @@ KEEP_PATTERNS: tuple[str, ...] = (
     "memory/archive/.gitkeep",
     "tmp/.gitkeep",
     "state/.gitkeep",
+    "deletions.txt",  # 新規: c3 update が読む削除指示書
 )
 
 

{claude_code_conductor-2.16.0 → claude_code_conductor-2.18.0}/src/c3/__init__.py

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

{claude_code_conductor-2.16.0 → claude_code_conductor-2.18.0}/src/c3/_excludes.py

@@ -11,6 +11,9 @@ Used by:
 Patterns are POSIX-style and relative to the ``.claude/`` directory itself
 (e.g. ``"reports/*"``, not ``".claude/reports/*"``). ``KEEP_PATTERNS`` win
 over ``EXCLUDE_PATTERNS`` so that placeholder ``.gitkeep`` files survive.
+
+See ``.claude/docs/config-policy.md`` for the distribution decision matrix
+and the rationale behind each excluded pattern.
 """
 
 from __future__ import annotations
@@ -62,6 +65,7 @@ KEEP_PATTERNS: tuple[str, ...] = (
     "memory/archive/.gitkeep",
     "tmp/.gitkeep",
     "state/.gitkeep",
+    "deletions.txt",  # 新規: c3 update が読む削除指示書
 )