コーディングルールの鮮度を保ちたい / keep-fresh-go-internal-conventions

kamakura.go #8 で行った LT のスライドです。
Agent Skill を使って、普段通りコードレビューをしていればコーディングルールが更新されていく仕組みの紹介です。

Transcript

1. コーディングルールの鮮度を保ちたい 2026-02-27 kamakura.go #8 @handlename
2. @handlename Hiroaki Nagata Nature Inc. Software Engineer (Backend) & SRE
3. Nature の backend アプリケーション 言語: Go 歴史: 10年くらい 規模: 70万行くらい (vendor/ 除く) Contributor: 100名以上
4. コーディングルール 使ってますか？メンテしてますか？
5. コーディングルール なぜ必要？ コード品質担保のため レビューコスト削減のため 最近では AI エージェント に精度高くコードを書かせるため 何をルールとする？ プロダクト固有のルールを定義したい 一般的なルールは公開されているもの を参照すればいい † ‡ Nature では主に Claude Code を使っています。 Google Style Guides や Go Code Review Comments など。 † ‡
6. Nature でのコーディ ングルール運用(過去) Notion の利用 全社共通のナレッジマネジメントツール データベースを作ってそこにルールを登録 機能はしていた 使い慣れたツールによる管理 プロパティでカテゴリ分け・ステータス管理
7. Notion 運用時代の課題 1. AI エージェントから参照しづらい Notion MCP を使えば参照は可能だが・・・ 複数ページの取得には複数回の tool 使用が必要 2. メンテナンスコスト 開発メンバーの余力に委ねられていた 開発チームの合意を取る方法が明確ではなかった これらの課題を解決したい。
8. 課題1: AI エージェントから参照しづらい ルールを Agent Skill として定義する 「AI エージェントに参照させたいなら、AI エージェントの仕組みに乗っけてしまおう」 Notion のデータベースから Agent Skill (= Markdown) に移行した Skill の説明に従って AI エージェントが適宜参照できるようになった ❯ tree .claude/skills/go-internal-conventions/ .claude/skills/go-internal-conventions/ ├── SKILL.md ├── references │ ├── architecture.md │ ├── comments.md : : │ └── type_design.md └── scripts └── search_conventions.py
9. 課題2: メンテナンスコスト (誰がメンテナンスするのか？) レビューコメントをもとに コーディングルールを更新する仕組み 「コードレビューでの指摘をルールに反映させよう」 「人がやるのは大変(できたらやってる)なので AI エージェントにやらせよう」 ルールを更新する Agent Skill を定義 直近 N 日間のレビューコメントを拾ってルールに追加 たとえば、直近7日間のレビューコメントからルールを更新するには: いつも通りコードレビューしていればコーディングルールが更新される /update-go-internal-conventions --days 7
10. 課題2: メンテナンスコスト (どうやって合意を取るのか？) ルールの更新を コードレビューする 「コードレビューを使って合意形成しよう」 1. Agent Skill を GitHub Actions で定期実行 2. 作成された Pull Request を開発メンバーがコード レビュー 3. Approve(=合意)されたらマージ(=採用) いつも通りコードレビューしていればコーディングル ールの合意が取れる
11. いつも通りコードレビューをしていればコーディングルールが更新されていく！
12. 成果 Notion 運用時代と比べて・・・ 未合意のルール: 13 → 0 合意済みのルール: 14 → 47 暗黙知が明文化され、未合意のまま放置されるルールがない状態を保つ仕組みができた 🎉 † 運用して3ヶ月弱なので増加傾向。時間が経つにつれて徐々に件数が安定してくる、はず。 †
13. まとめ いつも通りコードレビューしていれば コーディングルールが最新化される仕組みを作った レビューコメントをチームの知識として有効活用できるようになった