AI（LLM / エージェント）を使う際の実践知を、Anthropic の一次情報から自分で読んでまとめた知識ベース。 原典 78本、テーマ別の統合 10本。記述は日本語、technical term は英語のまま。
原典からの引用は英文をそのまま残し、直下に訳を併記している。原文で照合できるようにするため。
どこから読むか
| 何が得られるか | |
|---|---|
| QUOTES | まずこれ。 Anthropic 自身の言葉 57件を、読む順に並べたもの。5分で「何が問題で、何が答えとされているか」が通る |
| PRINCIPLES | 作業を始める前に。 命令形・判断基準になる一文だけ 38件。迷ったときに眺める |
| OVERVIEW | 78本を1ページに圧縮。数字・判断の早見表・モデル世代の落とし穴・原典どうしの食い違い。ここだけ読んでも実務は回る |
| SOURCES | 原典の台帳。どこに何があるか、優先度つき |
テーマ別に深掘りする
「結局どうすればいいか」を、複数の原典を横断して書いたもの。
| topic | 扱う問い |
|---|---|
| context-engineering | context をどう配分するか。何を入れないか |
| agent-design | エージェントにするか、どこまで委譲するか |
| tool-design | ツールをどう設計し、増えたときどうするか |
| evals | 何をどう測るか。grader の作り方 |
| prompting | プロンプトと出力の制御 |
| model-migration | モデル世代をまたぐとき何を剥がすか |
| claude-code-workflow | Claude Code の日常運用 |
| user-config | ~/.claude に何を置き、何を置かないか |
| writing-for-agents | CLAUDE.md と skill の書き方 |
| security | prompt injection への多層防御 |
目的別の入口
| やりたいこと | 見る場所 |
|---|---|
| これから学ぶ | building-effective-agents → effective-context-engineering-for-ai-agents → writing-tools-for-agents → agent-skills-best-practices |
| Claude Code をうまく使う | claude-code-best-practices 一本で足りる |
| API でエージェントを組む | claude-prompting-best-practices → develop-tests → manage-tool-context → effort |
| 用語を引く | glossary |
| コピペできるプロンプト | prompt-library |
このリポジトリを保守する
鮮度確認は ./scripts/freshness-check.sh（月1回）。URL の生存 / fetched の古さ / wikilink の解決 / 引用の訳漏れをまとめて見る。