AGENTS.md に「キャッチコピー・補足文・サブラベルは削る。必要ならレイアウトを直す」の1行を足す

説明の文字で画面を分かりやすくしようとするエージェントの癖を、ルールファイルの1行で止める。

エージェントに作らせた画面には、見出しの上の小さなキャッチ、入力欄の下の説明、ボタン横の補足ラベルがやたらと付く。どれも「分かりにくさ」を文字で埋めた跡で、画面がにぎやかになり、AIっぽさの原因にもなる。新しいプロジェクトのルールファイルに最初から入れておくとよい。

AGENTS.md（Claude Code なら CLAUDE.md）に、次の趣旨の2行を足す（原文は英語）。

- キャッチコピー、補足のヘルプテキスト、二次的なラベルは削る。それがないと画面の意味が通じないなら、文字を足さずにレイアウトを直す。
- 何も壊さずに、ユーザー体験（UX）・開発者体験（DX）・エージェント体験（AX）の3つがすべて良くなる判断をする。

1行目のポイントは「削れ」で終わらず、分からないならレイアウト側で解決せよと逃げ道をふさいでいること。補足文を消しただけで画面が分かりにくくなるのを防げる。

同じ投稿者は続けて、起こりそうもない競合状態やセキュリティの例外のためにコードを足す前に「何が起きるか・どれくらい起きそうか・どれだけ複雑になるか」を説明して許可を待たせる1行も勧めている（デザインではなく実装寄りの話）。

フォームのエラー文、空の状態の説明、法的な注記など、削ってはいけない文字まで消されないよう、必要なら例外として書いておく。
CLAUDE.md / AGENTS.md は「リポジトリの概要」を消し、「〜しない」ルールとプロジェクト固有の違いだけを残すと同じく「禁止」型のルールなので相性がよい。AIっぽさの印（見出し上の小さなラベルなど）の一覧は Hallmarkスキルで「作る・採点・作り直し・好きなサイトから抽出」を使い分け、AIっぽくないUIにするを参照。