AIへの指示書が肥大化して毒になる前に。削る3ステップ
こんにちは、時短ギア管理人の清光です。
コードは書けない現役の営業ですが、AIと一緒に、現場が毎日使う業務システムを1年以上つくり続けてきました。
AI(Claude)に”いつもの前提”を指示書として書かせている方、増えていませんか?
最初は数行だったのに、気づけば長文になっていて、正直もう全部は把握できていない——そんな状態になっていないでしょうか。
この記事では、私が実際に業務ツールの開発で指示書を書きすぎて起きた”毒”と、それを削って立て直した3つの手順を、文字化け対策まで含めてお伝えします。

なぜ指示書は”毒”になるのか
最初に指示書を書いた話は以前の記事に書きましたが、今回はその続き、育ちすぎた後の話です。
最初に指示書を書いた時点では、そこに書いてあることは全部正しいはずです。
ところが開発を進めるうち、方針が変わったり、途中でやめた仕様が出てきたりします。
古い記述を消さずに追記だけ続けると、指示書の中に”もう正しくない前提”が混在した状態になります。
AIはそこを区別できません。書いてあることをそのまま事実として読み、古い指示をまた実行してしまうことがあります。
たとえば「この項目は毎回手入力してください」という古い指示が残っていると、実際はもう自動入力に変わっていても、AIは古い指示通りに案内を出してしまいます。
さらに厄介なのが、長くなるほど「今も絶対に守ってほしい一行」が他の記述に埋もれてしまうことです。
私が自作の業務ツールを作っていた時も、同じことが起きました。
指示書はどんどん長くなり、ある時点で「これはもう使っていない設定の説明だ」という行が紛れ込んでいることに気づきました。
指示書を”ダイエット”する3ステップ
気づいた時点で、私は指示書を一度棚卸ししました。やったことは3つだけです。
- まず指示書を頭から全部読み返し、「今はもう使っていない前提」に印をつける。
- 消すのではなく、参照用の別ファイルへ移す。設定値やログ的な記録など、頻繁に変わる情報ほど本体から追い出す。
- 本体に残すのは「今も必ず守ってほしいルール」だけに絞り、大きな変更をしたタイミングで同じチェックを繰り返す。
私の場合、この棚卸しで指示書の中身がかなり軽くなりました。古い情報を消す作業そのものより、「どれを残すか」を決める作業の方が時間がかかりました。

文字化け対策まで指示書に書いた理由
棚卸しと同じ時期に、もう1つ手を加えました。
自分以外のAI(別のAIエージェント)にも同じ現場を触らせる場面が出てきたので、「このリポジトリでやってはいけないこと」をまとめた作業規約を別に作ったのです。
ここでハマったのが文字化けでした。
指示書を保存する時の形式を指定していなかったため、日本語の部分が崩れて、AIが正しく読み取れていない疑いが出ました。
直し方はシンプルで、保存形式(文字コード)を明示するルールを指示書そのものに書き加えただけです。
以後、同じ崩れは起きていません。
よくある疑問
Q. 指示書はどのくらいの頻度で見直せばいいですか?
私は「大きな方針転換をしたタイミング」を見直しの合図にしています。
日付を決めて定期的にやるよりも、「前提が変わった時」に合わせる方が、無駄な見直しをせずに済みます。
Q. 古い情報を消して、後で必要になったら困りませんか?
消さずに、参照用の別ファイルへ移すだけなので実質消えていません。
本体(AIが毎回読む場所)が軽くなることが目的で、情報自体は手元に残ります。
Q. 指示書を分けると、AIは全部読んでくれますか?
いいえ、分けた参照ファイルは「必要な時だけ思い出す」扱いになりやすいです。
だから今も絶対に守ってほしいルールだけは、必ず毎回読まれる本体側に残すのが肝心です。
まとめ
- 指示書は書くほど増え、古い前提が残ると”毒”になる
- 消すのではなく、参照用の別ファイルへ移して本体を軽くする
- 保存形式(文字コード)を明示しておくと、文字化けによる読み取り不良を防げる
- =AIへの指示が毎回正しく効くようになり、同じ指摘を繰り返す手間が減る
今日はここまで。この記事が、あなたの時間を少しでも価値に変えるお手伝いになれば嬉しいです。
それでは、また次の時短ハックでお会いしましょう。
自作している業務システムのことや、お仕事のご依頼はお問い合わせからどうぞ。