claude-code-conductor 2.75.0__tar.gz → 2.77.0__tar.gz

{claude_code_conductor-2.75.0 → claude_code_conductor-2.77.0}/.claude/CLAUDE.md

@@ -14,6 +14,22 @@ C3 は、業務アプリケーション開発で製品としての品質を保
 
 背景: 業務アプリは機密情報を扱い、作って終わりではなく保守・運用が続く。
 
+## 根本解決の原則（監査・レビューを通すための対応をしない）
+
+- 監査（C-3）・レビュー（E）・テストの指摘に対して、**指摘を消すためだけの対応（言い換え・周辺の付け足し・機構の差し替え）を行わない**
+- 指摘の背後にある**根本問題を 1 文で書き**、それを解く手段を採る。根本問題を解いているかは、OS・ライブラリの一次資料（ソース・公式ドキュメント）と実測で裏取りしてから確定する
+- **影響範囲が大きくても、コストがかかっても、根本解決できるものは必ず根本解決の手段を取る。** 同じコストを払うなら、修正範囲が広い根本解決の方が、後から積む機能への影響が少なくトータルコストが安い
+- 監査・レビューを通すためだけの対応に払うコストは、開発で最も無駄なコストである。ゲートが緑になることは目的の達成を意味しない
+- 対症療法しか取れない場合は、その理由（根本解決が構造的に不可能・現時点の情報では原因が確定しない等）を明記し、根本解決へ戻るトリガーをセッションファイルの残タスクに残す。「後で直す」をトリガーなしに先送りしない
+
+判断の手順:
+
+1. 指摘・欠陥の**根本問題を 1 文で書く**
+2. 候補となる対策が、その根本問題を**解くのか・隠すのか**を分ける。隠す対策は採らない
+3. 解く対策の修正範囲が大きい場合も、設計（architecture-report）と計画（plan-report）に載せて実施する。範囲の大きさを理由に縮小する裁定はユーザーが行う
+4. 実装前に一次資料と再現実験で仮説を裏取りする。仮説が反証されたら実装せず再調査する
+5. 是正後は「指摘が消えたか」ではなく「根本問題が解けたか」を実測で示す（Red → Green の反転・本番経路での再現条件の消失）
+
 ## 設計思想
 
 - 対策・規約は「書きやすい場所」ではなく「効く場所」に置く。読み手（agent / skill）の Read 経路に届いていない規約は存在しないのと同じ

{claude_code_conductor-2.75.0 → claude_code_conductor-2.77.0}/.claude/skills/dev-workflow/references/code-review-checklist.md

@@ -29,6 +29,12 @@
 - [ ] [CR-E-004] ユーザーへのエラーメッセージが適切か（内部情報を含まないか・わかりやすいか）
 - [ ] [CR-E-005] エラーの伝播方法が適切か（再スロー・ラップ・変換が適切か）
 
+### リソース管理
+- [ ] [CR-RS-001] 取得したリソース（ファイル・DB接続・ソケット・サブプロセス・一時ファイル）が正常系・異常系の両方で解放されているか（with / try-finally / using / defer 等。異常系のみを見る観点は [CR-E-003]）
+- [ ] [CR-RS-002] 登録したものが解除されているか（イベントリスナー・タイマー・シグナルハンドラ・購読・コールバック）
+- [ ] [CR-RS-003] 無制限に増加するコレクション・キャッシュ・バッファがないか（上限・退去ポリシー・弱参照の検討）
+- [ ] [CR-RS-004] 長時間稼働・ループ反復でメモリ使用量が単調増加しないか（反復ごとに解放されているか。作成物の種別を問わず確認する）
+
 ### ログ
 - [ ] [CR-L-001] ログ出力が適切なレベル（DEBUG / INFO / WARN / ERROR）で行われているか
 - [ ] [CR-L-002] 個人情報・秘密情報がログに出力されていないか
@@ -78,7 +84,7 @@
 
 ### フロントエンド向け
 - [ ] [CR-FE-001] 不要な再レンダリングが発生していないか（メモ化・依存配列の設定等）
-- [ ] [CR-FE-002] メモリリークが発生していないか（イベントリスナー・タイマーの解放）
+- [ ] [CR-FE-002] メモリリークが発生していないか（イベントリスナー・タイマーの解放。フロントエンド固有の具体化であり、リーク全般は [CR-RS-001]〜[CR-RS-004] で確認する）
 - [ ] [CR-FE-003] 大量データのレンダリングに仮想スクロール等の対策があるか
 - [ ] [CR-FE-004] アクセシビリティ（aria属性・キーボード操作・コントラスト）が考慮されているか
 - [ ] [CR-FE-005] 国際化（i18n）対応が必要な場合に対応されているか
@@ -86,7 +92,7 @@
 ### バッチ処理 / 非同期処理向け
 - [ ] [CR-BC-001] 冪等性が担保されているか（同じ処理を複数回実行しても問題ないか）
 - [ ] [CR-BC-002] 処理の途中失敗時にリカバリできるか（再実行・チェックポイント）
-- [ ] [CR-BC-003] メモリ使用量が適切か（大量データを一括ロードしていないか・ストリーム処理等）
+- [ ] [CR-BC-003] ピークメモリ使用量が適切か（大量データを一括ロードしていないか・ストリーム処理等。時間経過に伴う単調増加は [CR-RS-004]）
 - [ ] [CR-BC-004] キューの詰まり・バックプレッシャーへの対策があるか
 
 ### ライブラリ / SDK向け

{claude_code_conductor-2.75.0 → claude_code_conductor-2.77.0}/.claude/skills/parallel-agents/SKILL.md

@@ -157,7 +157,7 @@ wave を起動する前に `git status` が空（未コミット変更なし）
 各 Agent ツール呼び出しに以下を指定:
 
 - `subagent_type`: 上記マッピング表の値
-- `model`: **親 Claude は `model:` を指定しない**。`wt_developer` タスクは起動時に PreToolUse hook（`.claude/hooks/tier_autoapply.py`）が `[tier-routing 推奨]`（developer 基準）の推奨 Tier を `model:` へ自動適用する（機械適用・親 Claude が model: を転記する必要はない）。この推奨 Tier の SSOT は `.claude/state/tier_selection.json` の `tier`（無ければ `suggested_model`）であり、kickoff の UserPromptSubmit で 1 度確定して以降 wave をまたいで安定する（`[tier-routing 推奨]` の表示テキストはその派生表示）。hook は実適用した model を `.claude/state/tier_autoapply.jsonl` に記録する（適用者=記録 SSOT）。並列 wave 内に複数の `wt_developer` が居る場合、**全 wt_developer は同一の推奨 Tier（単一 tier_selection.json.tier）で起動される。これは本 MVP の設計として明示的に許容する**（per-task complexity に応じて wt_developer ごとに tier を変える機能は本 MVP のスコープ外・フェーズ 3 以降）。推奨と異なる Tier を使いたい場合のみ `model:` を明示指定する（明示指定は hook に尊重され上書きされない）。`wt_tester` は **test- タスク（Red）に限り機械適用対象**（`C3_TASK_ID` マーカーの `test-` プレフィックスで RED_APPLY_ROLES 注入・confirm- 等の非 test- タスクは対象外＝frontmatter 任せ）。`wt_systematic-debugger` / `code-reviewer` / `security-reviewer` は **model: 指定対象外**（frontmatter/元 agent 任せ・機械適用対象外）。fork は model 上書き不可のため対象外。
+- `model`: **親 Claude は `model:` を指定しない**。`wt_developer` タスクは起動時に PreToolUse hook（`.claude/hooks/tier_autoapply.py`）が `[tier-routing 推奨]`（developer 基準）の推奨 Tier を `model:` へ自動適用する（機械適用・親 Claude が model: を転記する必要はない）。この推奨 Tier の SSOT は `.claude/state/tier_selection.json` の `tier`（無ければ `suggested_model`）であり、kickoff の UserPromptSubmit で 1 度確定して以降 wave をまたいで安定する（`[tier-routing 推奨]` の表示テキストはその派生表示）。hook は実適用した model を `.claude/state/tier_autoapply.jsonl` に記録する（適用者=記録 SSOT）。並列 wave 内に複数の `wt_developer` が居る場合、**全 wt_developer は同一の推奨 Tier（単一 tier_selection.json.tier）で起動される。これは本 MVP の設計として明示的に許容する**（per-task complexity に応じて wt_developer ごとに tier を変える機能は本 MVP のスコープ外・フェーズ 3 以降）。推奨と異なる Tier を使いたい場合のみ `model:` を明示指定する（明示指定は hook に尊重され上書きされない）。**上流環境変数の注意**: `CLAUDE_CODE_SUBAGENT_MODEL_FORCE`（Claude Code v2.1.257+）が設定されていると、ハーネスは per-spawn の `model:`（hook 注入・明示指定とも）と agent 定義の `model:` を無視して全サブエージェントを強制モデルで起動する。hook は注入と `tier_autoapply.jsonl` 記録を行うため、記録された tier と実適用モデルが乖離する。C3 は同変数を設定しない。tier-routing を使う環境ではこの変数を設定しないこと（`CLAUDE_CODE_SUBAGENT_MODEL` は既定値扱いで注入が優先されるため影響なし・v2.1.251+）。`wt_tester` は **test- タスク（Red）に限り機械適用対象**（`C3_TASK_ID` マーカーの `test-` プレフィックスで RED_APPLY_ROLES 注入・confirm- 等の非 test- タスクは対象外＝frontmatter 任せ）。`wt_systematic-debugger` / `code-reviewer` / `security-reviewer` は **model: 指定対象外**（frontmatter/元 agent 任せ・機械適用対象外）。fork は model 上書き不可のため対象外。
 - `isolation`: **`read_only: false` タスクのみ `"worktree"` を指定する。ただし `writes` が全て gitignored ファイル（実質 `.claude/reports/` のレポートのみ）のタスク（confirm- 系が典型）は git 的に「未変更」の worktree となるため Agent 完了時に auto-cleanup され、親が取り込む前に成果物が消失する（2026-07-26 実測）ため、worktree を使わず `isolation` を省略して main 直接経路・素の agent（読み替え: `wt_tester`→`tester` 等）で起動する。`read_only: true`（code-reviewer / security-reviewer）はソースを変更しないため worktree 不要。`isolation` を省略して main リポジトリで直接実行し、レポートを main の `.claude/reports/` に直接書かせる。**
   > **R5 hook による機械強制**: 上記ルールに違反して `read_only: true` のレビュータスクに `isolation: "worktree"` を指定した場合、`.claude/hooks/check_agent_invocation.py`（PreToolUse Agent hook）が exit 2 でブロックする。詳細は `.claude/skills/dev-workflow/references/plan-design-guidelines.md` R5 参照。
 - `run_in_background`: `true`

{claude_code_conductor-2.75.0 → claude_code_conductor-2.77.0}/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## [2.77.0] - 2026-09-09
+
+### 追加
+
+- **`code-review-checklist.md` の必須チェック項目（全作成物共通）に「リソース管理」節を新設した**
+  （`[CR-RS-001]`〜`[CR-RS-004]`）。取得したリソース（ファイル・DB接続・ソケット・サブプロセス・
+  一時ファイル）の正常系・異常系両方での解放、登録したもの（イベントリスナー・タイマー・
+  シグナルハンドラ・購読・コールバック）の解除、無制限に増加するコレクション・キャッシュ・
+  バッファの有無、長時間稼働・ループ反復でのメモリ使用量の単調増加、の 4 観点を作成物の種別を
+  問わない共通項目として立てた。
+  従来メモリリークに関する観点は作成物別チェック項目の `[CR-FE-002]`（フロントエンド向け）にしか
+  存在せず、バッチ処理・Web API バックエンド・ライブラリのリークには該当 ID が無かった。
+  `[CR-BC-003]` はピーク使用量、`[CR-E-003]` は異常系のリソース解放を見る項目であり、
+  時間経過に伴う累積を射程に含まない。実利用先（業務バッチ）で code-reviewer / security-reviewer
+  とも 0 指摘で通過したメモリリークが外部レビューで検出された事例を受けた是正
+
+### 変更
+
+- `[CR-FE-002]` と `[CR-BC-003]` に射程の相互参照を追記した。`[CR-FE-002]` は
+  「フロントエンド固有の具体化であり、リーク全般は `[CR-RS-001]`〜`[CR-RS-004]` で確認する」を、
+  `[CR-BC-003]` は「ピークメモリ使用量」への限定と「時間経過に伴う単調増加は `[CR-RS-004]`」を
+  明示した。「メモリリークはフロントエンド固有の関心事」という誤読が今回の見落としの構造要因で
+  あったため、共通項目の新設と併せて射程を明文化したもの
+
+## [2.76.0] - 2026-09-04
+
+### 追加
+
+- `.claude/CLAUDE.md` に「根本解決の原則（監査・レビューを通すための対応をしない）」節を追加した。
+  監査（C-3）・レビュー（E）・テストの指摘に対し、指摘を消すためだけの対応（言い換え・周辺の付け足し・
+  機構の差し替え）を禁じ、根本問題を 1 文で書いてそれを解く手段を採る原則 5 項目と、判断の手順 5 段階
+  （根本問題の 1 文化 → 解く/隠すの仕分け → 修正範囲が大きくても設計・計画に載せる → 一次資料と再現実験で
+  裏取り → 根本問題が解けたことを実測で示す）を定めた。対症療法しか取れない場合は理由を明記し、
+  根本解決へ戻るトリガーをセッションファイルの残タスクに残す。是正ループの打切条件（3 連続で前提を疑う）は
+  dev-workflow E-3 を唯一の正本とし、本節には重複記述を置かない。利用先プロジェクトで運用して不足と
+  判明した規約を C3 本体へ取り込んだもの
+
+### 変更
+
+- `parallel-agents` skill の `model:` 指定規則と `docs/spec/02-hooks.md` の tier_autoapply 仕様表に、
+  Claude Code v2.1.257 で追加された環境変数 `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` の注意を追記した。
+  同変数が設定されていると per-spawn の `model:`（hook 注入・明示指定とも）と agent 定義の `model:` が
+  ハーネス側で無視され、tier_autoapply が記録した tier と実適用モデルが乖離する。C3 は同変数を設定しない
+  （`CLAUDE_CODE_SUBAGENT_MODEL` は v2.1.251 以降既定値扱いで注入が優先されるため影響なし）
+
 ## [2.75.0] - 2026-08-16
 
 ### 追加

{claude_code_conductor-2.75.0 → claude_code_conductor-2.77.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: claude-code-conductor
-Version: 2.75.0
+Version: 2.77.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.75.0 → claude_code_conductor-2.77.0}/src/c3/__init__.py

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