エージェントとの作業で最もコストがかかるのは、コンテキストを再説明することです。毎朝、昨日の決定を再説明し、最後のコミットメッセージを貼り付け、どのバグがデプロイをブロックしているかを再確認します。これをすべてのセッションで繰り返すと、隠れたコストは週に数時間になり、数分ではありません。
STATE.mdはその負担をなくします。1つのファイルで、すべてのセッションの終わりに更新され、次のセッションの開始時にロードされます。規律: セッションを閉じる前に、3分間ファイルを更新します。明日、その3分が20分を節約します。
STATE.mdは3つのことだけを保持し、それ以上は保持しません。
決定事項: 何を決定し、その理由。理由がなければ、将来のあなたはその決定を再検討します。「日次ダイジェストにはcronではなくPostgresトリガーを使用: トリガーはトランザクション性があり、cronは書き込みパスと競合する。」
進行中: 半分完了したもので、引き継ぎに十分な具体性のあるもの。「マイグレーション014は/migrations/014_add_subscription_columns.sqlに記述されているが、まだ適用されていない。Webhookハンドラーが稼働する前に実行する必要がある。」
ブロッカー: 前進を妨げるもの、試したことも含む。「テスト環境でStripeのWebhook署名が失敗している。生のボディパーサーを試したが、まだ400。次: Vercelプレビューで環境変数を確認する。」
60〜80行に制限してください。解決したら削除します。出荷したらアーカイブします。
更新の規律。 自分に思い出させるためにStopフックを追加します:
{
"hooks": {
"Stop": [
{
"command": "echo 'Before you close: update STATE.md with decisions, in-flight, and blockers from this session.'"
}
]
}
}リマインダーだけでは不十分です。習慣は自動的でなければなりません。最も速い方法は、5回連続で実行することです。6回目のセッションまでには、更新せずに閉じると違和感を感じるでしょう。その不快感が習慣が形成された合図です。
MEMORY.mdは、永続的なすべてのもののインデックスです。各エントリは、別のファイルを指す1行です。4つのタイプ:
user_*: あなたに関する永続的な事実: タイムゾーン、キャリアのコンテキスト、好み。user_location.md
feedback_*: 失敗から学んだルール、信頼度フィールド付き。0.3から開始し、パターンが繰り返されたら0.5に上げ、0.9+でCLAUDE.mdに昇格。feedback_public_endpoints_need_rate_limits.md
project_*: 1つのプロジェクトの日付付き状態と決定事項。出荷時にアーカイブ。project_stripe_integration_2026_05.md
reference_*: 人、ツール、APIのルックアップテーブル。reference_neon_db_config.md
各インデックス行を200文字未満に、インデックスを200行未満に保ちます。それを超えると、エントリが切り詰められ、Claudeはそれらを見ることができません。
STATE.mdは今のため。MEMORY.mdは常にのため。 大まかなルール: スタンドアップで言うことならSTATE.mdに入れます。Wikiやオンボーディングドキュメントに書くことならメモリファイルに入れます。スタンドアップは一時的なものですが、Wikiは永続的なものです。
プロジェクトが出荷され、STATE.mdにまだ5行残っている場合は、それらの行を日付付きのproject_*メモリファイルに移動してクリアします。プロジェクトが重要でなくなったわけではなく、現在の状態ではなくなっただけです。この区別がSTATE.mdを役立つものに保ちます。
ジャーナルではなく状態を記述します。 ジャーナルエントリ: 「Stripe統合に取り組んだ。難しかった。」状態エントリ: 「Webhookエンドポイントはapp/api/webhooks/stripe/route.ts。署名検証はローカルでは機能するが、Vercelプレビューでは失敗する（生のボディ形式が間違っている）。次: rawBodyミドルウェア設定を確認する。」一方は次のセッションに開始点を与え、もう一方は回顧録を与えます。
さらに2つのアンチパターン: 新しいセッションが実行できる具体的な次のアクションがない進行中のエントリ、および同じトピックのセッション間での重複エントリ。重複をマージします: 1つのトピック、1つのエントリ、現在の状態のみ。
良いセッション更新は9〜12行です: 理由付きの決定事項1つ、次のステップ付きの進行中の項目1つ、試したことを含むブロッカー1つ。
50個のメモリファイルを超えてスケーリングする場合: ダイジェスト層。 各MEMORY.mdポインタ行は約100〜150トークンかかります。200行で純粋なポインタだけで20〜30Kトークンになります。解決策: STRATEGY-DIGEST.md。これは、すべての主要なドキュメントの2〜3文の要約と「使用時:」フィールドです:
## q2-positioning.md
Q2のポジショニングは、中堅市場の営業組織におけるAI活用をターゲットとしています。
使用時: ターゲット顧客、価格設定、リードの適格性について議論する場合。Claudeはダイジェスト（約3Kトークン）を読み取り、関連する場合にのみ完全なドキュメントをロードします。25個の戦略ドキュメントがある場合、50Kではなく3Kトークンになり、セッションは高速に保たれます。「使用時:」フィールドはルーティングメカニズムです: ファイルの説明ではなく、特定のトリガー条件として記述します。
STATE.mdは現在の状態（決定事項、進行中、ブロッカー）を80行未満で捕捉します。セッション終了時に更新し、履歴は速やかにアーカイブします。MEMORY.mdは永続的な知識を4つのタイプ（ユーザー、フィードバック、プロジェクト、参照）でインデックス化し、200行に制限します。今夜、決定事項1つ、進行中の項目1つ、ブロッカー1つの3行から始めましょう。習慣が形成される間は、3行がゼロよりも優れています。