フォーク既定のサブエージェントで、レビュー役だけは名前で呼ぶという線引き

{
  "env": {
    "CLAUDE_CODE_FORK_SUBAGENT": "1"
  },
  "permissions": {
    "deny": ["Agent(fork)"]
  }
}

#!/usr/bin/env python3
"""fork_scope_audit.py — フォーク既定下で、文脈継承の可否をエージェント単位に仕分ける。
 
使い方:
    python3 fork_scope_audit.py [PROJECT_ROOT]
"""
from __future__ import annotations
 
import json
import re
import sys
from dataclasses import dataclass
from pathlib import Path
 
# 独立性が要る仕事を示す語。description と本文の両方を見る
ISOLATE_MARKERS = (
    "レビュー", "再検証", "検証し直", "監査", "第三者", "独立に", "見落とし",
    "review", "verify", "audit", "critique", "double-check", "second opinion",
)
# 継承を前提にした書き方（親の文脈がないと成立しない指示）
INHERIT_HINTS = ("前提", "続き", "先ほど", "この会話", "上記の", "follow up", "continue")
 
FM = re.compile(r"^---\s*\n(.*?)\n---\s*\n(.*)$", re.S)
 
 
@dataclass
class Agent:
    path: Path
    name: str
    description: str
    body: str
 
    @property
    def haystack(self) -> str:
        return f"{self.name}\n{self.description}\n{self.body}".lower()
 
    def isolate_reasons(self) -> list[str]:
        return [m for m in ISOLATE_MARKERS if m.lower() in self.haystack]
 
    def inherit_reasons(self) -> list[str]:
        return [m for m in INHERIT_HINTS if m.lower() in self.haystack]
 
 
def parse_agent(path: Path) -> Agent | None:
    m = FM.match(path.read_text(encoding="utf-8"))
    if not m:
        return None
    front, body = m.group(1), m.group(2)
    fields: dict[str, str] = {}
    for line in front.splitlines():
        # ネストしたキーは拾わない（トップレベルのみ）
        if ":" in line and not line.startswith(" "):
            k, _, v = line.partition(":")
            fields[k.strip()] = v.strip().strip('"').strip("'")
    return Agent(path, fields.get("name", path.stem), fields.get("description", ""), body)
 
 
def read_posture(root: Path) -> dict[str, object]:
    """settings.json から、フォークに関する現在の姿勢を読む。"""
    posture: dict[str, object] = {"env": None, "deny_fork": False}
    # local が後勝ちになるよう、この順で読む
    for rel in (".claude/settings.json", ".claude/settings.local.json"):
        p = root / rel
        if not p.exists():
            continue
        data = json.loads(p.read_text(encoding="utf-8") or "{}")
        env = (data.get("env") or {}).get("CLAUDE_CODE_FORK_SUBAGENT")
        if env is not None:
            posture["env"] = str(env)
        deny = (data.get("permissions") or {}).get("deny") or []
        if any(str(r).replace(" ", "").lower() == "agent(fork)" for r in deny):
            posture["deny_fork"] = True
    return posture
 
 
def main(argv: list[str]) -> int:
    root = Path(argv[1] if len(argv) > 1 else ".").resolve()
    agent_dir = root / ".claude" / "agents"
    if not agent_dir.is_dir():
        print(f"エージェント定義が見つかりません: {agent_dir}")
        return 2
 
    posture = read_posture(root)
    agents = [a for a in (parse_agent(p) for p in sorted(agent_dir.glob("*.md"))) if a]
 
    isolate = [(a, r) for a in agents if (r := a.isolate_reasons())]
    inherit = [a for a in agents if not a.isolate_reasons()]
 
    env = posture["env"]
    effective = "off" if env == "0" else "on"
    declared = "宣言あり" if env is not None else "宣言なし（既定に従う）"
 
    print(f"対象: {root}")
    print(f"エージェント定義: {len(agents)} 本")
    print(f"CLAUDE_CODE_FORK_SUBAGENT: {declared} → 実効 fork={effective}")
    print(f"Agent(fork) の deny 規則: {'あり' if posture['deny_fork'] else 'なし'}")
    print()
 
    print(f"[継承させない] {len(isolate)} 本 — 名前付きで呼び、親の文脈を渡さない")
    for a, reasons in isolate:
        print(f"  - {a.name:<20} 根拠: {', '.join(reasons[:3])}")
    print()
    print(f"[継承してよい] {len(inherit)} 本 — フォークでも成立する")
    for a in inherit:
        hints = a.inherit_reasons()
        tail = f" （継承前提の記述: {', '.join(hints[:2])}）" if hints else ""
        print(f"  - {a.name}{tail}")
    print()
 
    problems = 0
    if isolate and effective == "on" and not posture["deny_fork"]:
        problems += 1
        print("⚠️ 独立性が要るエージェントがあるのに、無名の委譲がフォークへ落ちる状態です。")
        print("   対処: これらは必ず名前付きで呼ぶ。無名の委譲を止めるなら Agent(fork) を deny する。")
    if env is None:
        problems += 1
        print("⚠️ フォークの可否がリポジトリに宣言されていません（各自の環境変数に依存します）。")
        print("   対処: .claude/settings.json の env に CLAUDE_CODE_FORK_SUBAGENT を明示する。")
    if not problems:
        print("✅ 継承の境界が宣言と一致しています。")
    return 1 if problems else 0
 
 
if __name__ == "__main__":
    raise SystemExit(main(sys.argv))

対象: /path/to/project
エージェント定義: 5 本
CLAUDE_CODE_FORK_SUBAGENT: 宣言なし（既定に従う） → 実効 fork=on
Agent(fork) の deny 規則: なし
 
[継承させない] 2 本 — 名前付きで呼び、親の文脈を渡さない
  - change-review        根拠: レビュー, 第三者, 独立に
  - gate-verify          根拠: 再検証, 検証し直, verify
 
[継承してよい] 3 本 — フォークでも成立する
  - asset-inventory
  - release-preflight
  - store-copy-i18n
 
⚠️ 独立性が要るエージェントがあるのに、無名の委譲がフォークへ落ちる状態です。
   対処: これらは必ず名前付きで呼ぶ。無名の委譲を止めるなら Agent(fork) を deny する。
⚠️ フォークの可否がリポジトリに宣言されていません（各自の環境変数に依存します）。
   対処: .claude/settings.json の env に CLAUDE_CODE_FORK_SUBAGENT を明示する。

CLAUDE_CODE_FORK_SUBAGENT: 宣言あり → 実効 fork=on
Agent(fork) の deny 規則: あり
...
✅ 継承の境界が宣言と一致しています。