From a7bec1dee0cc0ae796ae7560ca94d9f2fbba507f Mon Sep 17 00:00:00 2001 From: fumtas1k Date: Mon, 27 Jul 2026 23:10:06 +0900 Subject: [PATCH 1/2] =?UTF-8?q?docs:=20CLAUDE.md=20=E7=9B=A3=E6=9F=BB?= =?UTF-8?q?=E3=81=AB=E3=82=88=E3=82=8B=20Agent=20Teams=20=E8=A8=98?= =?UTF-8?q?=E8=BF=B0=E3=81=AE=E6=9B=B4=E6=96=B0=E3=81=A8=E3=83=97=E3=83=A9?= =?UTF-8?q?=E3=82=B0=E3=82=A4=E3=83=B3=E5=AE=A3=E8=A8=80=E3=81=AE=E5=90=8C?= =?UTF-8?q?=E6=9C=9F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit claude-md-improver による監査で見つかった 3 点を修正する。 - Agent Teams: teammateMode の既定値が v2.1.179 で auto → in-process に 変わった点、tmux 指定は split-pane で VS Code 統合ターミナル等では 非対応な点、TeamCreate / TeamDelete 廃止と team_name 無視を追記。 公式が明記するトークンコスト増と「使わない場面」（逐次タスク・同一 ファイル編集・依存の多い作業）が欠落しており、common.md 6.9 節の 委譲判断と方向性が矛盾していたため補った。 - 推奨プラグイン: claude-md-management を enabledPlugins に宣言。 claude plugin install はユーザーレベル設定に書くため宣言漏れだと web セッションで install されない旨も明記。 - 前提モデル節を新設: settings.json の model: opus[1m] と、規約が Opus 5 世代の既定挙動を前提にしている旨を出典付きで明示。 Co-Authored-By: Claude Opus 5 (1M context) --- .claude/settings.json | 3 ++- CLAUDE.md | 37 ++++++++++++++++++++++++++++--------- 2 files changed, 30 insertions(+), 10 deletions(-) diff --git a/.claude/settings.json b/.claude/settings.json index 3b182b95..9c793a92 100644 --- a/.claude/settings.json +++ b/.claude/settings.json @@ -13,7 +13,8 @@ } }, "enabledPlugins": { - "context7@claude-plugins-official": true + "context7@claude-plugins-official": true, + "claude-md-management@claude-plugins-official": true }, "hooks": { "SessionStart": [ diff --git a/CLAUDE.md b/CLAUDE.md index 1bc1f595..2529d348 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -18,15 +18,22 @@ Claude Code 固有の補足は `.claude/rules/` 配下に分割し、上記 `@im （注: 上記は Claude 固有。Codex は `.codex/rules/`、Gemini CLI は `docs/setup/gemini-policy.md` を参照） +### 前提モデル + +`.claude/settings.json` で `model: "opus[1m]"`（Claude Opus 5 / 1M context）を指定している。`.agents/rules/common.md` の出力量・委譲判断の規約はこの世代の既定挙動（応答と生成ドキュメントが長い / subagent 委譲に積極的）を前提に書かれている → [Prompting Claude Opus 5](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5) + --- ## 推奨プラグイン このプロジェクトは以下の Claude Code プラグインを前提に運用しています。`.claude/settings.json` の `enabledPlugins` で宣言済み。 -| プラグイン | 用途 | -| :--------------------------------- | :---------------------------------------------------------------- | -| `context7@claude-plugins-official` | ライブラリ公式ドキュメントの最新参照（Upstash Context7 MCP 同梱） | +| プラグイン | 用途 | +| :--------------------------------------------- | :-------------------------------------------------------------------- | +| `context7@claude-plugins-official` | ライブラリ公式ドキュメントの最新参照（Upstash Context7 MCP 同梱） | +| `claude-md-management@claude-plugins-official` | `CLAUDE.md` の監査・改善（`claude-md-improver` / `revise-claude-md`） | + +**リポジトリで共有するプラグインは必ず `enabledPlugins` に宣言する**。`claude plugin install` はユーザーレベル設定に書き込むため、宣言を忘れると **web セッションでは入らない**（`session-install.sh` は `enabledPlugins` を読んで install するため）。個人的に試すだけのプラグインは宣言しない。 **superpowers / frontend-design はプラグインではなく `npx skills add` でリポジトリ内に vendor 済み**（`.agents/skills/` + `skills-lock.json` 管理）。Web セッションでプラグイン install が効かない問題の回避のため移行した。frontend-design は単一スキルで MCP を同梱しないため skill 化できる（context7 は MCP server 同梱のためプラグインのまま）。出典・ライセンスは `.agents/skills/README.md` を参照。 @@ -38,11 +45,23 @@ CLI / Desktop は `.claude/settings.json` から自動 install を prompt しま ## Agent Teams (Claude Code 固有機能) -このプロジェクトでは **Claude Code の Agent Teams 機能**（実験的）を有効化しています。 +このプロジェクトでは **Claude Code の Agent Teams 機能**（実験的）を有効化しています。subagent と違い、teammate 同士が直接メッセージを交換し共有タスクリストを self-claim します。 - `.claude/settings.json` に `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: "1"` と `teammateMode: "tmux"` を設定済み。 -- 複数の Claude エージェントが tmux セッション上で協調して作業できます。 -- **活用する場面**: - - 独立した複数タスクを並列に進める場合 - - レビュー担当・実装担当を分けたい場合 - - 長大な実装を複数エージェントで分担する場合 +- `teammateMode` の既定値は **v2.1.179 で `"auto"` → `"in-process"` に変更**された。本リポジトリが明示している `"tmux"` は split-pane モードで、**tmux または iTerm2 (`it2` CLI) が必須**。**VS Code 統合ターミナル / Windows Terminal / Ghostty では非対応**なので、それらで使う場合は `"in-process"` を選ぶ。 +- `TeamCreate` / `TeamDelete` ツールは廃止済みで、team 作成・命名の事前ステップは不要（セッション終了時に自動クリーンアップ）。Agent tool の `team_name` 入力は受理されるが無視される。 + +**使う場面**（並列探索が実際に価値を生むもの）: + +- research / review: 複数 teammate が別観点で同時に調査し、互いの結論を突き合わせる +- 競合仮説のデバッグ: 各 teammate が別仮説を検証して収束させる +- 独立した新規モジュール追加 / レイヤーを跨ぐ変更（担当ファイルが重複しない場合） + +**使わない場面**: + +- **逐次的なタスク・同一ファイルを編集する作業・依存関係が多い作業** → 単一セッションか subagent の方が効果的。2 人が同じファイルを編集すると上書きになる +- 親が数ツールコールで完結できる規模の作業（`.agents/rules/common.md` 6.9 節の委譲判断と同じ基準） + +**Agent teams は単一セッションより著しく多くトークンを消費する**（teammate ごとに独立した context window を持つため線形に増える）。初手は 3〜5 teammate、実装並列より research / review から始めるのが公式推奨。 + +詳細 → [Agent teams](https://code.claude.com/docs/en/agent-teams) From 02e767fcffa022152eb6272cf36cb36b55b589f8 Mon Sep 17 00:00:00 2001 From: fumtas1k Date: Mon, 27 Jul 2026 23:51:26 +0900 Subject: [PATCH 2/2] =?UTF-8?q?docs:=20=E5=89=8D=E6=8F=90=E3=83=A2?= =?UTF-8?q?=E3=83=87=E3=83=AB=E7=AF=80=E3=82=92=E4=B8=96=E4=BB=A3=E9=9D=9E?= =?UTF-8?q?=E4=BE=9D=E5=AD=98=E3=81=AE=E8=A1=A8=E7=8F=BE=E3=81=AB=E4=BF=AE?= =?UTF-8?q?=E6=AD=A3=EF=BC=88PR=20#759=20=E3=83=AC=E3=83=93=E3=83=A5?= =?UTF-8?q?=E3=83=BC=E6=8C=87=E6=91=98=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit opus は現行世代の最新 Opus を指すエイリアスで解決先が移動するため、 世代番号 Opus 5 を固定すると本 PR が潰そうとした Currency ドリフトを 再導入することになる。エイリアスの性質を明記し、Opus 5 は「執筆時点の 現行世代」として behavioral リファレンスに残したうえで、解決先が次世代に 移ったら見直す旨を追記した。 Co-Authored-By: Claude Opus 5 (1M context) --- CLAUDE.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index 2529d348..fe8d57e3 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -20,7 +20,11 @@ Claude Code 固有の補足は `.claude/rules/` 配下に分割し、上記 `@im ### 前提モデル -`.claude/settings.json` で `model: "opus[1m]"`（Claude Opus 5 / 1M context）を指定している。`.agents/rules/common.md` の出力量・委譲判断の規約はこの世代の既定挙動（応答と生成ドキュメントが長い / subagent 委譲に積極的）を前提に書かれている → [Prompting Claude Opus 5](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5) +`.claude/settings.json` で `model: "opus[1m]"` を指定している。`opus` は **現行世代の最新 Opus を指すエイリアス**（`[1m]` は 1M context 版）であり、世代が更新されれば解決先も移動する。 + +`.agents/rules/common.md` の出力量・委譲判断の規約は、執筆時点の現行世代である Claude Opus 5 の既定挙動（応答と生成ドキュメントが長い / subagent 委譲に積極的）を前提にしている → [Prompting Claude Opus 5](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5) + +**エイリアスの解決先が次世代に移ったら、本節と上記規約の前提を見直すこと**（世代番号を固定した記述は Currency ドリフトの発生源になる）。 ---