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

{claude_code_conductor-2.53.0 → 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.53.0 → 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.53.0 → 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分は中間状態として除外

{claude_code_conductor-2.53.0 → claude_code_conductor-2.54.0}/.claude/skills/dev-workflow/SKILL.md

@@ -52,13 +52,14 @@ session.tmp の `モード:` 行を確認する。**有効な自律宣言**（§
 
 **機械適用（推奨 Tier の `model:` 自動注入・ADR-AS-1・フェーズ3）:**
 
-- developer を Agent ツールで起動する箇所（**D-2 / D-2.5 の再実行 / D-4**）では、PreToolUse hook（`tier_autoapply.py`）が `[tier-routing 推奨]` の推奨 Tier を Agent 呼び出しの `model:` に自動適用する（機械適用・学習データ収集中の期間も含め常に適用する。親 Claude が `model:` を転記する必要はない。fork は model 上書き不可のため対象外）。推奨と異なる Tier を使いたい場合のみ Agent 呼び出しで `model:` を明示指定する（明示指定は hook に尊重され上書きされない）。**tester / systematic-debugger は対象外**で従来どおり frontmatter 任せとする。interviewer/architect/planner は親 Claude ペルソナで動かし tier レバーが無いため対象外。
+- developer を Agent ツールで起動する箇所（**D-2 / D-2.5 の再実行 / D-4**）では、PreToolUse hook（`tier_autoapply.py`）が `[tier-routing 推奨]` の推奨 Tier を Agent 呼び出しの `model:` に自動適用する（機械適用・学習データ収集中の期間も含め常に適用する。親 Claude が `model:` を転記する必要はない。fork は model 上書き不可のため対象外）。推奨と異なる Tier を使いたい場合のみ Agent 呼び出しで `model:` を明示指定する（明示指定は hook に尊重され上書きされない）。**tester は Red 起動（D-1 のマーカー付き `test-` タスク）のみ機械適用対象**（RED_APPLY_ROLES・Red 限定注入）で、D-3/D-5 等の非 Red 起動と systematic-debugger は対象外＝従来どおり frontmatter 任せとする。interviewer/architect/planner は親 Claude ペルソナで動かし tier レバーが無いため対象外。
+- **opus 固定不変則（ADR-6）**: 機械適用（`model:` 自動注入）の対象に追加してよいのは frontmatter が `model: sonnet` の role（developer / wt_developer / tester / wt_tester）のみで、opus 5 体（architect / planner / design-critic / doc-writer / project-setup）は恒久的に注入対象外とする（強 model 固定の設計判断・機械検査で保護）。
 - **推奨 Tier の SSOT**: 「推奨 Tier」の唯一のソースは `.claude/state/tier_selection.json` の `tier`（無ければ `suggested_model`）であり、`[tier-routing 推奨]` の additionalContext テキストはその値を人間可読に射影した派生表示で SSOT ではない。この値は kickoff プロンプトの UserPromptSubmit で select_tier が 1 度だけ書き、E-2 の `--final` で削除されるまで wave/ゲートをまたいで安定する（承認応答は UserPromptSubmit を発火しないため途中で上書きされない）。
 - developer の record ブロックは**`--tier` を付けない**（tier_autoapply.py が実適用 model を `.claude/state/tier_autoapply.jsonl` に記録し、record_agent_outcome.py が applied-state を session_id 一致で読んで実適用 tier を機械解決する＝適用者=記録 SSOT。tier 値の LLM 申告を行わない。明示指定で推奨と異なる Tier を使った場合も、その実適用値が applied-state に記録されるため `--tier` の付与は不要）。
 
 **集計注記**（DC-AS-002 / ADR-25-3）:
 
-- E-1/E-2（レビュー指摘由来）のイベントは全 gate 不可逆に記録するが、bandit params・escalation 判定の集計対象は **BANDIT_GATES（D-2.5/D-3/D-5/D-2.5-stuck）のみ**である。E-1/E-2 の成否は個別の集計から除外される（意図どおり・read-side フィルタで実現）。
+- bandit params・escalation 判定の**集計対象 gate は role 別（`BANDIT_GATES_BY_ROLE`）**である: developer 等の既定 role は **BANDIT_GATES（D-2.5/D-3/D-5/D-2.5-stuck）**、**tester は D-1 のみ**（D-3/D-5 の tester 記録はイベントログとして残るが集計対象外）。E-1/E-2（レビュー指摘由来）のイベントは全 gate 不可逆に記録するが、その成否は従来どおり個別の集計から除外される（意図どおり・read-side フィルタで実現）。
 - **reviewer role（code-reviewer/security-reviewer・および E-gate のみの role）は BANDIT_GATES に該当 gate を持たないため、`c3 tier stats` 等の表示で当該 role の bandit は常に uniform（全 tier `(1.0,1.0,0)`・0 trials）になる**。これは設計意図の帰結であり退行ではない。tier 選択の実消費者は `select_tier`（developer role 固定）のみで、reviewer role の bandit が uniform でも tier 選択ロジックには影響しない。
 
 ---
@@ -532,8 +533,31 @@ legacy TDD モードまたは parallel-agents モードで実装される。
 
 Agent ツールで `tester` エージェントを起動する。→ 失敗するテストを先に作成する。**必ず `.claude/reports/test-report-YYYYMMDD-HHMMSS.md` を Write してから終了すること。**
 
+**Red 起動プロンプトのマーカー規約（必須）**: tester を Agent ツールで起動するプロンプトの**1 行目（文字列先頭）**に、以下の機械可読マーカー行を**必須**で 1 行含める（省略可能な推奨ではない・parallel 経路の同型マーカーの逐次版）。`tier_autoapply.py` の抽出正規表現は文字列先頭アンカー `\A` のため、2 行目以降・本文中・フェンス内に置くと抽出されず注入されない（SR-AI-001）:
+
+```
+C3_TASK_ID: test-{plan タスクID}
+```
+
+- `{plan タスクID}` は plan-report の当該 Red タスク ID（英数と `.` `_` `-` のみ・200 字以内）。値は下記の failure 記録・D-3 の success/failure 記録の `--task test-{plan タスクID}` と**完全一致**させる。plan タスク ID を持たない bug-fix モードでは D-1 自体がスキップされるため対象外。
+- この行を PreToolUse hook（`tier_autoapply.py`）が抽出し、`test-` プレフィックス条件を満たす tester 起動にのみ推奨 Tier を `model:` へ自動適用する（Red 限定注入・RED_APPLY_ROLES）。record はこのマーカー由来の applied-state を `--task` と突合して実適用 tier を機械解決する。
+- **不変則（D-3/D-5 マーカー付与禁止）**: D-3 / D-5 の tester 起動プロンプトには `C3_TASK_ID: test-...` マーカーを**付与しない**（注入条件はフェーズではなくマーカー値のみをキーにするため、D-3/D-5 に付与すると確認フェーズへ Red 注入が誤発火する）。D-3/D-5 の起動プロンプトに `C3_TASK_ID:` を書く必要がある場合は `confirm-` 等の非 test- 値とする。
+- **マーカー欠落の検知導線**: record 実行時に applied-state 突合失敗の stderr 警告（"marker not injected or task mismatch?"）が出た場合は、マーカー欠落による tier 記録欠損として**セッションファイルの `## 試みたが失敗したアプローチ` へ 1 行記録する**（自律運転中はあわせて gaps 台帳へも記録する）。
+
 完了後 → セッションファイルの `- [ ] tester: Red フェーズ` を `- [x]` に Edit し、`現在地:` を `現在地: フェーズD 実装中 / 次: developer Green` に Edit する。
 
+**D-1 完了時の成否判定（成否 4 条件のうち条件 1・2）**: Red 成果物の帰属先は Red を書いた tier（gate `D-1`）に統一する。
+
+- **条件 1（Red の失敗理由が意図と違う）** / **条件 2（ベースライン破壊＝既存の緑テストを赤化させた）**: いずれかに該当する場合はその場で failure を記録する:
+  ```bash
+  c3 run .claude/skills/dev-workflow/scripts/record_agent_outcome.py \
+    --role tester --outcome failure --gate D-1 \
+    --execution subagent --complexity {セッションファイルの tier-routing複雑度: 行の値} \
+    --task test-{plan タスクID}
+  ```
+- **条件 1・2 とも該当なし**: この時点では**記録しない**（成功の確定は D-3 全合格時＝条件 4）。
+- 条件 3（Green 中のテスト側修正の所在判定）・条件 4（success）は D-3 で扱う。
+
 ### D-2: developer（Green フェーズ）
 
 Agent ツールで `developer` エージェントを起動する（`model:` は tier_autoapply hook が推奨 Tier を自動適用・上記「tier-routing 結果記録の運用」節参照）。→ テストが通る実装を行う。
@@ -611,14 +635,33 @@ AskUserQuestion で確認する:
 
 不合格の場合: D-2（developer）に戻る。合格するまで繰り返す。
 
-**tier-routing 結果記録（不合格時のみ・D-2.5 と重複回避のため全合格時は記録しない・欠陥の所在で判定）**: D-5 否認ブロックと同型で、テストコード欠陥は `tester` failure、プロダクトコード欠陥は `developer` failure、両方または判別不能な場合は `developer` のみ記録する:
+**tier-routing 結果記録（全合格時・条件 4 = Red 成果物の生存確定）**: 全テスト合格＝Red が要求した挙動が実装で満たされ Red 成果物が生存した確定点なので、Red の tier に success を帰属する（gate `D-1`）:
 ```bash
 c3 run .claude/skills/dev-workflow/scripts/record_agent_outcome.py \
-  --role {tester|developer（欠陥の所在で判定・テストコード欠陥=tester／プロダクトコード欠陥=developer／両方または判別不能=developer）} --outcome failure --gate D-3 \
+  --role tester --outcome success --gate D-1 \
   --execution subagent --complexity {セッションファイルの tier-routing複雑度: 行の値} \
-  --task {plan タスクID}
+  --task test-{plan タスクID}
 ```
 
+**tier-routing 結果記録（不合格時のみ・D-2.5 と重複回避のため全合格時はこの failure ブロックを記録しない・欠陥の所在で判定）**: 欠陥の所在で role・gate を分岐する。
+
+- **テストコード欠陥（条件 3・Red 成果物への帰属）**: `tester` failure を gate `D-1` で記録する（`--gate D-3` ではなく `--gate D-1` に統一・Red 成果物への帰属）:
+  ```bash
+  c3 run .claude/skills/dev-workflow/scripts/record_agent_outcome.py \
+    --role tester --outcome failure --gate D-1 \
+    --execution subagent --complexity {セッションファイルの tier-routing複雑度: 行の値} \
+    --task test-{plan タスクID}
+  ```
+  - **除外境界（条件 3）**: テスト側修正を「仕様変更追随」として failure 記録から除外できるのは、**その裁定がセッションファイルに記録されている場合のみ**とする（裁定記録が無ければ既定で failure を記録する）。
+  - **所在判定チェック観点**: テストコード欠陥かを判定する際、source（プロダクトコード）が誤アサーションへ追従（over-fit）していないかを併せて確認する（over-fit していれば source 側の欠陥＝developer 帰属）。
+- **プロダクトコード欠陥／両方または判別不能**: `developer` failure を gate `D-3` で記録する（developer の bandit gate は現行どおり）:
+  ```bash
+  c3 run .claude/skills/dev-workflow/scripts/record_agent_outcome.py \
+    --role developer --outcome failure --gate D-3 \
+    --execution subagent --complexity {セッションファイルの tier-routing複雑度: 行の値} \
+    --task {plan タスクID}
+  ```
+
 ### D-4: developer（Refactor フェーズ）
 
 Agent ツールで `developer` エージェントを起動する（`model:` は tier_autoapply hook が推奨 Tier を自動適用・上記「tier-routing 結果記録の運用」節参照）。→ テストを壊さずにコードを整理する。