claude-code-conductor 2.52.1__tar.gz → 2.54.0__tar.gz

{claude_code_conductor-2.52.1 → claude_code_conductor-2.54.0}/.claude/CLAUDE.md

@@ -31,6 +31,8 @@
 
 コンテキストに応じて選択肢を追加してよい。
 
+自律モード（autonomous-mode skill・opt-in 必須）が有効な場合のみ、上記の承認ゲートは同 skill のゲート対応表に従って客観条件へ付け替わる。既定は常に HITL であり、opt-in なしに挙動が変わることはない（ただしこれは文書規約レベルの不変則であり、モード行挿入自体を機械的に承認と紐付ける仕組みではない。詳細は SKILL.md「モード行挿入の前提条件（不変則）」を参照）。
+
 ## Compact Instructions
 
 ### KEEP（保持する）
@@ -61,4 +63,6 @@
 - **`Skill` ツール / `/<skill>`** の参照は、Codex では `.agents/skills/<name>/SKILL.md`、Cursor では `.claude/skills/<name>/SKILL.md` を直接読み込む。OpenCode では `.opencode/agents/c3-skill-<name>.md`（`.claude/skills/<name>/SKILL.md` を本文に埋め込み済み）を `@mention` で起動する（スラッシュコマンド自動展開は Claude Code 専用機能）
 - **`isolation: worktree`** / **`permissionMode`** / **`tools` 制限** など agent フロントマターの一部キーは Claude Code 仕様。adapter 側では読み替え不能なものは無視される（OpenCode adapter は全 agent に `bash/read/edit/write/websearch` を一律付与する）
 
+- **自律モード**: autonomous-mode は Claude Code 専用。Codex / Cursor / OpenCode では自律宣言は常に無効＝HITL で動作する（モード行の検証は `mode_line.py`・Bash 経由に依存し、他プラットフォームで安全に再現できないため。検証できない → HITL の fail-closed 原則がそのまま正しい挙動になる）。adapter 生成物にも autonomous-mode skill は写像されない。
+
 レポート（`.claude/reports/`）・state（`.claude/state/`）・memory（`.claude/agent-memory/`）のファイル名と書き込み先は全プラットフォーム共通。adapter 生成物の詳細は `c3 init --platform codex|cursor|opencode` で出力される `AGENTS.md` / `.cursor/rules/c3-core.mdc` / `.opencode/agents/` を参照。

claude_code_conductor-2.54.0/.claude/docs/autonomous-mode-onboarding.md

@@ -0,0 +1,102 @@
+# 自律モード オンボーディング
+
+C3 の「自律モード（autonomous mode）」を初めて使う人向けの導入ガイド。
+**手順と心構え**だけを書く。数値・条件・文法の厳密な定義は規約 SSOT である
+`.claude/skills/autonomous-mode/SKILL.md` を参照すること（本文書は規約を再定義しない）。
+
+> このガイドは `.claude/docs/` 配下の人間向けリファレンス。エージェントが実行時に読む必要はない。
+
+---
+
+## ① 自律モードとは
+
+自律モードは、C3 標準ワークフローの承認ゲート（レポート承認・テスト承認・findings 分岐など）を、
+ユーザーが承認した**委任プラン**に従って客観条件で自動進行させる運転モードである。
+
+- **既定は常に HITL（Human In The Loop）**。何もしなければ従来どおり各フェーズで承認を求める。
+- 有効化には**二重の opt-in** が必要:
+  1. プランモードで「資源同意節を含む委任プラン」をユーザーが承認する
+  2. その承認直後に、親 Claude がセッションファイルへ**モード行**を挿入する
+- opt-in なしに挙動が変わることはない（誤発動ゼロを最優先に設計されている）。
+  ただしこれは文書規約レベルの不変則であり、モード行の挿入自体がセレモニー経由であることを機械検証する仕組みではない
+  （既知の限界は SKILL.md「モード行挿入の前提条件（不変則）」を参照）。
+
+---
+
+## ② 正しい始め方
+
+**プランモードを先に通すのが唯一の正しい入口**。順序を守ること。
+
+1. **プランモードで委任プランを作る**。プランには固定様式の `## 資源同意` 節を含める
+   （ハード上限・起動体数の見込み・「承認をもって資源消費に同意」の 3 点。様式は SKILL.md の
+   「委任プランの必須節（資源同意）」を参照）。
+2. **プランを承認する**。この承認が「資源消費への同意」の成立点になる。
+3. 承認直後に、親 Claude が `現在地:` 行の直後へモード行を挿入する。初期形は
+   `モード: 自律 plan=<委任プランの絶対パス> cycles=C-3/0,E/0`（`cycles=` は opt-in 時に発効し初期値は両ゲート 0）。
+
+**よくある誤り**:
+
+- **`/start` を先に叩くのは誤り**。標準ワークフローを HITL で走らせてしまい、自律モードにはならない。
+  自律運転は「プランモード承認 → モード行挿入」を経てから、init-session（セッション交代・コンパクト後）が
+  モード行を読んで継続する形で成立する。
+- 資源同意節を欠くプランで opt-in を成立させてはならない（欠落時は人間へ確認＝関所 2）。
+
+---
+
+## ③ 質問が来るのは設計どおり
+
+自律運転中でも人間に質問が返ってくることがある。これは**故障ではなく設計どおりの安全装置**である。
+以下の 2 類型（人間の関所）は自律モードでも自動選択せず、必ず人間が判断する。
+
+| 類型 | 具体例 | なぜ人間のままか |
+|---|---|---|
+| **非可逆操作** | git commit / push / tag / release・ファイル削除 | 取り消せない操作は最後の人間判断を残す（検証用ビルド足場の作成・後始末は含まない） |
+| **情報不足の質問** | task-question（このタスクに不足する情報）／ axis-question（以後の全タスクに効く方針） | 情報の欠落は自動では埋められない |
+
+加えて、E フェーズ最終承認後の**引き継ぎバックログ照合**と**コミット提案**はコミット直前＝人間の関所領域であり、
+自律でも AskUserQuestion を出して自動選択しない。
+
+「質問が来た＝暴走していない」と受け止めてよい。
+
+---
+
+## ④ 止まり方（上限到達時の流れ）
+
+自律運転は無限に回らない。C-3 監査・E レビューにはサイクル上限があり、到達すると次の流れで止まる。
+
+1. **上限到達**（例: C-3 が上限サイクルまで回っても High/Medium が 0 に収束しない）
+2. **状態保全**: ワーキングツリー・レポート群をそのまま残す（調査可能な形で保全）
+3. **報告**: 収束または打ち切りで初めてまとめて人間へ報告する（逐一停止はしない）
+4. **裁定**: 人間が続行・方針変更・打ち切りを判断する
+5. **再開**: 裁定を受けて運転を継続、または HITL へ復帰する
+
+実例（B1 実走）: E→C 差し戻し後に同一カウンタで早期に上限へ到達し、運転が止まった事例がある。
+この経験から「差し戻しごとに小上限の別枠を付与する」規定が入った（詳細と数値は SKILL.md 参照）。
+止まること自体は異常ではなく、上限に守られて安全側に倒れた結果である。
+
+---
+
+## ⑤ C-3 収束 ≠ 欠陥ゼロ
+
+**C-3 監査が収束しても、それは「欠陥がゼロになった」ことを意味しない。**
+C-3 の収束条件が保証する射程は、**その時点の計画の健全性**に限られる。
+
+- **実測の裏付け**: C-3 が収束（High/Medium 0）した後の E レビューで、実装バグが実際に発見された事例がある。
+  収束は「設計・計画レベルで High/Medium の指摘が消えた」ことであって、実装が正しいことの証明ではない。
+- **構造的な限界**: C-3 を担う design-critic は **Bash を持たず、コードを実行して検証できない**
+  （静的な読解のみ）。エスケープ処理・パーサ・状態機械のような組み合わせロジックの欠陥は、
+  静的読解では原理的に取りこぼしうる。
+- **最後の網は E の実行検証**: テスト実行を伴う E フェーズ（およびテスト全緑を客観条件とする D）が、
+  実装バグに対する最後の防波堤になる。C-3 収束を「もう安全」と読み替えないこと。
+
+---
+
+## ⑥ 従量課金ユーザー向け注記
+
+`## 資源同意` 節への承認は、**費用への同意を兼ねる**。
+
+- **定額プラン**では、資源同意は主に「残枠（サイクル回数）の消費」を意味する。
+- **従量課金（API 等）**では、資源同意は**費用の発生への同意**を意味する。
+- **重要**: ハード上限が担保するのは**サイクル回数**であって費用ではない。
+  D のタスク数はプラン依存で可変、stuck 時は systematic-debugger が加算され、E→C 差し戻しごとに D 相当が再走する。
+  **費用の上界は規約では担保されない**。従量課金で使う場合は、この点を理解した上で opt-in すること。

{claude_code_conductor-2.52.1 → claude_code_conductor-2.54.0}/.claude/hooks/select_tier.py

@@ -12,9 +12,17 @@ tier-routing MVP: タスクの複雑度を簡易ヒューリスティックで
   推奨の提示と tier_selection.json への記録のみを担い、model の注入は
   tier_autoapply.py が行う。明示指定された `model:` は tier_autoapply が
   尊重して上書きしない。agent の `model:` フロントマター自体は変更しない
-- **やらない**: developer / wt_developer 以外の role への適用、
+- **やる（ADR-3〜ADR-5 拡張）**: tester(Red) 推奨を additive な ``roles.tester``
+  キーとして tier_selection.json に併記する。tester / wt_tester は test- タスク
+  （Red フェーズ）に限り tier_autoapply が機械適用する（D-3/D-5 等の非 Red 起動は
+  従来どおり frontmatter 任せ）。
+- **やらない**: developer / wt_developer / tester(Red) 以外の role への適用、
   フォールバック（Haiku 失敗→Sonnet 自動昇格）
 
+【opus 固定不変則（ADR-6）】機械適用（APPLY_ROLES / RED_APPLY_ROLES）に追加できるのは
+frontmatter ``model: sonnet`` の role のみ。opus frontmatter の agent（architect /
+planner / design-critic / doc-writer / project-setup）は tier レバーを持たず恒久対象外。
+
 学習データ（帰属機械化・フェーズ3）:
 - 結果は ``.claude/state/tier_selection.json`` に直近 1 件のみ書き込む
 - Agent 起動時に ``tier_autoapply.py`` が実適用 model を
@@ -451,15 +459,20 @@ _ESCALATION_MAP: dict[str, str] = {
 # SSOT: db.ESCALATION_THRESHOLD_DEFAULT 由来（import 部で取得）。C3_ESCALATION_THRESHOLD env で上書き可（v2.26.0）。
 
 
-def _db_failure_rate(complexity: str, tier: str) -> tuple:
+def _db_failure_rate(complexity: str, tier: str, role: str = "developer") -> tuple:
     """DB から failure rate を読み取るデフォルト実装。
 
+    ``role`` は集計対象の agent role（既定 ``"developer"``・後方互換）。
+    ADR-5: tester 推奨の escalation では ``role="tester"`` を渡し
+    ``read_agent_failure_rate("tester", ...)`` を引く（role 別 gate 集合は
+    db 側 ``bandit_gates_for_role`` が解決する）。
+
     c3_db のインポートに失敗した場合は ``(None, 0)`` を返す。
     """
     c3_db = _load_c3_db_module()
     if c3_db is None:
         return None, 0
-    return c3_db.read_agent_failure_rate("developer", complexity, tier)
+    return c3_db.read_agent_failure_rate(role, complexity, tier)
 
 
 def maybe_escalate(
@@ -468,6 +481,7 @@ def maybe_escalate(
     *,
     failure_rate_fn=None,
     threshold: float | None = None,
+    role: str = "developer",
 ) -> tuple[str, str | None]:
     """Phase 2-B: failure rate が高ければ 1 段昇格する。
 
@@ -476,10 +490,15 @@ def maybe_escalate(
         chosen_tier: select_tier が選んだ tier。
         failure_rate_fn: テスト用に注入可能な
             ``(complexity, tier) -> (rate_or_None, sample_count)``。
-            省略時は :func:`_db_failure_rate` を使う。
+            省略時は :func:`_db_failure_rate` を使う。既存の注入契約（2 引数）を
+            保つため、注入時は ``role`` を渡さない（テストは戻り値を固定するため
+            role 分岐は不要）。role は既定実装 ``_db_failure_rate`` へのみ透過する。
         threshold: escalation 閾値（failure rate がこの値以上で昇格）。
             None のとき module 定数 ``ESCALATION_THRESHOLD`` を使う。
             ``main()`` は ``_resolve_escalation_threshold()`` で解決した値を渡す。
+        role: 集計対象の agent role（既定 ``"developer"``）。ADR-5: tester 推奨の
+            escalation では ``role="tester"`` を渡して ``_db_failure_rate`` 経由で
+            tester セルの failure rate を引く。
 
     Returns:
         ``(effective_tier, escalation_reason)``。
@@ -489,8 +508,10 @@ def maybe_escalate(
     if chosen_tier not in _ESCALATION_MAP:
         return chosen_tier, None
 
-    effective_fn = failure_rate_fn or _db_failure_rate
-    rate, samples = effective_fn(complexity, chosen_tier)
+    if failure_rate_fn is not None:
+        rate, samples = failure_rate_fn(complexity, chosen_tier)
+    else:
+        rate, samples = _db_failure_rate(complexity, chosen_tier, role)
     eff_threshold = threshold if threshold is not None else ESCALATION_THRESHOLD
     if rate is None or rate < eff_threshold:
         return chosen_tier, None
@@ -516,6 +537,7 @@ def write_tier_selection(
     cost_tiebreak: bool = False,
     cost_weighted: bool = False,
     cost_lambda: float | None = None,
+    roles: dict[str, dict] | None = None,
 ) -> None:
     """直近の選択結果を ``tier_selection.json`` に書く。
 
@@ -543,6 +565,13 @@ def write_tier_selection(
     ``cost_lambda`` を任意で含める（v2.26.0）。
     ``_resolve_cost_lambda()`` で解決した λ 値（None 以外のとき出力）。
     None のときはキー自体を省略する（env 未設定時の後方互換）。
+
+    ``roles`` を任意で含める（ADR-3・additive role 別推奨）。
+    ``{"tester": {"tier": <実効 tier>, "mode": <mode>, "escalated"?: True}}`` の形。
+    None（渡されない）のときはキー自体を省略する（session_id / cost_tiebreak と
+    同じ additive-omit パターン＝トップレベルの bit 一致を保つ後方互換の核心）。
+    トップレベルの ``tier`` / ``mode`` は現行どおり developer 推奨を書き、
+    ``roles.tester`` は新読者（tier_autoapply 注入・record 優先 3）だけが見る。
     """
     os.makedirs(os.path.dirname(TIER_SELECTION_PATH), exist_ok=True)
     payload: dict[str, object] = {
@@ -570,6 +599,8 @@ def write_tier_selection(
         payload["cost_weighted"] = True
     if cost_lambda is not None:
         payload["cost_lambda"] = cost_lambda
+    if roles is not None:
+        payload["roles"] = roles
     try:
         with open(TIER_SELECTION_PATH, "w", encoding="utf-8") as f:
             json.dump(payload, f, ensure_ascii=False)
@@ -588,6 +619,7 @@ def build_additional_context(
     complexity_source: str | None = None,
     cost_tiebreak: bool = False,
     cost_weighted: bool = False,
+    tester_tier: str | None = None,
 ) -> str:
     """親 Claude に追加注入する文字列を組み立てる。
 
@@ -597,6 +629,11 @@ def build_additional_context(
     ``cost_weighted`` が True のとき、cost-weighted 文言を suffix に追加する（v2.26.0）。
     True のときは cost_tiebreak の文言より優先される（λ>0 全 tier weighting を明示）。
     False のときは cost_tiebreak による既存文言のみ（v2.25.0 以前と完全一致）。
+
+    ``tester_tier`` が渡された場合、tester(Red) 推奨 Tier を併記する（ADR-4）。
+    None（既定）のときは併記行を省略する（build_additional_context を直接呼ぶ
+    既存テストの後方互換）。tester / wt_tester は test- タスク（Red）に限り機械適用
+    対象であることを対象説明に明記する。
     """
     trials = sum(p[2] for p in params.values())
     if mode == "uniform":
@@ -615,6 +652,10 @@ def build_additional_context(
     elif cost_tiebreak:
         suffix += " [cost-aware: 成功率拮抗のため低コスト Tier を選択]"
 
+    tester_note = ""
+    if tester_tier is not None:
+        tester_note = f" tester(Red) 推奨 Tier: {tester_tier}。"
+
     return (
         f"[tier-routing 推奨] 複雑度: {complexity} / 推奨 Tier: {tier}（{confidence}・developer 基準）。"
         f" developer / wt_developer を Agent ツールで起動する際は、PreToolUse hook"
@@ -622,9 +663,12 @@ def build_additional_context(
         f"（親 Claude が model: を転記する必要はありません・学習データ収集中の期間も含め常に適用）。"
         f" 推奨と異なる Tier を使いたい場合のみ、Agent 呼び出し時に model: を明示指定してください"
         f"（明示指定は尊重され hook に上書きされません。fork は model 上書き不可のため対象外）。"
-        f" 対象は developer / wt_developer のみ。tester 等の他 role、および親 Claude"
-        f" ペルソナで動かす role（interviewer / architect / planner）は"
-        f" tier レバーが無いため対象外で従来どおりとする。{suffix}"
+        f"{tester_note}"
+        f" tester / wt_tester は test- タスク（Red フェーズ）に限り機械適用対象です"
+        f"（C3_TASK_ID: test-... マーカー付き起動のみ・D-3/D-5 等の非 Red 起動は"
+        f" 従来どおり frontmatter 任せ）。親 Claude ペルソナで動かす role"
+        f"（interviewer / architect / planner）は tier レバーが無いため対象外で"
+        f" 従来どおりとする。{suffix}"
     )
 
 
@@ -814,6 +858,25 @@ def main() -> int:
     effective_tier, escalation_reason = maybe_escalate(complexity, tier, threshold=esc_thr)
     escalated = effective_tier != tier
 
+    # ADR-3/ADR-4/ADR-5: tester(Red) 推奨を additive に算出する。complexity /
+    # cost_map / epsilon / lam は developer と同一解決値を使う（per-prompt 分類・
+    # DC-AS-001）。escalation は role="tester" で tester セルの failure rate を引く。
+    # developer 推奨を先に確定してから算出するため、tester 側の rng 消費は
+    # developer の結果に影響しない（トップレベル bit 一致の後方互換を保つ）。
+    if c3_db is None:
+        tester_params = {t: (1.0, 1.0, 0) for t in TIERS}
+    else:
+        tester_params = c3_db.read_agent_tier_params("tester", complexity)
+    tester_result = select_tier_detailed(tester_params, cost_map=cost_map, epsilon=eps, lam=lam)
+    tester_effective, _tester_esc_reason = maybe_escalate(
+        complexity, tester_result.tier, threshold=esc_thr, role="tester",
+    )
+    tester_escalated = tester_effective != tester_result.tier
+    tester_entry: dict[str, object] = {"tier": tester_effective, "mode": tester_result.mode}
+    if tester_escalated:
+        tester_entry["escalated"] = True
+    roles = {"tester": tester_entry}
+
     write_tier_selection(
         complexity, effective_tier, mode,
         escalated=escalated, escalation_reason=escalation_reason,
@@ -823,6 +886,7 @@ def main() -> int:
         cost_tiebreak=cost_tiebreak,
         cost_weighted=result.cost_weighted,
         cost_lambda=lam,
+        roles=roles,
     )
 
     context_text = build_additional_context(
@@ -831,6 +895,7 @@ def main() -> int:
         complexity_source=complexity_source,
         cost_tiebreak=cost_tiebreak,
         cost_weighted=result.cost_weighted,
+        tester_tier=tester_effective,
     )
     output = {
         "hookSpecificOutput": {

{claude_code_conductor-2.52.1 → claude_code_conductor-2.54.0}/.claude/hooks/tier_autoapply.py

@@ -12,6 +12,10 @@ check_agent は reviewer 系のみ）のため実行順序に依存しない（
   tier_selection.json から有効 tier を解決できたとき、`updatedInput` で
   `model:{推奨tier}` を注入した（source=injected・permissionDecision は
   T0 実測により省略形を正とした）。
+- `RED_APPLY_ROLES = {tester, wt_tester}` かつ `model` 無指定かつ
+  `C3_TASK_ID:` マーカーが `test-` で始まりかつ `roles.tester.tier` を解決できた
+  ときのみ注入した（Red 限定・ADR-2）。confirm-/impl-/マーカー無し・roles 欠落は
+  注入せず記録のみ（frontmatter の既定が実効・fail-safe）。
 - 明示 `model` 指定時は素通り（source=explicit・明示尊重）。
 - tier_selection 不在/破損/非文字列 tier のときは注入せず素通り
   （source=frontmatter-default・frontmatter の sonnet が実効するため）。
@@ -81,7 +85,19 @@ TIER_SELECTION_PATH = os.path.join(_CLAUDE_DIR, "state", "tier_selection.json")
 APPLIED_STATE_PATH = os.path.join(_CLAUDE_DIR, "state", "tier_autoapply.jsonl")
 
 # §3-2 ロール分岐表の定数。
+# APPLY_ROLES: 無条件 APPLY（起動フェーズを問わず tier_selection.json のトップレベル
+#   tier を機械適用する）role 集合。
+# RED_APPLY_ROLES: Red フェーズ（test- タスク）限定で機械適用する role 集合（ADR-2）。
+#   注入条件は「role ∈ RED_APPLY_ROLES かつ C3_TASK_ID マーカーが test- 開始かつ
+#   roles.tester.tier 解決可」の 3 条件全成立時のみ。D-3/D-5 等の非 Red 起動には
+#   test- マーカーを付与しない運用不変則（dev-workflow SKILL）と組で NF-2 を守る。
+#
+# 【opus 固定不変則（ADR-6）】APPLY_ROLES / RED_APPLY_ROLES に追加できるのは
+# frontmatter model: sonnet の role のみ。opus frontmatter の agent（architect /
+# planner / design-critic / doc-writer / project-setup）は tier レバーを持たず
+# 恒久対象外（機械検査テストで frontmatter が sonnet であることを CI 回帰網に固定）。
 APPLY_ROLES = frozenset({"developer", "wt_developer"})
+RED_APPLY_ROLES = frozenset({"tester", "wt_tester"})
 LAUNCH_LOG_ROLES = frozenset({"developer", "wt_developer", "tester", "wt_tester"})
 # wt_* → 無印への正規化（record 側 role 語彙・agent_outcomes.role と一致・§0-4）。
 _ROLE_NORMALIZE = {"wt_developer": "developer", "wt_tester": "tester"}
@@ -99,9 +115,12 @@ _ROTATE_TAIL_LINES = 500
 
 _PROMPT_PREFIX_MAX_CHARS = 200
 
-# T8: 起動プロンプト先頭の C3_TASK_ID マーカー抽出用（§3-1）。行頭アンカー +
-# allowlist + 上限200字で誤抽出・秘密混入を構造排除する（record MAX_TASK_LEN=200 と整合）。
-_TASK_ID_MARKER_RE = re.compile(r'^C3_TASK_ID:[ ]([A-Za-z0-9._\-]{1,200})[ ]*$', re.MULTILINE)
+# T8: 起動プロンプト先頭の C3_TASK_ID マーカー抽出用（§3-1・SR-AI-001 で \A 化）。
+# 文字列先頭アンカー \A + allowlist + 上限200字で誤抽出・秘密混入を構造排除する
+# （record MAX_TASK_LEN=200 と整合）。re.MULTILINE の行頭 ^ は本文孤立行・フェンス内・
+# 2 行目マーカーを誤抽出するため撤廃し、マーカーは「文字列先頭 1 行目のみ」を唯一の
+# 正当配置に統一する（parallel/逐次とも 1 行目マーカー・2 行目以降にガード指示・§2-3 改訂 7）。
+_TASK_ID_MARKER_RE = re.compile(r'\AC3_TASK_ID:[ ]([A-Za-z0-9._\-]{1,200})[ ]*(?:\r?\n|\Z)')
 
 
 def _load_pricing_module():
@@ -176,7 +195,9 @@ def _clean_prompt_prefix(prompt: object) -> str:
 def _extract_task_id(prompt: object) -> str | None:
     """起動プロンプトから C3_TASK_ID マーカー（最初の 1 個）を抽出した（§3）。
 
-    許容文字集合 [A-Za-z0-9._-]・行頭アンカー・上限200字で誤抽出と秘密混入を防ぐ。
+    許容文字集合 [A-Za-z0-9._-]・文字列先頭アンカー \\A・上限200字で誤抽出と秘密混入を防ぐ。
+    マーカーは「プロンプト文字列の先頭 1 行目」にある場合のみ抽出成立する（本文孤立行・
+    フェンス内・2 行目以降は非マッチ＝None・SR-AI-001）。
     prompt_prefix の mask→truncate パイプラインとは独立（正規表現自体がサニタイザ・§3-3）。
     非文字列・不一致は None（→ jsonl は task_id: null で従来挙動・逐次経路も None）。
     """
@@ -221,6 +242,34 @@ def _resolve_selection_tier(c3_pricing) -> str | None:
     return None
 
 
+def _resolve_roles_tier(c3_pricing, role: str) -> str | None:
+    """tier_selection.json の ``roles.<role>.tier`` を正規化 tier に解決した（ADR-3）。
+
+    Red 限定注入の tier 源。トップレベル ``tier`` ではなく additive な
+    ``roles`` キー配下を読む。``roles`` 欠落・``roles.<role>`` 破損・非文字列 tier・
+    正規化不能は全て None を返し、呼び出し側は注入せず frontmatter-default に落ちる
+    （fail-safe が安全側に一致）。
+    """
+    if c3_pricing is None:
+        return None
+    selection = _read_selection()
+    if selection is None:
+        return None
+    roles = selection.get("roles")
+    if not isinstance(roles, dict):
+        return None
+    entry = roles.get(role)
+    if not isinstance(entry, dict):
+        return None
+    raw = entry.get("tier")
+    if not isinstance(raw, str):
+        return None
+    resolved = c3_pricing.resolve_tier(raw)
+    if resolved in _VALID_TIERS:
+        return resolved
+    return None
+
+
 def _rotate_if_needed(path: str) -> None:
     """applied-state が 1MB を超えていたら末尾500行へ切り詰めた（§3-4・失敗時は無視）。"""
     try:
@@ -351,9 +400,14 @@ def main() -> None:
     model_val = tool_input.get("model")
     has_explicit_model = isinstance(model_val, str) and model_val.strip() != ""
 
+    # task_id は注入判定（RED_APPLY_ROLES の test- プレフィックス条件）と row 記録の
+    # 双方で使うため先に抽出する（§3-1・ADR-2）。
+    prompt = tool_input.get("prompt")
+    task_id = _extract_task_id(prompt)
+
     inject = False
     if has_explicit_model:
-        # 明示尊重: 注入せず素通りし explicit で記録した。
+        # 明示尊重: 注入せず素通りし explicit で記録した（RED_APPLY_ROLES でも不変）。
         source = "explicit"
         model_applied: str | None = model_val
     elif subagent_type in APPLY_ROLES:
@@ -367,12 +421,28 @@ def main() -> None:
             # tier_selection 不在/破損/非文字列: frontmatter の既定が実効するため記録のみ。
             source = "frontmatter-default"
             model_applied = None
+    elif subagent_type in RED_APPLY_ROLES:
+        # tester/wt_tester: Red 限定注入（ADR-2）。C3_TASK_ID マーカーが test- 開始
+        # かつ roles.tester.tier が解決可のときのみ注入。confirm-/impl-/マーカー無し・
+        # roles 欠落/破損は注入せず記録のみ（frontmatter の既定が実効・fail-safe 一致）。
+        if isinstance(task_id, str) and task_id.startswith("test-"):
+            c3_pricing = _load_pricing_module()
+            tier = _resolve_roles_tier(c3_pricing, role_recorded)
+            if tier is not None:
+                inject = True
+                source = "injected"
+                model_applied = tier
+            else:
+                source = "frontmatter-default"
+                model_applied = None
+        else:
+            source = "frontmatter-default"
+            model_applied = None
     else:
-        # tester/wt_tester: 注入対象外（記録のみ）。frontmatter の既定が実効した。
+        # LAUNCH_LOG_ROLES のうち上記いずれにも該当しない role（現状なし・防御）。
         source = "frontmatter-default"
         model_applied = None
 
-    prompt = tool_input.get("prompt")
     row = {
         "ts": datetime.now(timezone.utc).isoformat(timespec="seconds"),
         "session_id": session_id,
@@ -381,7 +451,11 @@ def main() -> None:
         "model_applied": model_applied,
         "source": source,
         "prompt_prefix": _clean_prompt_prefix(prompt),
-        "task_id": _extract_task_id(prompt),
+        # SR-K-003 前提: task_id は _TASK_ID_MARKER_RE の allowlist [A-Za-z0-9._-] を
+        # 通過済みのため秘密混入が構造的に不可能で _mask_secrets を適用していない。
+        # 許容文字集合が緩和される場合（記号・空白等を許す等）は、prompt_prefix と同様に
+        # _mask_secrets 適用が必要になる（マスク非対称の申し送り）。
+        "task_id": task_id,
     }
     _append_applied_state(row)
 

{claude_code_conductor-2.52.1 → claude_code_conductor-2.54.0}/.claude/hooks/tier_gap_check.py

@@ -44,9 +44,10 @@ TIER_SELECTION_PATH = os.path.join(_CLAUDE_DIR, "state", "tier_selection.json")
 
 # roll 対象: developer のみ（tester は除外）。
 # 理由: tier_autoapply.py LAUNCH_LOG_ROLES に tester を含めて起動ログは記録するが、
-# dev-workflow の記録契約上 tester の outcome 記録（D-5）は成功時 1 回が上限。
-# tester の起動（Red フェーズでの テスト実行・confirm 起動など）は複数回のため、
-# 起動 N >> 記録 M となり常時 K' > 0 で誤警告が発火する（カーディナリティ不一致）。
+# dev-workflow の記録契約上 tester の outcome 記録は D-1（Red 限定・条件 1〜4）と
+# D-5（最終確認）に限られ、tester の起動回数（Red フェーズでのテスト実行・confirm
+# 起動・D-3 など複数回）には遠く及ばない。したがって起動 N >> 記録 M となり常時
+# K' > 0 で誤警告が発火する（カーディナリティ不一致）ため tester は依然除外する。
 # CR F-1 で構造的誤検知として developer のみに限定した（起動ログ記録は維持）。
 _EVALUATED_ROLES = frozenset({"developer"})
 # 直近5分は中間状態として除外