個人AIエージェント構築のための100のヒント：クラウドプロトタイプから本番環境へ

ある開発者が、6週間かけて個人用AIエージェントをゼロから構築しました。チャットボットのラッパーではなく、タスク管理、取引追跡、メール読み取り、ビジネスデータ分析、漏れた項目のプロアクティブな通知を行う永続的なアシスタントです。プロジェクトはクラウド（共有メモリファイル、リッチなコンテキストウィンドウ、カスタムスキルを備えたClaude Projects）で始まり、その後VS Code内のClaude Codeに移行し、ローカルファイルアクセス、gitトラッキング、シェルフック、スケジュールされたヘッドレスタスクが可能になりました。移行により、存在すら知らなかった問題を解決せざるを得なくなりました。これらの100のヒントはその成果を凝縮したもので、Claudeの最大使用量は当初の開発100％・実世界0％から6週間後には20％・80％にシフトしました。

基盤とアイデンティティ（1～8）

• システムプロンプトではなく憲法を書く。システムプロンプトはコマンドを列挙するもの。憲法はルールを説明するもの。エージェントがルールでカバーされないエッジケースに遭遇したとき、憲法から推論するため推測に頼らない。これにより、優雅に劣化するエージェントと自信満々に幻覚を見るエージェントが区別される。
• エージェントに名前、口調、役割を与える。例：「常に一人称。直接的。感情よりデータ。フィラーフレーズなし。後続の要約なし。」これにより、セッションごとに数百のマイクロ判断が削減され、監査のための一貫性が生まれる。
• ハードルールと行動ガイドラインを分離する。ハードルールは専用セクションに。決して上書きされない。行動ガイドラインは適応する。混在させると両方とも意味をなさなくなる。
• 主たるユーザーを深く定義する。エージェントは誰に仕えるのか？何がその人を苛立たせるのか？どのように決定するのか？例：「データで判断し、直感ではない。単一の推奨ではなく、スコア付きの代替案を求める。曖昧な回答を嫌う。」
• 能力マップとコンポーネントマップを別々に構築する。能力マップ：エージェントができること（スキル、統合、自動化）。コンポーネントマップ：どのように構築されているか（ファイル、接続）。混同すると、3ヶ月後には役に立たない文書になる。
• エージェントが何でないかを定義する。「要約者ではない。イエスマシンではない。検索エンジンではない。尋ねられるのを待たない。」否定的な定義は、汎用的な親切さへの漂流を防ぐ。
• THINK（考える）とDO（実行する）のメンタルモデルを構築する。不確かなとき→THINK（分析、草案、準備）。明確なとき→DO（実行、作成、発信）。決して固まらない。最もリスクの低いレベルで行動をデフォルトとし、結果を表面化させる。
• アイデンティティファイルをgitでバージョン管理する。設定に対して git blame を実行することで、特定の編集に起因する行動の退行をデバッグできる。

メモリシステム（9～18）

• メモリにはデータベースではなくフラットマークダウンファイルを使用する。読みやすく、grep可能、git追跡可能、エージェントが直接読み込める。インフラ層不要。
• メモリは日付ではなくドメインで分離する。例えば entities_people.md、entities_companies.md、entities_deals.md、hypotheses.md、task_queue.md などのファイル。1ファイル＝1ドメイン。時系列ダンプは2週間で検索不可能になる。
• MEMORY.md インデックスファイルを構築する。各メモリファイルを1行説明付きで列挙した単一のインデックス。エージェントは最初にインデックスを読み込み、必要に応じて特定のファイルを取得する。これによりコンテキストウィンドウの使用量を予測可能に保つ。
• 「キャッシュ」と「信頼できる情報源」を明示的に区別する。すべてのキャッシュファイルに last_sync: タイムスタンプを付ける。例えば、ローカルの deals.md はCRMのキャッシュであり、CRMがSSOT（信頼できる唯一の情報源）である。