AIのためのオンボーディングドキュメントを整備する - inSmartBank

こんにちは、SmartBankでサーバーサイドエンジニアをしているhiroteaです。 ここ最近、CursorをはじめとしたAIを活用したコードエディタの利用が社内で急速に進み、私自身も日常的に「ペアプロ」しています。 特にCursorのAgentモードは、明確な指示を与えることでテストコードまで自律的に生成・実行してくれて非常に便利です。 docs.cursor.com しかし、AIにコード生成をさせていると以下のような悩みに遭遇します。 社内で定めたコーディングルールが守られない 既存の共通クラスやベースクラスをガン無視して独自に実装し直してくる AIあるあるですよね。 例えば、既に認証やエラー処理を包括的に提供しているApi::BaseControllerという共通の親クラスが存在する場合、以下のような実装をすることが望ましいです。 class AratanaController <

[misshiki]

“AIが効率よく参照できるようなコーディングガイドラインを、プロジェクトの直下に次のような構成で配置しました。”

[stefafafan]

AI向けドキュメントまとめたらそれがそのまま人間向けにも親切になって便利そう / Copilotも併用する場合どうするのがいいのだろう