# Claude Code / Codex Feature Table（upstream snapshot 完全版） > **概要**: Harness が活用・追跡する Claude Code / Codex の主要機能と upstream snapshot の一覧。 > CLAUDE.md の Feature Table の完全版（詳細説明付き）。 ## 機能一覧 | 機能 | 活用スキル | 用途 | |------|-----------|------| | **Phase 89 セッション協調 (file lease + register + broadcast 復活)** | hooks, breezing, harness-work | `A: 実装あり`。同一 PC・同一 repo の複数 CC セッションで `.go`/`.md`/`.sh` 編集衝突を `continueOnBlock` 経由でモデルにフィードバック。`go/internal/hookhandler/session_lease.go` (`git --git-common-dir` 配下に sha256 hex 命名の lock + `os.Link` create-only + (TTL AND active.json) stale 判定 + 24h auto-prune + worktree shared store)、`session_register.go` (SessionStart/Stop で active.json 記名解除 + tri-state)、`file_lease_hook.go` (PreToolUse silent acquire + PostToolUse `permissionDecision:"deny"` + `continueOnBlock:true` + 8-char holder prefix + sanitized path)、`inbox_check.go` (structured fields only + 4096B cap + ANSI/NUL 除去 + `userprompt-inject-policy` disclaimer)、`session_auto_broadcast.go` (`.go`/`.md`/`.sh` extension match via `filepath.Ext` で 2026-02 死骸復活、`*` label で debug 可視化)。`hooks/hooks.json` + `.claude-plugin/hooks.json` dual-sync で PreToolUse/PostToolUse/SessionStart/Stop に配線。`continueOnBlock` は diagnostic feedback (R01-R13 guard rail でない、`hooks-2.1.139-plus.md` §3 整合)。Phase 120: `session_presence.go` が git-common-dir 親の `live-sessions/` presence (session-owned, 0600/0700, 24h prune) を追加し、lease staleness の生存判定を「共有 presence ∪ ローカル active.json」の worktree 横断 union に修正 (名簿 active.json と broadcast/inbox は従来どおり worktree ローカル)。harness-mem 非依存 = 同一 PC 限定、別 clone 間は非共有。Phase 121 (HOTL session messaging): livemsg directed message の配送路に信頼契約 (sanitize + 非命令 disclaimer + 4096B/768B cap)、人間送信 CLI `inbox send` / 既読可視化 `inbox sent`、Claude Stop 境界配線 (`hooks/hooks.json` dual-sync、未読 0 は silent)、生成 hook identity の runtime 解決 (`--from-env`、`{{TEAM}}` placeholder 撤去)、presence card `{label, task, since}` + `harness session declare/list` (task 番号→セッション逆引き、liveness は filename+mtime のまま)。 Phase 141 (セッション協調パイプライン): 名簿の寿命を修理し、`unregister` を Stop から SessionEnd へ移動 + Stop に `register` を追加 (Stop はターン境界であってセッション終了ではないため、従来は最初の 1 ターンで自分の presence を消していた)。refresh は mtime のみ更新し `session declare` の task/label を保持。`session_register_identity.go` が `CLAUDE_ENV_FILE` へ `export HARNESS_LIVEMSG_TEAM` / `..._AGENT` を **export 形式**で書き出す (素の `KEY=VALUE` は子プロセス env に届かない)。`deliveryidentity.Resolve()` の優先順位 (env → breezing) は不変で、env を埋める側だけを追加。`session_auto_broadcast.go` の broadcast を worktree ローカルから git-common-dir 親の共有 scope へ統一 (presence は共有なのに broadcast だけローカルで、姿は見えるのに通知が届かない不整合を解消)。`active.json` を `map[string]json.RawMessage` で読み書きし、自スキーマ以外のエントリを 24h prune から除外 (harness-mem 同居時の破壊を防止)。`skills/session-send/SKILL.md` がエージェント主導の送信口 (`harness inbox send`) を提供。`[livemsg] verification = "off"|"on"` (既定 off、`destructiveDelete` と同じ 5 段解決) と `templates/schemas/livemsg-gate.v1.json` + `agents/livemsg-gate.md` で検証の関所を opt-in 化。off の間は送信経路が gate を**呼ばない**ため検証コストがゼロ。`hosts.toml` に `[hermes]` を追加し delivery のみ配線 (5 ツール目)。配線検証は `scripts/ci/check-session-pipeline-wiring.sh` (7 点) が担当。 | | **Phase 80 Claude Code 2.1.143-2.1.152 + Codex 0.131-0.134 upstream refresh** | upstream-update, hooks, skill-editing, setup, codex, harness-plan | `A: 実装あり / C: 自動継承 / P: Plans 化 / Reject: 未確認 claim (B: 0 件)`。`docs/upstream-update-snapshot-2026-05-27.md` + `docs/upstream-adoption-plan-2026-05-27.md` を Plans `80.1.1`-`80.1.6` に接続。Claude: `disallowed-tools`, `/reload-skills`, `SessionStart.reloadSkills`, `MessageDisplay` opt-in policy, `/code-review` rename, `claude agents --json`, Auto mode consent 廃止 (Harness default 維持)。Codex: `--profile` primary, curl/PowerShell installer docs, MCP environment/OAuth (defer), read-only MCP parallelism (inherit). | | **Phase 69 Claude Code 2.1.133-2.1.142 後続活用** | upstream-update, hooks, guardrails, agents, harness-plan, harness-work | `A: 実装あり / C: 自動継承 / P: Plans 化 (B: 0 件)`。`docs/upstream-update-snapshot-2026-05-15.md` を Tier 1 5 件 (`worktree.baseRef` template 明示 / hooks `$CLAUDE_EFFORT` rule / `autoMode.hard_deny` baseline 7 件 / hook `args` exec form + `continueOnBlock` + SessionStart command-only rules / hook `terminalSequence` opt-in 実装) + Tier 2 5 件 (CC native `/goal` も Plans.md SSOT に従う policy / `claude agents` agent-view policy + 9 flag 利用条件 / background permission mode 保持の Worker 期待値 / `claude plugin details` の CI 補助情報化 / Phase 69 rule SSOT) に分解。`.claude/rules/hooks-2.1.139-plus.md` と `docs/agent-view-policy.md` を新設、`templates/claude/settings.security.json.template` に `worktree.baseRef: "fresh"` / `autoMode.hard_deny` を baseline 追加 (`.claude-plugin/settings.json` への手動マージは self-write guardrail のため release operator 作業)、`scripts/lib/terminal-notify.sh` 経由で `webhook-notify.sh` と `notification-handler.sh` が `HARNESS_TERMINAL_NOTIFY` opt-in で `terminalSequence` を emit する。 | | **Phase 67 Codex 0.130.0 stable snapshot** | upstream-update, setup, codex, harness-review | `A: 検証強化 / C: 自動継承 / P: Plans 化 (B: 0 件)`。`docs/upstream-update-snapshot-2026-05-10.md` を Plans `67.1.1`-`67.1.4` に接続し、`rust-v0.130.0` stable の `codex remote-control`, plugin-bundled hooks, plugin sharing metadata, app-server Thread pagination APIs, Bedrock `aws login`, selected-environment `view_image`, live threads from latest config snapshot, `apply_patch` 後の turn diffs, ThreadStore summaries/resume/fork, `response.processed`, Windows sandbox runtime bin cache, `cargo install --locked`, OTel trace metadata, built-in MCPs, `CODEX_HOME` environments TOML provider を A/C/P 分類した。 | | **Phase 62 Claude Code 2.1.112-2.1.132 後続活用 + Opus 4.7 follow-up** | upstream-update, harness-loop, breezing, harness-review, guardrails, hooks | `A: 検証強化 / C: 自動継承 (B: 0 件)`。`docs/upstream-update-snapshot-2026-05-07.md` を Plans `62.1.1`-`62.3.1` に接続。Tier 1: subagent stall 2 層防御 (CC 600s + elicitation-handler)、`ENABLE_PROMPT_CACHING_1H` 1h cache opt-in for long-running、hooks `type: "mcp_tool"` 採用判断 (= 保留)、`sandbox.network.deniedDomains` baseline 拡張 (template canonical 9 件)、R06/R11/R12 wrapper bypass test (env/sudo/watch × 3 = 9 ケース)。Tier 2: `PostToolUse.updatedToolOutput` opt-in handler + audit、agent permissionMode reaffirmation (Phase 59.2.3 方針 gate)、`skill_activated.invocation_trigger` privacy-first telemetry、`CLAUDE_CODE_SESSION_ID` env policy 4 経路、`skillOverrides` 3 mode governance。 | | **Phase 61 Sandbagging-Aware Weak-Supervision Harness** | harness-review, harness-loop, harness-mem | `docs/sandbagging-aware-weak-supervision.md` と `docs/weak-supervision-elicitation-snapshot-2026-05-06.md` に接続。`weak-supervision-report.v1` / `elicitation-event.v1` / `.claude/state/elicitation/events.jsonl` で、見せかけの成功・弱い採点・反例を記録し、Advisor cue と Reviewer 検出に使う。Advisor は `PLAN/CORRECTION/STOP`、Reviewer は最終判定のまま。 | | **Issue #105 English default + Japanese opt-in CI gate** | setup, harness-work, CI | New distribution surfaces default to English while Japanese opt-in UX, bilingual skill metadata, setup rendering, and mirror consistency are locked by the i18n regression suite. | | **Phase 58 Claude Code 2.1.120-2.1.126 / Codex 0.125.0-0.128.0 snapshot** | upstream-update, harness-review, setup, codex | `A: 検証強化 / P: Plans 化`。`docs/upstream-update-snapshot-2026-05-03.md` と `docs/upstream-followups-phase58-2026-05-03.md` を Plans `58.1.1`-`58.3.2` に接続し、Claude Code `--dangerously-skip-permissions`, `PostToolUse.updatedToolOutput`, MCP `alwaysLoad`, `claude plugin prune`, `claude project purge`, Codex permission profiles, `codex exec --json` reasoning tokens, plugin-bundled hooks, `/goal`, MultiAgentV2, and `0.129.0-alpha.2` watch status を A/C/P 分類した上で、runtime 実装は protected path taxonomy / output governance / Codex profile migration の後続 task に切った。 | | **Phase 56 Claude Code 2.1.119 / Codex 0.124.0 snapshot** | upstream-update, harness-review, setup | `A: 検証強化`。`docs/upstream-update-snapshot-2026-04-25.md` と `docs/upstream-followups-phase56-2026-04-25.md` を Plans `56.1.1`-`56.2.4` に接続し、`--print` frontmatter parity, `PostToolUse.duration_ms`, status line effort/thinking, `prUrlTemplate`, Codex stable hooks, multi-environment app-server, and `0.125.0-alpha.2` watch status を A/C/P 分類した上で、statusline 追従と docs-only safe default を tests で固定。 | | **Task tool メトリクス** | parallel-workflows | サブエージェントのトークン/ツール/時間を集計 | | **`/debug` コマンド** | troubleshoot | 複雑なセッション問題の診断 | | **PDF ページ範囲** | notebookLM, harness-review | 大型ドキュメントの効率的な処理 | | **Git log フラグ** | harness-review, CI, harness-release | 構造化されたコミット分析 | | **OAuth 認証** | codex-review | DCR 非対応 MCP サーバーの設定 | | **68% メモリ最適化** | session-memory, session | `--resume` の積極的活用 | | **サブエージェント MCP** | task-worker | 並列実行時の MCP ツール共有 | | **Reduced Motion** | harness-ui | アクセシビリティ設定 | | **TeammateIdle/TaskCompleted Hook** | breezing | チーム監視の自動化 | | **Agent Memory (memory frontmatter)** | task-worker, code-reviewer | 永続的学習 | | **Fast mode (Opus 4.6)** | 全スキル | 高速出力モード | | **自動メモリ記録** | session-memory | セッション間知識の自動永続化 | | **スキルバジェットスケーリング** | 全スキル | コンテキスト窓の 2% に自動調整 | | **Task(agent_type) 制限** | agents/ | サブエージェント種類制限 | | **Plugin settings.json** | setup | init トークン削減・即時セキュリティ保護 | | **Worktree isolation** | breezing, parallel-workflows | 同一ファイル並列書き込み安全化 | | **Background agents** | generate-video | 非同期シーン生成 | | **ConfigChange hook** | hooks | 設定変更監査 | | **last_assistant_message** | session-memory | セッション品質評価 | | **Sonnet 4.6 (1M context)** | 全スキル | 大規模コンテキスト処理 | | **メモリリーク修正 (v2.1.50〜v2.1.63)** | breezing, work | 長時間チームセッションの安定性向上 | | **`claude agents` CLI (v2.1.50)** | troubleshoot | エージェント定義の診断・確認 | | **WorktreeCreate/Remove hook (v2.1.50)** | breezing | Worktree ライフサイクル自動セットアップ・クリーンアップ（実装済み） | | **`claude remote-control` (v2.1.51)** | 調査済み・将来対応 | 外部ビルドとローカル環境サービング | | **`/simplify` (v2.1.63)** | work | Phase 3.5 Auto-Refinement: 実装後の自動コード洗練 | | **`/batch` (v2.1.63)** | breezing | 横展開タスクの並列マイグレーション委任 | | **`code-simplifier` プラグイン** | work | `--deep-simplify` 時の深いリファクタリング | | **HTTP hooks (v2.1.63)** | hooks | JSON POST テンプレート提供。`HARNESS_WEBHOOK_URL` 設定時に TaskCompleted 通知が有効化 | | **Auto-memory worktree 共有 (v2.1.63)** | breezing | worktree エージェント間のメモリ共有 | | **`/clear` スキルキャッシュリセット (v2.1.63)** | troubleshoot | スキル開発時のキャッシュ問題診断 | | **`ENABLE_CLAUDEAI_MCP_SERVERS` (v2.1.63)** | setup | claude.ai MCP サーバーの無効化オプション | | **Effort levels + ultrathink (v2.1.68)** | harness-work | 多要素スコアリングで複雑タスクに ultrathink 自動注入 | | **Agent hooks (v2.1.68)** | hooks | type: "agent" による LLM エージェントコード品質ガード | | **Opus 4/4.1 削除（v2.1.68）** | — | first-party API から削除。Opus 4.6 へ自動移行 | | **`${CLAUDE_SKILL_DIR}` 変数 (v2.1.69)** | 全スキル | スキル内の参照パスを実行環境非依存で解決 | | **InstructionsLoaded hook (v2.1.69)** | hooks | セッション前の instructions 読み込みイベントを追跡 | | **`agent_id` / `agent_type` 追加 (v2.1.69)** | hooks, breezing | teammate の識別・ロール判定を安定化 | | **`{"continue": false}` teammate 応答 (v2.1.69)** | breezing | 全タスク完了時の自動停止を実現 | | **`/reload-plugins` (v2.1.69)** | 全スキル | スキル・フック編集後の即時反映 | | **`includeGitInstructions: false` (v2.1.69)** | work, breezing | git 指示が不要な場面のトークン削減 | | **`git-subdir` plugin source (v2.1.69)** | setup, release | サブディレクトリ管理された plugin source に対応 | | **Auto Mode (RP Phase 1)** | breezing, work | CC native 機能。Harness 側は PermissionDenied 追跡のみ。判断ロジック未実装。現行 default は `bypassPermissions` | | **Per-agent hooks (v2.1.69+)** | agents/ | エージェント定義の frontmatter に `hooks` フィールドを追加。Worker に PreToolUse ガード、Reviewer に Stop ログを設定 | | **Agent `isolation: worktree` (v2.1.50+)** | agents/worker | Worker エージェント定義に `isolation: worktree` を追加。並列書き込み時の自動 worktree 分離 | | **Compaction 画像保持 (v2.1.70)** | notebookLM, harness-review | サマリーリクエストで画像を保持。プロンプトキャッシュ再利用改善 | | **サブエージェント最終レポート簡潔化 (v2.1.70)** | breezing, harness-work | サブエージェント完了レポートのトークン消費削減 | | **`--resume` スキルリスト再注入廃止 (v2.1.70)** | session | セッション再開時に ~600 tokens 節約 | | **Plugin hooks 修正 (v2.1.70)** | hooks | Stop/SessionEnd が /plugin 後に発火、テンプレート衝突解消、WorktreeCreate/Remove 正常動作 | | **Teammate ネスト防止追加修正 (v2.1.70)** | breezing | v2.1.69 対応に加え、追加のネスト防止修正 | | **PostToolUseFailure hook (v2.1.70)** | hooks | ツール呼び出し失敗時に発火する新フックイベント | | **`/loop` + Cron スケジューリング (v2.1.71)** | breezing, harness-work | `/loop 5m ` で定期実行。タスク進捗の自動監視に活用 | | **Background Agent 出力パス修正 (v2.1.71)** | breezing, parallel-workflows | 完了通知に出力ファイルパスを含む。圧縮後も結果回収可能 | | **`--print` チームエージェント hang 修正 (v2.1.71)** | CI 連携 | `--print` モードでのチームエージェント hang を修正 | | **Plugin インストール並列実行修正 (v2.1.71)** | breezing | 複数インスタンス時のプラグイン状態安定化 | | **Marketplace 改善 (v2.1.71)** | setup | @ref パーサー修正、update merge conflict 修正、MCP server 重複排除、/plugin uninstall が settings.local.json 使用 | | **Subagent `background` フィールド (v2.1.71+)** | breezing, parallel-workflows | エージェント定義に `background: true` を追加。常にバックグラウンドタスクとして実行 | | **Subagent `local` メモリスコープ (v2.1.71+)** | agents/ | `memory: local` で `.claude/agent-memory-local/` に保存。VCS にコミットしない機密性の高い学習を分離 | | **Agent Teams 実験フラグ (v2.1.71+)** | breezing | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` 環境変数で Agent Teams を有効化。公式ドキュメント化済み | | **`/agents` コマンド (v2.1.71+)** | troubleshoot, setup | エージェントの対話的管理UI。作成・編集・削除・一覧を GUI で操作 | | **Desktop Scheduled Tasks (v2.1.71+)** | harness-work | CC native 機能。Harness 側のデフォルト設定なし（CronCreate ツールは利用可） | | **`CronCreate/CronList/CronDelete` ツール (v2.1.71+)** | breezing, harness-work | `/loop` の内部ツール。セッション内での定期タスク作成・管理 | | **`CLAUDE_CODE_DISABLE_CRON` 環境変数 (v2.1.71+)** | setup | `=1` で Cron スケジューラを無効化。セキュリティポリシーで定期実行を制限する環境向け | | **`--agents` CLI フラグ (v2.1.71+)** | breezing, CI | JSON でセッションレベルのエージェント定義を渡す。ディスクに保存されない一時的なエージェント構成 | | **`ExitWorktree` ツール (v2.1.72)** | breezing, harness-work | プログラム的に worktree セッションを離脱するツール | | **Effort levels 簡素化 (v2.1.72)** | harness-work | `max` 廃止、`low/medium/high` の3段階 + `○ ◐ ●` シンボル。`/effort auto` でデフォルトリセット | | **Agent tool `model` パラメータ復活 (v2.1.72)** | breezing | per-invocation model override が再度利用可能に | | **`/plan` description 引数 (v2.1.72)** | harness-plan | `/plan fix the auth bug` のように説明付きでプランモードに入れる | | **並列ツール呼び出し修正 (v2.1.72)** | breezing, harness-work | Read/WebFetch/Glob 失敗が sibling 呼び出しをキャンセルしなくなった（Bash エラーのみカスケード） | | **Worktree isolation 修正 (v2.1.72)** | breezing | Task resume 時の cwd 復元、background 通知に worktreePath を含む | | **`/clear` バックグラウンドエージェント保持 (v2.1.72)** | breezing | `/clear` はフォアグラウンドタスクのみ停止。バックグラウンドエージェントは存続 | | **Hooks 修正群 (v2.1.72)** | hooks | transcript_path 修正、PostToolUse ダブル表示修正、async hooks stdin 修正、skill hooks 二重発火修正 | | **HTML コメント非表示 (v2.1.72)** | 全スキル | CLAUDE.md の `` が自動注入時に非表示。Read ツールでは引き続き可視 | | **Bash auto-approval 追加 (v2.1.72)** | guardrails | `lsof`, `pgrep`, `tput`, `ss`, `fd`, `fdfind` が許可リストに追加 | | **プロンプトキャッシュ修正 (v2.1.72)** | 全スキル | SDK `query()` のキャッシュ無効化修正。入力トークンコスト最大 12 倍削減 | | **Output Styles (v2.1.72+)** | 全スキル | `.claude/output-styles/` にカスタム出力スタイルを定義。`harness-ops` で Plan/Work/Review の構造化出力を提供 | | **`permissionMode` in agent frontmatter (v2.1.72+)** | agents/ | エージェント定義 YAML に `permissionMode` を明示宣言。spawn 時の `mode` 指定が不要に | | **Agent Teams 公式ベストプラクティス (v2.1.72+)** | breezing | 5-6 tasks/teammate ガイドライン、`teammateMode` 設定、plan approval パターンを team-composition に反映 | | **Sandboxing (`/sandbox`)** | breezing, harness-work | OS レベルのファイルシステム/ネットワーク隔離。`bypassPermissions` の補完レイヤー | | **`opusplan` モデルエイリアス** | breezing | Plan 時は Opus、実行時は Sonnet に自動切替。Lead の Plan → Execute フローに最適 | | **`CLAUDE_CODE_SUBAGENT_MODEL` 環境変数** | breezing, harness-work | サブエージェントのモデルを一括指定。Worker/Reviewer のモデル制御を集約 | | **`availableModels` 設定** | setup | 利用可能モデルの制限リスト。エンタープライズ運用でのモデルガバナンス | | **Checkpointing (`/rewind`)** | harness-work | セッション状態の追跡・巻き戻し・要約。安全な探索と実験をサポート | | **Code Review (managed service)** | harness-review | マルチエージェント PR レビュー + `REVIEW.md`。Teams/Enterprise 向け Research Preview | | **Status Line (`/statusline`)** | 全スキル | カスタムシェルスクリプトで状態表示バー。コンテキスト使用量・コスト・git 状態を常時モニタリング | | **1M Context Window (`sonnet[1m]`)** | harness-review, breezing | 大規模コードベース分析に 100 万トークンコンテキスト窓を活用 | | **Per-model Prompt Caching Control** | 全スキル | `DISABLE_PROMPT_CACHING_*` でモデル別にキャッシュ制御。デバッグ・コスト最適化 | | **`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`** | harness-work | Adaptive Reasoning 無効化で固定 thinking budget に復帰。予測可能なコスト制御 | | **Chrome Integration (`--chrome`, beta)** | harness-work, harness-review | ブラウザ自動化でUI テスト・フォーム入力・コンソールデバッグ。`/chrome` でセッション内切替 | | **LSP サーバー統合 (`.lsp.json`)** | setup | CC native 機能。Harness 側の `.lsp.json` デフォルト設定なし（`/setup lsp` で個別設定可） | | **`SubagentStart`/`SubagentStop` matcher (v2.1.72+)** | breezing, hooks | settings.json レベルで agent type 別にサブエージェントライフサイクルを監視。Worker/Reviewer/Scaffolder/Video Generator を個別トラッキング | | **Agent Teams: Task Dependencies** | breezing | タスク間依存の自動管理。依存完了で blocked タスクが自動 unblock。ファイルロックで claiming 競合防止 | | **`--teammate-mode` CLI フラグ (v2.1.72+)** | breezing | セッション単位で `in-process`/`tmux` 表示モードを切替。`claude --teammate-mode in-process` | | **`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` (v2.1.72+)** | setup | `=1` で全バックグラウンドタスク機能を無効化。セキュリティポリシーでバックグラウンド実行を制限する環境向け | | **`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` (v2.1.72+)** | breezing, harness-work | サブエージェントの auto-compaction しきい値を調整（デフォルト 95%）。`50` で早期圧縮、長時間 Worker の安定性向上 | | **`cleanupPeriodDays` 設定 (v2.1.72+)** | setup | サブエージェント transcript の自動クリーンアップ期間（デフォルト 30 日） | | **`/btw` サイドクエスチョン (v2.1.72+)** | 全スキル | 現在のコンテキストを保持したまま短い質問。ツールアクセスなし、履歴に残らない。サブエージェント起動の軽量代替 | | **Plugin CLI コマンド群 (v2.1.72+)** | setup | `claude plugin install/uninstall/enable/disable/update` + `--scope` フラグ。スクリプトによる自動化対応 | | **Remote Control 強化 (v2.1.72+)** | 調査済み・将来対応 | `/remote-control` (`/rc`) でセッション内から有効化。`--name`, `--sandbox`, `--verbose` フラグ。`/mobile` で QR コード表示。自動再接続対応 | | **`skills` フィールド in agent frontmatter (v2.1.72+)** | agents/ | サブエージェントにスキルをプリロード。Worker に `harness-work`+`harness-review`、Reviewer に `harness-review`、Scaffolder に `harness-setup`+`harness-plan` を注入（実装済み） | | **`modelOverrides` 設定 (v2.1.73)** | setup, breezing | モデルピッカーのエントリを Bedrock ARN 等のカスタムプロバイダモデル ID にマッピング | | **`/output-style` 非推奨化 (v2.1.73)** | 全スキル | `/config` に移行。出力スタイル選択はコンフィグメニューに統合 | | **Bedrock/Vertex Opus 4.6 デフォルト化 (v2.1.73)** | breezing | クラウドプロバイダのデフォルト Opus が 4.1 → 4.6 に更新 | | **`autoMemoryDirectory` 設定 (v2.1.74)** | session-memory, setup | 自動メモリの保存パスをカスタマイズ。プロジェクト固有のメモリ分離に対応 | | **`CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` (v2.1.74)** | hooks | SessionEnd フックのタイムアウトを設定可能に（従来は 1.5 秒固定で kill） | | **Full model ID 修正 (v2.1.74)** | agents/, breezing | `claude-opus-4-6` 等の完全モデル ID がエージェント frontmatter・JSON config で認識されるように | | **Streaming API メモリリーク修正 (v2.1.74)** | breezing, harness-work | ストリーミングレスポンスバッファの無制限 RSS 増大を修正 | | **`--remote` / Cloud Sessions** | breezing, harness-work | `--remote` でターミナルからクラウドセッションを起動。非同期タスク実行 | | **`/teleport` (`/tp`)** | session | クラウドセッションをローカルターミナルに取り込み | | **`CLAUDE_CODE_REMOTE` 環境変数** | hooks, session-env-setup | クラウド vs ローカル実行の検出。フックの条件分岐に活用 | | **`CLAUDE_ENV_FILE` SessionStart 永続化** | hooks, session-env-setup | SessionStart フックから後続 Bash コマンドへ環境変数を永続化 | | **Slack Integration (`@Claude`)** | — | 将来対応（Teams/Enterprise 前提）。Harness 側の実装なし | | **Server-managed settings (public beta)** | setup | サーバー配信による一括設定管理。Teams/Enterprise 向け | | **Microsoft Foundry** | setup, breezing | 新クラウドプロバイダとして追加 | | **`PreCompact` hook** | hooks | compact 前に Plans.md 未保存なら pathspec 限定 auto-checkpoint コミット後に続行（失敗時または `precompactAutoCommit: false` のみ block） | | **`Notification` hook event** | hooks | 通知発火時のカスタムハンドラ（実装済み） | | **`/context` コマンド (v2.1.74)** | all skills | コンテキスト消費の可視化と最適化提案 | | **`maxTurns` エージェント安全制限** | agents/ | ターン上限による暴走防止。Worker: 100, Reviewer: 50, Scaffolder: 75 | | **Output token limits 64k/128k (v2.1.77)** | all skills | Opus 4.6 / Sonnet 4.6 デフォルト 64k、上限 128k トークン | | **`allowRead` sandbox 設定 (v2.1.77)** | harness-review | `denyRead` 内で特定パスの読み取りを再許可 | | **PreToolUse `allow` が `deny` を尊重 (v2.1.77)** | guardrails | フック `allow` が settings.json `deny` を上書きしない | | **Agent `resume` → `SendMessage` (v2.1.77)** | breezing | Agent tool `resume` 廃止、`SendMessage({to: agentId})` に移行 | | **`/branch` (旧 `/fork`) (v2.1.77)** | session | `/fork` → `/branch` リネーム。エイリアス存続 | | **`claude plugin validate` 強化 (v2.1.77)** | setup | frontmatter + hooks.json 構文検証追加 | | **`--resume` 45% 高速化 (v2.1.77)** | session | fork-heavy セッション再開の高速化・メモリ削減 | | **Stale worktree 競合修正 (v2.1.77)** | breezing | アクティブ worktree 誤削除の防止 | | **`StopFailure` hook event (v2.1.78)** | hooks | API エラーでのセッション停止失敗をキャプチャ | | **`${CLAUDE_PLUGIN_DATA}` 変数 (v2.1.78)** | hooks, setup | プラグイン更新でも永続するステートディレクトリ | | **Agent `effort`/`maxTurns`/`disallowedTools` frontmatter (v2.1.78)** | agents/ | プラグインエージェントの宣言的制御 | | **`deny: ["mcp__*"]` 修正 (v2.1.78)** | setup | settings.json deny で MCP ツールを正しくブロック | | **`ANTHROPIC_CUSTOM_MODEL_OPTION` (v2.1.78)** | setup | カスタムモデルピッカーエントリ | | **`--worktree` skills/hooks 読込修正 (v2.1.78)** | breezing | worktree フラグ時のスキル・フック正常ロード | | **Skill `effort` frontmatter (v2.1.80)** | harness-work, harness-review, harness-plan, harness-release | 5動詞スキル自体に思考量を持たせ、重いフローの初動品質を引き上げる | | **Agent `initialPrompt` frontmatter (v2.1.83)** | agents/ | Worker / Reviewer / Scaffolder の最初の1ターンを役割ごとに安定化 | | **`sandbox.failIfUnavailable` (v2.1.83)** | setup, guardrails | sandbox 起動失敗時に unsandboxed へ silently fallback しない | | **`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1` (v2.1.83)** | hooks, setup | hook / Bash / MCP stdio subprocess への資格情報流出面を縮小 | | **`TaskCreated` / `CwdChanged` / `FileChanged` hooks (v2.1.83-2.1.84)** | hooks, session | reactive state tracking と Plans / ルール再読リマインドを追加 | | **Rules / skills `paths:` YAML list (v2.1.84)** | setup, localize-rules | 複数 glob を構造化して保持し、ルールの適用範囲を読みやすく壊れにくくする | | **Hooks conditional `if` field (v2.1.85)** | hooks, guardrails | `PermissionRequest` を安全な Bash と編集系だけに絞り、不要な hook 起動と誤警告を減らす | | **Large session truncation 修正 (v2.1.78)** | session | 5MB 超セッションの切り詰め修正 | | **`--console` auth フラグ (v2.1.79)** | setup | Anthropic Console API 課金認証 | | **Turn duration 表示 (v2.1.79)** | all skills | `/config` でターン実行時間の表示切替 | | **`CLAUDE_CODE_PLUGIN_SEED_DIR` 複数対応 (v2.1.79)** | setup | 複数シードディレクトリ指定 | | **SessionEnd hooks `/resume` 修正 (v2.1.79)** | hooks | 対話的セッション切替時の SessionEnd 正常発火 | | **18MB startup memory 削減 (v2.1.79)** | all skills | 起動時メモリ使用量削減 | | **MCP tool description cap 2KB (v2.1.84)** | all skills | OpenAPI 由来の巨大 MCP スキーマによるコンテキスト肥大化を防止。CC 自動継承 | | **`TaskCreated` hook blocking (v2.1.84)** | hooks | TaskCreate 時にフックが同期ブロックで発火。runtime-reactive で state tracking に活用 | | **Idle-return prompt 75min (v2.1.84)** | session | 75 分以上離席後に `/clear` を提案。stale セッションのトークン浪費防止。CC 自動継承 | | **`X-Claude-Code-Session-Id` header (v2.1.86)** | setup | API リクエストにセッション ID ヘッダ追加。プロキシ側の集計に利用可能。CC 自動継承 | | **Cowork Dispatch 修正 (v2.1.87)** | breezing | Cowork Dispatch のメッセージ配信修正。CC 自動継承 | | **`PermissionDenied` hook event (v2.1.89)** | hooks, breezing | auto mode classifier 拒否時に発火。`{retry:true}` でリトライ誘導。Breezing Worker の拒否追跡・Lead 通知に実装 | | **`"defer"` permission decision (v2.1.89)** | hooks, breezing | PreToolUse から `"defer"` を返すとヘッドレスセッションを一時停止→resume で再評価。Breezing の安全弁 | | **`updatedInput` + `AskUserQuestion` (v2.1.89+)** | hooks | ヘッドレス環境で外部 UI / 明示 answer source が質問回答を収集し、既知同義語だけ canonical option label に寄せて `updatedInput.answers` を返す。A: 実装あり (`ask-user-question-normalize`) | | **Hook output >50K disk save (v2.1.89)** | hooks | 大出力フックをディスク保存＋プレビュー。コンテキスト肥大化防止 | | **Hooks `if` compound command fix (v2.1.89)** | hooks | `ls && git push` や `FOO=bar git push` のような複合コマンドが `if` 条件にマッチするよう修正。CC 自動継承 | | **Autocompact thrash loop fix (v2.1.89)** | all skills | 3 回連続 compact→即再充填で actionable error を出して停止。CC 自動継承 | | **Nested CLAUDE.md re-injection fix (v2.1.89)** | all skills | 長セッションで CLAUDE.md が数十回再注入されるバグを修正。CC 自動継承 | | **Thinking summaries default off (v2.1.89)** | all skills | thinking summaries のデフォルト生成を停止。`showThinkingSummaries:true` で復元。CC 自動継承 | | **PreToolUse exit 2 JSON fix (v2.1.90)** | hooks, guardrails | JSON stdout + exit 2 でのブロック動作を修正。pre-tool.sh の deny がより確実に動作 | | **PostToolUse format-on-save fix (v2.1.90)** | hooks | PostToolUse フックがファイルを書き換えた後の Edit/Write 失敗を修正。CC 自動継承 | | **`--resume` prompt-cache miss fix (v2.1.90)** | session | v2.1.69 以降の回帰バグ修正。deferred tools/MCP/agents 使用時の resume キャッシュミス。CC 自動継承 | | **SSE/transcript performance (v2.1.90)** | all skills | SSE フレーム O(n²)→O(n)、transcript writes 二次関数→線形。CC 自動継承 | | **`/powerup` interactive lessons (v2.1.90)** | — | Claude Code 機能学習のアニメーションデモ。CC 自動継承 | | **MCP `maxResultSizeChars` 500K (v2.1.91)** | hooks, setup | MCP ツール結果の最大サイズを `_meta["anthropic/maxResultSizeChars"]` で 500K まで拡張。大きな harness-mem 結果等で活用可能 | | **`disableSkillShellExecution` setting (v2.1.91)** | setup, guardrails | スキル内の shell 実行を無効化。セキュリティ要件が高い環境向け設定 | | **Plugin `bin/` directory (v2.1.91)** | setup | プラグインが `bin/` ディレクトリにコンパイル済みバイナリを同梱可能。将来の配布形態拡張候補 | | **Transcript chain breaks fix (v2.1.91)** | session | `--resume` 時の transcript 途切れを修正。CC 自動継承 | | **Subagent spawning fix (v2.1.92)** | breezing | 「Could not determine pane count」修正。Breezing 安定性向上。CC 自動継承 | | **`forceRemoteSettingsRefresh` (v2.1.92)** | — | Teams/Enterprise 向け fail-closed remote settings。CC 自動継承 | | **`/usage` usage / cost / stats view (v2.1.92, v2.1.118 refresh)** | all skills | `/usage` を利用量・コスト・統計の入口として扱う。旧 `/cost` / `/stats` は関連 tab を開く shortcut として CC 自動継承 | | **Linux `apply-seccomp` helper (v2.1.92)** | setup | sandbox unix-socket ブロッキング強化。CC 自動継承 | | **Plugin `skills` フィールド明示化 (v2.1.94)** | setup | plugin.json に `"skills": ["./"]` を明示宣言。CC 2.1.94 でスキル呼び出し名が frontmatter `name` 基準に。A: 実装あり (plugin.json 更新) | | **Monitor ツール (v2.1.98)** | breezing/harness-work/ci/deploy/harness-review | 長時間プロセスの stdout ストリーミング監視。polling より低レイテンシ・低トークン消費で CI/デプロイ進捗を追跡。A: 実装あり (allowed-tools + 運用ガイド + Feature Table) | ## Phase 44 追補テーブル この追補セクションでは、`2.1.99-2.1.111` と Opus 4.7 だけをまとめて見られるようにしています。 | 機能 | 活用スキル / 領域 | 用途 | 付加価値 | |------|-------------------|------|----------| | **公開 changelog なしの版 (`2.1.99`, `2.1.100`, `2.1.102`, `2.1.103`, `2.1.104`, `2.1.106`)** | all skills | 明示追従項目なし。ベースライン確認のみ | `C: CC 自動継承` | | **`/team-onboarding` と `2.1.101` 系の安定化** | setup, session | onboarding / resume UX 向上 | `C: CC 自動継承` | | **`PreCompact` hook (v2.1.105)** | hooks, breezing | 長時間 Worker 実行中の compaction を block する設計の土台 | `A: 明示追従対象` | | **plugin `monitors` manifest (v2.1.105)** | hooks, setup, breezing | monitor を session start / skill invoke で auto-arm する | `A: 明示追従対象` | | **thinking hint 改善 (v2.1.107, v2.1.109)** | all skills | 長考中の UI ヒント改善 | `C: CC 自動継承` | | **`ENABLE_PROMPT_CACHING_1H` (v2.1.108)** | session, work, breezing | 1 時間 prompt cache TTL を opt-in で運用可能にする | `A: 明示追従対象` | | **recap / built-in slash command discovery (v2.1.108)** | session, all skills | 再開品質と slash command 利用の向上 | `C: CC 自動継承` | | **permission deny 再評価 fix (v2.1.110)** | hooks, guardrails | `updatedInput` と mode 更新後も deny を再評価する前提を docs とテスト観点に反映 | `A: 明示追従対象` | | **`/tui`, focus, recap まわりの UX 改善 (v2.1.110)** | session | 画面表示と remote client 体験の改善 | `C: CC 自動継承` | | **`xhigh` effort (v2.1.111)** | harness-review, advisor, docs | `high` と `max` の中間強度を正式対象として採用する | `A: 明示追従対象` | | **`/ultrareview` (v2.1.111)** | harness-review, docs | cloud 多エージェント review と `/harness-review` の役割を整理する | `A: 明示追従対象` | | **Auto mode no longer requires `--enable-auto-mode` (v2.1.111)** | docs, guardrails | Auto Mode の前提文言を古い enable flag 依存から更新する | `A: 明示追従対象` | | **`/effort` slider と model picker 連携 (v2.1.111)** | harness-review, docs | effort を会話中に調整しやすくする | `A: 明示追従対象` | | **read-only bash permission prompt 緩和 (v2.1.111)** | guardrails, docs | 安全な read-only コマンドの prompt 発火が減る前提を更新 | `C: CC 自動継承` | ### Opus 4.7 セクション | 機能 | 活用スキル / 領域 | 用途 | 付加価値 | |------|-------------------|------|----------| | **literal instruction following** | agents, skills, docs | 曖昧表現を減らし、指示と停止条件を具体化する | `A: 明示追従対象` | | **`xhigh` effort** | harness-review, advisor, docs | 重い review / advisory だけ thinking を一段引き上げる | `A: 明示追従対象` | | **task budgets** | docs, future work | 既存 `max_consults` / cost 制御との競合を先に整理する | `A: 明示追従対象` | | **tokenizer 改善** | all skills | token 効率改善の恩恵を受ける | `C: CC 自動継承` | | **vision 2576px** | harness-review, docs | 高解像度レビューの運用上限を更新する | `A: 明示追従対象` | | **memory 改善** | session-memory, docs | 長時間実行と resume の説明を新前提に合わせる | `A: 明示追従対象` | | **`/ultrareview`** | harness-review, docs | `/harness-review` との役割分担を明文化する | `A: 明示追従対象` | | **Auto Mode 拡大** | docs, guardrails | enable flag 前提を落とし、常設機能として扱う | `A: 明示追従対象` | | **`context: fork` host CLAUDE.md 継承仕様と auto-start 回避パターン (Phase 46)** | harness-review | `context: fork` スキルは isolated context で動作し、host CLAUDE.md の session-start rules に override されて停止する事象を解消。host CLAUDE.md 継承仕様と auto-start 回避パターンを `skill-editing.md` に明文化（Issue #84）。A: 実装あり（SKILL.md Step 0 硬化 + `REVIEW_AUTOSTART` marker 契約） | `A: 実装あり` | **注記**: この追補では `A` / `C` / `P` を使い、`B` は `0` 件です。 `A` は「Harness 側で明示追従する責務がある項目」、`C` は「Claude Code / Codex 本体の更新をそのまま継承する項目」、`P` は「今回直接実装せず Plans 化する項目」を意味します。 ## Phase 51 追補テーブル この追補セクションでは、Claude Code `2.1.112-2.1.114` と Codex `0.121.0` の一次情報から、Harness に載せる項目だけを分類します。 | 機能 | 活用スキル / 領域 | 用途 | 付加価値 | |------|-------------------|------|----------| | **AskUserQuestion `updatedInput.answers` bridge** | hooks, harness-plan, harness-release | `PreToolUse` で明示的に渡された answers を読み、`solo/team` や `scripted/exploratory` など既知同義語だけを option label に正規化して headless 対話を継続 | `A: 実装あり` (`go/internal/hookhandler/ask_user_question_normalizer.go`, `hooks/hooks.json`, `tests/test-claude-upstream-integration.sh`) | | **Claude Code 2.1.113 permission / sandbox hardening** | settings, guardrails | `sandbox.network.deniedDomains` を設定し、`find -exec` / `-delete` と macOS dangerous rm paths を Harness guardrail でも検出 | `A: 実装あり` (`.claude-plugin/settings.json`, `go/internal/guardrail/helpers.go`, `tests/test-claude-upstream-integration.sh`) | | **Claude Code 2.1.114 permission dialog crash fix** | hooks, team execution | Agent Teams teammate の permission dialog crash 修正 | `C: CC 自動継承` | | **Claude/Codex upstream update Skills gate** | skills, review | upstream update 実施前に version-by-version 分解表を必須化し、PR 対象の `skills/` / `codex/.codex/skills/` と local-only `.agents/skills/` の判定を同期 | `A: 実装あり` (`claude-codex-upstream-update`, `cc-update-review`) | | **Codex 0.121.0 marketplace / MCP Apps / memory controls** | setup, future Codex workflow | plugin marketplace、MCP Apps tool calls、memory reset / cleanup、sandbox metadata を Harness の Codex 比較軸へ残す | `P: Plans 化`。今回は Claude hardening 実装を優先し Plans に切り出し | | **Codex 0.121.0 secure devcontainer / bubblewrap** | setup, guardrails | secure devcontainer profile と macOS Unix socket allowlist を将来の sandbox policy 比較対象にする | `C: Codex 側調査済み / Harness 変更なし` | | **Skills mirror 総点検** | skills, setup | `.agents/skills` の Claude/Codex 置換 drift、Codex native tool model、memory/session path、media generation metadata を棚卸し | `P: Plans 化` (`docs/skills-audit-2026-04-20.md`) | **注記**: Phase 51 でも `B: 書いただけ` は `0` 件です。Codex 0.121.0 の大きい項目は、今回の直接実装ではなく「Codex 比較軸」として Plans に残し、Claude Code 側の `AskUserQuestion.updatedInput` と 2.1.113 hardening は settings / Go / tests まで実装して `A` としました。 ## Phase 52 追補テーブル この追補セクションでは、Claude Code `2.1.116` と Codex `0.122.0` / `0.123.0-alpha.2` の一次情報から、Harness に直接実装するべきか、自動継承 / Plans 化に留めるべきかを分類します。詳細は `docs/upstream-update-snapshot-2026-04-21.md` に記録しています。 | 機能 | 活用スキル / 領域 | 用途 | 付加価値 | |------|-------------------|------|----------| | **Claude Code 2.1.116 resume / MCP / plugin updater UX refresh** | session, setup, MCP | `/resume` 高速化、MCP startup deferred loading、plugin dependency auto-install を Harness の session / setup guidance と照合 | `C/P: 自動継承 + Plans 化`。Harness wrapper は追加せず、plugin dependency policy と MCP health watch の後続候補に残す | | **Claude Code 2.1.116 dangerous-path safety / agent hooks refresh** | guardrails, agents | sandbox auto-allow dangerous-path safety と main-thread `--agent` hooks 発火を既存 guardrail / agent policy と照合 | `C/P: 自動継承 + Plans 化`。R05 guardrail は維持し、agent frontmatter policy audit に残す | | **Codex 0.122.0 plugin / Plan Mode / permission model** | codex workflow, setup, sandbox | `/side`、fresh-context Plan Mode、plugin workflow、deny-read glob、tool discovery default-on を Codex mirror 改善候補に分類 | `P: Plans 化`。Phase 51.2 の Codex-native skill audit と一緒に扱う | | **Codex 0.123.0-alpha.2 pre-release** | future compare | release body が薄い alpha を推測実装せず、stable 化後の再確認対象にする | `P: Plans 化`。compare から推測実装しない | | **Upstream update Skills merge hardening** | skills, review, tests | `cc-update-review` を diff-aware 化し、`claude-codex-upstream-update` を no-op adaptation 対応にして mirror drift test を追加 | `A: 実装あり` (`skills/cc-update-review`, `skills/claude-codex-upstream-update`, `tests/test-claude-upstream-integration.sh`) | **注記**: Phase 52 でも `B: 書いただけ` は `0` 件です。Claude / Codex 本体が自然に改善する UX は `C` とし、Harness に重ねると二重責務になるものは `P` として後続の Codex-native skill audit / plugin policy に接続しました。直接実装は review findings の再発防止に絞り、skill mirror drift と no-op adaptation を test で固定しています。 ## Phase 53 追補テーブル この追補セクションでは、Claude Code `2.1.117-2.1.118` と Codex `0.123.0` の一次情報から、Harness に直接実装するべきか、自動継承 / Plans 化に留めるべきかを分類します。詳細は `docs/upstream-update-snapshot-2026-04-23.md` に記録しています。 | 機能 | 活用スキル / 領域 | 用途 | 付加価値 | |------|-------------------|------|----------| | **Claude Code `type: "mcp_tool"` hooks** | hooks, MCP diagnostics, tests | shell script を増やさず、読み取り専用の MCP health / resource 診断 hook を小さく検証する | `A: 実装あり`。53.1.2 では manifest 追加を no-op とし、常設 read-only diagnostic tool と安定 field 仕様が揃うまで配布 hooks へ入れない判断を snapshot に記録。書き込み系 MCP tool を呼ばないことは `tests/test-claude-upstream-integration.sh` で固定 | | **Claude Code `claude plugin tag`** | harness-release, plugin release | `VERSION` と `.claude-plugin/plugin.json` の同期確認後に plugin version validation 付き tag を作る | `A: 実装予定`。53.1.3 で release flow / dry-run / test guidance に追加 | | **Auto Mode `"$defaults"` extension** | permissions, sandbox, settings docs | built-in default を置き換えず、Harness 独自ルールを追加する形へ guidance を更新する | `A: 実装あり`。53.1.4 で `"$defaults"` を additive baseline として記録し、R05 / `deniedDomains` と二重責務にならない理由を snapshot・template・upstream integration test で固定 | | **Plugin themes / managed settings / dependency auto-resolve** | setup, plugin policy, enterprise docs | `themes/`, `DISABLE_UPDATES`, `blockedMarketplaces`, `strictKnownMarketplaces`, dependency hints を管理環境向けに整理する | `A: docs 化済み`。53.1.5 で `docs/plugin-managed-settings-policy.md` を新設し、Harness 独自 resolver を重ねない方針を明記。theme 同梱判断は snapshot 側で `P` として残す | | **Claude Code UX / runtime fixes** | session, agents, MCP, search, effort | `/usage` 統合、`/resume` `/add-dir` 対応、`--agent` + `mcpServers`、stale session summary、native `bfs` / `ugrep`、高 effort default を整理する | `C/P: 自動継承 + Plans 化`。53.1.6 で wrapper を追加しない理由を snapshot に記録し、`--agent` + `mcpServers` と external forked subagent flag は agent audit 候補として `P` に残す | | **Codex 0.123.0 provider / model metadata** | Codex setup, provider policy | built-in `amazon-bedrock` provider、AWS profile support、current `gpt-5.4` default metadata を Codex setup guidance に反映する | `A: docs 化済み`。53.2.1 で `docs/codex-provider-setup-policy.md` を新設し、Harness 配布 config では `model` / `model_provider` を固定せず、Bedrock 利用者だけが user / project config に追加する方針を固定 | | **Codex 0.123.0 MCP diagnostics / plugin loading** | troubleshoot, setup, Codex plugin docs | `/mcp verbose`、diagnostics / resources / resource templates、`.mcp.json` の `mcpServers` 形式と top-level server map 形式を setup guidance に反映する | `A: docs 化済み`。53.2.2 で `docs/codex-mcp-diagnostics.md` を新設し、普段は `/mcp`、困った時だけ `/mcp verbose` を使う手順と、Claude Code 側 MCP guidance と混ぜない方針を固定 | | **Codex 0.123.0 realtime handoff silence** | harness-loop, breezing, long-running | background agents が transcript delta を受け取り、必要ない時は明示的に沈黙できる前提で途中報告の頻度を整理する | `A: docs 化済み`。53.2.3 で `harness-loop` は 1 cycle につき最終報告 1 回、`breezing` は task 完了ごとに progress feed 1 回を基本にし、advisor / reviewer drift は silence 対象外として固定 | | **Codex 0.123.0 sandbox / exec changes** | sandbox, execution policy | `remote_sandbox_config`、`codex exec` shared flags を追従する | `A: docs 化済み`。53.2.4 で `docs/codex-sandbox-execution-policy.md` を追加し、remote environment ごとの sandbox 要件比較と wrapper flag 重複削減可否を固定 | | **Codex 0.123.0 automatic bug fixes** | Codex long-running UX, session shell, review privacy | `/copy` rollback、manual shell follow-up queue、Unicode / dead-key、stale proxy env、VS Code WSL keyboard、review prompt leak を記録する | `C: Codex 自動継承`。53.2.5 で workaround を追加しない理由を明記 | **注記**: Phase 53 でも `B: 書いただけ` は `0` 件です。Feature Table は入口に留め、公式 URL と version-by-version の判断根拠は `docs/upstream-update-snapshot-2026-04-23.md` に集約しました。`A` は Phase 53 の具体 task に接続し、`C` は本体修正の自動継承、`P` は推測実装しない将来判断として扱います。 Phase 53 closeout では、Codex mirror / path drift の広い棚卸しを Phase 51.2 の Codex-native skill audit TODO に残します。Phase 53 は upstream `0.123.0` 差分の具体反映だけを閉じ、Phase 51.2.1-51.2.4 の tool model / memory path / mirror path / media metadata 整理を先取りしません。 ## Phase 69 追補テーブル (Claude Code 2.1.133-2.1.142) この追補セクションでは、Claude Code `2.1.133-2.1.142` の 10 バージョン分を Harness の実装/自動継承/保留にどう分類したかを記載します。一次情報と version-by-version の判断根拠は `docs/upstream-update-snapshot-2026-05-15.md` を参照してください。 | 機能 | 活用スキル / 領域 | 用途 | 付加価値 | |------|-------------------|------|----------| | **Claude Code `worktree.baseRef` (2.1.133)** | settings, breezing, worker isolation | `--worktree` / `EnterWorktree` / agent-isolation worktree の起点を `origin/` (`fresh`) or local `HEAD` (`head`) で明示する | `A: 実装あり` (`templates/claude/settings.security.json.template`)。Phase 69.1.1 で template に baseline `fresh` を明示し、unpushed commits を持ち込みたい team は project-level で `head` を opt-in できる。Plugin 本体 `.claude-plugin/settings.json` は self-write deny のため release operator が手動マージ | | **Claude Code hook `$CLAUDE_EFFORT` env + `effort.level` JSON (2.1.133)** | hooks, observability | hook handler / Bash subprocess から現在の effort を観測できる | `A: 実装あり` (`.claude/rules/hooks-2.1.139-plus.md`)。Phase 69.1.2 で「観測のみ可、guard rail の effort 緩和は禁止」を明文化 | | **Claude Code `settings.autoMode.hard_deny` (2.1.136)** | settings, guardrails, auto mode | Auto Mode classifier が「許可意図に関わらず必ず deny」を扱える | `A: 実装あり` (`templates/claude/settings.security.json.template`)。Phase 69.1.3 で template baseline 7 件 (`Bash(sudo:*)` / `Bash(rm -rf:*)` / `Bash(rm -fr:*)` / `Bash(git push -f:*)` / `Bash(git push --force:*)` / `Bash(git reset --hard:*)` / `mcp__codex__*`) を Harness deny と整合。Plugin 本体 `.claude-plugin/settings.json` は self-write deny のため release operator が手動マージ | | **Claude Code `claude agents` agent view (2.1.139-2.1.142)** | agents, breezing, operator workflow | 全 CC session を 1 画面で監視できる operator entrypoint。`--cwd`, `--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions` の 9 flag が dispatched background session を構成する | `A: 実装あり` (`docs/agent-view-policy.md`, `docs/team-composition.md`, `agents/worker.md`)。Phase 69.2.2 で teammate spawn workflow (breezing skill) との分離と各 flag 利用条件を明文化 | | **Claude Code native `/goal` command (2.1.139)** | harness-plan, harness-work, Codex `/goal` 補完 | 完了条件を turn 超えで保持できる | `A: 実装あり` (`docs/codex-plugin-workflows-policy.md`)。Phase 69.2.1 で「session continuation memo 限定」「Plans.md SSOT を奪わない」「acceptance criteria を `/goal` だけに置かない」3 規則を Codex `/goal` と統合 | | **Claude Code `claude plugin details ` (2.1.139)** | plugin observability, CI 補助 | plugin の component 内訳と projected per-session token cost が見える | `A: 実装あり` (`docs/agent-view-policy.md`, `docs/upstream-update-snapshot-2026-05-15.md`)。Phase 69.2.4 で CI / doctor の補助情報として位置付け、plugin が session 予算閾値を越えた時の対応 step を docs 化 | | **Claude Code hook `args: string[]` (exec form, 2.1.139)** | hooks, security, future-proof | shell を介さず command を直接 spawn できる | `A: 実装あり` (`.claude/rules/hooks-2.1.139-plus.md`)。Phase 69.1.4 で「path placeholder のみは exec form 優先、shell 制御が必要な場合は既存 `command` を維持」を rules 化 | | **Claude Code hook `PostToolUse.continueOnBlock` (2.1.139)** | hooks, guardrails | hook の rejection reason を Claude に feedback し turn 継続できる | `A: 実装あり` (`.claude/rules/hooks-2.1.139-plus.md`)。Phase 69.1.4 で「diagnostic feedback のみ true、R01-R13 / secret / protected config では `false` 必須」を rule 化 | | **Claude Code hook `terminalSequence` (2.1.141)** | hooks, local notification | controlling terminal なしで desktop 通知 / window title / bell を発火 | `A: 実装あり` (`scripts/lib/terminal-notify.sh`, `scripts/hook-handlers/webhook-notify.sh`, `scripts/hook-handlers/notification-handler.sh`)。Phase 69.1.5 で `HARNESS_TERMINAL_NOTIFY` (`0` / `bell` / `title` / `osc9` / `notify`) opt-in 実装。既存 `HARNESS_WEBHOOK_URL` と独立 | | **Claude Code background permission mode 保持 (2.1.141)** | agents, breezing | `/bg` / `←←` / `claude agents` で起動した teammate が起動時 mode を保持する | `A: 実装あり` (`agents/worker.md`, `docs/team-composition.md`)。Phase 69.2.3 で「Worker は permission mode 再注入不要、`bypassPermissions` でも settings.json deny は override しない」期待値を明文化 | | **Claude Code hook config error (SessionStart/Setup/SubagentStart は command-only, 2.1.142)** | hooks, validation | bootstrap 段階の hook で LLM 型 hook が拒絶される | `A: 実装あり` (`.claude/rules/hooks-2.1.139-plus.md`)。Phase 69.1.4 と同 rule 内で「SessionStart/Setup/SubagentStart は `type: "command"` 限定」を grep-able に明示 | | **CC 2.1.142 fast mode Opus 4.7 default + `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE`** | model defaults | fast mode が常に Opus 4.7 で動く | `C: CC 自動継承`。Harness は既に Opus 4.7 を default として扱うため変更不要 | | **CC 2.1.139 MCP stdio receives `CLAUDE_PROJECT_DIR`** | MCP setup | MCP server が project dir を解決できる | `C: CC 自動継承` | | **CC 2.1.139 `x-claude-code-agent-id` / `parent-agent-id` headers + OTEL attrs** | OTel | subagent 監視性が上がる | `C: CC 自動継承` | | **CC 2.1.141 `claude agents --cwd`** | operator UX | session list を directory scope できる | `A: 実装あり` (`docs/agent-view-policy.md`)。Phase 69.2.2 で project ごとの分離運用を docs 化 | | **CC 2.1.141 Rewind "Summarize up to here"** | session | context compression 中間状態保持 | `C: CC 自動継承`。`.claude/rules/commit-safety.md` の `/undo` policy と整合 | | **CC 2.1.133/2.1.136-2.1.142 runtime bug fixes (parallel session credential race / MCP `/clear` persistence / OAuth refresh / extended thinking redaction / `--resume` underscore / WSL2 image paste / agent color palette / settings hot-reload symlink / spinner amber / 多数の plugin/MCP/UX 修正)** | runtime | safety / stability | `C: CC 自動継承`。Harness 側に wrapper を追加しない | **注記**: Phase 69 でも `B: 書いただけ` は `0` 件です。Feature Table は入口に留め、公式 URL と version-by-version の判断根拠は `docs/upstream-update-snapshot-2026-05-15.md` に集約しました。`A` は実 file 変更 (settings / hooks / rules / docs / scripts) と紐付き、`C` は本体修正の自動継承、`P` は推測実装しない将来判断として扱います。 ## Phase 133.6 追補テーブル (subagent depth/concurrency + sandbox credential-masking claim 検証) このセクションは、先行 research agent が報告した 2 クラスタの claim を一次情報 (raw `CHANGELOG.md`) で個別検証した結果のみを反映する。フルバージョン同期ではない (`2.1.153`-`2.1.216` は未確認)。検証記録・引用元: `docs/research/133-6-cc-cli-claim-verification.md`。 | 機能 | 活用スキル / 領域 | 用途 | 付加価値 | |------|-------------------|------|----------| | **Subagent nested-spawn depth limit + 同時実行数上限 (`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` / `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`, 2.1.217/2.1.219)** | breezing, harness-work, harness-review | `confirmed`。2.1.217 でネスト spawn を既定 OFF に + 同時実行数上限を既定 20 に設定可能化、2.1.219 で既定 depth を 1→3 に緩和 (原文 "was 1")。`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` は breezing の並列 worker 数と、`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` は sub-agent が further sub-agent を呼ぶ設計 (worker → 内部 delegation 等) と相互作用しうる | `A: 採用済 (docs 反映)`。133.9 で反映。`--parallel N` は希望値で実同時実行数は CC が決める旨を `skills/breezing/SKILL.md` と `skills/harness-work/SKILL.md` に明記した (20 超は待ち行列に入るだけでエラーにならない)。spawn 深さ 3 に対して Lead(0) → Worker(1) → advisor(2) と Mode 1 の Producer → Sub-Lead → Composer はいずれも収まることを確認。**env は Harness 側で明示設定せず CC 既定に従う** (既定を上書きすると CC 側の更新に追随できなくなるため) | | **Sandbox credential-masking (`mode: "mask"`, `extract`/`onExtractNoMatch`, JWT/AWS SigV4) + `sandbox.network.strictAllowlist` (2.1.219/2.1.221/2.1.224)** | guardrails, setup | `confirmed`。`denyRead` のディレクトリ単位 deny と異なり、値単位で credential を mask できる機構。macOS はファイル masking が `deny` にフォールバックする点に注意 (raw changelog 原文) | `P: Plans 化 (実測待ち)`。`docs/sandbox-allowlist-recipe.md` と `.claude/rules/defense-layer-blast-radius.md` に 採用検討の PROPOSAL セクションを追記済み (実装・live 設定変更なし)。133.9 時点で **`not_observed`** — raw changelog が macOS ではファイル masking が `deny` にフォールバックすると明記しており、本 repo の実行環境は macOS (`uname -s` = Darwin) のため実効性を測れない。**`absent` ではない**: Linux/WSL では動く可能性が残っている。手元に docker はあるが、CC CLI を Linux コンテナ内で sandbox 有効にして動かす経路は未確立。測るならそこが起点 | ## 機能詳細 ### Task tool メトリクス サブエージェントが消費したトークン数・ツール呼び出し数・実行時間を集計できる。 `parallel-workflows` スキルでは複数サブエージェントのメトリクスを集約し、コスト分析に使用。 ``` metrics: {tokens: 40000, tools: 7, duration: 67s} ``` ### `/debug` コマンド セッション診断用コマンド。複雑なエラーや予期しない挙動の原因調査に使用。 `troubleshoot` スキルが自動的に起動し、問題を体系的に診断。 ### PDF ページ範囲指定 大型 PDF を読み込む際にページ範囲を指定可能（例: `pages: "1-5"`）。 `notebookLM` スキルでのドキュメント処理、`harness-review` での大型仕様書参照に活用。 ### Git log フラグ `git log` の構造化オプション（`--format`, `--stat`, `--since` 等）を活用。 リリースノート生成、コミット分析、変更追跡を効率化。 ### OAuth 認証 DCR（Dynamic Client Registration）非対応 MCP サーバーへの OAuth 認証設定。 `codex-review` スキルでの Codex CLI 接続に使用。 ### 68% メモリ最適化 `--resume` フラグによるセッション再開時のメモリ使用量削減。 長時間作業セッションでのコンテキスト継続に有効。 ### サブエージェント MCP Task tool で起動したサブエージェントが親セッションの MCP ツールを共有できる。 `task-worker` での並列実装時に、各エージェントが同じ MCP ツールセットを使用可能。 ### Reduced Motion アクセシビリティ設定。モーション/アニメーションを削減するオプション。 `harness-ui` スキルで UI 生成時に考慮。 ### TeammateIdle/TaskCompleted Hook Breezing チームのメンバーがアイドル状態になった時、またはタスク完了時に発火するフック。 `scripts/hook-handlers/teammate-idle.sh` と `task-completed.sh` で処理。 ```json "TeammateIdle": [{"hooks": [{"type": "command", "command": "...teammate-idle", "timeout": 10}]}], "TaskCompleted": [{"hooks": [{"type": "command", "command": "...task-completed", "timeout": 10}]}] ``` ### Agent Memory (memory frontmatter) エージェント定義 YAML の `memory: project` フィールドで永続メモリを有効化。 `task-worker`, `code-reviewer` が過去の実装パターン・失敗と解決策を跨ぎセッションで学習。 ### Fast mode (Opus 4.6) `/fast` コマンドで切り替える高速出力モード。同じ Opus 4.6 モデルを使用。 全スキルで利用可能。長い実装タスクでの待ち時間短縮に有効。 ### 自動メモリ記録 セッション終了時に学習内容を自動的にメモリファイルへ永続化。 `session-memory` スキルが管理。次のセッションで前回の文脈を自動復元。 ### スキルバジェットスケーリング SKILL.md の文字数予算がコンテキスト窓の 2% に自動調整される。 推奨 500 行は目安値。実効上限はモデルのコンテキスト窓サイズに依存。 ### Task(agent_type) 制限 Task tool 呼び出し時に `subagent_type` を指定し、サブエージェントの種類を制限。 `agents/` 定義と組み合わせて、意図したエージェントのみを起動することを保証。 ### Plugin settings.json プラグインの `settings.json` で初期化時の設定を事前定義。 init トークン消費を削減し、セキュリティポリシーをセッション開始直後から適用。 ### Worktree isolation `git worktree` を使って同一ファイルへの並列書き込みを安全化。 `breezing` と `parallel-workflows` での複数エージェント並列実装時のコンフリクト防止。 ### Background agents 非同期でバックグラウンドエージェントを起動。完了を待たずに他の処理を継続可能。 `generate-video` スキルでの複数シーン並列生成に使用。 ### ConfigChange hook 設定ファイル（`settings.json` 等）が変更された時に発火するフック。 `scripts/hook-handlers/config-change.sh` で変更を記録・監査。 ### last_assistant_message セッション終了時の最後のアシスタントメッセージを参照できる機能。 `session-memory` スキルがセッション品質の自己評価に使用。 ### Sonnet 4.6 (1M context) 最大 1M トークンのコンテキスト窓を持つ Sonnet 4.6 モデル。 大規模コードベースの分析、長大なドキュメント処理に対応。全スキルで利用可能。 > 補足: 2.1.69 系では旧 Sonnet 4.5 参照は Sonnet 4.6 へ自動マイグレーションされる前提で運用する。 ### メモリリーク修正 (v2.1.50〜v2.1.63) CC 2.1.50 で LSP 診断データ、大型ツール出力、ファイル履歴、シェル実行に関するメモリリークが修正された。 完了タスクのガベージコレクションも実装され、`/breezing` 等の長時間チームセッションの安定性が大幅に改善。 v2.1.63 ではさらに MCP 再接続時のリーク、git root キャッシュ、JSON パースキャッシュ、Teammate メッセージ保持、シェルコマンドプレフィックスキャッシュのリークが追加修正された。 Harness 側は JSONL ローテーション（500→400 行）やアトミック更新で既に独自対策を実施済み。 ### `claude agents` CLI (v2.1.50) `claude agents list` で登録済みエージェントの一覧を表示。 `troubleshoot` スキルでエージェント spawn 失敗時の診断に活用。 ```bash claude agents list # 登録済みエージェントの一覧 ``` ### WorktreeCreate/WorktreeRemove hook (v2.1.50) Worktree の作成・削除時に発火するライフサイクルフック。 `/breezing` 並列ワークフローでの自動セットアップ・クリーンアップに活用。 `scripts/hook-handlers/worktree-create.sh` と `worktree-remove.sh` で実装済み。 ### `claude remote-control` (v2.1.51) 外部ビルドシステムとローカル環境のサービングを可能にするサブコマンド。 将来的に Breezing のクロスセッション制御や CI 連携に活用の余地あり。 ### `/simplify` (v2.1.63) CC 2.1.63 で追加された実装後の自動コード洗練コマンド。 `/work` の Phase 3.5 Auto-Refinement として統合され、実装完了後に自動でコードを簡潔化・整理する。 `code-simplifier` プラグインと組み合わせて `--deep-simplify` オプションで深いリファクタリングも可能。 ### `/batch` (v2.1.63) 横展開タスク（同じ変更を複数ファイルに適用するマイグレーション等）を並列委任するコマンド。 `/breezing` と組み合わせて、Breezing チームに一括マイグレーションを並列実行させる際に使用。 繰り返し作業の効率化と、人為的ミスの削減に有効。 ### `code-simplifier` プラグイン `/simplify` の深いリファクタリングモードを担う外部プラグイン。 `--deep-simplify` 指定時に起動し、複雑なロジックの分解・不要な抽象化の除去・命名の改善を自動実行。 通常の `/simplify` は軽量、`--deep-simplify` はより踏み込んだリファクタリングを実施。 ### HTTP hooks (v2.1.63) CC 2.1.63 で追加された新しいフック形式。既存の `command` / `prompt` タイプに加え `http` タイプが利用可能になった。 JSON を指定 URL に POST し、外部サービス（Slack、ダッシュボード、メトリクス収集等）と連携できる。 詳細は [.claude/rules/hooks-editing.md](../.claude/rules/hooks-editing.md) の「http Type」セクションを参照。 ### Auto-memory worktree 共有 (v2.1.63) CC 2.1.63 で `isolation: "worktree"` 使用時に Agent Memory が worktree 間で共有されるようになった。 `/breezing` の並列 Implementer が各自 worktree 分離で作業しながら、同一の MEMORY.md を参照・更新可能。 Implementer 間の知識共有と、同一バグへの重複対応を防止する。 ### `/clear` スキルキャッシュリセット (v2.1.63) CC 2.1.63 で追加されたスキルキャッシュのリセットコマンド。 スキルファイルを編集後に古いキャッシュで動作する問題（スキル開発時に頻発）を `/clear` で解消できる。 `troubleshoot` スキルのキャッシュ問題診断ステップに組み込み済み。 ### `ENABLE_CLAUDEAI_MCP_SERVERS` (v2.1.63) CC 2.1.63 で追加された環境変数。`false` を設定すると claude.ai が提供する MCP サーバーを無効化できる。 セキュリティポリシー上、外部 MCP サーバーへの接続を制限したい環境での利用を想定。 `setup` スキルの環境初期化チェックリストに追加済み。 ### Agent hooks (v2.1.68) CC 2.1.68 で追加された `type: "agent"` フック。LLM エージェントがフック判断を行うことで、正規表現では検出困難なコード品質問題を動的に判断できる。 Harness では3箇所に限定採用し、コスト管理のため `model: "haiku"` と `matcher` で対象を絞る: - **PreToolUse Write|Edit**: シークレット埋め込み・TODO スタブ・セキュリティ脆弱性のガード - **PreCompact**: dirty Plans.md は pathspec 限定 auto-checkpoint（`chore(plans): auto-checkpoint before compaction`）後に compact 続行。commit 失敗または `precompactAutoCommit: false` のみ block（harness-loop 所有セッションは別途 block） - **PostToolUse Write|Edit**: コードレビュー（品質・命名・単一責任） 効果不足時は `command` 型にロールバック可能な設計。 これら3件は Claude 専用。Codex manifest は inline の空 hook object で plugin-root fallback を止め、Codex / Orca が未対応 agent hook を読み飛ばす警告を 防ぐ。Codex の command hook は `harness gen hooks` の project-local 生成物として 別経路で配線する。 ### Effort levels + ultrathink (v2.1.68) CC 2.1.68 で Opus 4.6 が **medium effort** をデフォルトに変更。`ultrathink` キーワードで1ターンのみ high effort（extended thinking）を有効化できる。 `harness-work` スキルが多要素スコアリング（変更ファイル数・対象ディレクトリ・キーワード・失敗履歴・PM 明示指定）でスコアを算出し、閾値 3 以上で Worker spawn prompt 冒頭に `ultrathink` を自動注入する。 詳細は `skills/harness-work/SKILL.md` の「Effort レベル制御」セクション参照。 ### Opus 4/4.1 削除（v2.1.68） CC 2.1.68 で Opus 4 と Opus 4.1 が first-party API から削除された。Harness が対象エージェントで `model: opus` 相当を指定している場合、Opus 4.6 へ自動移行される。 Worker/Reviewer エージェントは `model: sonnet` のため影響なし。Lead（Opus 使用時）のみ medium effort がデフォルトになる変更を受ける。 ### `${CLAUDE_SKILL_DIR}` 変数 (v2.1.69) CC 2.1.69 でスキル実行時の基準パス変数 `${CLAUDE_SKILL_DIR}` が導入された。 Harness では `SKILL.md` から `references/*.md` を参照するリンクを `${CLAUDE_SKILL_DIR}/references/...` へ統一し、ミラー構成（codex/opencode）でも同じ参照を維持する。 ### InstructionsLoaded hook (v2.1.69) CC 2.1.69 で `InstructionsLoaded` イベントが追加された。Harness では `scripts/hook-handlers/instructions-loaded.sh` を新設し、instructions 読み込み完了時の軽量トラッキングと事前検証に利用する。 ### `agent_id` / `agent_type` 追加 (v2.1.69) Teammate 系イベントに `agent_id` / `agent_type` が追加された。 Harness の guardrail は `session_id` 前提から `agent_id` 優先（fallback: `session_id`）へ拡張し、role ガードを安定化した。 ### `{"continue": false}` teammate 応答 (v2.1.69) `TeammateIdle` / `TaskCompleted` で `{"continue": false, "stopReason": "..."}` を返せるようになった。 Harness では stop リクエスト受信時と全タスク完了時に同レスポンスを返し、breezing の停止判定を明示化した。 ### `/reload-plugins` (v2.1.69) スキル・フック編集後にセッション再起動なしで反映するため、開発フローに `/reload-plugins` を追加。 編集 → `/reload-plugins` → 再実行、を標準手順とする。 ### `includeGitInstructions: false` (v2.1.69) git 指示を常時埋め込む必要がないタスクでは `includeGitInstructions: false` を適用し、トークン消費を抑制できる。 Harness では breezing/work の軽量タスク（ドキュメント更新など）での活用を推奨する。 ### `git-subdir` plugin source (v2.1.69) plugin source を monorepo のサブディレクトリで管理する `git-subdir` 方式がサポートされた。 Harness では現状 `.claude-plugin/plugin.json` に追加フィールドを強制せず、リリース時に `plugin source` を明示して運用する（互換性優先）。 ### Compaction 画像保持 (v2.1.70) CC 2.1.70 でコンテキスト圧縮（Compaction）時にサマリーリクエストが画像を保持するようになった。 これにより、スクリーンショットや図表を含むセッションで Compaction 後も画像コンテキストが維持される。 プロンプトキャッシュの再利用率も改善され、画像を扱うスキル全般で効率が向上。 ### サブエージェント最終レポート簡潔化 (v2.1.70) サブエージェント完了時の最終レポートが簡潔化され、トークン消費が削減された。 `breezing` や `harness-work` で多数のサブエージェントを起動する場合、累積的なトークン節約効果が大きい。 ### `--resume` スキルリスト再注入廃止 (v2.1.70) `--resume` でセッション再開する際、スキルリストの再注入が廃止された。 これにより約 600 tokens が節約され、`session` スキルでの再開フローが軽量化。 ### Plugin hooks 修正 (v2.1.70) v2.1.70 で複数の Plugin hooks 関連バグが修正された: - `Stop` / `SessionEnd` フックが `/plugin` コマンド実行後にも正常に発火 - 同一テンプレートを持つフック間の衝突が解消 - `WorktreeCreate` / `WorktreeRemove` フックの正常動作が確認 ### Teammate ネスト防止追加修正 (v2.1.70) v2.1.69 で対応済みの Teammate ネスト防止に追加修正が入った。 エージェントが別のエージェントを無限に spawn するカスケード問題の防止が強化された。 ### PostToolUseFailure hook (v2.1.70) CC 2.1.70 で `PostToolUseFailure` イベントが追加された。ツール呼び出しが失敗した時に発火する新しいフックイベント。 Harness では `hooks` スキルと `error-recovery` で活用し、連続失敗時の自動エスカレーション（3回連続失敗で停止）に使用。 ```json "PostToolUseFailure": [{ "hooks": [{ "type": "command", "command": "...post-tool-failure.sh", "timeout": 10 }] }] ``` ### `/loop` + Cron スケジューリング (v2.1.71) CC 2.1.71 で `/loop` コマンドが追加された。`/loop 5m ` のように間隔とプロンプトを指定すると、定期的にコマンドを実行する Cron 風スケジューリングが可能。 `breezing` では `/loop 5m /sync-status` でタスク進捗の定期チェックに活用。 既存の `TeammateIdle`（受動的・イベント駆動）と異なり、能動的に定期監視を行える。 ### Background Agent 出力パス修正 (v2.1.71) CC 2.1.71 で Background Agent の完了通知に出力ファイルパスが含まれるようになった。 これにより、圧縮後でもバックグラウンドエージェントの結果を安全に回収可能。 `breezing` や `parallel-workflows` での `run_in_background: true` が実用的に。 ### `--print` チームエージェント hang 修正 (v2.1.71) `--print` モードでチームエージェントが hang する問題が修正された。 CI パイプラインでの `claude --print` 実行時のチームエージェント安定性が向上。 ### Plugin インストール並列実行修正 (v2.1.71) 複数の Claude Code インスタンスが同時にプラグインをインストールする際の状態競合が修正された。 `breezing` で複数 Teammate が同時に起動する際のプラグイン読み込み安定性が向上。 ### Marketplace 改善 (v2.1.71) CC 2.1.71 で Marketplace 周りに複数の改善が入った: - `@ref` パーサー修正: `owner/repo@vX.X.X` 形式の参照解決が正確に - update 時の merge conflict 修正: プラグイン更新がより安定に - MCP server 重複排除: 同一 MCP サーバーの多重登録を防止 - `/plugin uninstall` が `settings.local.json` を使用: ユーザーローカル設定への正確な反映 ### Per-agent hooks (v2.1.69+) CC 2.1.69 でエージェント定義の frontmatter に `hooks` フィールドが追加された。 グローバル hooks.json とは別に、エージェント固有のフックを定義できる。 Harness での活用: - **Worker**: `PreToolUse` で Write/Edit 時の `pre-tool.sh` ガードレールを適用 - **Reviewer**: `Stop` でレビューセッション完了をログ出力 エージェント定義内フックはそのエージェントのライフサイクル中のみ有効で、終了時に自動クリーンアップされる。 ### Agent `isolation: worktree` (v2.1.50+) エージェント定義の frontmatter に `isolation: worktree` を追加すると、 そのエージェントが起動時に自動で git worktree を作成し、独立したリポジトリコピーで作業する。 変更がない場合は worktree が自動クリーンアップされる。 Harness では Worker エージェントに `isolation: worktree` を追加。 `memory: project` と組み合わせることで、worktree 間で Agent Memory（MEMORY.md）が共有され、 並列 Worker が同一の学習内容を参照・更新可能。 ### Auto Mode rollout ポリシー Auto Mode は Claude Code の team execution をより安全側に寄せるための移行候補として整理している。 ただし shipped default はまだ `bypassPermissions` であり、project template や frontmatter には公式 docs に載っている permission mode のみを残す。 | レイヤー | 採用値 | 理由 | |---------|--------|------| | project template (`permissions.defaultMode`) | `bypassPermissions` | documented permission modes に `autoMode` が含まれないため | | agent frontmatter (`permissionMode`) | `bypassPermissions` | 宣言的設定は documented 値のみを使うため | | teammate 実行経路 | `bypassPermissions`（現行） | shipped default と実際の permission 継承を一致させるため | | `--auto-mode` | opt-in marker | 親セッションが互換な permission mode の場合のみ rollout を試すため | 既定コマンド例: ```bash /breezing all /execute --breezing all ``` ### Subagent `background` フィールド エージェント定義の frontmatter に `background: true` を追加すると、そのエージェントは常にバックグラウンドタスクとして実行される。 明示的に `run_in_background: true` を指定しなくても、Agent tool 経由で起動するたびにバックグラウンド実行となる。 ```yaml --- name: long-running-analyzer background: true --- ``` Harness では `breezing` の Worker spawn 時に検討可能だが、現状は Lead が明示的に `run_in_background` を制御しているため、追加適用は Phase 2 以降で検討する。 ### Subagent `local` メモリスコープ `memory: local` は `.claude/agent-memory-local//` に保存され、`.gitignore` に追加すべきパス。 `project` との違い: | スコープ | パス | VCS コミット | ユースケース | |---------|------|-------------|------------| | `user` | `~/.claude/agent-memory//` | 対象外 | 全プロジェクト共通の学習 | | `project` | `.claude/agent-memory//` | 共有可能 | チーム共有のプロジェクト知識 | | `local` | `.claude/agent-memory-local//` | 非推奨 | 個人固有・機密性の高い学習 | Harness では Worker/Reviewer ともに `memory: project` を使用中。`local` は個人的なデバッグパターンの記録に適するが、チーム共有を優先するため現行設定を維持。 ### Agent Teams 実験フラグ Agent Teams は実験的機能として `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` 環境変数で有効化される。 settings.json 経由でも設定可能: ```json { "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } } ``` Harness の `breezing` スキルは Agent Teams 機能を前提としているため、 セットアップ時にこの環境変数が設定されていることを確認する検証ステップを追加。 ### Desktop Scheduled Tasks Desktop アプリの Scheduled Tasks は `~/.claude/scheduled-tasks//SKILL.md` に保存される。 YAML frontmatter で `name` と `description` を定義し、本文にプロンプトを記述する。 スケジュール設定（頻度・時刻・フォルダ）は Desktop アプリの UI から管理。 `/harness-work` や `/harness-review` を定期実行する用途に活用可能。 ### `/agents` コマンド エージェントの対話的管理インターフェース。以下の操作が可能: - 利用可能な全エージェントの一覧表示（built-in, user, project, plugin） - ガイド付きまたは Claude 生成によるエージェント作成 - 既存エージェントの設定・ツールアクセス編集 - カスタムエージェントの削除 CLI からの非対話的な一覧表示: `claude agents` ### `--agents` CLI フラグ セッション起動時に JSON でエージェント定義を渡す。ディスクに保存されない一時的な構成: ```bash claude --agents '{ "quick-reviewer": { "description": "Quick code review", "prompt": "Review for critical issues only", "tools": ["Read", "Grep", "Glob"], "model": "haiku" } }' ``` CI/CD パイプラインでの一時的なエージェント注入に有用。 ### `ExitWorktree` ツール (v2.1.72) CC 2.1.72 で `ExitWorktree` ツールが追加された。`EnterWorktree` で作成された worktree セッションからプログラム的に離脱できる。 従来は worktree セッション終了時のプロンプトで手動選択するしかなかったが、エージェントが実装完了後に自動で worktree を離脱できるようになった。 Harness での活用: - `breezing` の Worker が `isolation: worktree` で作業完了後、`ExitWorktree` で明示的に worktree を閉じる - worktree クリーンアップの確実性が向上（変更がない場合は自動削除される既存動作と組み合わせ可能） ### Effort levels 簡素化 (v2.1.72) CC 2.1.72 で effort レベルが `low/medium/high` の3段階に簡素化された。`max` レベルが廃止され、表示シンボルが `○ ◐ ●` に統一された。`/effort auto` でデフォルト（medium）にリセット可能。 Harness への影響: - `ultrathink` キーワードによる high effort 注入は引き続き有効（変更なし） - harness-work のスコアリングロジックに変更は不要（ultrathink → high effort の対応が維持） - ドキュメント上の `max` への言及を `high` に統一 ### Agent tool `model` パラメータ復活 (v2.1.72) CC 2.1.72 で Agent tool の `model` パラメータが復活した。per-invocation でモデルを指定してサブエージェントを起動できる。 エージェント定義の `model` フィールドとは別に、spawn 時に一時的なモデル指定が可能。 Harness での活用余地: - 軽量タスク（ドキュメント更新、フォーマット修正等）には `model: "haiku"` で spawn してコスト削減 - セキュリティレビューやアーキテクチャ変更には `model: "opus"` で spawn して品質最大化 - 現状は Worker/Reviewer とも `model: sonnet` で固定。Lead がタスク特性に応じて動的にモデルを切り替える実装は Phase 2 以降で検討 ### `/plan` description 引数 (v2.1.72) CC 2.1.72 で `/plan` コマンドがオプションの description 引数を受け付けるようになった。 `/plan fix the auth bug` のように、説明付きで即座にプランモードに入れる。 Harness での活用: - `harness-plan` スキルの `create` サブコマンドと補完的に使用可能 - ユーザーが簡易にプランモードに入りたい場合のショートカットとして案内 ### 並列ツール呼び出し修正 (v2.1.72) CC 2.1.72 で並列ツール呼び出し時の重要なバグが修正された。 以前は Read, WebFetch, Glob のいずれかが失敗すると、並列実行中の sibling 呼び出しもキャンセルされていた。 修正後は Bash エラーのみがカスケードし、他のツールの失敗は独立して処理される。 Harness への影響: - `breezing` や `harness-work` でファイル読み込みと Web 検索を並列実行する際の安定性が向上 - 存在しないファイルの Read が他の正常な Read をキャンセルする問題が解消 - Worker エージェントの探索フェーズでの信頼性改善 ### Worktree isolation 修正 (v2.1.72) CC 2.1.72 で worktree isolation に関する2つのバグが修正された: 1. **Task resume の cwd 復元**: `resume` パラメータで再開したタスクが worktree の作業ディレクトリを正しく復元するようになった 2. **Background 通知の worktreePath**: バックグラウンドタスクの完了通知に `worktreePath` フィールドが含まれるようになった Harness への影響: - `breezing` の Worker が `isolation: worktree` で作業し、Lead が結果を回収する際の信頼性が向上 - `run_in_background: true` で spawn した Worker の完了通知から worktree パスを取得可能に ### `/clear` バックグラウンドエージェント保持 (v2.1.72) CC 2.1.72 で `/clear` の動作が変更された。フォアグラウンドのタスクのみ停止し、バックグラウンドで実行中のエージェントや Bash タスクは影響を受けなくなった。 Harness への影響: - `breezing` のチーム実行中にユーザーが `/clear` してもバックグラウンド Worker が存続 - Lead が `/clear` でコンテキストを整理しても、実行中のタスクが中断されないため安全性向上 ### Hooks 修正群 (v2.1.72) CC 2.1.72 で複数のフック関連バグが修正された: 1. **transcript_path**: `--resume` / `--fork` セッションでの `transcript_path` が正しく設定されるようになった 2. **PostToolUse ブロック理由の二重表示**: PostToolUse フックがブロックした際の理由メッセージが2回表示される問題が修正 3. **async hooks の stdin**: 非同期フックが stdin を正しく受信するようになった 4. **skill hooks 二重発火**: スキルフックが1イベントにつき2回発火する問題が修正 Harness への影響: - `pre-tool.sh` / `post-tool.sh` ガードレールフックの発火が正確に1回になり、ログの信頼性が向上 - `session-memory` の transcript 参照が `--resume` セッションでも正常動作 ### HTML コメント非表示 (v2.1.72) CC 2.1.72 で CLAUDE.md ファイル内の HTML コメント（``）が自動注入時に非表示になった。 Read ツールで直接ファイルを読んだ場合は引き続き可視。 Harness への影響: - **実害なし**: 重要な指示や設定は HTML コメント内に記述しない運用を徹底 ### Bash auto-approval 追加 (v2.1.72) CC 2.1.72 で以下のコマンドが Bash auto-approval 許可リストに追加された: `lsof`, `pgrep`, `tput`, `ss`, `fd`, `fdfind` Harness への影響: - Worker がプロセス確認（`pgrep`）やファイル検索（`fd`）を権限プロンプトなしで実行可能に - guardrails の `pre-tool.sh` は引き続きこれらのコマンドを通過させる（ブロック対象外） ### プロンプトキャッシュ修正 (v2.1.72) CC 2.1.72 で SDK の `query()` 呼び出し時のプロンプトキャッシュ無効化バグが修正された。 入力トークンコストが最大 12 倍削減される。 Harness への影響: - `breezing` や `harness-work` で多数のサブエージェント spawn を行う際のコスト大幅削減 - 特に同一セッション内での反復的な API 呼び出しパターンで効果大 ### Output Styles (v2.1.72+) CC の Output Styles 機能により、システムプロンプト自体をカスタマイズできる。 CLAUDE.md（ユーザーメッセージとして追加）や Skills（特定タスク用）とは異なるレイヤー。 Harness では `.claude/output-styles/harness-ops.md` を提供: - `keep-coding-instructions: true` — コーディング指示を維持しつつ運用フローを最適化 - 構造化された進捗報告フォーマット（実施/現在地/次アクション） - Quality Gate の表形式出力 - Review 判定の構造化フォーマット - エスカレーション（3回ルール）の標準出力形式 ```bash # 有効化 /output-style harness-ops ``` ### `permissionMode` in agent frontmatter (v2.1.72+) 公式ドキュメントで `permissionMode` がエージェント frontmatter の正式フィールドとして文書化された。 Harness への反映: - Worker/Reviewer/Scaffolder の3エージェント全てに `permissionMode: bypassPermissions` を追加 - spawn 時の `mode` 指定に依存しない宣言的権限管理を実現 - Auto Mode は rollout 候補として整理し、現行 shipped default は `bypassPermissions` のまま維持する ```yaml # agents/worker.md frontmatter permissionMode: bypassPermissions # 追加 ``` ### Agent Teams 公式ベストプラクティス (v2.1.72+) Claude Code 公式に `agent-teams.md` が独立ドキュメントとして整備された。 Harness の `docs/team-composition.md` に以下を反映: 1. **タスク粒度ガイドライン**: 5-6 tasks/teammate の推奨値 2. **`teammateMode` 設定**: `"auto"` / `"in-process"` / `"tmux"` の公式サポート 3. **Plan Approval パターン**: Worker に plan mode を要求する公式パターン 4. **Quality Gate Hooks**: `TeammateIdle`/`TaskCompleted` のexit 2 フィードバックパターン 5. **チームサイズ**: 3-5 teammates の推奨値（Harness の Worker 1-3 + Reviewer 1 と整合） ### Sandboxing (`/sandbox`) Claude Code にネイティブ統合された OS レベルのサンドボックス機能。macOS は Seatbelt、Linux は bubblewrap を使用し、Bash コマンドのファイルシステム/ネットワークアクセスを制限する。 **2つのモード**: - **Auto-allow mode**: サンドボックス内のコマンドは自動承認。制約外のアクセスは通常の権限フローへフォールバック - **Regular permissions mode**: サンドボックス内でも全コマンドに承認が必要 **Harness での活用戦略**: - `bypassPermissions` の **補完レイヤー** として位置づける（置換ではない） - Worker エージェントの Bash コマンドに OS レベルの安全境界を追加 - `sandbox.filesystem.allowWrite` で Worker が書き込める範囲を明示制限 - `sandbox.network` で外部アクセスを信頼済みドメインに制限（エクスフィルトレーション防止） **段階導入計画**: | フェーズ | Worker 権限 | Sandbox | |---------|-----------|---------| | 現行 | `bypassPermissions` + hooks ガード | 未適用 | | 検証フェーズ | `bypassPermissions` + hooks + sandbox auto-allow | Worker の Bash に適用 | | 安定後 | sandbox auto-allow のみ（`bypassPermissions` 廃止検討） | 全 Bash に適用 | ```json // settings.json (検証フェーズ用) { "sandbox": { "enabled": true, "filesystem": { "allowWrite": ["~/.claude", "//tmp"] } } } ``` > `@anthropic-ai/sandbox-runtime` が OSS として公開されており、MCP サーバーのサンドボックス化にも利用可能。 ### `opusplan` モデルエイリアス Plan mode では Opus、実行モードでは Sonnet に自動切替するハイブリッドエイリアス。 **Harness での活用**: - Breezing の Lead セッションに最適: Plan フェーズ（タスク分解・アーキテクチャ決定）は Opus の推論力を活用し、Worker spawn 後の実行コーディネーションは Sonnet でコスト効率化 - `claude --model opusplan` または `/model opusplan` で有効化 **環境変数による制御**: ```bash # opusplan の内部マッピングをカスタマイズ ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6 # Plan 時 ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 # 実行時 ``` ### `CLAUDE_CODE_SUBAGENT_MODEL` 環境変数 サブエージェント（Worker/Reviewer）のモデルを一括で指定する環境変数。 **Harness での活用**: - 現状: Worker/Reviewer は `model: sonnet` をエージェント定義で固定 - 本環境変数を使うと、エージェント定義を変更せずにモデルを切り替え可能 - CI 環境でのコスト制御（`CLAUDE_CODE_SUBAGENT_MODEL=haiku` でテスト実行）に有用 ```bash # 全サブエージェントを haiku で実行（CI コスト削減） export CLAUDE_CODE_SUBAGENT_MODEL=claude-haiku-4-5-20251001 ``` ### `availableModels` 設定 ユーザーが選択可能なモデルを制限する設定。managed/policy settings で設定すると、`/model`、`--model`、`ANTHROPIC_MODEL` のいずれでも制限が適用される。 **Harness での活用**: - エンタープライズ環境でのモデルガバナンス: Worker/Reviewer が意図しないモデルを使用することを防止 - `availableModels` + `model` の組み合わせで全ユーザーのモデル体験を統制可能 ```json // managed settings { "model": "sonnet", "availableModels": ["sonnet", "haiku", "opusplan"] } ``` ### Checkpointing (`/rewind`) セッション中のファイル編集を自動追跡し、任意のポイントに巻き戻し可能にする機能。 各ユーザープロンプトでチェックポイントが自動作成される。 **操作方法**: - `Esc + Esc` または `/rewind` でリワインドメニューを開く - 選択肢: コード復元 / 会話復元 / 両方復元 / ここから要約 **Harness での活用**: - `harness-work` のセルフレビューフェーズで問題発見時、実装前の状態に巻き戻し - 「ここから要約」で冗長なデバッグセッションのコンテキスト窓を回収 - `/compact` との違い: チェックポイントは選択的に圧縮範囲を指定できる **制限事項**: - Bash コマンドによるファイル変更は追跡されない（`rm`, `mv`, `cp` 等） - 外部の手動変更は追跡されない - Git の代替ではなく、セッションレベルの「ローカル Undo」 ### Code Review (managed service) Anthropic インフラ上で動作するマルチエージェント PR レビューサービス。Teams/Enterprise 向け Research Preview。 **動作概要**: 1. PR 作成/更新時に自動起動 2. 複数の専門エージェントが並列で差分とコードベースを分析 3. 検証ステップで偽陽性をフィルタ 4. 重複排除・重要度ランク付け後にインラインコメントとして投稿 **重要度レベル**: | マーカー | レベル | 意味 | |---------|--------|------| | 🔴 | Normal | マージ前に修正すべきバグ | | 🟡 | Nit | 軽微な問題（ブロッキングではない） | | 🟣 | Pre-existing | この PR 以前から存在するバグ | **`REVIEW.md`**: リポジトリルートに配置するレビュー専用ガイダンスファイル。`CLAUDE.md` とは別に、レビュー時のみ適用されるルールを定義。 **Harness での活用**: - `harness-review` スキルの Code Review 対応として `REVIEW.md` テンプレート生成を検討 - Harness の Worker セルフレビューと managed Code Review は補完的（ローカル + リモートの二重検査） - 平均コスト $15-25/レビュー。`on-push` トリガーは push 回数分のコストが発生するため注意 ### Status Line (`/statusline`) Claude Code のターミナル下部に表示されるカスタマイズ可能な状態バー。シェルスクリプトに JSON セッションデータを渡し、出力テキストを表示。 **利用可能データ**: - `model.id`, `model.display_name` — 現在のモデル - `context_window.used_percentage` — コンテキスト使用率 - `cost.total_cost_usd` — セッションコスト - `cost.total_duration_ms` — 経過時間 - `worktree.*` — ワークツリー情報 - `agent.name` — エージェント名 - `output_style.name` — 出力スタイル名 **Harness での活用**: - `scripts/statusline-harness.sh` で Harness 専用ステータスライン提供 - モデル名・コンテキスト使用率・セッションコスト・git ブランチ・Harness バージョンを常時表示 - ANSI カラーでコンテキスト使用率のしきい値表示（70% 黄色、90% 赤） ### 1M Context Window (`sonnet[1m]`) Opus 4.6 と Sonnet 4.6 で利用可能な 100 万トークンコンテキスト窓。200K トークンを超えると long-context pricing が適用される。 **Harness での活用**: - `harness-review` の大規模コードベース分析に有用 - `breezing` で多数のファイルを同時に扱うセッション - `/model sonnet[1m]` で有効化。`CLAUDE_CODE_DISABLE_1M_CONTEXT=1` で無効化可能 ### Per-model Prompt Caching Control モデル別にプロンプトキャッシュを制御する環境変数群。 | 環境変数 | 用途 | |---------|------| | `DISABLE_PROMPT_CACHING` | 全モデルのキャッシュ無効化 | | `DISABLE_PROMPT_CACHING_HAIKU` | Haiku のみ無効化 | | `DISABLE_PROMPT_CACHING_SONNET` | Sonnet のみ無効化 | | `DISABLE_PROMPT_CACHING_OPUS` | Opus のみ無効化 | **Harness での活用**: - デバッグ時に特定モデルのキャッシュを無効化して挙動を確認 - クラウドプロバイダ（Bedrock/Vertex）でキャッシュ実装が異なる場合の選択的制御 ### `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` Opus 4.6 / Sonnet 4.6 の Adaptive Reasoning を無効化し、`MAX_THINKING_TOKENS` で制御される固定 thinking budget に復帰する環境変数。 **Harness での活用**: - トークンコストの予測可能性が必要な CI 環境で有用 - `harness-work` の effort スコアリングと排他的ではない（両方使用可能だが、通常は adaptive thinking を有効にしたまま ultrathink で制御する方が効果的） ### Chrome Integration (`--chrome`) Claude Code の Chrome 拡張機能と連携し、ブラウザ自動化をターミナルから実行する beta 機能。 `--chrome` フラグでセッション起動、または `/chrome` でセッション内から有効化。 **主要機能**: - ライブデバッグ: コンソールエラーを読み取り、原因コードを即座に修正 - UI テスト: フォーム検証、ビジュアルリグレッション確認、ユーザーフロー検証 - データ抽出: Web ページから構造化データを抽出しローカル保存 - GIF 記録: ブラウザ操作シーケンスを GIF として記録 **Harness での活用**: - `harness-work` での UI コンポーネント実装後の自動検証 - `harness-review` での Web アプリケーションのビジュアルレビュー - `/chrome` 有効化で Worker がブラウザテストを実行可能に **制約**: Google Chrome / Microsoft Edge のみ。Brave, Arc 等は未対応。WSL 非対応。 ### LSP サーバー統合 (`.lsp.json`) Language Server Protocol サーバーを Plugin 経由で統合し、リアルタイムコード診断を提供。 **利用可能な LSP プラグイン**: | プラグイン | Language Server | インストール | |-----------|----------------|------------| | `pyright-lsp` | Pyright (Python) | `pip install pyright` | | `typescript-lsp` | TypeScript Language Server | `npm install -g typescript-language-server typescript` | | `rust-lsp` | rust-analyzer | rust-analyzer 公式ガイド参照 | **提供される機能**: - 即座の診断: 編集後すぐにエラー/警告を表示 - コードナビゲーション: 定義ジャンプ、参照検索、ホバー情報 - 型情報: シンボルの型とドキュメント表示 **設定例** (`.lsp.json`): ```json { "typescript": { "command": "typescript-language-server", "args": ["--stdio"], "extensionToLanguage": { ".ts": "typescript", ".tsx": "typescriptreact" } } } ``` ### `SubagentStart`/`SubagentStop` matcher settings.json レベルでサブエージェントのライフサイクルを agent type 別に監視するフック。 公式ドキュメントで matcher にエージェント名を指定するパターンが文書化された。 **Harness の実装**: - `SubagentStart`: Worker/Reviewer/Scaffolder/Video Generator の起動を個別にトラッキング - `SubagentStop`: 各エージェントの完了を個別に記録 - 既存の `subagent-tracker` Node.js スクリプトに matcher を追加 ```json "SubagentStart": [ { "matcher": "worker", "hooks": [{ "type": "command", "command": "...subagent-tracker start" }] }, { "matcher": "reviewer", "hooks": [{ "type": "command", "command": "...subagent-tracker start" }] } ] ``` ### Agent Teams: Task Dependencies Agent Teams のタスクに依存関係を設定可能。依存タスク完了で blocked タスクが自動 unblock。 **動作**: - タスクは `pending`, `in_progress`, `completed` の3状態 - 未解決の依存がある pending タスクは claimed 不可 - 依存完了時に自動 unblock（手動介入不要） - ファイルロックで複数 teammate の同時 claim を防止 **Harness での活用**: - Breezing の Lead がタスク分解時に依存関係を明示指定 - 例: 「API エンドポイント実装」→「テスト作成」→「ドキュメント更新」の順序保証 ### `--teammate-mode` CLI フラグ セッション単位で Agent Teams の表示モードを指定するフラグ。 ```bash claude --teammate-mode in-process # 全 teammate を同一ターミナル claude --teammate-mode tmux # 各 teammate に個別ペイン ``` settings.json の `teammateMode` 設定を上書き。VS Code 統合ターミナルでは `in-process` が推奨。 ### `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` `=1` で全バックグラウンドタスク機能を無効化する環境変数。 **Harness での活用**: - セキュリティポリシーでバックグラウンド実行を制限する環境向け - Breezing のバックグラウンド Worker spawn も無効化されるため、使用時は要注意 ### `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` サブエージェントの auto-compaction しきい値を調整する環境変数（デフォルト 95%）。 **Harness での活用**: - `50` に設定で早期圧縮を有効化。長時間 Worker の安定性向上 - Breezing の Worker が大量のファイルを読み込む場合にコンテキスト溢れを防止 ### `cleanupPeriodDays` 設定 サブエージェント transcript の自動クリーンアップ期間を制御する設定（デフォルト 30 日）。 transcript は `~/.claude/projects/{project}/{sessionId}/subagents/agent-{agentId}.jsonl` に保存。 ### `/btw` サイドクエスチョン 現在のコンテキストを保持したまま短い質問を行うコマンド。 回答後にメインの会話履歴に残らないため、コンテキスト窓を消費しない。 **サブエージェントとの使い分け**: - `/btw`: 現在のコンテキストで即答可能な質問（ツールアクセスなし） - サブエージェント: 独立した調査・実装タスク（ツールアクセスあり） ### Plugin CLI コマンド群 プラグインの非対話的管理コマンド。スクリプトによる自動化に対応。 ```bash claude plugin install [--scope user|project|local] claude plugin uninstall [--scope user|project|local] claude plugin enable [--scope user|project|local] claude plugin disable [--scope user|project|local] claude plugin update [--scope user|project|local|managed] ``` ### Remote Control 強化 `/remote-control` (`/rc`) でセッション内から Remote Control を有効化可能に。 **新機能**: - `--name "My Project"`: セッション名の指定 - `--sandbox` / `--no-sandbox`: サンドボックスの有効化/無効化 - `--verbose`: 詳細ログ表示 - `/mobile`: QR コード表示で iOS/Android アプリに素早く接続 - 自動再接続: ネットワーク断からの自動復帰（10 分以内） - `/config` → "Enable Remote Control for all sessions" で常時有効化 ### `skills` フィールド in agent frontmatter サブエージェントの frontmatter に `skills` フィールドを追加し、起動時にスキルの全コンテンツをプリロード。 親会話のスキルは継承されないため、明示的にリストする必要がある。 **Harness の実装状況**: - Worker: `skills: [harness-work, harness-review]` — 実装とセルフレビューのスキルをプリロード - Reviewer: `skills: [harness-review]` — レビュースキルをプリロード - Scaffolder: `skills: [harness-setup, harness-plan]` — セットアップと計画スキルをプリロード > `skills` in skill (`context: fork`) の逆パターン。skill が agent を制御するのではなく、agent が skill を読み込む。 ### `modelOverrides` 設定 (v2.1.73) CC 2.1.73 で追加された設定。モデルピッカー（`/model` メニュー）のエントリを、カスタムプロバイダのモデル ID にマッピングできる。 Bedrock ARN や Vertex AI のモデル ID など、プロバイダ固有の識別子を指定可能。 **Harness での活用**: - エンタープライズ環境で Bedrock/Vertex 経由の Anthropic モデルを使用する場合、`modelOverrides` でモデルピッカーの表示名と実際のプロバイダモデル ID を対応付け - Worker/Reviewer の `model: sonnet` がプロバイダ固有の ARN に自動解決される - `availableModels` と組み合わせて、チーム全体のモデル体験を統制可能 ```json // settings.json { "modelOverrides": { "sonnet": "arn:aws:bedrock:us-east-1::foundation-model/anthropic.claude-sonnet-5", "opus": "arn:aws:bedrock:us-east-1::foundation-model/anthropic.claude-opus-4-6-20250610-v1:0" } } ``` ### `/output-style` 非推奨化 (v2.1.73) CC 2.1.73 で `/output-style` コマンドが非推奨となり、出力スタイルの選択は `/config` メニューに統合された。 既存の `/output-style harness-ops` 等は引き続き動作するが、公式には `/config` 経由の選択が推奨される。 **Harness への影響**: - ドキュメント上の `/output-style harness-ops` への言及を `/config` 経由に更新推奨 - `.claude/output-styles/harness-ops.md` 自体は引き続き有効（設定ファイルの配置場所に変更なし） - スキル内で `/output-style` を実行している箇所があれば `/config` に切り替え検討 ### Bedrock/Vertex Opus 4.6 デフォルト化 (v2.1.73) CC 2.1.73 でクラウドプロバイダ（Amazon Bedrock / Google Vertex AI）上のデフォルト Opus モデルが 4.1 から 4.6 に更新された。 first-party API では v2.1.68 時点で Opus 4.6 がデフォルトだったが、クラウドプロバイダ経由でも統一された。 **Harness への影響**: - Bedrock/Vertex 環境でも Lead（Opus 使用時）が medium effort デフォルトで動作 - `opusplan` エイリアスが Bedrock/Vertex 環境でも Opus 4.6 を参照 - `ANTHROPIC_DEFAULT_OPUS_MODEL` 環境変数による上書きは引き続き有効 ### `autoMemoryDirectory` 設定 (v2.1.74) CC 2.1.74 で追加された設定。自動メモリ（auto-memory）の保存ディレクトリをカスタマイズ可能。 デフォルトの `~/.claude/` 配下からプロジェクト固有のパスに変更できる。 **Harness での活用**: - 複数プロジェクトで Harness を使用する場合、プロジェクトごとに自動メモリを分離 - CI 環境で一時ディレクトリにメモリを保存し、セッション終了時にクリーンアップ - Agent Memory（`memory: project`）とは異なるレイヤー（自動メモリはユーザーレベルの学習） ```json // settings.json (プロジェクトレベル) { "autoMemoryDirectory": ".claude/auto-memory" } ``` ### `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` (v2.1.74) CC 2.1.74 で追加された環境変数。`SessionEnd` フックのタイムアウトをミリ秒単位で指定可能。 従来は固定 1.5 秒で kill されていたため、重いクリーンアップ処理が完了前に中断される問題があった。 **Harness での活用**: - `SessionEnd` フックで `harness-mem` のセッション記録や JSONL ローテーションを実行する場合、十分なタイムアウトを確保 - 推奨値: `5000`（5秒）。複雑なクリーンアップが必要な場合は `10000`（10秒）まで ```bash export CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS=5000 ``` ### Full model ID 修正 (v2.1.74) CC 2.1.74 で `claude-opus-4-6`、`claude-sonnet-4-6` 等の完全なモデル ID（ハイフン区切り形式）がエージェント frontmatter および JSON config で正しく認識されるようになった。 従来はエイリアス（`opus`, `sonnet`）のみが安定して動作していた。 **Harness への影響**: - エージェント定義の `model` フィールドに完全モデル ID を指定可能に（例: `model: claude-sonnet-4-6`） - `--agents` CLI フラグの JSON 内でも完全モデル ID が使用可能 - 現状 Harness はエイリアス（`sonnet`, `opus`）を使用しており即時影響なし。Bedrock/Vertex 環境でフル ID 指定が必要な場合に有用 ```yaml # agents/worker.md frontmatter（完全モデル ID 使用例） model: claude-sonnet-4-6 ``` ### Streaming API メモリリーク修正 (v2.1.74) CC 2.1.74 でストリーミング API レスポンスバッファの無制限 RSS（Resident Set Size）増大が修正された。 長時間のストリーミングセッションで Node.js プロセスのメモリ使用量が際限なく増加する問題が解消。 **Harness への影響**: - `breezing` の長時間チームセッションでの安定性が向上 - `harness-work` で大量のファイル読み書きを含む長時間 Worker セッションのメモリ消費が安定化 - v2.1.50〜v2.1.63 のメモリリーク修正シリーズ（LSP 診断、ツール出力、ファイル履歴等）に続く追加修正 - Harness 側の JSONL ローテーション対策（独自のメモリ管理）と組み合わせて、二重の安定性確保 ### `--remote` / Cloud Sessions CC の `--remote` フラグでターミナルからクラウドセッションを起動できる。タスクは Anthropic 管理の隔離 VM 上で実行され、完了後に PR 作成が可能。 **Harness での活用**: - `breezing` の大規模タスクをクラウドに委任し、ローカルリソースを節約 - `--remote` で複数タスクを並列起動（各タスクが独立したクラウドセッション） - `/teleport` でクラウドの成果物をローカルに取り込み、後続の `/harness-review` に接続 ```bash # クラウドでタスク実行 claude --remote "Fix the authentication bug in src/auth/login.ts" # 完了後にローカルに取り込み /teleport ``` ### `/teleport` (`/tp`) クラウドセッションをローカルターミナルに取り込むコマンド。`/teleport` または `/tp` で対話的にセッションを選択、`claude --teleport ` で直接指定も可能。 **前提条件**: - ローカルの git working directory がクリーンであること - 同一リポジトリから実行すること - 同一 Claude.ai アカウントで認証されていること ### `CLAUDE_CODE_REMOTE` 環境変数 クラウドセッション内では `CLAUDE_CODE_REMOTE=true` が設定される。Harness の `session-env-setup.sh` はこの値を `HARNESS_IS_REMOTE` として永続化し、他のフックハンドラがローカル専用処理をスキップする判定に使用可能。 ```bash # フックスクリプト内でのクラウド検出例 if [ "$HARNESS_IS_REMOTE" = "true" ]; then # クラウド環境ではローカル専用処理をスキップ exit 0 fi ``` ### `CLAUDE_ENV_FILE` SessionStart 永続化 CC の `SessionStart` フックは `CLAUDE_ENV_FILE` 環境変数が指すファイルに `KEY=VALUE` を書き込むことで、後続の Bash コマンドにも環境変数を永続化できる。 Harness の `session-env-setup.sh` はこの機構を活用し、`HARNESS_VERSION`、`HARNESS_AGENT_TYPE`、`HARNESS_IS_REMOTE` 等をセッション全体で利用可能にしている。 ### Slack Integration (`@Claude`) Slack チャネルで `@Claude` にコーディングタスクをメンションすると、自動的にクラウドセッションが作成される。GitHub リポジトリとの連携が前提。 **Harness との関係**: - Harness の HTTP hooks（`type: "http"`）を Slack Webhook URL に設定することで、タスク完了時の Slack 通知が可能 - クラウドセッション内でも `.claude/settings.json` のフックが動作するため、Harness のガードレールは Slack 経由のタスクにも適用される ### Server-managed settings (public beta) Claude.ai の管理画面からチーム全体の Claude Code 設定をサーバー配信する機能。Teams/Enterprise 向け。 **Harness での活用**: - チーム全体の `permissions.deny` ルールを一括管理 - Harness のフック設定をサーバー経由で配信（ただしフック設定はセキュリティ確認ダイアログが表示される） - `availableModels` + `model` の組み合わせでチームのモデル体験を統制 ### Microsoft Foundry Azure ベースの新クラウドプロバイダ。Bedrock / Vertex に続く第3のサードパーティプロバイダとして追加。 `modelOverrides` 設定で Foundry のモデル ID にマッピング可能。 ### `PreCompact` hook コンテキスト圧縮が実行される直前に発火するフックイベント。Harness では以下の3層で実装済み: 1. **`pre-compact-save.js`**: セッション状態（進捗、メトリクス）を永続化 2. **`bin/harness pre-compact` (Go)**: dirty Plans.md を pathspec 限定で auto-checkpoint コミットし `{"continue":true,...}` で compact 続行。commit 失敗または `precompactAutoCommit: false` のときのみ block 3. **agent hook**: `cc:WIP` タスクが残っていないかチェックし、警告メッセージを注入 ```json "PreCompact": [ { "hooks": [ { "type": "command", "command": "...pre-compact-save.js" }, { "type": "agent", "prompt": "Check Plans.md for WIP tasks...", "model": "haiku" } ]} ] ``` ### `Notification` hook event Claude Code が通知を発行する際に発火するフックイベント。プラグインリファレンスに記載。 外部監視ツールやダッシュボードへの通知転送に活用可能。 ### `--plugin-dir` 仕様変更 (v2.1.76, breaking) **変更内容**: `--plugin-dir` が1つのパスのみを受け付けるように変更。複数ディレクトリは繰り返し指定。 ```bash # 旧（非対応に） claude --plugin-dir path1,path2 # 新 claude --plugin-dir path1 --plugin-dir path2 ``` **Harness への影響**: Harness プラグインのみを使用する一般的な構成では影響なし。 複数プラグインを同時使用する場合のみ構文変更が必要。 --- ## Claude Code 2.1.76 新機能 ### MCP Elicitation サポート **動作概要**: MCP サーバーがタスク実行中にユーザーへ構造化された入力を要求できるプロトコル。フォームフィールドまたはブラウザ URL を通じてインタラクティブなダイアログを表示する。 **Harness での活用**: - Breezing のバックグラウンド Worker/Reviewer は UI 対話不能なため、`Elicitation` フックで自動スキップを実装 - 通常セッションではそのまま通過（ユーザーが対話で応答） - Go hookhandler が旧互換ログ `.claude/state/elicitation-events.jsonl` に加えて、`elicitation-event.v1` を `.claude/state/elicitation/events.jsonl` に append-only 記録 - harness-mem が healthy な時だけ `/v1/events/record` へ `event_type: "elicitation_event"` として best-effort 転送し、不達時は local ledger に silent fallback **制約事項**: - バックグラウンドエージェントでは elicitation に応答不能（フックによる自動処理が必須） - MCP サーバー側が elicitation をサポートしている必要がある - Claude-harness は harness-mem DB を直接読まない ### `Elicitation`/`ElicitationResult` フック **動作概要**: MCP Elicitation の前後でインターセプト可能な2つの新フックイベント。`Elicitation` はレスポンスが MCP サーバーに返される前に、`ElicitationResult` は返された後に発火する。 **Harness での活用**: - `Elicitation`: Breezing セッション中の自動スキップ判定 + ログ記録 + `capability_probe` event 記録 - `ElicitationResult`: 結果のログ記録（`.claude/state/elicitation-events.jsonl`）+ `eval_result` event 記録 - hooks.json に両イベントのハンドラを登録 **制約事項**: - `Elicitation` フックでブロック（deny）するとMCPサーバーへの入力が届かない - 推奨 timeout: Elicitation 10s / ElicitationResult 5s ### `PostCompact` フック **動作概要**: コンテキストコンパクション完了後に発火する新フックイベント。`PreCompact` フック（既存）と対になる。 **Harness での活用**: - コンパクション後のコンテキスト再注入（WIP タスク状態の復元） - `.claude/state/compaction-events.jsonl` にイベント記録 - 長時間セッションでの状態継続性向上 - PreCompact（状態保存）→ PostCompact（状態復元）の対称構造 **制約事項**: - 推奨 timeout: 15s - コンパクション失敗時（circuit breaker 発動時）は PostCompact が発火しない可能性あり ### `-n`/`--name` CLI フラグ **動作概要**: セッション起動時に表示名を設定する CLI フラグ。`claude -n "auth-refactor"` のように使用し、セッション一覧での識別に活用する。 **Harness での活用**: - Breezing セッションに `breezing-{timestamp}` 形式の名前を自動設定 - セッション一覧でのフィルタリング・追跡に活用 - ログ分析時のセッション特定が容易に **コード例**: ```bash claude -n "breezing-$(date +%Y%m%d-%H%M%S)" ``` ### `worktree.sparsePaths` 設定 **動作概要**: 大規模モノレポで `claude --worktree` 使用時に、git sparse-checkout を通じて必要なディレクトリのみをチェックアウトする設定。ワークツリー作成のパフォーマンスを大幅に改善する。 **Harness での活用**: - Breezing の並列 Worker 起動時間を短縮（大規模リポジトリ） - `.claude/settings.json` で設定: ```json { "worktree": { "sparsePaths": ["src/", "tests/", "package.json"] } } ``` **制約事項**: - sparse-checkout されていないパスのファイルは Worker からアクセス不可 - 依存関係のあるディレクトリはすべて sparsePaths に含める必要がある ### `/effort` スラッシュコマンド **動作概要**: セッション中に effort レベル（low/medium/high）を切り替えるスラッシュコマンド。`/effort auto` でデフォルトにリセット。 **Harness での活用**: - harness-work の多要素スコアリングと連携し、タスク複雑度に応じた effort 制御が可能 - 複雑なタスクでは `/effort high`（ultrathink 有効化）を手動で設定可能 - 簡易タスクでは `/effort low` でトークン消費を抑制 ### `--worktree` 起動高速化 **動作概要**: git refs の直接読み取りと、リモートブランチが利用可能な場合の冗長な `git fetch` スキップにより、`--worktree` の起動時間を短縮。 **Harness での活用**: - Breezing の Worker 起動オーバーヘッドが自動的に削減 - 特に多数の Worker を同時起動する場合に恩恵が大きい ### バックグラウンドエージェント部分結果保持 **動作概要**: バックグラウンドエージェントが kill された場合にも、部分的な結果が会話コンテキストに保存される。 **Harness での活用**: - Breezing の Worker がタイムアウトや手動停止で中断された場合、作業の一部が Lead に伝達される - Worker の途中成果物を活用した再割り当てが可能に - 「やり直し」の無駄が削減 ### stale worktree 自動クリーンアップ **動作概要**: 中断された並列実行で残った stale ワークツリーが自動的にクリーンアップされる。 **Harness での活用**: - `worktree-remove.sh` による手動クリーンアップの補完 - Breezing セッションのクラッシュ後も自動回復 - ディスク容量の無駄な消費を防止 ### 自動コンパクション circuit breaker **動作概要**: 自動コンパクションが連続して失敗した場合、3回で停止するサーキットブレーカーが導入された。無限リトライによるトークン浪費を防止する。 **Harness での活用**: - Harness の「3回ルール」（CI失敗時の3回制限）と一致する設計思想 - 長時間 Breezing セッションでの予期せぬコスト増加を防止 - circuit breaker 発動時は PostToolUseFailure フックと連携してエスカレーション ### Deferred Tools スキーマ修正 **動作概要**: `ToolSearch` で読み込んだツールがコンパクション後に入力スキーマを失い、配列・数値パラメータが型エラーで拒否される問題を修正。 **Harness での活用**: - 長時間セッションでの ToolSearch 経由ツールの安定性が向上 - Breezing のコンパクション後もMCPツールが正常に動作 ### `/context` コマンド (v2.1.74) **動作概要**: コンテキスト窓の消費状況を分析し、コンテキストを圧迫しているツールやメモリを特定する。アクション可能な最適化提案（不要な MCP サーバーの切断、肥大化したメモリの整理等）を表示する。 **Harness での活用**: - 長時間 Breezing セッションでの「なぜコンパクションが頻繁に起きるのか」の原因特定 - 大量の hooks や MCP サーバーが接続された環境でのコンテキスト最適化 - セッション中に `/context` を実行するだけで即座に分析結果が得られる **制約事項**: - セッション中のみ利用可能（バッチモードでは非対応） - サブエージェント内では利用不可 ### `maxTurns` エージェント安全制限 **動作概要**: サブエージェントの最大ターン数を制限する frontmatter フィールド。設定ターン数に到達すると、エージェントは自動的に停止して結果を返す。CC 公式ドキュメントで推奨されている安全機構。 **Harness での活用**: - Worker: `maxTurns: 100` — 複雑な実装タスク向け。十分な余裕を持ちつつ暴走を防止 - Reviewer: `maxTurns: 50` — Read-only 分析に特化。50 ターンで完了しない場合は問題あり - Scaffolder: `maxTurns: 75` — 足場構築と状態更新の中間的な複雑度 **設計判断**: - 上限に達した場合、Lead が途中結果を回収して判断可能 - `bypassPermissions` と組み合わせることで、暴走時の安全弁として機能 ### `Notification` フック実装 **動作概要**: Claude Code が通知を発行する際に発火するフックイベント。`permission_prompt`（権限確認）、`idle_prompt`（アイドル通知）、`auth_success`（認証成功）等のイベントをインターセプトする。 **Harness での活用**: - `notification-handler.sh` で全通知イベントを `.claude/state/notification-events.jsonl` にログ記録 - Breezing のバックグラウンド Worker で発生した `permission_prompt` を追跡（事後分析用） - hooks-editing.md では v3.10.3 からドキュメント化済みだったが、hooks.json への実装が今回完了 **ログ形式**: ```json {"event":"notification","notification_type":"permission_prompt","session_id":"...","agent_type":"worker","timestamp":"2026-03-15T..."} ``` ### Output token limits 64k/128k (v2.1.77) CC 2.1.77 で Opus 4.6 と Sonnet 4.6 のデフォルト最大出力トークンが 64k に引き上げられ、上限が 128k トークンまで拡張された。 **Harness への影響**: - 長い実装コードや大規模リファクタリングの出力がトランケートされにくくなった - Worker エージェントが大量のファイル変更を一度に出力する場合の信頼性が向上 - 128k 出力はコスト増大につながるため、コスト管理にも留意が必要 ### `allowRead` sandbox 設定 (v2.1.77) `sandbox.filesystem.denyRead` で広範囲をブロックしつつ、`allowRead` で特定パスの読み取りを再許可できるようになった。 **Harness での活用**: - Reviewer エージェントのサンドボックスで `/etc/` を denyRead しつつ、特定の設定ファイルだけ allowRead する - セキュリティレビュー時に機密ディレクトリの制限付き読み取りアクセスを提供 ### PreToolUse `allow` が `deny` を尊重 (v2.1.77) CC 2.1.77 で PreToolUse フックが `"allow"` を返しても、settings.json の `deny` パーミッションルールが引き続き適用されるようになった。以前はフックの `allow` がグローバル `deny` を上書きしていた。 **Harness への影響**: - guardrails のセキュリティモデルが強化された - `deny: ["mcp__codex__*"]` を settings.json に設定すれば、PreToolUse フックの判断に関わらず確実にブロック - `.claude/rules/codex-cli-only.md` のフックベース MCP ブロックに加え、settings.json deny が推奨パターンに ### Agent `resume` → `SendMessage` (v2.1.77) CC 2.1.77 で Agent tool の `resume` パラメータが廃止された。停止中のエージェントを再開するには `SendMessage({to: agentId})` を使用する。`SendMessage` は停止中のエージェントを自動でバックグラウンド再開する。 **Harness での影響**: - `breezing` スキルの Lead が Worker/Reviewer と通信する際は `SendMessage` を使用 - `team-composition.md` の Lead Phase B で `SendMessage` が正式なコミュニケーション手段として記載 ### `/branch` (旧 `/fork`) (v2.1.77) CC 2.1.77 で `/fork` コマンドが `/branch` にリネームされた。`/fork` はエイリアスとして引き続き機能する。 ### `claude plugin validate` 強化 (v2.1.77) CC 2.1.77 で `claude plugin validate` がスキル・エージェント・コマンドの YAML frontmatter と hooks.json の構文を検証するようになった。 **Harness での活用**: - CI パイプラインに `claude plugin validate` を追加し、frontmatter エラーを早期検出 - `tests/validate-plugin.sh` の補完として活用可能 ### `StopFailure` hook event (v2.1.78) CC 2.1.78 で `StopFailure` イベントが追加された。API エラー（レート制限 429、認証失敗 401 等）でセッション停止が失敗した際に発火する。 **Harness での活用**: - `stop-failure.sh` ハンドラーでエラー情報を `.claude/state/stop-failures.jsonl` にログ記録 - Breezing の Worker がレート制限で停止失敗した場合の事後分析に使用 - 10 秒タイムアウトの軽量ハンドラーとして実装（復旧処理は不要） ### Hooks conditional `if` field (v2.1.85) CC 2.1.85 で、hooks 定義に `if` 条件を付けて「どんな入力のときだけ hook を走らせるか」を細かく絞れるようになった。Permission rule syntax を使うので、`Bash(git status*)` のようにツール名と入力パターンをまとめて指定できる。 **Harness での活用**: - `PermissionRequest` を 2 系統に分割し、`Edit|Write|MultiEdit` は常時評価、`Bash` は安全コマンド候補だけを `if` で事前フィルタする - `hooks/permission.sh` 自体の安全判定は残しつつ、そもそも不要な Bash permission hook の起動数を減らす - `MultiEdit` も matcher に含め、core guardrail では対応済みだった自動承認の取りこぼしを hooks 側でもなくした **ユーザー体験の改善**: - 今まで: Bash の権限確認は広く hook が走り、最終的にスルーされるケースでも起動コストがかかっていた - 今後: safe-read / test 系の Bash だけに hook が走るため、応答ノイズと無駄な評価を減らしつつ、自動承認の精度は維持できる ### `${CLAUDE_PLUGIN_DATA}` 変数 (v2.1.78) CC 2.1.78 で `${CLAUDE_PLUGIN_DATA}` ディレクトリ変数が追加された。プラグイン更新でも永続するステートストレージとして使用できる。 **Harness での活用余地**: - 現在は `${CLAUDE_PLUGIN_ROOT}/.claude/state/` を使用しているが、プラグイン更新で消える可能性 - 長期的にはメトリクス・通知ログ等の永続データを `${CLAUDE_PLUGIN_DATA}` に移行を検討 - 移行パターン: `STATE_DIR="${CLAUDE_PLUGIN_DATA:-${CLAUDE_PLUGIN_ROOT}/.claude/state}"` ### Agent frontmatter: `effort`/`maxTurns`/`disallowedTools` (v2.1.78) CC 2.1.78 でプラグインエージェント定義の frontmatter に `effort`, `maxTurns`, `disallowedTools` が公式サポートされた。 **Harness での現状**: - `maxTurns`: v3.10.4 で既に実装済み（Worker: 100, Reviewer: 50, Scaffolder: 75） - `disallowedTools`: Worker は `[Agent]`、Reviewer は `[Write, Edit, Bash, Agent]` で実装済み - `effort`: 未使用。Worker/Reviewer 定義に `effort` フィールドを追加して、デフォルト thinking レベルを宣言的に制御可能 ### `deny: ["mcp__*"]` 修正 (v2.1.78) CC 2.1.78 で settings.json の `deny` パーミッションルールが MCP サーバーツールに対して正しく機能するように修正された。 **Harness での活用**: - `.claude/rules/codex-cli-only.md` で推奨している Codex MCP ブロックを、フックベースから settings.json `deny` に移行可能 - `"permissions": { "deny": ["mcp__codex__*"] }` がクリーンなパターン ### `--console` auth フラグ (v2.1.79) CC 2.1.79 で `claude auth login --console` フラグが追加され、Anthropic Console API 課金での認証に対応。 ### SessionEnd hooks `/resume` 修正 (v2.1.79) CC 2.1.79 で対話的 `/resume` セッション切替時に `SessionEnd` フックが正常に発火するようになった。以前はセッション切替時に SessionEnd が発火しなかったため、cleanup 処理が実行されないケースがあった。 ### `PermissionDenied` hook event (v2.1.89) CC 2.1.89 で auto mode classifier がコマンドを拒否した際に `PermissionDenied` フックが発火するようになった。`{retry: true}` を返すとモデルにリトライ可能であることを伝えられる。拒否されたコマンドは `/permissions` → Recent タブにも表示される。 **Harness での活用**: - `permission-denied-handler.sh` を新規実装し、拒否イベントを `permission-denied.jsonl` に telemetry 記録 - Breezing Worker が拒否された場合、Lead に `systemMessage` で通知し代替アプローチの検討を促す - `agent_id` / `agent_type` フィールドを活用して、どのエージェントが何を拒否されたかを追跡 **ユーザー体験の改善**: - 今まで: auto mode の拒否は通知だけで記録に残らず、同じ拒否が繰り返されやすかった - 今後: 拒否パターンが蓄積され、Breezing では Lead が即座に認知して対応できる ### `"defer"` permission decision (v2.1.89) CC 2.1.89 で PreToolUse フックから `"defer"` permission decision を返せるようになった。ヘッドレスセッション（`-p` モード）でフックが defer を返すとセッションが一時停止し、`claude -p --resume` で再開時にフックが再評価される。 **Harness での活用余地**: - Breezing Worker が本番環境への書き込みや外部サービスへのリクエストなど、判断困難な操作に遭遇した際の安全弁 - `pre-tool.sh` の guardrail に「defer 条件」を追加し、特定パターンで Worker を一時停止→Lead が判断 - 現時点では機能の文書化のみ。具体的な defer ルールは運用パターンの蓄積後に設計 ### Hook output >50K disk save (v2.1.89) CC 2.1.89 でフック出力が 50K 文字を超える場合、コンテキストへの直接注入ではなくディスクに保存され、ファイルパス＋プレビューとして参照される。 **Harness への影響**: - 大量の出力を返す可能性のあるフック（quality-pack, ci-status-checker 等）はこの挙動を前提に設計 - 現状の Harness フックは出力が軽量のため直接影響は小さいが、将来の拡張時の設計制約として文書化 ### PreToolUse exit 2 JSON fix (v2.1.90) CC 2.1.90 で PreToolUse フックが JSON を stdout に出力して exit code 2 で終了する際のブロック動作が修正された。以前はこのパターンでブロックが正しく機能しないバグがあった。 **Harness への影響**: - `pre-tool.sh` は deny 時に JSON + exit 2 パターンを使用しており、v2.1.90 以降で guardrail の deny がより確実に動作 - 既存のガードレールが「deny を出したのにツールが実行された」ケースがあった場合、このバグが原因だった可能性 ### Built-in slash commands を Skill tool から呼ぶ際の Harness 影響 (v2.1.108) CC 2.1.108 以降、モデルが `Skill` tool を通じて `/init`、`/review`、`/security-review` などの built-in slash commands を呼び出せるようになった。これにより Harness スキルが CC の組み込み機能を 内部から呼び出す構成が可能になるが、Harness 独自の `/harness-review` との役割重複に注意が必要。 具体的には、`Skill` tool 経由で `/review` を呼び出した場合、Harness の guardrails（R01-R13）が 適用されない CC ネイティブのレビューが実行される。Harness のレビューフローでは `/harness-review` または `codex-companion.sh review` を経由させることで guardrails の保護と `review-result.v1` 形式への正規化が維持される。built-in slash command の Skill tool 呼び出しは 軽量な inline レビューや初期化処理に限定し、品質ゲートを要するレビューには使用しない。 ## v2.1.99-v2.1.110 + Opus 4.7 詳細セクション（Phase 44.11.1） > このセクションは `.claude/rules/cc-update-policy.md` の 3 カテゴリ分類（A/B/C）に準拠。 > B 分類は **0 件**。A = 実装あり、C = CC 自動継承。 ### PreCompact hook 3-way decision API (v2.1.99) **付加価値**: `A: 実装あり`（hooks/hooks.json PreCompact エントリ、Phase 44.13 で確認済み） CC 2.1.99 で PreCompact フックが `"block"` / `"allow"` / `"defer"` の 3-way decision API に対応した。 それまでは `block` / `allow` の 2 択のみで、「後で判断」の選択肢がなかった。 **Harness での活用**: - Breezing Worker が cc:WIP 状態のとき compaction を `"block"` し、WIP 完了後に `"allow"` するパターンが安全に実装できる - `hooks/hooks.json` の PreCompact ハンドラは `bin/harness pre-compact` 経由で dirty Plans.md を pathspec 限定 auto-checkpoint し、通常は compact 続行（commit 失敗または `precompactAutoCommit: false` のみ block） - `"defer"` はヘッドレス環境での条件付き延期に活用予定（現在は block/allow の 2-way を使用） **ユーザー体験の改善**: - 今まで: WIP 中の compaction を防ぐには `block` しかなく、長時間 Worker では不要な compaction 抑止が続く問題があった - 今後: `defer` で「今はダメだが resume 後に再評価」を指示でき、Worker 完了と同時に compaction が適切に走る ### ENABLE_PROMPT_CACHING_1H opt-in (v2.1.108) **付加価値**: `A: 実装あり`（`scripts/enable-1h-cache.sh`、Phase 44.6.1 で実装済み） CC 2.1.108 で `ENABLE_PROMPT_CACHING_1H=1` 環境変数による 1 時間 prompt cache TTL が追加された。 デフォルトの 5 分 TTL では 30 分超のセッションでキャッシュミスが頻発しコスト増大していた。 **Harness での活用**: - `scripts/enable-1h-cache.sh` を実行すると `env.local` に `ENABLE_PROMPT_CACHING_1H=1` を idempotent に追記 - `skills/breezing/SKILL.md` と `skills/harness-loop/SKILL.md` の開始前推奨として記載 - `docs/long-running-harness.md` に選択基準テーブル（セッション 30 分超なら 1h cache）を追加 **ユーザー体験の改善**: - 今まで: 長時間 Breezing セッションで cache miss が増え、同じ CLAUDE.md や hooks.json が繰り返し課金されていた - 今後: 1h TTL でキャッシュヒット率が大幅向上。長時間タスクのコストを削減できる ### /undo (rewind alias) (v2.1.108) **付加価値**: `A: 実装あり`（`.claude/rules/commit-safety.md`、Phase 44.7.1 で実装済み） CC 2.1.108 で `/rewind` のエイリアスとして `/undo` が追加された。セッション内の直前ツール呼び出しを取り消す。 **Harness での活用**: - `.claude/rules/commit-safety.md` に `/undo` の動作定義・利用制約・禁止パターンを明記 - Worker / Reviewer が自律的に `/undo` を実行する禁止条件（git commit 後の取り消しは `git revert` を使う）を文書化 - commit 済みの変更を間違えて `/undo` で消すリスクを防止 **ユーザー体験の改善**: - 今まで: `/rewind` と `/undo` の使い分けが曖昧で、エージェントが誤用するリスクがあった - 今後: Harness ルールで「`/undo` = セッション内ファイル変更の取り消し」「commit 後は `git revert`」と明確に分離 ### PermissionRequest updatedInput / additionalContext (v2.1.110) **付加価値**: `A: 実装あり`（`go/internal/guardrail/cc2110_regression_test.go`、Phase 44.3.1 で実装済み） CC 2.1.110 で PermissionRequest フックに `updatedInput` と `additionalContext` フィールドが追加・整備された。 `updatedInput` で CC が再評価した入力を渡し、`setMode: dontAsk` で mode 変更後も deny ルールが再適用される。 **Harness での活用**: - `go/internal/guardrail/cc2110_regression_test.go` に 3 グループのリグレッションテストを追加 - `updatedInput` + `setMode` → deny ルール（R01, R02, R06）が再評価後も適用されることを検証 - `additionalContext` が JSON round-trip で保持されることを確認（R09 警告パス） - Bash bypass ベクター（`;`, `&&`, `||`, サブシェル等）の検出強化 - `helpers.go` の `hasSudo()` をシェルメタキャラクタを含むコンテキストにも対応 **ユーザー体験の改善**: - 今まで: CC が入力を更新した後、guardrail の deny が再評価されない抜け穴が理論的に存在した - 今後: `updatedInput` 後も R01-R13 全ルールが再適用され、guardrail の完全性が保証される ### /recap と built-in slash command discovery (v2.1.108) **付加価値**: `C: CC 自動継承`（Harness 側変更不要） CC 2.1.108 で `/recap` コマンドが追加され、resume 前にセッション内容を要約して確認できるようになった。 built-in slash command の Skill tool 経由呼び出しも同バージョンで実現。 **Harness での活用**: - `/recap` は長時間の `--resume` 時にセッション記憶を確認する手順として `skills/session-memory/SKILL.md` に記載 - CC 本体の機能として自動利用可能。Harness 側の実装変更は不要 ### EnterWorktree path 引数 / stale worktree 自動クリーンアップ (v2.1.105) **付加価値**: `A: 実装あり`（`scripts/reenter-worktree.sh`、Phase 44.7.1 で実装済み） CC 2.1.105 で `EnterWorktree` フックに worktree パスが引数として渡されるようになった。 それまでは worktree パスをスクリプト内で自力特定する必要があった。 **Harness での活用**: - `scripts/reenter-worktree.sh` で EnterWorktree パス引数を活用した worktree 再入ヘルパーを実装 - worktree 登録確認と `worktree-info.json` 照合を含む安全な再入フロー - Breezing の Worker が一時停止後に正しい worktree に再入できることを保証 **ユーザー体験の改善**: - 今まで: Worker の worktree 再入は環境依存の worktree パス特定が必要で不安定だった - 今後: フックから直接パスを受け取り、worktree-info.json との照合で確実に正しいコンテキストに再入 --- ## Opus 4.7 詳細セクション（Phase 44.11.1） > このセクションでは Opus 4.7 固有機能の Harness への統合状況を詳述する。 > 付加価値分類: A = 実装あり、C = CC 自動継承。B 分類は 0 件。 ### 1. Literal Instruction Following **付加価値**: `A: 実装あり`（`.claude/rules/opus-4-7-prompt-audit.md`、Phase 44.4.1 + 44.4.2 で実装済み） Opus 4.7 は「指示を文字通り実行する」能力が大幅に向上した。曖昧な表現を補完して意図を推測するのではなく、指示された内容だけを実行する。 **Harness での活用**: - `.claude/rules/opus-4-7-prompt-audit.md` を新設。エージェントプロンプトの品質基準を定義 - 行動指示には実行コマンド名 / ファイルパス / JSON schema 名 / 数値閾値のいずれかを必須化 - 回数制御は `最大 3 回` のように数字で記述 - `必要に応じて` / `適宜` 等の曖昧語には直後に条件補足を必須化 - `agents/worker.md`, `agents/reviewer.md`, `agents/advisor.md` のプロンプトを監査基準に適合 **ユーザー体験の改善**: - 今まで: エージェントプロンプトの曖昧表現がモデルの誤解釈を招き、意図しない動作が発生した - 今後: 監査基準に合格したプロンプトはモデルが文字通りに解釈し、一貫した動作が保証される ### 2. xhigh Effort **付加価値**: `A: 実装あり`（`agents/reviewer.md`, `agents/advisor.md`, `docs/effort-level-policy.md`、Phase 44.5.1 で実装済み） Opus 4.7 では `xhigh` effort レベルが追加された（CC v2.1.111 frontmatter として受け付け可能）。 `high` より thinking 強度が高く、複雑なレビューや設計判断に適する。 **Harness での活用**: - `agents/reviewer.md`: `effort: medium` → `effort: xhigh` に変更（レビューの深度向上） - `agents/advisor.md`: `effort: high` → `effort: xhigh` に変更（判断の正確性向上） - `docs/effort-level-policy.md`: CC frontmatter effort と Anthropic API effort の対応マトリクスを整備 - `harness-work` スキルの多要素スコアリングで `ultrathink` を Worker に注入する仕組みは維持 **ユーザー体験の改善**: - 今まで: Reviewer は medium effort で動作し、複雑なアーキテクチャ変更のレビューが浅くなるケースがあった - 今後: xhigh effort で Reviewer の thinking 品質が向上し、critical/major 指摘の検出率が上がる ### 3. Task Budgets（採用見送り） **付加価値**: `C: 採用見送り`（`docs/task-budgets-research.md`、Phase 44.10.1 で調査済み） Anthropic Task Budgets (public beta) はタスク単位でトークン・ツール呼び出し数を制限する機能。 **Harness での活用**: - `docs/task-budgets-research.md` に仕様要約・Harness 既存機構との競合関係分析を記録 - 既存の `maxTurns` (Worker: 100, Reviewer: 50) および `MAX_REVIEWS` と機能が重複するため本 Phase では採用見送り - GA 昇格時の再評価トリガー条件（Harness 独自制御との統合設計が確定した時点）を明記 **採用見送り理由**: - Harness は既に `maxTurns` と `MAX_REVIEWS` で Worker の実行制限を管理 - Task Budgets との二重管理は設定の複雑性を増やすリスクがある - Public beta 段階での採用より GA 後の安定 API を待つ判断 ### 4. Tokenizer 改善 **付加価値**: `C: CC 自動継承`（Harness 側変更不要） Opus 4.7 の新 tokenizer により、同一プロンプトのトークン数が削減される。特に日本語・コード混在コンテンツで効果が大きい。 **Harness への影響**: - CLAUDE.md、スキルファイル、エージェントプロンプトのトークン消費が自動的に削減 - スキルバジェット（コンテキスト窓の 2%）の実効文字数が増加 - Harness 側の変更は不要。モデル更新で自動的に恩恵を受ける ### 5. Vision 2576px 対応 **付加価値**: `A: 実装あり`（`docs/opus-4-7-vision-usage.md`, `skills/harness-review/references/vision-high-res-flow.md`、Phase 44.9.1 で実装済み） Opus 4.7 では画像の短辺上限が 2576px まで拡大された。PDF・設計図・UI スクリーンショットのレビュー品質が向上。 **Harness での活用**: - `docs/opus-4-7-vision-usage.md`: 高解像度レビューの運用ガイドを新設（3 種のシナリオ: PDF レビュー / 設計図解析 / UI スクリーンショット） - `skills/harness-review/references/vision-high-res-flow.md`: 2576px 上限の運用フロー（リサイズ判定・多ページ PDF の分割戦略）を整備 - `/harness-review` で画像添付時の自動上限チェックを組み込み **ユーザー体験の改善**: - 今まで: 高解像度スクリーンショットは自動リサイズで品質が低下し、細部の UI 問題を見落とすケースがあった - 今後: 2576px まで原寸でレビュー可能。UI のピクセルレベルの問題や設計図の微細なラベルも検出できる ### 6. Memory 機能拡張 **付加価値**: `C: CC 自動継承`（auto-memory システムが既存。Harness 側変更不要） Opus 4.7 の Memory 機能拡張（自動メモリ記録の精度向上・長期記憶の圧縮品質改善）は Harness の既存 Agent Memory 基盤と自動的に統合される。 **Harness での活用**: - `memory: project` frontmatter によるエージェント固有メモリは引き続き機能 - CC の自動メモリ精度向上により、Worker / Reviewer / Scaffolder の学習品質が自動的に向上 - `.claude/agent-memory/` の既存エントリとの互換性は維持 ### 7. /ultrareview（並立維持方針） **付加価値**: `A: 実装あり`（`docs/ultrareview-policy.md`, `skills/harness-review/SKILL.md`、Phase 44.8.1 で実装済み） CC v2.1.111 で `/ultrareview` が built-in operator entrypoint として追加された。cloud 多エージェントレビューを実行する。 **Harness での活用（方針 B: 並立維持）**: - `docs/ultrareview-policy.md`: `/ultrareview` は ad-hoc レビューに限定、Harness automation flow には組み込まない方針を確立 - Harness の review automation は `review-result.v1` 契約ベースの `codex-companion.sh review`（優先）+ reviewer agent（フォールバック）を維持 - `skills/harness-review/SKILL.md` に役割分担セクションを追加 **ユーザー体験の改善**: - 今まで: `/ultrareview` の登場で Harness の `/harness-review` との役割が曖昧になっていた - 今後: `/ultrareview` = 人間の ad-hoc レビュー向け / `/harness-review` = 自動化フロー向け と明確に分離 ### 8. Auto Mode 拡大 **付加価値**: `C: opt-in 扱い`（`skills/breezing/SKILL.md` の `--auto-mode` フラグ説明） CC v2.1.111 で Auto Mode が `--enable-auto-mode` フラグなしでも利用可能になった。 **Harness での活用**: - `skills/breezing/SKILL.md` の `--auto-mode` オプションは「Harness 側の Auto Mode rollout を明示」する opt-in フラグとして説明を維持 - CC 本体での Auto Mode 拡大は自動的に継承されるが、Harness の `bypassPermissions` ベースの実装と混在しないよう注意 - operator entrypoint としての `--auto-mode` は呼び出し側が選ぶ設計を維持。agent 定義側に `autoMode` 値は書かない **ユーザー体験の改善**: - 今まで: Auto Mode には `--enable-auto-mode` フラグが必要で、Breezing との組み合わせが複雑だった - 今後: CC 本体で Auto Mode が常設化されたが、Harness では `--auto-mode` を明示 opt-in として扱い続けることで予測可能な挙動を維持 ## Phase 65 (cognitive-load 3 surface) — 2026-05-09 〜 2026-05-10 | Feature | Skill / Component | Purpose | 付加価値 | |---------|-------------------|---------|---------| | Plan Brief HTML (1st surface) | `harness-plan-brief` | 着工前の Claude 理解・選択肢・リスク・受け入れ条件・確信度を 1 枚 HTML で施主に承認確認 | A: 実装あり (Phase 65.1) | | Acceptance Demo HTML (2nd surface) | `harness-accept` | 引き渡し時の ship/wait/reject 判定 + 受け入れ条件検証 + 過去問題パターン表示 | A: 実装あり (Phase 65.2) | | Progress Tracker HTML (3rd surface) | `harness-progress` | 進捗 % + WIP/TODO/完了一覧 + 5 種 drift alert + PostToolUse 自動再生成 (60s rate limit) | A: 実装あり (Phase 65.4) | | 3-Layer Redaction | `redact-by-{dictionary,ner}.sh` + `final-scan-redaction.py` + `render-html.sh --with-redaction` | Layer 2a 辞書 + 2b NER (fugashi) + 3 final scan で固有名詞 leakage を 3 層防御 | A: 実装あり (Phase 65.3) | | Cross-Project Group | `cross-project-groups.yaml` + `load-cross-project-groups.sh` | 横断検索の opt-in グループ定義 (default OFF) | A: 実装あり (Phase 65.3.1) | | Cross-Project Audit Log | `cross-project-audit-log.sh` | 横断検索 1 回ごとに 1 行 JSON Lines (privacy: query_hash のみ) | A: 実装あり (Phase 65.3.6) | | Audit-trail UI | 3 HTML templates 共通追加 | 各 surface 末尾「🔍 この artifact の根拠」セクション (検索範囲 / 参照 ID / redact 件数 / log link) | A: 実装あり (Phase 65.5.2) | | user_request_hash join | `personal-preference.v1` + `acceptance-decision.v1` の sha256 fields | Plan Brief ↔ Acceptance を同 hash で graph join 可能に | A: 実装あり (Phase 65.1.4 / 65.2.3) | **ユーザー体験の改善**: - 今まで: Plans.md (200 行) + git log を読まないと進捗・判断根拠が見えなかった。エンジニアじゃない発注者は完全にブラックボックス - 今後: ブラウザで 1 枚 HTML を開けば 3 秒で「何を作る予定か (Plan Brief) / 今どこか (Progress) / 受け取れるか (Acceptance)」が判断できる - 横断検索を有効化しても 3 層 redaction で他プロジェクトの固有名詞は漏れない (fail-safe) - 詳細: [cognitive-load-surfaces.md](./cognitive-load-surfaces.md) / [cross-project-safety.md](./cross-project-safety.md) ### Orchestration Visibility (Phase 90) | 機能 | 活用スキル / 領域 | 用途 | 付加価値 | |------|-----------------|------|---------| | Delegation Ledger | `orchestration-ledger.sh` + `codex/cursor-companion.sh` | 委譲ごとに backend / counts 等 8 項目を `orchestration-ledger.jsonl` へ記録（prompt/秘密なし、status は計上除外） | A: 実装あり (Phase 90.1.1) | | Lifetime Accumulator | `orchestration-rollup.sh` + `go/internal/orchestration` | 完了時 + SessionEnd の 2 経路で累計へ冪等 roll up（`orchestration-totals.json`、record-only） | A: 実装あり (Phase 90.1.2) | | Scorecard Aggregator | `orchestration-scorecard.sh` | session mix + lifetime をマージし tri-state (used/available/not-configured) で集計。claude=ホスト | A: 実装あり (Phase 90.1.3) | | HTML Scorecard | `templates/html/orchestration.html.template` + `render-html.sh` | 累計主役の共有可能 1 枚 HTML（JS 不要 standalone） | A: 実装あり (Phase 90.1.4) | | Completion Summary + Skill | `harness-orchestration` + `task_completed.go` | 全完了時に 1 回ターミナルサマリ（Go all-done）+ on-demand HTML スキル | A: 実装あり (Phase 90.1.5) | **ユーザー体験の改善**: - 今まで: 委譲は実行時に不可視で「本当に Codex/Cursor を使ったか、全部 Claude に落ちたか」が分からなかった - 今後: 記録 → 累計 → スコアカードで「このセッション/プロジェクトでどれだけオーケストレーションを活用したか」を見せられる（累計が主役の数字） ## 関連ドキュメント - [CLAUDE.md](../CLAUDE.md) - 開発ガイド（Feature Table の要約版） - [CLAUDE-skill-catalog.md](./CLAUDE-skill-catalog.md) - スキルカタログ - [CLAUDE-commands.md](./CLAUDE-commands.md) - コマンドリファレンス - [ARCHITECTURE.md](./ARCHITECTURE.md) - アーキテクチャ概要