<p data-line="0" class="code-line">こちらは <a href="https://primenumber-dev.github.io/ai-native-summer-calendar/" target="_blank" rel="nofollow noopener noreferrer">primeNumber AI Native Summer Calendar</a>の記事です。</p>
<p data-line="2" class="code-line">本日の担当は、CTO の kekekenta (<a href="https://x.com/kekekenta" target="_blank" rel="nofollow noopener noreferrer">@kekekenta</a>) です。<br>
他の記事も読みたい人は <a href="https://primenumber-dev.github.io/ai-native-summer-calendar/" target="_blank" rel="nofollow noopener noreferrer">カレンダー</a> を見てください！</p>
<hr data-line="5" class="code-line">
<h1 id="%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" data-line="7" class="code-line">
<a class="header-anchor-link" href="#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> はじめに</h1>
<p data-line="9" class="code-line">インシデントの再発防止策として「レビューで注意する」「チェックリストに追加」といったアクションを決めても、時間とともに形骸化してしまう経験はありませんか？</p>
<p data-line="11" class="code-line">TROCCO/COMETAの開発チームでは、AIエージェント（Claude Code）を活用して、過去のインシデントから学んだ知見をもとに、AIのレビューで事前に問題を検知することを試しています。</p>
<h1 id="%E8%AA%B2%E9%A1%8C%EF%BC%9A%E4%BA%BA%E3%81%AE%E8%A8%98%E6%86%B6%E3%81%AB%E9%A0%BC%E3%82%8B%E5%86%8D%E7%99%BA%E9%98%B2%E6%AD%A2%E7%AD%96%E3%81%AE%E9%99%90%E7%95%8C" data-line="13" class="code-line">
<a class="header-anchor-link" href="#%E8%AA%B2%E9%A1%8C%EF%BC%9A%E4%BA%BA%E3%81%AE%E8%A8%98%E6%86%B6%E3%81%AB%E9%A0%BC%E3%82%8B%E5%86%8D%E7%99%BA%E9%98%B2%E6%AD%A2%E7%AD%96%E3%81%AE%E9%99%90%E7%95%8C" aria-hidden="true"></a> 課題：人の記憶に頼る再発防止策の限界</h1>
<p data-line="15" class="code-line">primeNumber では、インシデントやヒヤリハットが発生した場合にポストモーテムを実施し、再発防止のアクションを決定しています。しかし、以下のような課題がありました。</p>
<ul data-line="17" class="code-line">
<li data-line="17" class="code-line">
<strong>属人化</strong>：対応したメンバーは覚えているが、他のメンバーや新メンバーへの浸透が困難</li>
<li data-line="18" class="code-line">
<strong>ドキュメントの肥大化</strong>：チェックリストやガイドラインが増え続け、実用性が低下</li>
<li data-line="19" class="code-line">
<strong>実装コスト</strong>：CIでの自動検知は理想的だが、工数対効果を考えると優先度が上がりにくい</li>
</ul>
<aside class="msg message"><span class="msg-symbol">!</span><div class="msg-content">
<p data-line="22" class="code-line">弊社のポストモーテムについては、社内のポストモーテム文化を広めたSREの記事をぜひ御覧ください<br>
<a href="https://note.com/tk3fftk/n/n241612789742" target="_blank" rel="nofollow noopener noreferrer">1人目の専任SREがポストモーテム文化を改善したらエンジニア以外にも広まり、他部門との連携も強化された話｜Hiroki Takatsuka</a></p>
</div></aside>
<h1 id="%E8%A7%A3%E6%B1%BA%E7%AD%96%EF%BC%9Aai%E3%81%AE%E3%83%A1%E3%83%A2%E3%83%AA%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%92%E6%B4%BB%E7%94%A8%E3%81%97%E3%81%9F%E8%87%AA%E5%8B%95%E3%83%AC%E3%83%93%E3%83%A5%E3%83%BC" data-line="27" class="code-line">
<a class="header-anchor-link" href="#%E8%A7%A3%E6%B1%BA%E7%AD%96%EF%BC%9Aai%E3%81%AE%E3%83%A1%E3%83%A2%E3%83%AA%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%92%E6%B4%BB%E7%94%A8%E3%81%97%E3%81%9F%E8%87%AA%E5%8B%95%E3%83%AC%E3%83%93%E3%83%A5%E3%83%BC" aria-hidden="true"></a> 解決策：AIのメモリファイルを活用した自動レビュー</h1>
<p data-line="29" class="code-line">Claude Codeのメモリファイル（CLAUDE.md）に過去のインシデントから学んだ観点を蓄積することで、開発時とPRレビュー時の両方で自動的に問題を検知できるようにしました。</p>
<h2 id="%E5%AE%9F%E8%A3%85%E6%89%8B%E9%A0%86" data-line="31" class="code-line">
<a class="header-anchor-link" href="#%E5%AE%9F%E8%A3%85%E6%89%8B%E9%A0%86" aria-hidden="true"></a> 実装手順</h2>
<ol data-line="33" class="code-line">
<li data-line="33" class="code-line">
<p data-line="33" class="code-line"><strong>インシデントの優先度付け</strong><br>
過去のポストモーテム資料を確認し、影響度や発生頻度から対応優先度を決定</p>
</li>
<li data-line="36" class="code-line">
<p data-line="36" class="code-line"><strong>メモリファイルへの反映</strong><br>
各インシデントから一般化した観点をCLAUDE.mdに追加</p>
</li>
<li data-line="39" class="code-line">
<p data-line="39" class="code-line"><strong>効果検証</strong><br>
過去の問題のあるPRで検知できるかテストし、必要に応じて調整</p>
</li>
</ol>
<h1 id="%E3%83%A1%E3%83%A2%E3%83%AA%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E6%9B%B4%E6%96%B0%E3%81%AE%E5%85%B7%E4%BD%93%E7%9A%84%E3%81%AA%E6%B5%81%E3%82%8C" data-line="42" class="code-line">
<a class="header-anchor-link" href="#%E3%83%A1%E3%83%A2%E3%83%AA%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E6%9B%B4%E6%96%B0%E3%81%AE%E5%85%B7%E4%BD%93%E7%9A%84%E3%81%AA%E6%B5%81%E3%82%8C" aria-hidden="true"></a> メモリファイル更新の具体的な流れ</h1>
<p data-line="44" class="code-line">メモリファイルは人間が書くよりも、Claude Code自身に書かせることが最も効率的で実用的です。</p>
<h2 id="1.-%E3%83%90%E3%82%B0%E3%82%92%E5%86%85%E5%8C%85%E3%81%99%E3%82%8Bpr%E3%82%92%E9%81%B8%E3%81%B6" data-line="46" class="code-line">
<a class="header-anchor-link" href="#1.-%E3%83%90%E3%82%B0%E3%82%92%E5%86%85%E5%8C%85%E3%81%99%E3%82%8Bpr%E3%82%92%E9%81%B8%E3%81%B6" aria-hidden="true"></a> 1. バグを内包するPRを選ぶ</h2>
<p data-line="48" class="code-line">まず、対象のPRを選択します。</p>
<h2 id="2.-claude-code%E3%81%A7%E5%95%8F%E9%A1%8C%E3%81%AE%E3%81%82%E3%81%A3%E3%81%9Fpr%E3%82%92%E3%83%AC%E3%83%93%E3%83%A5%E3%83%BC%E3%81%95%E3%81%9B%E3%82%8B" data-line="50" class="code-line">
<a class="header-anchor-link" href="#2.-claude-code%E3%81%A7%E5%95%8F%E9%A1%8C%E3%81%AE%E3%81%82%E3%81%A3%E3%81%9Fpr%E3%82%92%E3%83%AC%E3%83%93%E3%83%A5%E3%83%BC%E3%81%95%E3%81%9B%E3%82%8B" aria-hidden="true"></a> 2. Claude Codeで問題のあったPRをレビューさせる</h2>
<div class="code-block-container"><pre><code class="code-line" data-line="52">prompt例:
&gt; 以下のPRの問題点を指摘して
&gt; https://github.com/your-org/your-repo/pull/12345
</code></pre></div><p data-line="58" class="code-line">この時点で問題を指摘できれば、CLAUDE.mdの修正は不要です。</p>
<h2 id="3.-%E6%A4%9C%E7%9F%A5%E3%81%A7%E3%81%8D%E3%81%AA%E3%81%84%E5%A0%B4%E5%90%88%E3%81%AF%E3%80%81%E3%82%A4%E3%83%B3%E3%82%B7%E3%83%87%E3%83%B3%E3%83%88%E3%81%AE%E5%8E%9F%E5%9B%A0%E3%82%92%E4%BC%9D%E3%81%88%E3%82%8B" data-line="60" class="code-line">
<a class="header-anchor-link" href="#3.-%E6%A4%9C%E7%9F%A5%E3%81%A7%E3%81%8D%E3%81%AA%E3%81%84%E5%A0%B4%E5%90%88%E3%81%AF%E3%80%81%E3%82%A4%E3%83%B3%E3%82%B7%E3%83%87%E3%83%B3%E3%83%88%E3%81%AE%E5%8E%9F%E5%9B%A0%E3%82%92%E4%BC%9D%E3%81%88%E3%82%8B" aria-hidden="true"></a> 3. 検知できない場合は、インシデントの原因を伝える</h2>
<div class="code-block-container"><pre><code class="code-line" data-line="62">prompt例:
&gt; このPRはインシデントに繋がりました。
&gt; 原因としては、xx機能の有無を問わず /api/internal/yy APIを叩き、
&gt; xx機能無効されているアカウントについては 401が返却されることでエラーとなっていたことです。
&gt; もう一度レビューしてみてください。
</code></pre></div><p data-line="70" class="code-line">ここでClaude Codeがコード上の問題箇所を正確に指摘できることを確認します。</p>
<h2 id="4.-claude.md%E3%81%AE%E6%9B%B4%E6%96%B0%E3%82%92claude-code%E8%87%AA%E8%BA%AB%E3%81%AB%E4%BE%9D%E9%A0%BC%E3%81%99%E3%82%8B" data-line="72" class="code-line">
<a class="header-anchor-link" href="#4.-claude.md%E3%81%AE%E6%9B%B4%E6%96%B0%E3%82%92claude-code%E8%87%AA%E8%BA%AB%E3%81%AB%E4%BE%9D%E9%A0%BC%E3%81%99%E3%82%8B" aria-hidden="true"></a> 4. CLAUDE.mdの更新をClaude Code自身に依頼する</h2>
<div class="code-block-container"><pre><code class="code-line" data-line="74">prompt例:
&gt; このインシデントを防ぐために、CLAUDE.mdを充実させてください。
&gt; この問題に特化せず、同様の問題に気づけるようになるべく一般化してください。
&gt; 変更したCLAUDE.mdをもとに、この問題をレビューで気づけるようにしてください。
</code></pre></div><p data-line="81" class="code-line"><strong>ポイント</strong></p>
<ul data-line="82" class="code-line">
<li data-line="82" class="code-line">特定の問題に特化せず、一般化した観点として記述してもらう</li>
<li data-line="83" class="code-line">冗長になりすぎないよう、シンプルな記述を心がけてもらう</li>
</ul>
<h2 id="5.-%E6%9B%B4%E6%96%B0%E5%BE%8C%E3%81%AEclaude.md%E3%81%A7%E6%A4%9C%E7%9F%A5%E3%81%A7%E3%81%8D%E3%82%8B%E3%81%8B%E6%A4%9C%E8%A8%BC" data-line="85" class="code-line">
<a class="header-anchor-link" href="#5.-%E6%9B%B4%E6%96%B0%E5%BE%8C%E3%81%AEclaude.md%E3%81%A7%E6%A4%9C%E7%9F%A5%E3%81%A7%E3%81%8D%E3%82%8B%E3%81%8B%E6%A4%9C%E8%A8%BC" aria-hidden="true"></a> 5. 更新後のCLAUDE.mdで検知できるか検証</h2>
<p data-line="87" class="code-line"><strong>重要</strong>: <code>/clear</code> コマンドでセッションをクリアした上で、再度同じPRをレビューさせます。</p>
<div class="code-block-container"><pre><code class="code-line" data-line="89">prompt例:
&gt; 以下のPRの問題点を指摘して
&gt; https://github.com/your-org/your-repo/pull/12345
</code></pre></div><p data-line="95" class="code-line">検知できない場合は、手順4と5を繰り返してCLAUDE.mdを改善していきます。</p>
<h1 id="%E5%AE%9F%E9%9A%9B%E3%81%AE%E5%8A%B9%E6%9E%9C" data-line="97" class="code-line">
<a class="header-anchor-link" href="#%E5%AE%9F%E9%9A%9B%E3%81%AE%E5%8A%B9%E6%9E%9C" aria-hidden="true"></a> 実際の効果</h1>
<p data-line="99" class="code-line">TROCCO/COMETAの開発では、Claude Code Actionsを使用しています。<br>
実際に問題のあるPRを作成し、レビューで指摘してもらった様子です。</p>
<p data-line="102" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/6b0d606dedcc-20250821.png" class="md-img" loading="lazy"></p>
<p data-line="104" class="code-line">Claude Code Actions を利用することで、開発中もGitHub上のPRレビューでも同じメモリファイルを参照して問題を検知できます。<br>
Claude Code が cli である強みをひしひしと感じます。</p>
<h1 id="%E5%AD%A6%E3%81%B3%E3%81%A8%E4%BB%8A%E5%BE%8C%E3%81%AE%E5%B1%95%E6%9C%9B" data-line="107" class="code-line">
<a class="header-anchor-link" href="#%E5%AD%A6%E3%81%B3%E3%81%A8%E4%BB%8A%E5%BE%8C%E3%81%AE%E5%B1%95%E6%9C%9B" aria-hidden="true"></a> 学びと今後の展望</h1>
<h2 id="ai%E3%81%A8%E3%81%AE%E9%81%A9%E5%88%87%E3%81%AA%E5%BD%B9%E5%89%B2%E5%88%86%E6%8B%85" data-line="109" class="code-line">
<a class="header-anchor-link" href="#ai%E3%81%A8%E3%81%AE%E9%81%A9%E5%88%87%E3%81%AA%E5%BD%B9%E5%89%B2%E5%88%86%E6%8B%85" aria-hidden="true"></a> AIとの適切な役割分担</h2>
<p data-line="111" class="code-line">AIは非決定的な性質があるため、すべてをAIに任せるのではなく、決定的に判定できる部分はスクリプト等で実装することが重要です。<br>
CIで決定的に検知するようなスクリプトは、これまでは開発に時間がかかっていましたが、AIによって高速化できる部分です。<br>
どこをAIに任せるべきかを判断することは、AI時代のソフトウェアエンジニアにとって必須なスキルだと感じます。</p>
<h2 id="%E3%82%A8%E3%83%B3%E3%82%B8%E3%83%8B%E3%82%A2%E3%83%AA%E3%83%B3%E3%82%B0%E3%81%AE%E6%96%B0%E3%81%9F%E3%81%AA%E4%BE%A1%E5%80%A4" data-line="115" class="code-line">
<a class="header-anchor-link" href="#%E3%82%A8%E3%83%B3%E3%82%B8%E3%83%8B%E3%82%A2%E3%83%AA%E3%83%B3%E3%82%B0%E3%81%AE%E6%96%B0%E3%81%9F%E3%81%AA%E4%BE%A1%E5%80%A4" aria-hidden="true"></a> エンジニアリングの新たな価値</h2>
<p data-line="117" class="code-line">ドキュメント整備はこれまでもチームスケールの要でしたが、AI時代においてはさらに重要性が増しています。AIにとってドキュメントが唯一のコンテキストであることを考えると、構造化された知識の蓄積がそのまま開発生産性に直結する時代になったと感じます。</p>
<p data-line="119" class="code-line">ドキュメントの文化を築いてきた開発チームには大変感謝です！</p>


2025年の最も大きなチャレンジ

AIレビューでインシデントを未然に防ぐ仕組みづくり

課題：人の記憶に頼る再発防止策の限界

解決策：AIのメモリファイルを活用した自動レビュー

2. Claude Codeで問題のあったPRをレビューさせる

3. 検知できない場合は、インシデントの原因を伝える

4. CLAUDE.mdの更新をClaude Code自身に依頼する

5. 更新後のCLAUDE.mdで検知できるか検証

メモリファイル更新の具体的な流れ

エンジニアリングの新たな価値

Discussion