tac-tac-go
← Clips
zenn.dev 2026年4月21日

Claude Codeに仕様書を丸ごと渡すな ── 「要件を伝える」との決定的な違い

元記事を読む ↗
読了日: 2026年5月15日
個人的メモ
Claude Codeの強みはコードを読んで文脈を理解し、一貫性のある実装を行うこと。仕様書を丸ごと渡すとその強みが殺される。その強みを生かすために仕様書を渡してそれを正とされるのではなくすでにあるコーディングルールとの乖離を生み出さないためにも、チケット単位にタスクを分離してコーディングを行わせる。

元記事

3行まとめ

  • 仕様書をそのまま渡す運用では重要要件の見落としや既存コードパターンの無視が繰り返し発生していた
  • 仕様書を機能単位チケットに分解し「何を作るか」だけを伝える方式に転換した
  • Claude Codeは毎回コードを直接読んで理解する設計であり、仕様書依存を減らすことで精度が向上する

要約

背景・課題

  • 仕様書丸ごと渡しでは、重要要件の見落とし・既存コードのパターン無視・ファイル間整合性崩壊が繰り返されていた

アプローチ

  • 仕様書を機能単位チケットに分解し「何を作るか」のみを渡す方式に転換し、実装後にコードから技術ドキュメントを生成

成果・ポイント

  • Claude Codeは既存コードを直接読む設計のため、仕様書への依存を減らすことで一貫性と精度が向上