SOURCES — 一次情報源の台帳
最終棚卸し: 2026-08-12
このファイルは「どこを読むべきか」の索引。sources/ にファイルがあるものは ✅、未着手は ⬜。
優先度は「AI活用全般のベストプラクティスとしての汎用性」で付けている。
2026-08-12 時点で、下表の原典はすべて取り込み済み（
sources/に 78 ファイル）。 唯一の例外は §1 末尾の「参考（事例報告）」2本で、これは信号対雑音比を保つため意図的にsources/に入れていない。 複数ページを束ねていた行は、README の「原典1本 = 1ファイル」に従ってページごとに分解した（該当行に注記あり）。
0. ドメイン構成の注意（重要）
一次情報は3つのホストに分かれており、過去に大きなURL移設があった。
| ホスト | 扱う範囲 |
|---|---|
www.anthropic.com/engineering | Engineering ブログ。設計思想・研究寄り |
code.claude.com/docs | Claude Code の製品ドキュメント |
platform.claude.com/docs | Claude Developer Platform（API、prompting、tool use、Skills、evals） |
判明している転送:
www.anthropic.com/engineering/claude-code-best-practices→ 308 →code.claude.com/docs/en/best-practices（かつての有名なブログ記事は独立文書として消滅。ネット上の解説記事の多くは古い版を参照している）docs.claude.com/en/docs/claude-code/*→ 301 →code.claude.com/docs/en/*docs.claude.com/en/docs/build-with-claude/*→ 302 →platform.claude.com/docs/en/*
日本語版について: 両ドキュメントサイトとも /docs/ja/<en と同じパス> で到達する。
本台帳と frontmatter は英語版URLを正とし、url_ja を併記する（理由と実測は DECISIONS.md #1）。
Engineering ブログに日本語版は存在しない（404）。
索引ファイル（全ページを機械的に列挙できる）:
- https://code.claude.com/docs/llms.txt （200 直接）
- https://platform.claude.com/llms.txt （
/docs/は付かない。platform.claude.com/docs/llms.txtは 308 でここへ転送される）
2サイトで llms.txt の位置が非対称なので注意。2026-08-10 に実測して確認済み。
1. Engineering ブログ（全25本）
https://www.anthropic.com/engineering
エージェント設計
| 記事 | URL slug | 優先度 | |
|---|---|---|---|
| ✅ | Building effective agents | building-effective-agents | 高 — この分野の出発点 |
| ✅ | How we built our multi-agent research system | multi-agent-research-system | 高 — orchestrator-workers の実運用 |
| ✅ | Effective harnesses for long-running agents | effective-harnesses-for-long-running-agents | 高 |
| ✅ | Harness design for long-running application development | harness-design-long-running-apps | 中 |
| ✅ | Scaling Managed Agents: Decoupling the brain from the hands | managed-agents | 中 |
| ✅ | Building a C compiler with a team of parallel Claudes | building-c-compiler | 中 — 並列エージェントの事例 |
コンテキスト設計
| 記事 | URL slug | 優先度 | |
|---|---|---|---|
| ✅ | Effective context engineering for AI agents | effective-context-engineering-for-ai-agents | 高 |
| ✅ | Introducing Contextual Retrieval | contextual-retrieval | 中 — RAG 寄り |
| ✅ | The “think” tool | claude-think-tool | 中 |
ツール・MCP
| 記事 | URL slug | 優先度 | |
|---|---|---|---|
| ✅ | Writing effective tools for agents — with agents | writing-tools-for-agents | 高 |
| ✅ | Code execution with MCP: Building more efficient agents | code-execution-with-mcp | 高 — MCP のトークン効率 |
| ✅ | Equipping agents for the real world with Agent Skills | equipping-agents-for-the-real-world-with-agent-skills | 高 |
| ✅ | Introducing advanced tool use on the Claude Developer Platform | advanced-tool-use | 中 |
| ✅ | Desktop Extensions: One-click MCP server installation | desktop-extensions | 低 |
Claude Code
| 記事 | URL slug | 優先度 | |
|---|---|---|---|
| ✅ | Beyond permission prompts: making Claude Code more secure and autonomous | claude-code-sandboxing | 中 |
| ✅ | How we built Claude Code auto mode | claude-code-auto-mode | 中 |
Claude Code のベストプラクティス本体は Engineering ブログではなく
code.claude.com/docs/en/best-practices（§2 参照）。
評価 (evals)
| 記事 | URL slug | 優先度 | |
|---|---|---|---|
| ✅ | Demystifying evals for AI agents | demystifying-evals-for-ai-agents | 高 |
| ✅ | Designing AI-resistant technical evaluations | AI-resistant-technical-evaluations | 中 |
| ✅ | Quantifying infrastructure noise in agentic coding evals | infrastructure-noise | 中 — eval の再現性 |
| ✅ | Eval awareness in Claude Opus 4.6’s BrowseComp performance | eval-awareness-browsecomp | 低 — モデル固有 |
| ✅ | Raising the bar on SWE-bench Verified with Claude 3.5 Sonnet | swe-bench-sonnet | 低 — モデル固有・古い |
安全性・運用
| 記事 | URL slug | 優先度 | |
|---|---|---|---|
| ✅ | How we contain Claude across products | how-we-contain-claude | 中 |
参考（ベストプラクティスではなく事例報告）
sources/ には入れない。信号対雑音比を保つため、ここに留める。
- An update on recent Claude Code quality reports —
april-23-postmortem - A postmortem of three recent issues —
a-postmortem-of-three-recent-issues
2. Claude Code ドキュメント
https://code.claude.com/docs/en/ （日本語: /docs/ja/）
| ページ | パス | 優先度 | |
|---|---|---|---|
| ✅ | Best practices for Claude Code | best-practices | 最高 — Claude Code 運用の中核 |
| ✅ | How Claude Code works | how-claude-code-works | 高 — agentic loop の内部 |
| ✅ | Extend Claude Code（skills/hooks/MCP/subagents/plugins の使い分け） | features-overview | 高 — 判断ガイドとして実用性が高い |
| ✅ | How Claude remembers your project（CLAUDE.md、auto memory） | memory | 高 |
| ✅ | Explore the context window | context-window | 高 — 起動時に何が読まれるかの実測 |
| ✅ | Extend Claude with skills | skills | 高 |
| ✅ | Create custom subagents | sub-agents | 高 |
| ✅ | Orchestrate subagents at scale with dynamic workflows | workflows | 高 |
| ✅ | Common workflows | common-workflows | 中 — レシピ集 |
| ✅ | Automate actions with hooks | hooks-guide / hooks | 中 |
| ✅ | Connect Claude Code to tools via MCP | mcp | 中 |
| ✅ | Orchestrate teams of Claude Code sessions | agent-teams | 中 |
| ✅ | Message your other Claude Code sessions | cross-session-messaging | 高 — SendMessage の適用範囲がチーム外へ広がった。信頼モデルが要点 |
| ✅ | Choose a permission mode / Configure permissions | permission-modes / permissions | 中 |
| ✅ | Manage costs effectively | costs | 中 |
| ✅ | Set up Claude Code in a monorepo or large codebase | large-codebases | 中 |
| ✅ | Run Claude Code programmatically | headless | 中 |
| ✅ | Claude Code settings | settings | 低 — リファレンス |
| ✅ | Glossary | glossary | 低 — 用語確認用 |
| ✅ | What’s new（週次） | whats-new/index | 低 — 鮮度確認の起点として有用 |
3. Claude Developer Platform ドキュメント
https://platform.claude.com/docs/en/intro （日本語: /docs/ja/...）
platform.claude.com/docs/enおよび.../docs/en/はどちらも/docs/en/introへ転送される。 各ページの実URLは、ホストplatform.claude.com+/docs/en/+ 下表の「パス」欄を連結した形。
プロンプト設計
| ページ | パス | 優先度 | |
|---|---|---|---|
| ✅ | Prompting best practices（公式が「living reference。まずここから」と明言） | build-with-claude/prompt-engineering/claude-prompting-best-practices | 最高 |
| ✅ | Prompt engineering overview | build-with-claude/prompt-engineering/overview | 中 — 上記への導線 |
| ✅ | Prompting Claude Opus 5 | build-with-claude/prompt-engineering/prompting-claude-opus-5 | 高 — モデル固有の調整 |
| ✅ | Prompting Claude Sonnet 5 / Opus 4.8 / Fable 5 | 同ディレクトリ | 中 |
Agent Skills
| ページ | パス | 優先度 | |
|---|---|---|---|
| ✅ | Skill authoring best practices | agents-and-tools/agent-skills/best-practices | 最高 |
| ✅ | Agent Skills overview | agents-and-tools/agent-skills/overview | 中 |
ツール使用
| ページ | パス | 優先度 | |
|---|---|---|---|
| ✅ | Manage tool context | agents-and-tools/tool-use/manage-tool-context | 高 |
| ✅ | Define tools | agents-and-tools/tool-use/define-tools | 中 |
| ✅ | Programmatic tool calling | agents-and-tools/tool-use/programmatic-tool-calling | 中 |
| ✅ | Tool search tool（ツールが多数あるとき） | agents-and-tools/tool-use/tool-search-tool | 中 |
| ✅ | Memory tool | agents-and-tools/tool-use/memory-tool | 中 |
コンテキスト管理
| ページ | パス | 優先度 | |
|---|---|---|---|
| ✅ | Context windows | build-with-claude/context-windows | 高 |
| ✅ | Compaction | build-with-claude/compaction | 高 |
| ✅ | Context editing | build-with-claude/context-editing | 中 |
| ✅ | Prompt caching | build-with-claude/prompt-caching | 中 — コスト直結 |
| ✅ | Thinking / Steering thinking / Effort | build-with-claude/thinking*, build-with-claude/effort | 中 |
評価・品質
| ページ | パス | 優先度 | |
|---|---|---|---|
| ✅ | Define success criteria and build evaluations | test-and-evaluate/develop-tests | 最高 — evals の起点 |
| ✅ | Reduce hallucinations | test-and-evaluate/strengthen-guardrails/reduce-hallucinations | 高 |
| ✅ | Increase output consistency | test-and-evaluate/strengthen-guardrails/increase-consistency | 中 |
| ✅ | Mitigate jailbreaks and prompt injections | test-and-evaluate/strengthen-guardrails/mitigate-jailbreaks | 中 |
| ✅ | Reducing latency | test-and-evaluate/strengthen-guardrails/reduce-latency | 中 |
その他
| ページ | パス | 優先度 | |
|---|---|---|---|
| ✅ | Choosing the right model | about-claude/models/choosing-a-model | 中 |
| ✅ | Securely deploying AI agents | code.claude.com agent-sdk/secure-deployment | 中 |
| ✅ | Use case guides（分類、ticket routing、content moderation 等） | about-claude/use-case-guides/overview | 中 |
| ✅ | Prompt library | code.claude.com prompt-library | 低 |
4. ブログ・その他（Engineering 以外）
| 資料 | URL | 優先度 | |
|---|---|---|---|
| ✅ | Best practices for prompt engineering | https://claude.com/blog/best-practices-for-prompt-engineering | 高 — Claude 非依存の一般論 |
| ✅ | A harness for every task: dynamic workflows in Claude Code | https://claude.com/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code | 高 — Claude Code チーム自身の使い方 |
| ✅ | How Anthropic teams use Claude Code (PDF) | https://www-cdn.anthropic.com/58284b19e702b49db9302d5b6f135ad8871e7658.pdf | 中 — 社内事例集 |
| ✅ | prompt-eng-interactive-tutorial | https://github.com/anthropics/prompt-eng-interactive-tutorial | 中 — 手を動かす用 |
| ✅ | claude-cookbooks | https://github.com/anthropics/claude-cookbooks | 中 — 実装レシピ |
5. 維持
§1〜§4 の原典はすべて取り込み、topics/ も執筆済み。 残る作業は鮮度の維持だけ。
5.1 topics/
**10本を執筆済み。**一覧と、意図的に統合していない4本の理由は topics/README.md にある。
各 topic の synthesizes frontmatter が、統合した原典を機械可読な形で持つ。
原典を更新したら grep して該当 topic を直す:
grep -l 'writing-tools-for-agents' topics/*.md5.2 鮮度の維持
./scripts/freshness-check.sh で URL の生存 / fetched の古さ / wikilink の解決 /
引用の訳漏れをまとめて確認できる。whats-new の最新エントリだけは目視（DECISIONS.md #2）。
月1回が妥当。fetched の90日閾値だけに頼ると、変化の速い3領域（auto mode / permission、
subagent の既定、モデルの既定）が取り残される（DECISIONS.md #6）。
digest は再取得のトリガーにのみ使い、記述の根拠にしない（DECISIONS.md #3）。
5.3 未取得のまま残しているもの
各 sources/ の「未取得の派生リンク」節に、原典から辿れるが未読のページを記録してある。
主なものは Agent SDK 系（agent-sdk/*）、plugin 系（plugins、plugin-marketplaces）、
運用系（sessions、worktrees、monitoring-usage、env-vars、cli-reference）、
API リファレンス系（structured-outputs、streaming、token-counting、extended-thinking）。
必要になったときに §0 の索引ファイル（llms.txt）から辿るのが速い。