Repolode
OthmanAdi

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 の数値は毎日更新されます。

関連プロジェクト