外部 MCP クライアントや別の AI が読む skill、prompt、tool documentation では、読者が参照できない内部計画名、フェーズ名、ローカルレビュー用語を本文の根拠にしない。指示は、その文書単体を読んだ AI が「何をすればよいか」「なぜそうするか」「どの挙動につながるか」を理解できる粒度で書く。

判断基準

• その用語が planning doc、review thread、issue 内だけで意味を持つなら、配布される skill 文書では使わず、観測可能な効果や挙動に置き換える。
• 内部名を残す必要がある場合は、内部設計文書や作業メモ側に閉じ、外部 AI が読む runtime instruction には持ち込まない。
• 置換では、単に抽象語へ丸めず、どの入力や操作がどの集計、提案、保存、検証につながるかを明示する。

検証

対象文書だけを開き、関連する計画書やレビュー指摘を読まずに各指示の意味が取れるかを確認する。意味が取れない固有名やフェーズ名が残る場合は、その場で分かる目的、条件、結果へ言い換える。