#434

frontend/AGENTS.md

@@ -15,6 +15,17 @@
 - 秘匿は React / CSS では実装しない。認可済み API のみを使う。
   認証・権限変更時は取得中リクエストと履歴キャッシュを破棄し、SSR の管理者データを共有しない。
 
+## Mandatory naming contract
+
+- ルート `AGENTS.md` の必須命名規約を適用する。非 callable の自前識別子に
+  動詞を使わず、形容詞の状態名、名詞の真偽値には `Flg` を使用する。
+  例：`isLatest` は `latest`、`isAdmin` は `adminFlg`。
+- React / TanStack Query 等の外部 API 名は維持する。取得した値を自前の状態に
+  保持するときは、必要に応じて分割代入等の境界で別名を付ける。
+  callable の state setter、event handler、callback は動詞名を使用できる。
+- 型、表示項目キー、URL、API、コピー・エクスポートのフィールド参照を整合させる。
+  旧キーの互換性は共通の入出力境界で処理し、新しい内部状態には旧名を使用しない。
+
 ## Scope
 
 These rules apply to work under `frontend/`.