オーケストレーター役のAIエージェントが、インストール済みのコーディングCLIにタスクを委任し、差分を確認して自分でコミットできるエージェントスキル集です。
OthmanAdi/planning-with-files
AIコーディングエージェント向けのファイルベースの計画スキル。タスク計画をディスクに保存するため、コンテキストのリセットや/clear、クラッシュ後も維持できます。
- スター
- 27,923
- フォーク
- 2,313
- 未解決の Issue
- 11
- 最終コミット
- 3 日前
これは何?
Planning with Filesは、タスクの計画、調査メモ、進捗をプロジェクト内の3つのMarkdownファイル(task_plan.md、findings.md、progress.md)に保存する、AIコーディングエージェント向けのスキルです。状態はコンテキストウィンドウではなくディスク上にあるため、/clearやコンテキストの圧縮、クラッシュの後でも、エージェントは現在のフェーズから作業を再開できます。
ライフサイクルフックによって各ターンの開始時に進行中の計画のコンテキストが再注入され、完了チェックで計画の各フェーズが完了しているかを確認できます。並行タスクでは、アクティブな計画を指すポインターで選択した、.planning/配下の別々のディレクトリを使用できます。自動復旧ではプロジェクトファイルのみを読み込み、ローカルのエージェントセッション記録を読むには明示的にcatchupモードを指定する必要があります。
npx skills、Claude Codeのプラグインマーケットプレイス、またはnpmからインストールできます。Claude Code、Codex CLI、Cursor、OpenCode、Hermes Agentなどとのネイティブなプラグイン連携に対応し、複数の言語に翻訳されたバージョンもあります。
主な機能
- 01計画、調査結果、進捗をプロジェクト内のMarkdownファイルに保存
- 02ライフサイクルフックを使い、各ターンで進行中の計画を再注入
- 03/clear、コンテキスト圧縮、セッションのクラッシュ後に計画を復旧
- 04すべての計画フェーズが完了したかを完了チェックで報告
- 05並行タスク用に計画ディレクトリを分離
- 06Agent Skills標準を通じて多数のコーディングエージェントにインストール
ユースケース
- 複数のセッションにまたがる長期的なリファクタリングや移行
- /clear後もエージェントが状況を見失ってはならない、複数ステップのコーディングタスク
- エージェント作業中の意思決定やテスト結果を、監査可能な記録として残す
収録されている特集
トピック
よくある質問
- planning-with-files とは?
- AIコーディングエージェント向けのファイルベースの計画スキル。タスク計画をディスクに保存するため、コンテキストのリセットや/clear、クラッシュ後も維持できます。 Planning with Filesは、タスクの計画、調査メモ、進捗をプロジェクト内の3つのMarkdownファイル(task_plan.md、findings.md、progress.md)に保存する、AIコーディングエージェント向けのスキルです。状態はコンテキストウィンドウではなくディスク上にあるため、/clearやコンテキストの圧縮、クラッシュの後でも、エージェントは現在のフェーズから作業を再開できます。
- planning-with-files は無料で使えますか?ライセンスは?
- planning-with-files は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- planning-with-files は今もメンテナンスされていますか?
- 活発にメンテナンス中。planning-with-files の最終コミットは 2026年11月4日 です。
- planning-with-files は何に使えますか?
- 複数のセッションにまたがる長期的なリファクタリングや移行 /clear後もエージェントが状況を見失ってはならない、複数ステップのコーディングタスク エージェント作業中の意思決定やテスト結果を、監査可能な記録として残す
- planning-with-files はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/OthmanAdi/planning-with-files
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
AIコーディングエージェント向けのローカルファーストな永続メモリ。決定事項や学びをSQLiteに保存し、MCP経由でClaude Code、Cursorなどのクライアントに提供します。
Claude Code、Codex CLI、Cursor CLI、Gemini CLI向けの平易なエージェントスキル。セッション報告を誰にでも分かる一画面の結論にまとめます。
Claude Code、Codex、Gemini CLI、Cursorなどで使える、公式ベンダーチームやコミュニティ提供の1,000件以上のAgent Skillsを厳選したディレクトリ。
コードを書く前に提案・仕様・タスクを合意する、AIコーディングアシスタント向けの仕様駆動開発ワークフロー。
Potetoのpstack Cursorスキルスタックを移植し、Claude Code、Codex、Copilot、Piなどのエージェントハーネスに、コーディングタスク向けの体系的なワークフローを提供します。