Claude Code と使うパーソナルOS
このスキルは「brain」、つまり Claude Code があなたから委ねられた情報を整理し、過去の決定を振り返り、次の一手を準備するための Markdown ファイル群（あらゆるエディタで読めるテキストファイル）を構築するのに役立ちます。最初はシンプルな質問から始め、後はコピーして使えるテンプレートを提供する、ステップバイステップのガイドです。
読み方の原則：初回はステップを順番に実行してください。references/ 内のファイルに詳細とテンプレートがあります。必要に応じて参照してください。
0. 目的と得られるもの
記憶がなければ、Claude との会話は毎回ゼロから始まります。brain があれば、会話は「使い捨て」になり、フォルダ自体が記憶となります。重要なことはすべてファイルに書き込まれ、Claude は応答の前にそれらのファイルを読み込みます。
セットアップ完了後に得られるもの：
- 受信箱（
inbox/）：会議の文字起こし、メモ、コピーしたメール、スクリーンショットなど、あらゆる生の情報を放り込める場所。 - 4カテゴリへの分類：決定（理由付き）、アクション（担当者付き）、新しい事実、未解決の質問。
- 追記専用の記録：ジャーナル、意思決定ログ、タイムラインは決して上書きされず、追加のみ。
- トピックシートと自動生成ビュー：プロジェクトごとのファイルと、小さなスクリプトで再生成される集計テーブル。
- 専用エージェントとショートカットコマンド：取り込み、ボードレビュー、整合性チェック、執筆、1on1準備、意思決定アドバイス、および
/inbox、/journalなどのコマンド。 - 変更履歴（
CHANGELOG.md）：外部ツール（Wiki、チケット管理ツール、プレゼンテーションなど）に報告すべき変更点を記録。
あなたの同意なしには何も書き込まれません。Claude が提案し、あなたが承認し、そして Claude が書き込みます。
1. 前提条件
- マシンに Claude Code がインストールされ、動作していること（ターミナルで
claudeコマンドが使用可能）。 - 空のフォルダ（例：
~/brain）があること。このプロジェクトでは、このフォルダのみが Claude の書き込み可能領域となります。 - ビュースクリプト用に Python 3（オプション、追加インストール不要）。
- Markdown を開けるテキストエディタ。Git リポジトリを推奨（変更を元に戻せるため）しますが、必須ではありません。
空のフォルダでターミナルを開き、claude を実行してください。
2. 初期インタビュー
Claude は以下の7つの質問を、それぞれあなたの回答を待ってから次の質問に進みます。簡潔な回答で構いません。各回答がどのように使われるかを以下に示します。
| 質問 | Claude が行うこと |
|---|---|
| 1. あなたの役割とチームを一文で教えてください。 | CLAUDE.md の「私について」セクションを埋め、Claude が適切なレベルで話しかけられるようにします。 |
| 2. 現在進行中のプロジェクトを3～5つ教えてください。 | 05_scope/sheets/ にプロジェクトごとのトピックシートを作成します。 |
| 3. 最も頻繁にやり取りする人の名前（名前と役割）を教えてください。 | 03_team/directory.md を埋め、確認すべき名前のリストを準備します。 |
| 4. どのような種類の情報を受け取りますか？（文字起こし、メール、メモ、スクリーンショットなど） | inbox/ の分類ルールと、Claude が読み取れるフォーマットのリストを設定します。 |
| 5. 成果物をどこに報告しますか？（Wiki、チケット管理ツール、プレゼンテーションなど） | CHANGELOG.md を調整します。更新対象のページごとに1行、「追加」または「置換」の指示を記載します。 |
| 6. どの言語で書き、どのような文体ルールを適用しますか？ | CLAUDE.md の「文体」セクションを埋めます。 |
| 7. どのくらいの頻度でレビューを希望しますか？（毎日、毎週、1on1前など） | 最初にインストールするコマンドとエージェントを選択します（ステップ5）。 |
先に進む前に、Claude は理解した内容を10行程度で要約し、あなたの承認を待ちます。
3. 構造の作成
Claude は references/structure.md に記載されたディレクトリ構造を提案し、あなたの承認後に作成します。基本ディレクトリは以下の通りです：
inbox/とarchive/：生情報の保管場所と、処理後の保管場所。00_journal/：ジャーナルとタイムライン（追加のみ）。01_steering/：タスクボードを含む、プロジェクト運営。02_product/：プロダクトに関する永続的な事実。03_team/：連絡先とコラボレーションノート。04_decisions/：意思決定ログ（追加のみ）。05_scope/：トピックシートと生成ビュー。06_resources/：用語集、参考資料。scripts/：ビュースクリプト。.claude/：エージェントとコマンド。
黄金律：1ファイル＝1トピック、トピック名は中立に。個人名がファイル名になることはありません。個人に関する情報はディレクトリに格納されます。
次に、references/templates/ からテンプレートをコピーし、角括弧 [] で囲まれたフィールドをステップ2の回答で置き換えます。
4. 指示ファイル CLAUDE.md の作成
CLAUDE.md は Claude Code がセッション開始時に自動的に読み込むファイルです。ルールを記述します。テンプレート references/templates/CLAUDE.md を基に、少なくとも以下が含まれていることを確認してください：
- あなたが誰か、Claude がどのように話しかけるべきか。
- 新しい情報が届いたときの Claude の対応（取り込みプロトコル、詳細は
references/ingestion-rules.md参照）。 - 鮮度ルール、追記専用ファイル、「1つの事実＝1つのファイル」のルール。
- ステップ9の安全ルール。
- 質問6で選んだ文体。
- 文字起こしツールでよく誤変換される固有名詞のリスト（随時追加）。
このファイルは簡潔に保ち、1～2ページに収めます。詳細は references/ 内のファイルに記述し、Claude が必要に応じて参照します。
5. エージェントとコマンドの追加
エージェントは、独自の指示と権限を持つ専門アシスタントです。コマンドは、Claude Code で入力するショートカット（例：/inbox）です。どちらも .claude/ 内の単純な Markdown ファイルです。
小さく始めましょう。最初に以下をインストールします：
- エージェント
inbox-ingestionとコマンド/inbox（受信箱の処理用） - コマンド
/journal（素早いメモの記録用）
必要に応じて、board-review、consistency-check、deliverables-writer、meeting-prep、decision-advisor、およびコマンド /review-board、/prep-1to1、/propagate を追加します。各エージェントの役割は references/agents.md に、コピー用テンプレートは references/templates/.claude/ にあります。
追加後は、必ず Claude に /agents と入力してファイルが読み込まれているか確認してもらいます。
6. 最初のテスト：ノートをドロップして処理させる
- 実際のノート（短くても良い）を
inbox/に書き込むか貼り付けます。例：inbox/2026-01-15_チームミーティング.txt。 /inboxと入力します。- Claude がファイルを読み込み、疑わしい箇所を特定し、既存情報と照合し、修正案を番号付きリストで提示します。各修正案には、ファイル名、変更前、変更後、ソースが含まれます。
- 「1、2、4 を承認」または「すべて承認」と回答します。明確な回答がない限り、何も書き込まれません。
- Claude が書き込み、元のファイルを
archive/に移動し、CHANGELOG.mdに処理内容を記録し、ビュースクリプトを再実行します。
完全なプロトコルは references/inbox-processing.md にあります。生のノートと結果を含むエンドツーエンドの例は references/example-acme/ にあります。
7. ルーティン
最初は4つのルーティンで十分です。
- 毎日（5分）。届いた情報を
inbox/にドロップし、/inboxを実行し、承認します。一日の終わりに/journalで自由ノートを記録します。 - 会議後。文字起こしやメモをドロップし、
/inboxを実行します。まず意思決定とその理由を確認し、次にアクションとその担当者を確認します。 - 毎週。
/review-boardを実行し、その後consistency-checkエージェントに日付、ステータス、名前のチェックを依頼します。ビュースクリプトを再実行します。 - 1on1前。
/prep-1to1 [名前]と入力します。meeting-prepエージェントが、これまでに話されたこと、保留中のタスク、未解決の質問を、それぞれのソース付きでまとめます。
8. 進化させる
- トピックの追加。
references/templates/scope-sheet.mdを05_scope/sheets/にコピーし、フィールドを埋め、ビュースクリプトを実行します。 - エージェントの追加。
references/templates/.claude/agents/からテンプレートをコピーし、名前、説明、指示を変更します。採用前に実際のケースでテストします。 - ビューの追加。トピックシートを読み取り、テーブルを生成する小さなスクリプトを作成するか、作成させます。スクリプトはシートを読み取りのみで、決して変更しません。
references/scripts/build_views.pyが出発点として役立ちます。 - 複数のコンテンツに影響する変更。
/propagateを使用します（references/use-cases.mdにユースケースがあります）。
何かを追加する前に、自分に4つの質問をしてください。それは、決定とその理由を失うことを防ぎますか？それは、各プロジェクトの次のアクションと担当者を教えてくれますか？それは、トピック間の切り替えの労力を減らしますか？それは、チームにとって有益な痕跡を残しますか？すべての答えが「いいえ」の場合、追加しないでください。
9. 安全ルール
- 提案、承認、実行。Claude は最初に変更内容を提示します。あなたの明示的な承認後、書き込みます。
- 決して捏造しない。テキストにない決定やアクションは作成しません。決定の理由が不明な場合は、「理由は未記録」と記載します。
- 疑わしい箇所を報告する。箇所が曖昧だったり、名前が文字起こしの誤変換のように見える場合、Claude はそれを指摘し、決定を下さずに質問します。
- 承認なしに削除しない。所定のフロー（inbox から archive へ）以外でのファイルの削除や移動は、あなたが要求しない限り行われません。
- 事実、約束、アイデアを区別する。完了したこと、誰かに約束したこと、検討中のことは、3つの異なるステータスです。Claude の提案が約束として提示されることはありません。
- 出典を保持する。重要な各行はそのソース（ファイル、日付）を参照します。
チェックリスト
- brain フォルダで
claudeを起動し、CLAUDE.mdを読み込む。 - ステップ2の7つの質問に回答し、要約を承認した。
- ステップ3のディレクトリが存在し、個人名のファイルがない。
-
CLAUDE.mdでジャーナル、意思決定ログ、タイムラインが「追加のみ」と宣言されている。 - 鮮度ルールと「1つの事実＝1つのファイル」ルールが
CLAUDE.mdに含まれている。 - エージェント
inbox-ingestionとコマンド/inboxが/agentsとコマンド一覧に表示される。 - 最初のテストが完了している（提案、承認、書き込み、アーカイブ、
CHANGELOG.mdへの追記）。 -
python3 scripts/build_views.pyがエラーなく実行され、ビューを生成する。 - ステップ7の4つのルーティンが、自分が確認できる場所にメモされている。
- ステップ9の安全ルールが
CLAUDE.mdにコピーされている。
スキルファイル
| ファイル | 内容 |
|---|---|
references/structure.md | 推奨ディレクトリ構造と各ディレクトリの役割 |
references/ingestion-rules.md | 取り込みルール（変更前後の例付き） |
references/inbox-processing.md | 受信箱ファイルの処理プロトコル（完全な例） |
references/agents.md | 6つのエージェントのカタログ |
references/use-cases.md | 7つの使用シナリオ |
references/templates/ | コピー用テンプレート（指示、ボード、ログ、ジャーナル、シート、エージェント、コマンド） |
references/scripts/build_views.py | ビュー生成スクリプト |
references/example-acme/ | 架空の完全な brain の例 |