claude-code-conductor 2.78.0__tar.gz → 2.79.0__tar.gz

{claude_code_conductor-2.78.0 → claude_code_conductor-2.79.0}/.claude/CLAUDE.md

@@ -30,6 +30,20 @@ C3 は、業務アプリケーション開発で製品としての品質を保
 4. 実装前に一次資料と再現実験で仮説を裏取りする。仮説が反証されたら実装せず再調査する
 5. 是正後は「指摘が消えたか」ではなく「根本問題が解けたか」を実測で示す（Red → Green の反転・本番経路での再現条件の消失）
 
+## テストとプロダクトの関係
+
+プロダクトコードが正であり、テストコードはその変更に合わせて作成・変更・削除するものである。既存テストを不可侵として設計を歪めない。
+
+守る対象は次の 3 段に分かれる。段が違えば扱いも違う。
+
+1. **直前の Red が書いたテストは実装タスクが変更しない。** 崩すと「実装が通るようにテストを書き換える」経路が開き、TDD の検査そのものが消える。変更が要ると判断したら実装を止めて親へ申告する
+2. **assert が測っている性質（期待値）は変えない。** 削除・恒真化・比較の緩和を行わない。変える必要があると判断したら、それはプロダクトの振る舞いを変える判断であって実装タスクの裁量ではないので、止めて親へ申告する（親がユーザーの裁定を仰ぐ）
+3. **呼び出しの形（署名・引数の数・タプルの形・ヘルパ名・型注釈・インポート）は必要なら機械的に直してよい。** これは契約ではなく結合である。直したファイルと件数、変更箇所の diff、および「assert が測っている性質を 1 件も変えていない」ことを report に申告する
+
+`writes` に無いファイルの形を直す必要が出たら止めて親へ申告する（親が `writes` を見直す）。「`writes` に無いから設計を曲げる」判断をタスク側で行わない。
+
+段 3 の申告を受け取った側（親、および確認を担うタスク）は、申告と実 diff を突合し、申告外の変更が無いことを確認する。
+
 ## 設計思想
 
 - 対策・規約は「書きやすい場所」ではなく「効く場所」に置く。読み手（agent / skill）の Read 経路に届いていない規約は存在しないのと同じ

{claude_code_conductor-2.78.0 → claude_code_conductor-2.79.0}/.claude/agents/planner.md

@@ -41,7 +41,7 @@ requirements-report・architecture-report・各種レビューレポートを統
 **During:**
 - レビュー指摘がある場合は優先度を付けて反映する
 - タスクは「1タスク = 1コミット」の粒度を意識して分解する
-- `.claude/skills/dev-workflow/references/plan-design-guidelines.md` のルール 1〜20 と R2〜R6 を遵守する（適用射程は同ファイル冒頭の分類表に従う。`"sequential"` プランでは並列前提ルールを適用しない）
+- `.claude/skills/dev-workflow/references/plan-design-guidelines.md` の全ルールと R2〜R6 を遵守する（適用射程は同ファイル冒頭の分類表に従う。`"sequential"` プランでは並列前提ルールを適用しない）
 
 **After:**
 - Skill ツールで `report-timestamp` を呼び出してタイムスタンプを取得し、Write ツールで `.claude/reports/plan-report-{timestamp}.md` に出力する
@@ -58,7 +58,7 @@ requirements-report・architecture-report・各種レビューレポートを統
 制限:
 - ソースファイルの編集・書き込みは行わない
 - plan-report の YAML フロントマター内で `tasks[].id` の重複・未定義の `depends_on` 参照・エージェント名の typo を出力しない（`c3 plan validate` で検証可能）
-- `.claude/skills/dev-workflow/references/plan-design-guidelines.md` のルール 1〜20 と自己チェックリストに違反した plan-report を出力しない（適用射程は分類表に従う）
+- `.claude/skills/dev-workflow/references/plan-design-guidelines.md` の全ルールと自己チェックリストに違反した plan-report を出力しない（適用射程は分類表に従う）
 - 自動検査対象に違反する plan-report を出力しない:
   - R2/R4/R6（配布対象）: `.claude/hooks/planner_check.py` が PostToolUse で WARN を出す
   - R3（C3 固有）: `.dev/hooks/_planner_check.py` が PostToolUse で exit 2 ブロック

{claude_code_conductor-2.78.0 → claude_code_conductor-2.79.0}/.claude/skills/dev-workflow/references/plan-design-guidelines.md

@@ -5,7 +5,7 @@
 | 分類 | ルール番号 | R 番号 | 自己チェックリスト項目 |
 |---|---|---|---|
 | `"0.1"`（並列実行）限定 | ルール 1・2・10・11・14／ルール 3・9（※直後の注記により sequential でも成果物宣言・レビュー配置の規律は満たすこと） | R5（isolation 指定が発生しない逐次では非該当） | チェーン長／同一ファイル衝突／R5／ルール 14 |
-| 両モード共通 | ルール 4・5・7・8・12・13・15・16・17・18・19・20 | R2・R3・R4・R6（planner_check hook 群は po_plan_version の値を読まないため sequential プランでも発火する） | id 一意・depends_on 参照先実在／空配列禁止／TDD 3 タスク分解／15 分粒度／R6／writes が空のタスク／レビュータスクの depends_on／ルール 15 方向検算／テスト凍結の実装責任／手順過多の契約化／一時改変の後始末方法／検知力検証の双方向／gitignored 検証パス |
+| 両モード共通 | ルール 4・5・7・8・12・13・15・16・17・18・19・20・21 | R2・R3・R4・R6（planner_check hook 群は po_plan_version の値を読まないため sequential プランでも発火する） | id 一意・depends_on 参照先実在／空配列禁止／TDD 3 タスク分解／15 分粒度／R6／writes が空のタスク／レビュータスクの depends_on／ルール 15 方向検算／テスト凍結の実装責任／手順過多の契約化／一時改変の後始末方法／検知力検証の双方向／gitignored 検証パス／既存テストの扱いの指示 |
 | 逐次では読み替え | ルール 6（Stuck Signal の契約自体は共通。wave 失敗時の 2-E 吸収は並列限定の運用であり、逐次は dev-workflow SKILL.md の D-2.5〈Stuck チェック〉で吸収する） | - | - |
 
 **注記**: 両モード共通に分類されたルール（5・R2・R4・R6 等）が `writes` や reviewer タスクの存在を前提とする場合、**その前提を作るルール（9・3）も sequential プランで満たすこと**。`"0.1"` 限定の趣旨は『並列度・worktree 取り込み衝突に関する制約』に限られ、成果物宣言・レビュー配置の規律はモードを問わない。
@@ -151,6 +151,17 @@ Stage 1: dev_a, dev_b, dev_c (並列)
 
 20. **直接 Read・状態外の指示分離** — gitignored ファイル（`.claude/reports/` 等）の検証は `git status --short` ではなく **直接 Read で行うこと**。git 管理下で成果物を検証する必要があれば、明示的に commit → 確認 → cleanup の流れを指示する。worktree で起動される worker（developer / tester）の prompt には gitignored 文書の Read を指示しないこと（届く経路が無い。親か plan-report 経由で指す）。reviewer 向けの prompt には「当該ファイルは gitignored である」と明記し、reviewer に直接 Read させることを指示する。
 
+## 既存テストの扱いの指示（ルール 21）
+
+21. **3 段を指し、不可侵と読ませない** — `tasks[].prompt` に「既存テストを変えない」「既存テストの期待を変えない」「既存の行に触れない」と書かない。呼び出しの形まで不可侵と読まれ、プロダクト側の設計が歪む。代わりに次の各点を満たす:
+    - **TDD の各タスクすべて**（Red / Green / 確認、および D-4 / D-5 に対応する Refactor / 最終確認を置く場合はそれらも）の `prompt` に「`.claude/CLAUDE.md`「テストとプロダクトの関係」の 3 段に従う」を 1 行書く。3 段の本文は `.claude/CLAUDE.md` が唯一の所在であり、`prompt` および本ファイルへ転記しない
+    - 実装タスクの `prompt` に「段 3 に該当する修正をした場合は `.claude/CLAUDE.md` 段 3 が要求する申告を返却報告に含める」を書く（申告項目は `.claude/CLAUDE.md` 段 3 が正であり本ファイルへ列挙しない。実装タスクは `.claude/reports/` に成果物を書かないため、申告先を返却報告に確定する）
+    - 凍結対象を挙げる必要がある場合は assert が測っている性質を挙げ、呼び出しの形（署名・引数の数・タプルの形・ヘルパ名・型注釈・インポート）を挙げない
+
+    射程を「既存テストに触れるタスク」で切らないのは、`writes` に `tests/` を含むかで同定すると、段 1 を守るべき実装タスク自身が射程外になるためである。`writes` の外の形を直す必要が出た場合もタスク側で設計を曲げさせない（`writes` の見直しは親が行う）。本ルールはルール 16（凍結仕様の実装責任）と対になる。
+
+    **なぜ必要か**: 別リポジトリの実運用で、prompt の「既存テストの期待を変えない」が「既存の行に触れない」と読まれ、既存メソッドへの引数追加を断念して別名メソッドを 2 本並べる形が Red に固定された。呼び出し 30 箇所は引数 1 つの追加で済み、当該ファイルは Red を書くタスクの `writes` に入っていた（制約は実在しなかった・2026-09-16 / Issue #6）。
+
 ---
 
 ## 出力直前の自己チェックリスト
@@ -174,6 +185,7 @@ plan-report を Write する前に以下を必ず確認する:
 - [ ] ルール 18: 一時改変指示は後始末手段を逐語で指定し、git checkout/restore/reset を明示的に禁止しているか
 - [ ] ルール 19: 検証系 task の contract に do-nothing スタブ 2 種の赤緑反転実証が含まれているか（適用困難なら代替宣言）
 - [ ] ルール 20: gitignored 成果物検証は直接 Read 指示で行い、worker prompt には Read を指示していないか
+- [ ] ルール 21: prompt に「既存テストを変えない」類の文言が無く、TDD の各タスクに 3 段への参照 1 行と、実装タスクに段 3 の申告要求があるか
 
 ---
 

{claude_code_conductor-2.78.0 → claude_code_conductor-2.79.0}/CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog
 
+## [2.79.0] - 2026-09-18
+
+### 追加
+
+- **既存テストの扱いを 3 段に分ける規約を追加した**（GitHub Issue #6 を起点とする）。`.claude/CLAUDE.md` に
+  「テストとプロダクトの関係」節を新設し、プロダクトコードが正でありテストコードはその変更に合わせて
+  作成・変更・削除するものであることを明記した。既存テストへの向き合い方を 3 段に分け、(1) 直前の Red が
+  書いたテストは実装タスクが変更しない (2) assert が測っている性質（期待値）は変えない (3) 呼び出しの形
+  （署名・引数の数・タプルの形・ヘルパ名・型注釈・インポート）は機械的に直してよく report に申告する、とした。
+  `plan-design-guidelines.md` にルール 21（既存テストの扱いの指示）を追加し、`tasks[].prompt` に
+  「既存テストを変えない」「既存の行に触れない」といった不可侵と読める文言を書かないことを求め、代わりに
+  TDD の各タスクへ 3 段への参照 1 行と、実装タスクへ段 3 の申告要求を書くことを規定した
+- `tests/skills/test_existing_test_policy.py` を新規追加し、(a) `.claude/CLAUDE.md` に「テストとプロダクトの
+  関係」の見出しが存在すること (b) `plan-design-guidelines.md` にルール 21 の見出しが存在すること
+  (c) `.claude/agents/planner.md` にルール番号範囲のハードコードが存在しないこと、を機械検証する
+- ルール 21 の段 3（呼び出しの形の機械修正）の申告要求を強化した。実装タスクの返却報告に「変更箇所の diff」を
+  含めることを求め、さらに実装タスクの `writes` に既存テストファイルを含む計画（＝段 3 が発火しうる計画）に限り、
+  確認タスクの `prompt` に段 3 の申告と実 diff の突合を書くよう求めた。段 3 の許可は自己申告であり、申告の
+  妥当性を見る主体が無いと段 2 の禁止が実効しないため
+- `tests/skills/test_existing_test_policy.py` の判定を 2 点狭めた。(a) ルール 21 のキーワード判定に右側の数値境界を
+  加え、「ルール 210」「ルール 219」のように右に数字が続く文字列に当たらないようにした（`（ルール 210）` の見出し
+  だけを置いた偽ルートで不充足になる負の対照を常設した）(b) リポジトリルートの解決で環境変数の値を realpath で
+  正規化（シンボリックリンク解決後）してから使い、解決後が実在するディレクトリでない場合は明示的に失敗する
+  ようにした。いずれも判定が狭くなる方向のみで、既存の検査を緩めていない
+
+### 変更
+
+- `.claude/agents/planner.md` のルール番号範囲のハードコード（「ルール 1〜20」）を撤去し「全ルール」という
+  番号非依存の表現に変えた。ルール追加のたびに番号を追随させる運用を無くし、陳腐化する形そのものを消した
+- 段 3 の申告項目（変更箇所の diff）を `.claude/CLAUDE.md` の段 3 本体に配置し、planner 経由ではない
+  全エージェントが参照できる形にした。これにより plan-report の prompt 経由でなく CLAUDE.md 自動注入経由で
+  申告要求に到達する
+- 段 3 の申告と実 diff の突合を `.claude/skills/dev-workflow/SKILL.md` の D-3 にも配置し、
+  plan-design-guidelines.md のルール 21 に加えて dev-workflow フェーズの直接起動経路（plan-report 非経由）にも
+  届く形にした。段 3 の許可が自己申告のみでは実効しない問題を両経路で対策
+- 段 3 の統制の前提を転換した。経路ごとに手順書へ 1 文ずつ配線する方式は、周回のたびに新しい経路（plan 経路 →
+  直接起動経路 → bug-fix モードの D-3）が見つかり配線漏れを生んだため、受け取り側の突合義務を
+  `.claude/CLAUDE.md` 段 3 の 1 箇所へ集約した。同ファイルは全 role へ自動注入されるため経路の数え上げが不要になる。
+  あわせて経路ごとの個別配線 2 箇所（`dev-workflow/SKILL.md` 通常 D-3 の 1 文、`plan-design-guidelines.md`
+  ルール 21 の突合箇条）を撤去し、同じ義務が複数箇所に存在してドリフト源になる状態を解消した
+
 ## [2.78.0] - 2026-09-13
 
 ### 追加

{claude_code_conductor-2.78.0 → claude_code_conductor-2.79.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: claude-code-conductor
-Version: 2.78.0
+Version: 2.79.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.78.0 → claude_code_conductor-2.79.0}/src/c3/__init__.py

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