claude-code-conductor 2.47.0__tar.gz → 2.48.0__tar.gz

{claude_code_conductor-2.47.0 → claude_code_conductor-2.48.0}/.claude/hooks/tier_autoapply.py

@@ -18,6 +18,8 @@ check_agent は reviewer 系のみ）のため実行順序に依存しない（
 - `LAUNCH_LOG_ROLES = {developer, wt_developer, tester, wt_tester}` は
   注入有無に関わらず applied-state（tier_autoapply.jsonl）へ 1 行追記した。
   reviewer 系・その他 role は記録も注入もしない（exit 0 素通り）。
+- 起動プロンプト先頭の `C3_TASK_ID:` マーカーを抽出し jsonl の `task_id` に
+  載せた（T8・並列経路の record 突合キー）。
 
 ## 安全弁
 
@@ -97,6 +99,10 @@ _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)
+
 
 def _load_pricing_module():
     """c3.pricing モジュールを返した（import 失敗時は None）。"""
@@ -167,6 +173,21 @@ def _clean_prompt_prefix(prompt: object) -> str:
     return "".join(out)[:_PROMPT_PREFIX_MAX_CHARS]
 
 
+def _extract_task_id(prompt: object) -> str | None:
+    """起動プロンプトから C3_TASK_ID マーカー（最初の 1 個）を抽出した（§3）。
+
+    許容文字集合 [A-Za-z0-9._-]・行頭アンカー・上限200字で誤抽出と秘密混入を防ぐ。
+    prompt_prefix の mask→truncate パイプラインとは独立（正規表現自体がサニタイザ・§3-3）。
+    非文字列・不一致は None（→ jsonl は task_id: null で従来挙動・逐次経路も None）。
+    """
+    if not isinstance(prompt, str):
+        return None
+    m = _TASK_ID_MARKER_RE.search(prompt)
+    if m is None:
+        return None
+    return m.group(1)
+
+
 def _read_selection() -> dict | None:
     """tier_selection.json を読んだ（無い/壊れていれば None）。"""
     if not os.path.isfile(TIER_SELECTION_PATH):
@@ -351,6 +372,7 @@ def main() -> None:
         source = "frontmatter-default"
         model_applied = None
 
+    prompt = tool_input.get("prompt")
     row = {
         "ts": datetime.now(timezone.utc).isoformat(timespec="seconds"),
         "session_id": session_id,
@@ -358,7 +380,8 @@ def main() -> None:
         "role_recorded": role_recorded,
         "model_applied": model_applied,
         "source": source,
-        "prompt_prefix": _clean_prompt_prefix(tool_input.get("prompt")),
+        "prompt_prefix": _clean_prompt_prefix(prompt),
+        "task_id": _extract_task_id(prompt),
     }
     _append_applied_state(row)
 

{claude_code_conductor-2.47.0 → claude_code_conductor-2.48.0}/.claude/skills/dev-workflow/scripts/record_agent_outcome.py

@@ -20,12 +20,22 @@ Usage:
 
     | 優先 | ソース                                            | 対象                          |
     |----|--------------------------------------------------|-------------------------------|
-    | 1  | --tier（明示・TIERS 検証）                        | 全 role（並列/worktree 経路は常用申告） |
-    | 2  | applied-state（tier_autoapply.jsonl・session_id 一致の最新行） | _SOFT_APPLY_ROLES（developer） |
+    | 1  | --tier（明示・TIERS 検証）                        | 全 role（escape hatch・優先1 存続） |
+    | 2a | applied-state（session_id + role + task_id 全一致の最新行） | _SOFT_APPLY_ROLES（developer）かつ --task 指定時（T8・並列経路の task 突合） |
+    | 2b | applied-state（session_id + role 一致の最新行）     | 同上・2a が 0 件 or --task 未指定時（現行の優先2＝呼称のみ細分化） |
     | 3  | tier_selection.json の tier→suggested_model       | 同上・優先2 不成立時（フォールバック A 互換） |
     | 4  | agents/{role}.md frontmatter model:               | developer 以外、および 2・3 が不成立の developer |
     | 5  | 解決不能                                          | 記録スキップ（stderr 警告 + exit 0） |
 
+  T8（architecture §5）: 並列経路（wt_developer→developer）は起動プロンプトの
+  ``C3_TASK_ID:`` マーカーを tier_autoapply.py が jsonl の task_id に載せ、record は
+  ``--task`` 値と (session_id, role, task_id) 突合で実適用 tier を機械解決する（優先2a）。
+  これにより同一 session_id の複数 wt_developer を task 単位で一意分離し `--tier` 明示を
+  不要化した（ADR-AS-4 解消）。逐次経路は ``--task`` を渡すがマーカー未注入で全行
+  task_id=null のため優先2b で従来どおり解決する（挙動不変）。task 突合 0 件かつ当該
+  session/role に task_id 非 null 行が存在するとき（マーカー運用中の突合失敗）は record が
+  stderr へ 1 行警告する（§5-7・戻り値/exit code 不変の「警告のみ」）。
+
   --execution=subagent かつ role が _SOFT_APPLY_ROLES に含まれる場合（現状
   developer のみ）、--tier 省略時はまず applied-state を読む（優先2）。
   フェーズ3で PreToolUse hook（tier_autoapply.py）が Agent 起動時の実適用
@@ -42,9 +52,9 @@ Usage:
   推奨 Tier と異なる場合は必ず --tier に実際の tier を付す運用を dev-workflow
   SKILL.md 側が担う（本スクリプトは優先 1 で受けるのみでコード変更は無い）。
   並列（worktree isolation）経路は wt_developer→developer の記録を親 Claude
-  が main リポジトリで実行し、tier_selection.json を読まず常に --tier を
-  明示する（ADR-AS-4）。そのため本スクリプトは並列経路向けの追加コードを
-  持たず、優先 1（--tier 明示）を共用するだけで足りる。
+  が main リポジトリで実行するが、T8 以降は --tier を明示せず C3_TASK_ID:
+  マーカー由来の task_id を --task と (session_id, role, task_id) 突合して
+  優先2a で機械解決する（上記 L27-37 の新記述に一本化。ADR-AS-4 解消済み）。
   --execution=persona は --tier 省略時、frontmatter へも tier_selection.json
   へも fallback せず常に tier="unknown" 固定でイベントログのみ記録する
   （frontmatter/tier_selection は subagent の実使用 tier であり、persona の
@@ -379,27 +389,49 @@ def _iter_applied_state_capped_lines(path: str):
             yield raw.decode("utf-8", errors="replace")
 
 
-def _read_applied_tier(session_id: str | None, role: str, c3_pricing) -> str | None:
-    """applied-state（tier_autoapply.jsonl）から実適用 tier を解決する（優先2・§4-2）。
+def _read_applied_tier(
+    session_id: str | None, role: str, c3_pricing, task: str | None = None
+) -> str | None:
+    """applied-state（tier_autoapply.jsonl）から実適用 tier を解決する（優先2・§5）。
 
     フェーズ3で PreToolUse hook（tier_autoapply.py）が Agent 起動時の実適用値を
     session_id・role_recorded 付きで JSONL 追記する。record はこれを session_id
     一致で読むことで「適用者=記録 SSOT」を成立させる（tier_selection.json の
     推奨値を読む優先3 より優先する）。
 
+    優先2 の内部細分（T8・architecture §5-4。優先1/3/4 の体系は不変）:
+    - 優先2a（task-exact）: ``task`` 指定時、(session_id, role_recorded, task_id)
+      全一致の最新行を優先する。並列 wave（parallel-agents）で同一 session_id の
+      複数 wt_developer を task_id で一意分離し、`--tier` 明示なしに実適用 tier を
+      機械解決する（ADR-AS-4 解消）。task_id は起動プロンプトの ``C3_TASK_ID:``
+      マーカーを tier_autoapply.py が抽出して jsonl に載せた値。
+    - 優先2b（session-latest）: 優先2a が 0 件、または ``task`` 未指定（task=None）の
+      とき、(session_id, role_recorded) 一致の最新行（現行ロジックそのもの）を採用する。
+    - 後方互換: ``task=None`` では優先2a 候補が常に None のまま → 現行と bit 一致。
+      逐次経路は ``--task {plan タスクID}`` を渡すが ``C3_TASK_ID:`` マーカーを注入
+      しないため jsonl 全行が task_id=null で、優先2b で従来どおり解決される（挙動不変）。
+
     突合規則（_read_selection() と同じ防御思想）:
     - APPLIED_STATE_PATH 不在なら None。
     - session_id が None なら None（突合不能・§0-4 の NULL 制約。session_id
       NULL の行同士を突き合わせない）。
     - 行単位で json.loads し、壊れ行は skip（try/except continue）。
-    - session_id 一致 かつ role_recorded == role の行を収集し、最新
-      （末尾側／ts 最大）の model_applied を採用する。
+    - session_id 一致 かつ role_recorded == role の行を 1 パスで走査し、優先2b
+      候補（session+role 最新）と優先2a 候補（task 一致の最新）を同時収集する。
     - model_applied 非文字列（int/list/dict 等）は skip（resolve_tier の
       内部 .lower() による AttributeError 防止。soft-apply 側 L566-574 と同理由）。
       source=frontmatter-default（model_applied=null）の行は tier を持たない
       ため自然に skip される。
     - resolve_tier で正規化し _VALID_TIERS に含まれれば返す。
 
+    §5-7 additive 警告ガード（ADR-T8-9・C-3 R2 反映: DC-T8-AS-003）:
+    - ``task`` 指定・優先2a 0 件・かつ当該 (session_id, role) に task_id 非 null 行が
+      1 件以上存在する（``saw_task_id_row`` 真＝マーカー運用中）ときのみ、stderr へ
+      1 行の英語警告を出す（マーカー未注入 or task 表記ゆれ or tier 未注入による真の
+      突合失敗の可視化）。全行 task_id=null（＝マーカー未運用の純逐次）や task=None
+      では発火しない（逐次 crying-wolf 回避）。
+    - 警告のみで戻り値・exit code・chosen の決定式は一切変えない（fail-safe 不変）。
+
     Returns:
         解決できた正規化 tier 文字列、または解決不能なら None。
     """
@@ -414,8 +446,12 @@ def _read_applied_tier(session_id: str | None, role: str, c3_pricing) -> str | N
         or os.path.islink(APPLIED_STATE_PATH)
     ):
         return None
-    latest_model: str | None = None
-    latest_ts: str | None = None
+    # 1 パス 2 候補収集（architecture §5-2・GP-003: 既存ループを土台に候補を 2 本化）。
+    latest_session_model: str | None = None  # 優先2b（session+role 最新・現行ロジック）
+    latest_session_ts: str | None = None
+    latest_task_model: str | None = None  # 優先2a（session+role+task 全一致の最新）
+    latest_task_ts: str | None = None
+    saw_task_id_row = False  # 当該 (session_id, role) に task_id 非 null 行が存在するか（§5-7）
     try:
         # item5(SR-NEW): 末尾優先で最大 5MB のみ走査する（_iter_applied_state_capped_lines）。
         for line in _iter_applied_state_capped_lines(APPLIED_STATE_PATH):
@@ -432,6 +468,11 @@ def _read_applied_tier(session_id: str | None, role: str, c3_pricing) -> str | N
                 continue
             if row.get("role_recorded") != role:
                 continue
+            # §5-7: マーカー運用中の検出。model_applied 非文字列ガードより前に判定
+            # する（frontmatter-default 行〈model_applied=null〉でも task_id が
+            # 非 null なら運用中と見なす。追加走査コストゼロ）。
+            if row.get("task_id") is not None:
+                saw_task_id_row = True
             model_applied = row.get("model_applied")
             if not isinstance(model_applied, str):
                 continue
@@ -440,18 +481,48 @@ def _read_applied_tier(session_id: str | None, role: str, c3_pricing) -> str | N
             # 最新（ts 最大）を採用。ts 同値/欠落時は後勝ち（末尾側）で
             # 上書きするため >= で比較する。ts プロファイルは
             # tier_autoapply.py と同一 UTC 秒精度 ISO8601（辞書順＝時系列）。
-            if latest_ts is None or ts_key >= latest_ts:
-                latest_ts = ts_key
-                latest_model = model_applied
+            # 優先2b 候補（session+role 最新）＝現行ロジックそのもの。
+            if latest_session_ts is None or ts_key >= latest_session_ts:
+                latest_session_ts = ts_key
+                latest_session_model = model_applied
+            # 優先2a 候補（task 指定時のみ・session+role+task 全一致の最新）。
+            if task is not None and row.get("task_id") == task:
+                if latest_task_ts is None or ts_key >= latest_task_ts:
+                    latest_task_ts = ts_key
+                    latest_task_model = model_applied
     except OSError as exc:
         print(
             f"[record_agent_outcome] failed to read applied-state: {exc}",
             file=sys.stderr,
         )
         return None
-    if latest_model is None:
+    # 決定: task-exact（優先2a）を優先し、0 件なら session-latest（優先2b）へ。
+    chosen = latest_task_model if latest_task_model is not None else latest_session_model
+    # §5-7 additive 警告: task 指定・優先2a 0 件・かつマーカー運用中（saw_task_id_row 真）
+    # のときのみ 1 行警告する（戻り値/exit code/chosen は不変・fail-safe 不変）。
+    # 安全性根拠（SR-K-003 解消）: --task 値（task 変数）自体は allowlist 検証を受けない。
+    # allowlist（[A-Za-z0-9._\-]）が適用されるのは tier_autoapply.py の task_id 抽出
+    # 経路のみで、--task CLI 引数経路には存在しない（_truncate は文字数/バイト数の
+    # 切り詰めのみで文字種検証はしない）。この警告文の安全性は下記の二段で担保する:
+    # (1) _mask_secrets(task) で既知の秘密パターン（token=/api_key=/Bearer/PEM 等）を
+    #     *** に潰す（allowlist 非検証の --task に秘密様文字列が混入しても stderr へ
+    #     生の秘密を出さない・display-only）。
+    # (2) その結果を {...!r} で repr エスケープする（制御文字・改行・引用符混入時も
+    #     1 行維持・インジェクション不成立）。
+    # マスクは警告表示だけに閉じる（chosen 決定・突合・DB note は生の task を使う）。
+    # 将来 !r を !s 等へ変更する／_mask_secrets 適用を外すリファクタが入るとこの前提
+    # （二段防御）が崩れるため、_mask_secrets(task) + !r 依存であることに留意する。
+    if task is not None and latest_task_model is None and saw_task_id_row:
+        print(
+            f"[record_agent_outcome] --task {_mask_secrets(task)!r} specified but no matching "
+            "(session,role,task) row in applied-state though task_id rows exist "
+            "for this session/role; falling back to session-latest (priority 2b). "
+            "marker not injected or task mismatch?",
+            file=sys.stderr,
+        )
+    if chosen is None:
         return None
-    resolved = c3_pricing.resolve_tier(latest_model)
+    resolved = c3_pricing.resolve_tier(chosen)
     if resolved in _VALID_TIERS:
         return resolved
     return None
@@ -698,14 +769,18 @@ def main(argv: list[str] | None = None) -> int:
         # 一致で読む。role が soft-apply 対象のときのみ突合する（tester 等は
         # _SOFT_APPLY_ROLES 外なので applied-state を読まない・role gating）。
         if role in _SOFT_APPLY_ROLES:
-            tier = _read_applied_tier(session_id, role, c3_pricing)
+            # T8: 切り詰め済み task を突合キーとして配線（優先2a）。task=None の
+            # 従来呼び出し・逐次経路（マーカー未注入）は優先2b で従来どおり解決。
+            tier = _read_applied_tier(session_id, role, c3_pricing, task=task)
         # 優先 3（降格・旧優先2）: role が soft-apply 対象（_SOFT_APPLY_ROLES）なら
         # tier_selection.json の tier（無ければ suggested_model）を
         # resolve_tier で正規化し、_VALID_TIERS に含まれれば採用する。
         # 優先2（applied-state）が不成立のとき（applied-state 不在／session_id
         # 不一致／kill-switch で jsonl に行が無い等）のフォールバック A 互換。
-        # 逐次経路（worktree なし）のみが対象。並列（worktree）経路は親が
-        # --tier を明示するため優先 1 で解決され、ここには来ない（ADR-AS-4）。
+        # 逐次経路（worktree なし）はマーカー未注入で優先2b により解決される。
+        # 並列（worktree）経路は T8 以降 --tier を渡さないため、task_id 突合
+        # （優先2a/2b）が不成立の場合はこの優先3フォールバックに到達しうる
+        # （ADR-AS-4 解消後は「ここには来ない」という言い切りは成立しない）。
         if tier is None and role in _SOFT_APPLY_ROLES and selection is not None:
             soft_apply_raw = selection.get("tier") or selection.get("suggested_model")
             # 非文字列ガード: resolve_tier() は内部で無条件に model.lower() を

{claude_code_conductor-2.47.0 → claude_code_conductor-2.48.0}/.claude/skills/parallel-agents/SKILL.md

@@ -164,6 +164,14 @@ plan-report 承認時点で全タスク・agent・writes・prompt が確認済
     Bash でまず以下を実行: `export PO_WORKTREE_GUARD=1`（worktree_guard.py PreToolUse が worktree 外書き込みをブロックする条件）
     ```
     worktree_guard.py はこの env 未設定時 `sys.exit(0)` で完全無効化されるため、wt_* agent 起動プロンプトの先頭で必ず設定すること。
+  - **全 `read_only: false` タスク（wt_developer / wt_tester）: プロンプト先頭付近（PO_WORKTREE_GUARD の Bash 行の直後・タスク本文の前）に機械可読マーカー行を必須で 1 行含める**:
+    ```
+    C3_TASK_ID: {task_id}
+    ```
+    - `{task_id}` は `description`（タスク id）および record の `--task` に渡す値と**完全一致**させる（英数と `.` `_` `-` のみ・200 字以内）。
+    - この行を PreToolUse hook（`tier_autoapply.py`）が抽出し applied-state（`tier_autoapply.jsonl`）の `task_id` に記録する。record が `--task` と突合して適用 tier を機械解決するための入力キー。
+    - **三者一致の責務は親 Claude が負う**: マーカー値 `C3_TASK_ID: {task_id}`・`description`（タスク id）・record `--task {task_id}` の三者は、**親 Claude が同一の `task_id` 変数から 3 箇所（description / C3_TASK_ID マーカー / record `--task`）へ転記**し、大小・末尾空白・省略の表記ゆれを生じさせない（by convention の保証者を明文化）。転記ミス時の静かな優先2b フォールバックは record 側の stderr 警告で検知する二段構え。
+    - **不均質 wave ではマーカー注入が必須**: escape hatch として一部タスクに `model:` を明示し wave 内で tier が不均質になる場合、マーカー欠落で優先2b に落ちると 2b は task を無視して session+role 最新の 1 行を拾うため、**別タスクの tier を誤帰属しうる**。均質 wave では顕在化しないが、`model:` 明示混在の**不均質 wave ではマーカー欠落＝誤帰属リスクのためマーカー注入を必須**とする。
   - タスクの `prompt` 本文
   - 「**禁止事項: git add / git commit / git push を実行しないこと**。コミットは親 Claude がユーザー承認後に行う」
   - 「**返り値フォーマット厳守**:
@@ -215,19 +223,18 @@ worktree path は Agent ツール返り値の `<worktree><worktreePath>...</work
 
 **tier-routing 結果記録（失敗タスク）**: 選択肢に関わらず、この wave で失敗した各タスクのうち `wt_developer`/`wt_tester` で起動したものについて、1 タスク = 1 記録で failure を記録する（`wt_developer`→`--role developer`、`wt_tester`→`--role tester`。`--execution subagent`）。`code-reviewer`/`security-reviewer`/`wt_systematic-debugger` のタスクは記録対象外。この記録は親 Claude が **main リポジトリ（2-F-0 の `cd <ROOT>` 後）で実行**する。**「スキップして次の wave へ」を選んだ場合も、次の wave に進む前に必ずこの記録を済ませること**（`--complexity` は dev-workflow 開始時の `[tier-routing 推奨]` 表示の複雑度をそのまま渡す。「リトライ」を選び再実行が成功した場合は 1 タスク 1 記録の原則により 2-F-4 で改めて success を記録する＝リトライ結果は新たな別記録になる）。
 
-**`--tier` の付与ルール（ADR-AS-4・worktree の state 分離対応）**:
-- `wt_developer`→`developer` の記録は **`--tier {当該 wt_developer 起動時に hook（tier_autoapply）が model: へ自動適用した推奨 Tier}` を明示する**（tier_selection.json の worktree 自己解決には依存せず親が申告する）。この値の SSOT は `tier_selection.json.tier`（kickoff で 1 度確定・以降 wave をまたいで安定）で、2-C で hook が `model:` へ自動適用したのと同一値を渡す。並列 wave 内の複数 wt_developer は同一の推奨 Tier を共有する（単一 tier_selection.json・DC-AS-003 で許容済み）。逸脱時（明示指定した `model:` が推奨 Tier と異なる）はその実際に適用された tier を `--tier` に渡す（並列経路では常に実適用値を申告するため、逸脱の有無に依らず `--tier` を付ける運用に一本化される）。**hook は worktree 側で実適用 model を `.claude/state/tier_autoapply.jsonl` に記録するが、worktree の state 分離により親 main の record からは session_id 一致で読めないことがあるため、並列経路では初回は `--tier` 明示を維持する（applied-state 経由の自己解決への一本化は T8 で対応）。**
+**tier 記録ルール（ADR-AS-4 解消・applied-state task_id 突合）**:
+- `wt_developer`→`developer` の記録は **`--tier` を付けない**。起動時に PreToolUse hook（`tier_autoapply`）が applied-state（`tier_autoapply.jsonl`）に記録した実適用 tier を、record が `(session_id, role, task_id)` 突合で機械解決する（優先2a）。**`--task {task_id}` は突合キーとして必須**であり、2-C のマーカー `C3_TASK_ID: {task_id}` と完全一致させる。**従来 `--task` は dedupe 専用の任意引数だったが、T8 で突合の必須キーへ役割が変わる**（未注入だと優先2b フォールバック＝session_id 一致だけの曖昧解決に戻り、並列で誤 tier 帰属リスクが残る）。applied-state の `task_id` 突合により、並列 wave 内の複数 wt_developer が同一 session_id でも task 単位で**一意**に実適用 tier を解決できる（ADR-AS-4 解消・T8）。hook の書き込み先が main の `.claude/state/` であること（cwd リーク下でも `__file__` 基準で不変）は T4 E2E で実測確認済み（2026-07-07・並列 wt_developer×2 で worktree 側 jsonl 0 件・main 側 2 行・record が `--tier` なしで正解 tier を機械解決）。
 - `wt_tester`→`tester` の記録は **`--tier` を付けない**（frontmatter 解決のまま不変。tester は機械適用対象外）。
 
 ```bash
-# wt_developer→developer（--tier を明示）
+# wt_developer→developer（tier フラグは付けない・applied-state task 突合で機械解決）
 python .claude/skills/dev-workflow/scripts/record_agent_outcome.py \
   --role developer --outcome failure --gate 2-E \
   --execution subagent --complexity {セッションファイルの tier-routing複雑度: 行の値} \
-  --tier {当該 wt_developer 起動時に hook が model: へ自動適用した推奨 Tier（tier_selection.json.tier と同値）} \
-  --task {task_id}
+  --task {task_id}   # ← 2-C の C3_TASK_ID マーカーと完全一致・突合の必須キー
 
-# wt_tester→tester（--tier を付けない・frontmatter 解決）
+# wt_tester→tester（tier フラグは付けない・frontmatter 解決）
 python .claude/skills/dev-workflow/scripts/record_agent_outcome.py \
   --role tester --outcome failure --gate 2-E \
   --execution subagent --complexity {セッションファイルの tier-routing複雑度: 行の値} \
@@ -320,17 +327,16 @@ git branch -D worktree-agent-{id}
 
 **tier-routing 結果記録（成功タスクのみ）**: この wave で成功した各タスクのうち `wt_developer`/`wt_tester` で起動したものについて、1 タスク = 1 記録で success を記録する（`wt_developer`→`--role developer`、`wt_tester`→`--role tester`。`--execution subagent`）。`code-reviewer`/`security-reviewer`/`wt_systematic-debugger` のタスクは記録対象外（`--complexity` は dev-workflow 開始時の `[tier-routing 推奨]` 表示の複雑度をそのまま渡す）。この記録は親 Claude が **main リポジトリ（2-F-0 の `cd <ROOT>` 後）で実行**する。
 
-**`--tier` の付与ルール（ADR-AS-4・2-E と同一）**: `wt_developer`→`developer` は **`--tier {当該 wt_developer 起動時に hook（tier_autoapply）が model: へ自動適用した推奨 Tier（tier_selection.json.tier と同値）}` を明示**する（worktree 自己解決に依存しない・並列 wave 内の複数 wt_developer は同一 tier を共有〈DC-AS-003〉・逸脱時は実際に適用された tier を渡す）。**hook は実適用 model を `.claude/state/tier_autoapply.jsonl` に記録するが、worktree の state 分離により親 main の record が読めないことがあるため並列経路では初回 `--tier` 明示を維持する（T8 で一本化）。** `wt_tester`→`tester` は **`--tier` を付けない**（frontmatter 解決のまま不変・機械適用対象外）。
+**tier 記録ルール（ADR-AS-4 解消・2-E と同一）**: `wt_developer`→`developer` は **`--tier` を付けない**。起動時に hook（`tier_autoapply`）が applied-state（`tier_autoapply.jsonl`）に記録した実適用 tier を、record が `(session_id, role, task_id)` 突合で機械解決する（優先2a）。**`--task {task_id}` は突合キーとして必須**であり、2-C のマーカー `C3_TASK_ID: {task_id}` と完全一致させる（従来 `--task` は dedupe 専用の任意引数だったが、T8 で突合の必須キーへ役割が変わる）。applied-state の `task_id` 突合により、同一 session_id の複数 wt_developer を task 単位で**一意**に分離できる（ADR-AS-4 解消・T8）。hook の書き込み先が main の `.claude/state/` であること（cwd リーク下でも `__file__` 基準で不変）は T4 E2E で実測確認済み（2026-07-07・並列 wt_developer×2 で worktree 側 jsonl 0 件・main 側 2 行・record が `--tier` なしで正解 tier を機械解決）。 `wt_tester`→`tester` は **`--tier` を付けない**（frontmatter 解決のまま不変・機械適用対象外）。
 
 ```bash
-# wt_developer→developer（--tier を明示）
+# wt_developer→developer（tier フラグは付けない・applied-state task 突合で機械解決）
 python .claude/skills/dev-workflow/scripts/record_agent_outcome.py \
   --role developer --outcome success --gate 2-D \
   --execution subagent --complexity {セッションファイルの tier-routing複雑度: 行の値} \
-  --tier {当該 wt_developer 起動時に hook が model: へ自動適用した推奨 Tier（tier_selection.json.tier と同値）} \
-  --task {task_id}
+  --task {task_id}   # ← 2-C の C3_TASK_ID マーカーと完全一致・突合の必須キー
 
-# wt_tester→tester（--tier を付けない・frontmatter 解決）
+# wt_tester→tester（tier フラグは付けない・frontmatter 解決）
 python .claude/skills/dev-workflow/scripts/record_agent_outcome.py \
   --role tester --outcome success --gate 2-D \
   --execution subagent --complexity {セッションファイルの tier-routing複雑度: 行の値} \

{claude_code_conductor-2.47.0 → claude_code_conductor-2.48.0}/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [2.48.0] - 2026-07-07
+
+### 追加
+
+- **並列経路の record `--tier` 明示を不要化（T8・ADR-AS-4 解消）**: applied-state（`.claude/state/tier_autoapply.jsonl`）に `task_id` フィールドを追加し、`record_agent_outcome.py` が `(session_id, role, task_id)` の全一致で実適用 tier を一意解決できるようにした（優先2a）。並列 wave 内の複数 wt_developer が同一 session_id でも task 単位で分離される。task 一致行が 0 件なら従来の「session 最新行」（優先2b）へフォールバックし後方互換（task 未指定の逐次経路は挙動 bit 一致）。`--tier` 明示は優先1 の escape hatch として存続
+- **`C3_TASK_ID:` マーカー**: parallel-agents skill の起動プロンプトに機械可読マーカー行（`C3_TASK_ID: {task_id}`）を必須注入し、`tier_autoapply.py` が行頭アンカー＋厳格書式（`[A-Za-z0-9._-]{1,200}`・first-match）で抽出して jsonl に記録する。allowlist が制御文字・秘密情報パターンを構造的に排除（誤抽出・秘密混入・ReDoS 耐性を security-review で確認済み）。マーカー不在（逐次経路等）は `task_id: null` で従来挙動
+- **2b フォールバック警告（additive）**: record が `--task` 指定かつ task 一致 0 件かつ当該 session/role に task_id 非 null 行が存在する場合のみ、stderr に 1 行警告（マーカー運用中の真の突合失敗に限定・純逐次 0 回・並列正常 0 回の発火設計・警告のみで戻り値/exit code 不変・task 値は `_mask_secrets`＋repr の二段防御で表示）
+
+### 変更
+
+- parallel-agents SKILL.md: 2-E / 2-F-4 の wt_developer 向け `--tier` 付与ルールと bash 例を撤去し「applied-state task 突合で機械解決・`--task` は突合の必須キー」に一本化。2-C にマーカー注入手順（三者一致責務: 親 Claude が同一 task_id 変数から description / マーカー / `--task` へ転記）と不均質 wave でのマーカー必須性を明記。wt_tester の「`--tier` を付けない」は不変
+- 旧 ADR-AS-4 注記（「worktree state 分離で session_id 一致でも読めないことがある」）は E2E 実測（並列 wt_developer×2）で反証し解消形に更新: hook の書き込み先は cwd リーク下でも `__file__` 基準で常に main の `.claude/state/`（worktree 側 jsonl 0 件を実測確認）
+
+### 後方互換
+
+- 全て additive（jsonl はキー追加のみ・既存 7 フィールド不変・読者 `tier_gap_check.py` は無改修で耐性確認済み・record は task 未指定経路が bit 一致・DB migration なし）。既存 fail-safe（kill-switch `C3_TIER_AUTOAPPLY_DISABLE`・全例外 exit 0・壊れ行 skip・5MB 上限・symlink 防御）は不変。**破壊的変更なし**
+
 ## [2.47.0] - 2026-07-07
 
 ### 追加

{claude_code_conductor-2.47.0 → claude_code_conductor-2.48.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-conductor
-Version: 2.47.0
+Version: 2.48.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.47.0 → claude_code_conductor-2.48.0}/src/c3/__init__.py

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