軽量で依存関係のないプロンプト：AIエージェントがコンテキストを失うのを防ぐ

複数のセッションにわたって動作するAIコーディングエージェントにとって、コンテキストの一貫性を維持することは重要な課題です。新しいプロンプト規約は、逆のポリシーを持つ2つの文書を使用するというシンプルながらパワフルな解決策を提案します。最初の文書は追記専用の設計ログ（DESIGN.md）であり、作業単位ごとに番号付きの日付入りセクションが追加され、以前の内容は決して編集されません。エラーが発見された場合、新しいセクションが番号で参照して訂正しますが、元の誤った文章は残されます。各セクションは、意図的にスキップした項目、延期したもの、未検証のものを列挙した明示的な「未完了」リストで終わらなければなりません。2番目の文書はその場で編集されるインデックス（CLAUDE.mdまたはAGENTS.md）であり、各セッションで自動的にロードされ、現在のルールと少数の重要な事実を含みます。このパターンにより、推論の履歴は完全に保たれ、エージェントは常に最新のガイダンスを持ちます。

この規約は実際のプロジェクトから派生し、数十のセッションと約60のセクションを経て進化しました。その核心的なメカニズムは、安価な自己修正にあります。過去のエラーを遡って編集する必要がないため、エージェントは誤りを認めやすくなります。さらに、未完了リストはプロジェクトに隠れた20%の問題を強制的に露呈させ、エージェントが成功部分だけを報告するのを防ぎます。番号システムにより、「後のセクションが優先」というルールが実行可能になり、矛盾は大きな番号によって自動的に解決されます。

しかし、この方法には代償もあります。追記専用ログは長くなり、誤った記述を含むことになります。ログを最初から最後まで読んだ人は誤った印象を持つかもしれません。そのため、2番目の文書が重要であり、現在の真実を提供し、ログへの入り口として機能します。著者は、ログをクリーンアップしたり圧縮したりしないように強調しています。なぜなら、既知のエラーを含む古いセクションを含む一見乱雑な記録こそがシステムの価値であり、決定の履歴と文脈を保持しているからです。

この規約は、特にエラーが発生しやすく、後になって発見される複雑なプロジェクト、例えば移植、リバースエンジニアリング、プロトコル開発、パフォーマンスチューニングなどに最適です。短く明確な作業では利益は限定的です。主な3つの失敗モードは、セクションに番号がない、ロードされるファイルにログへのポインタがない、「未完了」リストがあいまいな「将来の作業」に退化することです。各セッションの開始時に規約を参照することで、ログが継続的に読み書きされることが保証されます。著者はまた、DESIGN.mdでの作業ログの維持、CLAUDE.mdでの参照行の追加、コミットメッセージのフォーマット調整など、正確な開始手順を提供しています。この規約は特定の言語やドメインに依存せず、その成功は複数セッションにわたる作業、高価な再導出、後になって発見されるエラーの可能性にかかっています。要するに、この2文書パターンは、長期プロジェクトにおいてAIエージェントのコンテキストと信頼性を維持するための実用的で実証済みの方法を提供します。