Claude Code Tips - SDDで設計に時間をかける

はじめに

最近、コードは全てClaude Codeに書かせるようになってしまい、Claude Codeが無いと仕事ができない人間になってしまいました。

Claude CodeのPlanモードにおける課題

Claude Codeで新たな機能を実装するときにPlanモードをよく使うと思います。Claudeが作成したPlanで、ほぼほぼ問題ない場合は便利だと思うのですが、ちょっと複雑なソフトウェアだったり、ニッチな言語や環境になってくると、Claudeの知識では細部までケアできないことが多くなってきて、Planに対してあれこれ修正を要求したくなります。そうすると、Planモードではできることが限られるので、ちょっと使いにくくなってきます。

Spec Driven Development (SDD)

設計が複雑になってくるとPlanモードは使いにくいので、そういう場合、私は、要件定義書を書いて、設計書を書いて、と設計文書をClaudeに書かせて、設計文書をブラッシュアップしながら段階的に進めていくようにしています。これはSpec Driven Development (SDD)と言うらしいです。この方法の利点は、PlanモードではPlan承認という1度きりの合意で全ての工程が進行してしまうが、まずは、要件定義を書かせて確認した後、設計を書かせて確認して、と複数の段階を踏めること。こうすることで、大きな機能を一気に実装させることができるようになります。

また、ソフトウェアの規模が大きく複雑になってくると、一度でPlanを書かせてもClaudeが見落としてしまうところが増えてきます。設計文書を書かせるやり方なら、同じお題で複数回、設計を書かせて、複数の設計文書をまとめて読ませて、見落としや間違いがないかチェックさせたり、複数の設計文書からClaudeに正解を見つけさせて統合した設計文書を作ったりできるので、難しい作業もこなせるようになります。

まとめ

ぜひ、Planモードで行き詰ったときに試してみてください。