planning-with-files: コンテキスト消去時に AI コーディングエージェントが複雑なタスクの追跡を失わないようにする永続的なファイルベースのプランニングスキル

解決する課題

AI コーディングエージェントは、コンテキストの喪失、クラッシュ、またはメモリ消去（例: /clear 使用時）に悩まされ、複雑で多段階のタスクの進行状況を失うことがあります。このプロジェクトは、永続的なファイルベースのプランニングシステムを提供し、エージェントがセッション間で状態と進捗を保持できるようにします。

仕組み

システムは「スキル」を実装し、エージェントにディスク上の 3 つの特定の Markdown ファイル（task_plan.md、findings.md、progress.md）を保持させます。プランと進捗を会話履歴とは別に外部保存することで、クラッシュやコンテキストクリア後にエージェントは状態を復元できます。SKILL.md 標準を介して 60 以上のエージェントと統合し、ライフサイクルフックを使用して重要なタイミングで現在のプランをエージェントのコンテキストに注入します。

対象ユーザー

長時間にわたる複雑なソフトウェアエンジニアリングタスクに取り組み、構造化されたプランニングと永続性が必要な AI コーディングエージェント（Claude Code、Codex、Pi、Copilot など）を使用する開発者向けです。

ハイライト

• コンテキストサバイバル: クラッシュや手動のコンテキストクリア時に進捗喪失を防止。
• 広範な互換性: SKILL.md 標準を使用して 60 以上のエージェントにインストール可能。
• 自律モードとゲートモード: プランが実際に完了するまでエージェントの停止を防ぐオプトインの完了ゲートを搭載。
• 改ざん保護: SHA-256 ハッシュ認証を使用してプランをロックし、ファイルが改ざんされた場合の注入をブロック。
• セッション復旧: コンテキストを迅速に復元するセッションキャッチアップコマンドを含む。

---

要約: AI コーディングエージェント向けの永続的なファイルベースプランニングスキルで、Markdown ファイルを使用してコンテキスト喪失を防止し、セッション間で進捗を追跡します。

タイトル: planning-with-files: コンテキスト消去時に AI コーディングエージェントが複雑なタスクの追跡を失わないようにする永続的なファイルベースのプランニングスキル