Claude Codeで反省会をする - Xtone Design & Tech Talk

エクストーンの豊田です。最近のLLMのモデルの進化はすさまじく、開発プロセスにおいてAIを利用する割合がどんどん増えていっています。エクストーンではClaude CodeやGemini CLI, OpenAI Codexなどのコーディングエージェントを全面的に取り入れて開発プロセスの高速化に全社的に取り組んでいます。この記事では過去のClaude Codeとのやりとりをベースに反省会を行って、より自分の意図通りの出力をClaude Codeにさせるようにする取り組みについてお話しします。

Claude Codeでの開発プロセスについて

自分はエコシステムの利便性からClaude Codeを利用することが多いのですが、Claude Codeに指示を出したときに100%意図通りのものが出てくるケースは稀で、最初の出力から足りないものや意図と異なるものを追加の指示を出して100%に近づけていくことがほとんどです。以下のようなケースがよくあります。

テストコードを実装していない
実装したコードやテストコードが意図と違うディレクトリに出力される
実装したコードのビルドやテストが毎回失敗する
エラーを「今回の作業とは無関係です」といって放置する

毎回上記のようなケースが発生するので、だんだん最初の指示の際に「〇〇を実装してください。必ずテストコードを実装してください」とか「現在発生しているすべてのエラーを解決してください」など、最初の指示時に先回りするようになってきます。が、毎回これ書くの面倒じゃないですか？

Claude Codeエコシステムの活用

Claude Codeは CLAUDE.md にプロジェクト共通の前提条件を書くことが出来たり、カスタムコマンドやサブエージェント、スキルなどのエコシステムが豊富なので、これをうまく活用することで毎回同じプロンプトを書くことなく、複雑な指示を簡単に出すことが出来るようになります。各機能の詳細については公式ドキュメントに詳しく書いてあるので、是非読んでみてください。

これらのエコシステムを利用することでClaude Codeの出力の精度を上げることが出来ます。どのような指示を出せばいいかは公式ドキュメントにベストプラクティスがあるので、それを参照していただくのが一番早いです。

ここから本題です。

Claude Codeとのプロンプトのやり取りやClaudeの思考の過程は、全て ~/.claude/projects 以下にjsonl形式のファイルで保存されています。「毎回同じ失敗している」「自分で手順が確立していて毎回同じ指示を出している」などの傾向をここから分析することが可能なので、ある機能を一通り作り切った後、プロンプトを振り返り反省会をして CLAUDE.md を充実させたり、エージェントやスキルなどの精度を上げていくことで、効率の良いエコシステムの開発を行うことが出来ます。

以下のコマンドで ~/.claude/projects 以下のやりとりしたプロンプトを抽出することが出来ます。

$ cat ~/.claude/projects/<プロジェクトディレクトリ>/*.jsonl | jq -r 'select(.type == "user") | .message.content'

上記コマンドを実行した出力結果をファイルに保存し、そのファイルをClaude Codeのプロンプトに渡してフィードバックを依頼することが出来ます。例えばアプリケーションのルートディレクトリに prompt.txt という名前で上記コマンドの実行結果を保存した場合、以下のプロンプトで反省会が行えます。

このWebアプリケーションを実装するにあたって、Claude Codeとやりとりをした履歴を @prompt.txt に保存しています。
このやりとりからフィードバックを受けて、以下の点で改善点があるかどうかを指摘してください。

- プロンプトの改善
- カスタムスラッシュコマンドの提案
- サブエージェントの提案・修正
- Claude Code Hooksの提案・修正
- Claude Agent Skillの提案・修正
- mcpの提案
- そのほか、toolsとして実装した方がいいもの

Railsの開発で、全てClaude Codeで実装したプロジェクトに対して上記の分析を行った結果を1枚の画像にまとめたものが以下になります。こちらはClaude Codeの出力をNano Banana Proに渡して生成しました。