agent teams GA 時に CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS env フラグを除去する

[okash1n]

背景

#120（v0.70.0）で CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 を agent-teams feature（features/agent-teams/hooks.json）として切り出した。現時点では実験機能のオプトインゲートとして有効だが、Claude Code 側で agent teams が GA（env フラグ不要化・廃止）になった時点でこの env 注入は dead config になる。

対応（GA 確認後）

• features/agent-teams/hooks.json から env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS キーを削除（または feature 自体を撤去し ENABLE_AGENT_TEAMS をレガシーキー化）
• 既存ユーザーへの伝播は 3-way merge の kit-remove 経路（fix: 3-way merge がキー削除の代わりに literal JSON null を書き込む問題を修正 #75 修正済み）で自動処理される — ユーザーが env に手動追加していた場合は保持される
• README / docs/wizard-config-mapping / CHANGELOG を追随

トリガー

Claude Code のリリースノートで agent teams の GA / env フラグ deprecation を確認した時点。

Refs #120 #121

[loadbalance-sudachi-kun]

ステータス確認（2026-08-20・GA トリガー判定）

判定: 未到来（agent teams は依然 experimental・env フラグ必須）→ defer 継続、CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 注入は維持。

根拠（一次情報）:

• 公式ドキュメント https://code.claude.com/docs/en/agent-teams（2026-08-20 取得）の Warning ブロックに逐語で明記: "Agent teams are experimental and disabled by default. Enable them by setting CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 in your settings.json or environment." Troubleshooting にも同変数を 0 にする無効化手順があり、この変数が現在も唯一のオン/オフスイッチ。ページは v2.1.234 の変更まで反映された現行版。
• Claude Code CHANGELOG（最新 v2.1.237 時点）に GA / フラグ廃止 / デフォルト有効化のエントリなし。agent teams 関連は UX 改善・バグ修正のみ（v2.1.178 のチーム作成手順の不要化はセットアップ簡素化であってフラグ不要化ではない）。

次回チェックの監視ポイント:

1. CHANGELOG の "AGENT_TEAMS" 言及（フラグ廃止・デフォルト有効化）
2. 上記 Doc ページから Warning ブロック（"experimental and disabled by default"）が消えること

[loadbalance-sudachi-kun]

現状確認（2026-08-31、Claude Code 2.1.251）

退役条件（agent teams の GA / env フラグ不要化）はまだ満たされていない。現行 CLI は依然としてこのフラグをゲートとして参照している。

インストール済みバイナリ（~/.local/share/claude/versions/2.1.251、Mach-O）から抽出した判定ロジック:

function t(){ return process.argv.includes("--agent-teams") }
function io(){
  if(!a.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS && !t()) return !1;
  if(!I("tengu_amber_flint", !0)) return !1;
  return !0
}

CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS が未設定で、かつ --agent-teams も渡されていない場合は即座に false を返す。つまり env 注入は dead config ではなく、現時点で除去すると agent teams が無効化される。

検出状況（対照として、同バイナリから可視な CLAUDE_CODE_* は 565 種類）:

• EXPERIMENTAL_AGENT_TEAMS の出現: 6 箇所
• 設定スキーマの env allowlist にも "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS" として含まれる
• 別途 tengu_amber_flint というゲートも AND 条件で存在する

したがって本 issue は継続。次回の確認時は、同じ手順で io() 相当の判定から env 参照が消えているかを見るのが確実。

strings -a ~/.local/share/claude/versions/<version> \
  | grep -o ".\{0,90\}EXPERIMENTAL_AGENT_TEAMS.\{0,90\}" | sort -u

なお、Agent ツールの team_name パラメータは "Deprecated; ignored. The session has a single implicit team." と記述されており、GA が近い兆候ではある。ただしこれは env ゲートの撤廃とは別の話で、上記の判定が残る限り除去はできない。