Claude Codeでプロジェクト解析から設計書を自動作成するコマンド

【結論】コードと実行結果から根拠付き設計書を生成する

Claude Codeで設計書を作る際は、コードを要約するだけでなく、実行可能な根拠、未確認事項、推測を分離します。

成果物はMarkdownで管理し、Architecture、Component、Data flow、API、Security、Deployment、Trade-off、Open issueを明示します。

# ターミナルで設計書用Directoryを作成
mkdir -p docs/design
# ターミナルで対象Branchと差分を確認
git status --short && git branch --show-current
# ターミナルでClaude Codeを起動
claude

具体的な手順・設定方法

1. README、Dependency定義、Entry point、Schema、Route、Infra、Testを順に調査します。

2. Mermaid図はCode上の実際の呼び出し関係から作り、推測したConnectionは破線や未確認ラベルで区別します。

3. 生成後にBuild・Test・API schemaと照合し、Source pathと検証日を設計書へ記録します。

実践プロンプト / 活用テクニック

既存Systemの設計書を生成する依頼例です。

# 起動後のセッション内で入力
src、infra、database migration、testを調査し、docs/design/system.mdを作成してください。
# 続けて入力
各主張に根拠ファイルのPathを付け、確認できない外部Serviceは推測せず『未確認』と記載してください。

注意点・よくあるエラーと対処法

AIはRuntime構成、運用手順、隠れた外部連携をCodeだけから完全には把握できません。

設計書を正とする前に、担当者Interview、Production設定、監視、障害履歴、契約要件を確認します。

秘密値や顧客情報を図・例・ログへ転載せず、公開範囲別に文書を分けてください。