毎回渡す情報と、そのときだけ渡す情報

「毎回」と「今回だけ」を混ぜない

毎回いるもの

プロジェクトの前提、決まりごと、よく使うコマンド。これは指示ファイルに置きます。

今回だけのもの

今回の背景、触るファイル、完成の判定基準。これは依頼文に書きます。

この2つを混ぜると、指示ファイルが作業日誌のようにふくらみます。そして、その全部を毎回読ませることになります。

最初は短く、必要になったら詳しく

はじめから全部を読ませるのではなく、入口を短くしておきます。そして、必要になった時点で詳しい説明へ辿ってもらいます。

スキルの仕様でも、短い説明を入口に置き、手順や資料は必要になってから読み込む形が採られています。

リポジトリでも同じです。指示ファイルは目次として使い、詳しい話は別のファイルに置いて、そこから参照させます。そのほうが、毎回の読み込みは軽くなります。

上限は数字で決めます

AIが一度に扱える情報の量には上限があります。多く渡すほど良くなるわけではありません。毎回読ませる分について、あらかじめ上限を決めておきます。超えたら削るか、別ファイルに分けます。

FRKZ の「コンテキスト予算」（/tools/context-budget）を使うと、リポジトリのファイル構成から目安が出ます。毎回読ませるもの、必要なときだけ読ませるもの、読ませないものの3つに分かれます。

どちらが優先かを、書いておきます

指示があちこちにあるとき、どれが優先されるかを書いていなければ、勝ち負けはその場任せになります。

「より狭い範囲の指示が、広い範囲の指示より優先される」といった決まりを先に作って、指示ファイル自体に書いておきます。