#434

backend/AGENTS.md

@@ -15,6 +15,17 @@
 - 履歴読み取りは HistoryAccess の共通認可を必須とする。書込用 relation を公開しない。
   export は生成時と取得時に認可し、権限変更・除票後に古いファイルを再利用しない。
 
+## Mandatory naming contract
+
+- ルート `AGENTS.md` の必須命名規約を適用する。メソッド等の callable 以外の
+  自前識別子に動詞を使わず、形容詞の状態名、名詞の真偽値には `_flg` を使用する。
+  例：`is_latest` は `latest`、`is_admin` は `admin_flg`。
+- 引数、属性、SQL alias、API・URL パラメータ、JSON キー、DB カラムも対象とする。
+  Rails 等が定義する外部 API 名や、処理を実行するメソッド名は変更しない。
+- 旧 API・URL の互換性は解析・シリアライズ境界で扱い、内部定義は新名に統一する。
+  DB カラムの改名はデータを保持する追加マイグレーションで設計し、適用済みの
+  マイグレーションを書き換えない。マイグレーションの実行には個別指示を要する。
+
 ## Scope
 
 These rules apply to work under `backend/`.