OthmanAdi/planning-with-files

解決する課題

このプロジェクトは、AIコーディングエージェントにおける「コンテキストの劣化」とメモリ損失の問題を解決します。エージェントのコンテキストウィンドウがいっぱいになったり、ユーザーが /clear コマンドを実行したり、エージェントがクラッシュしたりすると、通常、エージェントは現在のタスク、進捗、および調査結果を見失います。このツールは、揮発性のRAMだけに頼るのではなく、エージェントの計画状態をローカルディスクに永続化します。

仕組み

このプロジェクトは、エージェントの永続的な外部メモリとして機能する「3ファイルパターン」 (task_plan.md, findings.md, progress.md) を実装しています。ライフサイクルフックを使用して、各ターンの開始時にこれらのファイルをエージェントのコンテキストウィンドウに自動的に注入します。状態はファイルシステム上の標準的な Markdown ファイルとして保存されるため、エージェントがセッションをリセットしても状態は保持され、中断した場所から正確に再開できます。

対象ユーザー

Claude Code, Cursor, GitHub Copilot、またはその他のCLIベースのエージェントを使用して、単一のコンテキストウィンドウの容量を超える長時間または複雑なコーディングタスクを行う開発者、あるいはセッションの中断に対する耐性を必要とする開発者向けに設計されています。

ハイライト

• 永続的な状態： タスク計画、調査結果、進捗ログをディスクに保持し、/clear コマンドやクラッシュ後も存続します。
• 幅広い互換性： Agent Skills 標準を通じて60以上のエージェントとIDEをサポートし、Claude Code, Qoder, Hermes などのツール向けのネイティブプラグインを提供します。
• パフォーマンスの最適化： フックは速度（300ms以下）が最適化されており、モデルの注意ウィンドウ内での安定性を維持します。
• 実証済みの有効性： 96.7%のアサーション合格率でベンチマークされ、ブラインドA/Bテストで成功が実証されています。