Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 10 additions & 1 deletion 02_コンテキストエンジニアリング.md
Original file line number Diff line number Diff line change
Expand Up @@ -348,9 +348,18 @@ CLAUDE.mdにトリガー条件を記載する:
作業ディレクトリより上位のCLAUDE.mdファイルは起動時に全文ロード。

### R-089: 自動メモリ(Auto Memory)の対象
Claudeが自ら蓄積する知見: ビルドコマンド、デバッグインサイト、アーキテクチャメモ、コードスタイルの好み、ワークフローの習慣。
Claudeが自ら蓄積する知見: ビルドコマンド、デバッグインサイト、アーキテクチャメモ、コードスタイルの好み、ワークフローの習慣。v2.1.59以降で利用可能。

### R-089a: メモリシステムは3トラックに分類される
- **ネイティブスタック**: CLAUDE.md、Auto Memory(v2.1.59+)、Auto Dream、Agentメモリfrontmatter
- **クロスセッションツール**: claude-mem、agentmemory(BM25+ベクトル+グラフ、LongMemEval-S R@5 95.2%)、ICM、OpenMemory MCP 等
- **チーム共有**: Mem0 Cloud MCP、Zep/Graphiti、Trinity 等

### R-089b: メモリシステムの選択基準
単一セッション内 → CLAUDE.md / Auto Memory。クロスセッション個人 → claude-mem / agentmemory。チーム共有 → Mem0 / Zep。OAuth/ブラウザリダイレクトが必要な外部サービス → MCP一択(スキルでは代替不可)。

**情報源:** Anthropic公式 - Memory
**更新:** https://github.com/FlorianBruniaux/claude-code-ultimate-guide/commit/028ca48 (Memory Systems guide v2.1.150)

---

Expand Down
3 changes: 3 additions & 0 deletions 03_コア機能.md
Original file line number Diff line number Diff line change
Expand Up @@ -343,8 +343,11 @@ EOF
| R-142 | Skillsはフォルダ構成の指示・スクリプト・リソースで、動的にロードされる | |
| R-143 | Skill定義にはfrontmatter(name, description, allowed-tools等)を使う | `context: fork` でサブエージェント実行 |
| R-144 | docx/xlsx/pptx/pdf のスキルはProprietary(オープンソースではない) | |
| R-145 | v2.1.145時点でバンドルスキルは9種(旧6種): docx/xlsx/pptx/pdf/run/verify/run-skill-generator | `run`・`verify`・`run-skill-generator` はv2.1.145で追加 |
| R-146 | `run` スキルはアプリ起動・動作確認、`verify` は変更の動作検証、`run-skill-generator` は新スキル生成を担う | 「Run and verify your app」カテゴリの3スキル |

**情報源:** https://github.com/anthropics/skills
**更新:** https://github.com/shanraisshan/claude-code-best-practice/commit/cf86431 (v2.1.145)

---

Expand Down
9 changes: 8 additions & 1 deletion 05_自動化と並列実行.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,6 +119,11 @@ claude /install-github-app
| `plugins` | - | プラグインリスト |
| `use_bedrock` | - | AWS Bedrock OIDC有効化 |
| `use_vertex` | - | Google Vertex AI OIDC有効化 |
| `anthropic_federation_rule_id` | - | Workload Identity Federation ルールID(WIF認証時) |
| `anthropic_organization_id` | - | AnthropicオーガニゼーションID(WIF認証時) |
| `anthropic_service_account_id` | - | サービスアカウントID(WIF認証時) |
| `anthropic_workspace_id` | - | ワークスペースID(WIF認証時) |
| `anthropic_oidc_audience` | `https://api.anthropic.com` | OIDCオーディエンス(WIF認証時) |

### R-015: 出力パラメータ一覧

Expand Down Expand Up @@ -655,7 +660,9 @@ compactionエラー時は1Mトークンモデルに切替後に再compact。

### R-074: `/extra-usage` でオーバーフロー課金設定(拡張トークン予算)を行う

### R-075: チェックポイント機能(`Esc Esc` or `/rewind`)でgitベースの編集追跡を行う
### R-075: チェックポイント機能(`Esc Esc` or `/rewind`)でファイル編集追跡を行う

Checkpointingはgitベースではなく、Claudeが行ったファイル編集操作の追跡によって実装されている。

### R-076: MCPサーバーはプロジェクトあたり10以下、アクティブツールは80以下を推奨する

Expand Down
4 changes: 4 additions & 0 deletions reference/mcp_catalog.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,10 @@

> 情報源: `research/04_拡張機能.md` / `04_拡張機能.md`
> 作成日: 2026-03-28
> 更新日: 2026-05-25

> **注意(2026-05):** `modelcontextprotocol/servers` リポジトリのサードパーティサーバーリストは廃止され、公式 MCP Registry に移行された。サードパーティMCPサーバーの探索には [MCP Registry](https://registry.mcp.run/) を参照。
> ソース: https://github.com/modelcontextprotocol/servers/commit/d5bfe34

---

Expand Down
27 changes: 26 additions & 1 deletion research/02_コンテキストエンジニアリング.md
Original file line number Diff line number Diff line change
Expand Up @@ -331,7 +331,7 @@ Claude Codeのコンテキストウィンドウ(標準200Kトークン、Max/T

### 自動メモリ(Auto Memory)

Claudeが自ら知見を蓄積する機能:
Claudeが自ら知見を蓄積する機能(v2.1.59以降):
- ビルドコマンド
- デバッグインサイト
- アーキテクチャメモ
Expand All @@ -340,6 +340,31 @@ Claudeが自ら知見を蓄積する機能:

> ソース: [Anthropic公式 - Memory](https://docs.anthropic.com/en/docs/claude-code/memory)

### メモリシステム全体マップ(2026-05時点)

FlorianBruniaux/claude-code-ultimate-guideのMemory Systemsガイド(guide/core/memory-systems.md, 1100行)による包括的整理:

**ネイティブスタック:**
| 手段 | 説明 |
|------|------|
| CLAUDE.md | プロジェクト/グローバル/ローカルの3階層 |
| Auto Memory | v2.1.59+。Claudeが自動でCLAUDE.mdに書き込む |
| Auto Dream | セッション終了時の自動要約 |
| Agentメモリfrontmatter | スキルファイルのfrontmatterでメモリ注入 |

**クロスセッションツール(外部):**
- **agentmemory**: BM25+ベクトル+グラフのRRFアーキテクチャ。LongMemEval-S R@5 95.2%
- **claude-mem**: シンプルなCLI型メモリツール
- **OpenMemory MCP**: MCPサーバー型の永続メモリ
- ICM、Kairn、doobidoo 等

**チーム共有:**
- Mem0 Cloud MCP、Zep/Graphiti、Trinity 等

**選択ガイド:** OAuth/ブラウザリダイレクトが必要な外部サービスへのメモリ連携はMCP一択(スキルでは代替不可)。

> ソース: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/commit/028ca48 (2026-05)

---

## 13. 実践的なルール遵守改善パターン(5つのパターン)
Expand Down
19 changes: 18 additions & 1 deletion research/03_コア機能.md
Original file line number Diff line number Diff line change
Expand Up @@ -762,8 +762,25 @@ description: スキルの説明(トリガー条件)
| `effort` | 推論レベルオーバーライド |
| `context: fork` | サブエージェントで実行 |

### バンドルスキル一覧(v2.1.145時点)

| スキル | カテゴリ | 説明 |
|--------|---------|------|
| `docx` | ドキュメント | Word文書操作 |
| `xlsx` | ドキュメント | Excelスプレッドシート操作 |
| `pptx` | ドキュメント | PowerPointプレゼン操作 |
| `pdf` | ドキュメント | PDF操作 |
| `run` | アプリ実行 | アプリ起動・動作確認(v2.1.145追加) |
| `verify` | アプリ実行 | 変更の動作検証(v2.1.145追加) |
| `run-skill-generator` | アプリ実行 | 新スキル生成(v2.1.145追加) |

v2.1.145で「Run and verify your app」カテゴリとして run/verify/run-skill-generator の3スキルが追加され、バンドルスキル数が6→9に増加。

**ソース:** https://github.com/anthropics/skills
**更新:** https://github.com/shanraisshan/claude-code-best-practice/commit/cf86431 (2026-05-21)

### ドキュメントスキルのライセンス

docx, xlsx, pptx, pdf のスキルは**Proprietary(ソースアベイラブル、オープンソースではない)**。Claude のドキュメント機能を裏で動かしている本番スキルを開発者向けに共有したもの。
docx, xlsx, pptx, pdf のスキルは**Proprietary(ソースアベイラブル、オープンソースではない)**。Claude のドキュメント機能を裏で動かしている本番スキルを開発者向けに共有したもの。run/verify/run-skill-generator は MIT ライセンス。

**ソース:** https://github.com/anthropics/skills
30 changes: 30 additions & 0 deletions research/04_拡張機能.md
Original file line number Diff line number Diff line change
Expand Up @@ -1014,6 +1014,36 @@ MCP >> Agent定義 >> Skills >> CLAUDE.md >> Hooks ≒ 0

---

## MCP vs CLI 推奨テーブル(2026-05)

FlorianBruniaux/claude-code-ultimate-guide の guide/ecosystem/mcp-vs-cli.md より。

| MCPサーバー | 推奨 | CLI代替 | 理由 |
|------------|------|---------|------|
| GitHub | CLI | `gh` | CLIで全機能カバー |
| GitLab | CLI | `glab` | CLIで全機能カバー |
| git | CLI | `git` | CLIで全機能カバー |
| docker | CLI | `docker` | CLIで全機能カバー |
| aws-cli | CLI | `aws` | CLIで全機能カバー |
| terraform | CLI | `terraform` | CLIで全機能カバー |
| semgrep | CLI | `semgrep` | CLIで全機能カバー |
| filesystem | CLI | `ls`/`cat` 等 | CLIで全機能カバー |
| Sentry | MCP | - | API認証が必要 |
| Slack | MCP | - | OAuth/API必要 |
| Notion | MCP | - | OAuth必要 |
| Google Drive | MCP | - | OAuth必要 |
| Figma | MCP | - | API認証必要 |
| Linear | MCP | - | API認証必要 |
| Context7 | MCP | - | リアルタイムドキュメント取得 |
| Playwright | 場合による | playwright CLI | インタラクティブ vs スクリプト |
| Kubernetes | 場合による | `kubectl` | 操作の複雑さによる |

**原則:** OAuth/ブラウザリダイレクトが必要、または継続的なAPIセッションが前提のサービス → MCP。CLIツールが存在してすべての操作をカバーできる → CLI。

> ソース: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/commit/0442507 (2026-05)

---

## ソース一覧

### 公式ドキュメント
Expand Down
43 changes: 42 additions & 1 deletion research/05_自動化と並列実行.md
Original file line number Diff line number Diff line change
Expand Up @@ -146,6 +146,15 @@ claude /install-github-app
| `plugins` | - | プラグインリスト |
| `use_bedrock` | - | AWS Bedrock OIDC有効化 |
| `use_vertex` | - | Google Vertex AI OIDC有効化 |
| `anthropic_federation_rule_id` | - | Workload Identity Federation ルールID |
| `anthropic_organization_id` | - | AnthropicオーガニゼーションID(WIF認証時) |
| `anthropic_service_account_id` | - | サービスアカウントID(WIF認証時) |
| `anthropic_workspace_id` | - | ワークスペースID(WIF認証時) |
| `anthropic_oidc_audience` | `https://api.anthropic.com` | OIDCオーディエンス(WIF認証時) |

WIFを使うと静的APIキー不要で GitHub Actions OIDC トークンを Anthropic の短命アクセストークンに交換できる(`ANTHROPIC_IDENTITY_TOKEN_FILE` 経由)。`id-token: write` パーミッションが必要。

> ソース: https://github.com/anthropics/claude-code-action/pull/1338 (2026-05)

### 2.4 出力パラメータ

Expand Down Expand Up @@ -933,6 +942,34 @@ hooks: {

SDKフックが全ツール呼び出しをインターセプト。`parent_tool_use_id` でサブエージェントの起源を追跡。ログは人間可読トランスクリプトと構造化JSONL形式の両方で記録。

### 4.5 Managed Agents API 更新(2026-05)

> ソース: https://github.com/anthropics/skills/commit/d211d43
> ソース: https://github.com/anthropics/skills/commit/690f15c

v2.1.145〜v2.1.150 の期間に追加されたManaged Agents関連の新機能:

**Session Threads API(新規):**
- `sessions.threads.list` / `retrieve` / `archive`
- `sessions.threads.events.list` / `stream`
- セッション内のスレッドを独立して追跡・アーカイブ可能

**Webhooks(新規):**
- Webhookエンドポイント登録
- HMAC署名検証
- セッションイベントをHTTPで外部に配信

**Credentials API 更新:**
- `vaults.credentials.mcp_oauth_validate` 追加(MCP OAuth検証用)

**self-hosted sandboxes(新規):**
- `config: {type: "self_hosted"}` でエージェントループをAnthropicのオーケストレーションに、ツール実行を自社インフラで行うハイブリッド構成
- アウトバウンドポーリングワーカー経由

**mid-session agent update(新規):**
- `sessions.update(session_id, agent={tools, mcp_servers}, vault_ids=[...])` でセッション実行中にエージェント設定を変更可能
- エージェントバージョンは上げずにセッションローカルのオーバーライドとして機能

---

## 5. 並列実行
Expand Down Expand Up @@ -1097,7 +1134,7 @@ Claude CodeとCodex CLIを組み合わせ、計画/実装レビューを同時
**セッション管理:**
- `/clear` でタスク切替時にコンテキストリセット
- `/extra-usage` でオーバーフロー課金設定(拡張トークン予算)
- チェックポイント機能(`Esc Esc` or `/rewind`)でgitベースの編集追跡
- チェックポイント機能(`Esc Esc` or `/rewind`)でファイル編集追跡(gitベースではなくClaudeのファイル操作追跡による)

**MCP制約:**
- プロジェクトあたり **10 MCP以下** を推奨
Expand Down Expand Up @@ -1130,3 +1167,7 @@ CI/CDビルドゲートとして、クリティカル検出時にexit code 2を
| 9 | claude-agent-sdk-demos | https://github.com/anthropics/claude-agent-sdk-demos |
| 10 | claude-code-best-practice | https://github.com/shanraisshan/claude-code-best-practice |
| 11 | everything-claude-code | https://github.com/affaan-m/everything-claude-code |
| 12 | claude-code-action WIF PR | https://github.com/anthropics/claude-code-action/pull/1338 |
| 13 | claude-code-action WIF example | https://github.com/anthropics/claude-code-action/blob/main/examples/claude-wif.yml |
| 14 | Managed Agents Webhooks | https://platform.claude.com/docs/en/managed-agents/webhooks.md |
| 15 | Managed Agents Multi-Agent | https://platform.claude.com/docs/en/managed-agents/multi-agent.md |
Loading