~/.claude の構成要素マップ
ハーネスの考え方（Agent = Model + Harness）と分類の物差し（Guides と Sensors）を踏まえて、この章では実際の ~/.claude/ ディレクトリに何が置かれているかを地図にします。次章以降でコマンドの流れを追うとき、「いま発火したファイルはこのマスにある」と参照できる索引です。
以下の個数は筆者の環境を実測した値です（2026-06-12 時点。hook は ls hooks/*.sh、rule は frontmatter の有無で集計）。ハーネスは育てるものなので、数は増減します。「だいたいこの規模感」として読んでください。
構成要素の一覧
「区分」列は凡例の 3 区分です。🔧 = 筆者の自作、📦 = Claude Code 標準の機構、🌐 = 外部リポジトリ由来。
| 要素 | 置き場所 | 役割 | 発火のきっかけ | 区分 | 分類 |
|---|---|---|---|---|---|
CLAUDE.md | ~/.claude/CLAUDE.md | 全体の方針・アイデンティティ | 常時ロード（起動時に必ず読まれる） | 🔧 | Inferential Guide |
| rules（34 件） | ~/.claude/rules/*.md | 守るべき規範 | 7 件は常時、27 件は対象ファイルを開いたとき | 🔧 | Inferential Guide |
| skills（39 件 = 自作 25 + 外部 14） | ~/.claude/skills/*/SKILL.md | 手順をパッケージ化したコマンド | 発話のトリガー語、または /名前 | 🔧 + 🌐 | Inferential Guide |
| agents（7 役割） | ~/.claude/agents/*.md | 専門の subagent | main agent が委任を判断したとき | 🔧 | Inferential（生成 or 評価） |
| hooks（17 本、うち 5 本は本章執筆直後の事故対応で追加） | ~/.claude/hooks/*.sh | 自動実行スクリプト | settings.json に登録されたイベント | 🔧（イベント機構は 📦） | Computational |
| MCP | 外部サーバー | 公式ドキュメント取得・構造化推論など | ToolSearch で必要時にロード | 📦（サーバー選定・用途の取り決めは 🔧） | Inferential ツール |
| memory | learnings/ projects/.../memory/ context/ | セッションをまたぐ学び | /learn / 自動 / handoff | 📦 + 🔧 | 永続化 |
| references | ~/.claude/references/*.md | 詳細プロトコル・テンプレート | 必要時に Read で取得 | 🔧 | 補助資料 |
| docs/adr | ~/.claude/docs/adr/*.md | 設計判断の記録 | 重要決定時に追記・参照 | 🔧 | 記録 |
skills の 39 件のうち 14 件は、外部リポジトリ（Anthropic / Addy Osmani / Vercel Labs）から取り込んだものです（🌐）。これらは skills/ATTRIBUTION.md という管理ファイルで出典と license を追跡しています。「他人の作例を自分のハーネスに組み込む」ときも、出どころを記録しておくと後から育てやすくなります。
全体の関係図
実線が「呼び出しの流れ」、点線が「hook の割り込み」です。hook はどの段階にも横から差し込まれるので、図では点線で表しています。
主役と脇役の subagent
agents/ には 7 つの役割が定義されています。後の章で扱う「実装する人と評価する人を分ける」設計（Generator-Evaluator 分離）の土台です。
- 生成役（Generator）:
implementer（実装）、refactorer（リファクタ） - 評価役（Evaluator）:
code-reviewer/architect/test-strategist/infra-reviewer - 両方（調査して直す）:
debugger（バグ調査・修正）
このほか ~/.claude/teams/ には、複数の subagent をセットで並列起動する team 定義が 1 件（multi-perspective-review）あります。詳細は subagent と役割分担 で扱います。
/debug と subagent の debugger は別物このガイドの背骨は skill の /debug です。よく似た名前の debugger subagent もありますが、こちらは大量コードを別コンテキストで隔離調査する専門エージェントです。/debug は「いまの作業環境で即座に調査」、debugger は「隔離環境でじっくり」と役割を分けています（次章で再確認します）。
ここまでで地図は揃った
要素の名前・置き場所・発火条件が頭に入れば、準備は完了です。次章からは、/debug を 1 回実行したときに、この地図のどこが、どの順番で光るのかを追っていきます。
要点は次のとおりです。
- ハーネスは
CLAUDE.md/ rules / skills / agents / hooks / MCP / memory / references / docs/adr で構成される - 常時効くもの（
CLAUDE.md・7 rule）と、条件付きで効くもの（27 rule・skills・MCP）がある - hook はどの段階にも横から割り込む決定的な仕掛け
- subagent は「生成役」と「評価役」に分かれている
続いて 発話から skill 起動 に入り、/debug の実行フローを時系列で追います。