← プロジェクト一覧に戻る

Planning with Files

計画を3つのファイルとしてディスクに置き、毎ターン読み直させる。文脈が消えても計画は残る

エージェントスキルMIT
スター
27.8k
フォーク
2.3k
オープンIssue
7
最終コミット
2026年10月28日

Planning with Filesとは

長い作業には特有の壊れ方があります。エージェントは計画を持っていたのに、文脈が消去または圧縮され、戻ってきたエージェントが自信満々に別の仕事を仕上げてしまう、という壊れ方です。このスキルは計画を会話から外し、ディスク上に移します。計画のファイル、分かったことのファイル、済んだことのファイルの3つで、毎ターンそれらをエージェントの目の前に戻します。計画がファイルである以上、消去や異常終了、圧縮を越えて残り、実行中に人が自分で読むこともできます。任意で有効にできる関門は、計画がそう示すまでエージェントに完了を宣言させません。開発元は盲検のA/B比較結果を公開しており、これは多くのスキルにはない点です。

Planning with Filesで何ができますか?

  • 文脈の消去を越えて残る — 計画は会話ではなくディスク上にあるため、文脈の消去や異常終了、圧縮が起きても、何をしていたかが失われません。
  • 毎ターン計画を差し戻す — エージェントの記憶に任せず、フックが毎ターンファイルを読み直させます。計画と単なる提案の違いはここにあります。
  • 実行中に人が計画を読む — リポジトリ内の普通のMarkdownファイルなので、途中で開いて、エージェントが今どう認識しているかを確認できます。
  • 分かったことと進捗を分ける — 学んだ内容と完了した内容が別のファイルになっているため、途中の発見がチェックリストの中に埋もれません。
  • 早すぎる完了を拒む — 任意の関門を有効にすると、計画ファイルが認めるまでエージェントは完了を宣言できません。自信を伴う早期終了を防げます。

Planning with Filesを選ぶ前に

  • 作業用のファイルがプロジェクト内に書き出されます。版管理に含めるかどうかを早めに決めてください。誤ってコミットされた計画ファイルは履歴の雑音になります。
  • 毎ターン計画を読み直させる分、毎ターン費用がかかります。迷走する長い作業に比べれば安いものですが、計画の要らない短い作業では割に合いません。

スター推移

8月29日〜10月30日 · +1.4k

26.4k27.8k

よくある質問

Planning with Filesは商用利用できますか?

Planning with FilesはMITライセンスで公開されています。OSI承認のオープンソースライセンスで、商用利用が認められています。

Planning with Filesはどの形で使えますか?

Planning with Filesはローカル実行の形で利用できます。

Planning with Files
AIに聞く
GitHub