はじめに
こんばんは。
最近、仕事で Claude Code を使って開発しています。
使い始めてからそれなりに経つのですが、最近ようやく自分なりのワークフローが固まってきました。
前提
Claude Code にはカスタムスラッシュコマンドという機能があります。
自分で作ったプロンプトを /コマンド名 で呼び出せる仕組みです。僕はこれを使って、開発の各工程ごとにスキル（コマンド）を作っています。
スキルの中身については今回は割愛しますが、ワークフローの全体像と、各ステップで何をやっているかを紹介します。
ワークフローの全体像
僕のワークフローは大きく4つのフェーズに分かれています。
仕様書作成 → 計画作成 → 実装 → レビュー対応
それぞれ見ていきます。
1. 仕様書作成
最初にやるのは仕様書作成です。
参考資料や既存の実装コードを読ませて、ドメインの仕様書を作らせます。その後、作った仕様書をレビューさせます。
ポイントは、いきなりコードを書かせないということです。
Claude Code は指示すればすぐコードを書いてくれますが、仕様の理解が浅いまま書かせると、的外れなものが出てきます。まず「お前はこのドメインをちゃんと理解してるか？」を確認するフェーズです。
2. 計画作成
仕様書ができたら、次は実装計画を作らせます。
「何をどの順番で、どのファイルに対して実装するか」を計画としてまとめさせます。これも作ったあとにレビューさせます。
ここで大事なのは、計画をアーキテクト視点でレビューさせるということです。
「この順番で大丈夫か？」「影響範囲は考慮されているか？」「もっと良い設計はないか？」といった観点で、AI自身に自分の計画を見直させます。
人間がやっていたレビューの一部をAIに肩代わりさせているイメージですね。
3. 実装
計画ができたら、やっと実装です。
計画書を元にコードを書かせます。計画があるので、AIが変な方向に行きにくくなります。
実装が終わったらセルフレビューさせます。自分で書いたコードの問題点を自分で指摘させる。さらに必要に応じて Feature テストも作らせます。
この「書く → 自分でレビューする → テストを書く」のサイクルを、全部AIにやらせるのがミソです。
4. レビュー対応
人間のレビュアーからフィードバックをもらったあとのフェーズです。
レビュー指摘を読み込ませて、まず対応方針をまとめさせます。方針が決まったら、それを元に修正させます。
ここも「いきなり直させない」のがポイントです。方針をまとめるステップを挟むことで、的外れな修正を防いでいます。
全体を通して意識していること
ワークフロー全体で共通して意識しているのは、各フェーズで必ず「作る」と「レビューする」をセットにするということです。
作る → レビューする → 次のフェーズへ
一つ大事なのは、最終判断は全部自分でやっているということです。AIが作った仕様書も計画も実装も、最後は自分の目で確認しています。AIは優秀なジュニアメンバーくらいの位置づけで、丸投げはしていません。
あくまで 現状は ですけど..
まとめ
今の自分のワークフローを紹介しました。
正直、まだまだ試行錯誤中です。もっと効率のいいやり方や、こういう工夫してるよ、というのがあればぜひ教えてください。
ではでは。
