「速く作る」から「正しく作る」の現場のリアル 〜誰が書いても同じコードになる仕組みを、開発資本として積み上げる〜

Transcript

1. 「速く作る」から「正しく作る」の現場のリアル 〜誰が書いても同じコードになる仕組みを、開発資本として積み上げる〜 robin（ファインディ株式会社） AI DevEx Conference リバイバル公演 / 2026.10.07 © Findy Inc.
2. ⾃⼰紹介 • ニックネーム ◦ • 所属 ◦ • ファインディ(株) プロダクト開発部 Team+推進 担当領域 ◦ • robin：高校の頃にクリストファー・ロビンに似てたらしい バックエンド、フロントエンド 最近ハマっていること ◦ ガチャガチャ ◦ 散歩 © Findy Inc. 2
3. 元講演と、今⽇の話 🎤 🛠 元講演 今⽇の私 AI Engineering Summit Tokyo 2026 「速く作る」から「正しく作る」へ （⼾⽥ 千隼） Findy Team+ 開発エンジニア Findy Team+ の API と MCP サーバーの開 発を担当 © Findy Inc.
4. 同じAIを使っているのに なんでコード品質がバラつくんだっけ？ © Findy Inc.
5. 元講演の計測：AIを⼊れても、⽣産性は伸びなかった 👥 稼働⼈数 📤 1⼈あたりPR作成数 1.5倍 横ばい メンバーは増加 アウトプットは変わらず ⏱ レビュー → Approve 💬 平均コメント‧レビュー数 +20分 +30% 昨年⽐で延伸 指摘が増加 © Findy Inc.
6. 現場で起きていたこと：Controller に何でも書く ruby # Before: ArticlesController（説明用の例） def index raise BadRequest if params[:limit].to_i > 100 articles = Article.where(team_id: params[:team_id]) if params[:keyword].present? articles = articles.where("title LIKE ?", "%#{params[:keyword]}%") end render json: articles.order(:published_at).limit(params[:limit]) .map { |a| { id: a.id, title: a.title } } end © Findy Inc.
7. 1 PR にインライン指摘12件‧レビュー4往復 “ fat controller になっている（Controller で⾊々 やりすぎている）ので分割しましょう — 当時の私のレビューコメント（2026年7⽉） © Findy Inc.
8. AIは既存コードを踏襲する バラバラな既存コード AIが踏襲 近くのコードを参考にする バラバラな出⼒ レビューで同じ指摘 お⼿本がバラバラなら、AIの出⼒もバラバラになる © Findy Inc.
9. 登場⼈物を固定する：API の「固定キャスト」 登場⼈物 責務 XxxController HTTPの⼊⼝。認証‧認可と各役割の呼び出しだけ XxxParams ⼊⼒の契約。必須チェック‧パース‧検証 XxxFinder 権限を踏まえて対象リソースを⾒つける（なければ404） XxxQuery 検索条件を受け取り、データ取得のクエリを組み⽴てる XxxSerializer レスポンスの形に変換する © Findy Inc.
10. rules の作り⽅：レビュー指摘がそのまま規約になる 1. 既存コードを読む AIと壁打ち 4. レビュー指摘 2. 規約を⾔語化 新しい論点を規約へ追記 .claude/rules に paths 指定 3. AIが規約どおり実装 該当パスで⾃動読込 © Findy Inc. 9
11. After：Controller は委譲するだけ ruby # After: ArticlesController（説明用の例） def index input = ArticlesParams.new(params) # 入力の契約 articles = ArticlesQuery.call( # データ取得 team: current_team, keyword: input.keyword, limit: input.limit ) render json: ArticlesSerializer.call(articles) # レスポンス整形 end © Findy Inc. 10
12. レビューの中⾝が変わった Before（〜8/4） After（8/5〜） • インライン指摘 4.0件 / PR • インライン指摘 0.78件 / PR • 指摘の約4割が「責務‧置き場 所」 • 論点は性能‧セキュリティ‧API 契約へ • 同じ指摘を何度も書く • 指摘は「規約の◯◯によると」 と引⽤する形に © Findy Inc. 12
13. Team+ で⾒ると①：PR作成数が約1.8倍に PR作成数 486 → 862件（前期間 6/13〜8/4 → 8/5〜9/26、Team+推進） © Findy Inc. 12
14. Team+ で⾒ると②：PRあたりのコメント数が減った 平均コメント数 4.2 → 2.9件（−31%） © Findy Inc. 13
15. Team+ で⾒ると③：レビューから Approve までが短く なった レビュー → Approve 約1.7h → 約0.5h（⼈のレビューのみ‧21⽇移動平均） © Findy Inc. 14
16. 別チームのメンバーでも「同じコード」になった 初めての API 実装、PRの積み順が固定キャストどおり ① Params ② Query ③ Serializer ④ Controller ⑤ OpenAPI 規約に関する指摘 0件 ∕ 承認コメント「skinny controller!!!」 © Findy Inc. 14
17. 整備して分かったこと：rules は育ち、そして太る 1ファイル 736⾏で限界 → 2ファイルに分割 736⾏ 771⾏ 531⾏ 381⾏ 214⾏ 38⾏ 07/29 08/05 08/14 09/15 09/17 現在 © Findy Inc. 11
18. 開発資本スコアで⾒る現在地 ⼿戻りの少なさ 50 → 72 ∕ PRあたりコメント数 4.7 → 3.1件（2026年6⽉ → 9⽉） ※開発資本スコアβ版の値。9⽉からβ版の定義で計算 © Findy Inc.
19. トークンを「消費」して、rules という「資本」を⽣み出した ✅ 🧩 🧭 Quality 変更単位の制御 コンテキストの制御 ⼿戻りの少なさ 50 → 72 （6⽉ → 9⽉） スコア 100 ハーネス整備度 38.2% （スコア基準は策定中） 資本: rules が次のPRでも 効き続ける ⼩さなPR × 固定キャスト が効いている 次の投資: rules を他領域 へ‧OpenAPI‧⾃動⽣成 © Findy Inc.
20. トークンを消費して、 資本を⽣み出す 誰が書いても同じコードになる仕組みは、次のPRでも効き続ける © Findy Inc.
21. 開発資本とは？ 将来の価値を⽣み続ける、開発組織に蓄積された⼒ ROI（起きた成果）ではなく「次の成果を⽣む⼒」を⾒る先⾏指標 画⾯例：開発資本スコアβ（Team+推進‧2026年9⽉分） Speed Quality Control 価値を⽣み出し、届け、学ぶ速さ ⼿戻りなく、本番で信頼され続ける品質 速さと品質を増幅させる基盤と運⽤ NEW 2026年10⽉「開発資本スコアβ」リリース ── Findy Team+ で計測できます © Findy Inc.