大規模な変更
完全なドキュメント改訂を必要とする大規模な方向転換のための完全再構築ワークフロー。
このワークフローを使うとき
大規模な変更ワークフローは以下の場合に使用します：
- アプリ全体のアーキテクチャを再構築
- 機能や目的の大幅な方向転換
- 既存のドキュメントが大幅に古くなっている
- すべてのAIドキュメントをゼロから再作成する必要がある
- コア技術の変更（フレームワーク、データベースなど）
これは最も包括的なワークフローで、通常完了までに数週間かかります。
概要
大規模な変更は開発前にすべてのドキュメントの再作成を必要とします：
- アーキテクチャ計画：Claude Webを使用して新しい構造を設計
- ドキュメント改訂：すべての
ai_docs/ファイルを再作成 - フェーズ計画：実装のための新しいフェーズドキュメントを作成
- フェーズ開発：フェーズ開発ワークフローを使用して実行
ステップ1：Claude Webでアーキテクチャを計画
claude.aiを開き、再構築の目標を説明します。完全なアーキテクチャドキュメントを依頼します。
大規模な再構築計画のプロンプト
Claudeプロンプト[app-name]というアプリを再構築する必要があります。現在の状態と達成したいことは以下の通りです：
**現在の状態：**
- [現在のアプリの簡単な説明]
- [現在の技術スタック]
- [主な課題や再構築の理由]
**目標：**
- [アプリがどうなるべきか]
- [新機能や新しい能力]
- [必要な技術的改善]
**制約：**
- [タイムラインの制約]
- [維持すべき機能]
- [技術的制限]
以下を含む包括的な再構築計画を作成してください：
1. 新しいアーキテクチャの概要
2. データモデルの変更
3. API/ルートの変更
4. UI/UXの変更
5. 移行戦略
6. リスク評価
詳細なアーキテクチャドキュメントとしてフォーマットしてください。
ステップ2：ドキュメントを再作成
計画後、すべてのAIドキュメントファイルを再作成する必要があります。以下のチェックリストとプロンプトを使用してください。
ドキュメントチェックリスト
アプリルートファイル
| ファイル | 目的 | 状態 |
|---|---|---|
README.md | アプリ概要、セットアップ手順 | ☐ |
CLAUDE.md | このアプリのAI開発ガイドライン | ☐ |
PLAN.md | 開発状態とフェーズ追跡 | ☐ |
ai_docs/ ディレクトリ
| ファイル | 目的 | 状態 |
|---|---|---|
README.md | ドキュメントインデックスと読む順序 | ☐ |
00_product_brief.md | 目標、ユーザー、成功指標 | ☐ |
01_user_experience.md | ユーザーフロー、画面、インタラクション | ☐ |
02_architecture.md | 技術的決定、パターン | ☐ |
03_data_contract.md | データベーススキーマ、API契約 | ☐ |
04_integrations.md | 外部サービス、API | ☐ |
05_runbook.md | デプロイ、運用、モニタリング | ☐ |
06_acceptance_tests.md | テストシナリオ、品質基準 | ☐ |
フェーズ計画
| ファイル | 目的 | 状態 |
|---|---|---|
plans/README.md | フェーズ計画ディレクトリの概要 | ☐ |
plans/phase-1-*.md | 最初の実装フェーズ | ☐ |
各ドキュメント用プロンプト
プロダクトブリーフ作成 (00_product_brief.md)
Claudeプロンプト作成したアーキテクチャ計画に基づいて、[app-name]のプロダクトブリーフドキュメントを書いてください。
含めるもの：
- プロダクトビジョンと目標
- ターゲットユーザーとペルソナ
- コア機能（必須 vs あると良い）
- 成功指標とKPI
- スコープ外の項目
00_product_brief.md用のmarkdownとしてフォーマットしてください。
ユーザーエクスペリエンスドキュメント作成 (01_user_experience.md)
Claudeプロンプトアーキテクチャ計画に基づいて、[app-name]のユーザーエクスペリエンスドキュメントを書いてください。
含めるもの：
- ユーザーフロー（ステップバイステップのジャーニー）
- 画面の説明とワイヤーフレーム
- ナビゲーション構造
- インタラクションパターン
- エラー状態とエッジケース
01_user_experience.md用のmarkdownとしてフォーマットしてください。
アーキテクチャドキュメント作成 (02_architecture.md)
Claudeプロンプト計画に基づいて、[app-name]のアーキテクチャドキュメントを書いてください。
含めるもの：
- システム概要図（ASCIIまたは説明）
- 技術スタックの決定と理由
- ディレクトリ構造
- 主要なパターンと規約
- パフォーマンスの考慮事項
- セキュリティの考慮事項
02_architecture.md用のmarkdownとしてフォーマットしてください。
データ契約ドキュメント作成 (03_data_contract.md)
Claudeプロンプト計画に基づいて、[app-name]のデータ契約ドキュメントを書いてください。
含めるもの：
- データベーススキーマ（テーブル、関係）
- APIエンドポイント（ルート、メソッド、ペイロード）
- データ検証ルール
- 旧スキーマからの移行戦略
03_data_contract.md用のmarkdownとしてフォーマットしてください。
ステップ3：フェーズドキュメントを作成
実装をフェーズに分割します。各フェーズは1〜2週間の作業量が目安です。
フェーズ分割を作成
Claudeプロンプト作成した完全なドキュメントに基づいて、実装をフェーズに分割してください。
典型的なフェーズ：
- フェーズ 1: 基盤（プロジェクトセットアップ、コアインフラ）
- フェーズ 2: コア機能（主要機能）
- フェーズ 3: 二次機能
- フェーズ 4: 仕上げと最適化
各フェーズについて以下を提供：
1. 目標と成果物
2. タスクリスト
3. 前のフェーズへの依存関係
4. 推定複雑度
その後、phase-templateフォーマットに従った詳細なフェーズドキュメントを作成してください。
ステップ4：ドキュメントを検証
開発開始前に、Claudeにすべてのドキュメントの一貫性をレビューしてもらいます。
ドキュメントの一貫性を検証
Claudeプロンプト[app-name]用に作成したすべてのドキュメントをレビューし、以下を確認してください：
1. ドキュメント間の一貫性（命名、用語）
2. 情報の欠落やギャップ
3. ドキュメント間の矛盾
4. 不明確またはあいまいな要件
5. 技術的実現可能性の問題
見つかった問題をリストし、修正を提案してください。
ステップ5：フェーズ開発を開始
ドキュメントが完成し検証されたら：
- すべてのドキュメントをアプリのディレクトリ構造に保存
- Claude Codeに切り替え
- 各フェーズでフェーズ開発ワークフローに従う
Claude Codeで開発を開始
Claudeプロンプトmy-app-name: ドキュメントの再構築が完了しました。
ai_docs/とCLAUDE.mdのすべてのドキュメントを読んで、以下を行ってください：
1. 新しいアーキテクチャを理解していることを確認
2. フェーズ 1用のフィーチャーブランチを作成
3. フェーズドキュメントに従って実装を開始
開始前に確認したいことがあれば質問してください。
タイムライン期待値
| アクティビティ | 典型的な期間 |
|---|---|
| アーキテクチャ計画 | 1〜2日 |
| ドキュメント作成 | 2〜3日 |
| ドキュメントレビュー | 1日 |
| フェーズ 1 開発 | 1〜2週間 |
| 後続フェーズ | 各1〜2週間 |
合計：スコープにより4〜8週間以上
成功のためのヒント
計画フェーズ
- 計画を急がない—十分なドキュメントは後で時間を節約
- 可能な場合は図やビジュアルを含める
- コーディング前にアーキテクチャについて関係者の同意を得る
- 決定とその理由を文書化
ドキュメントフェーズ
- すべてのドキュメントで一貫した用語を使用
- 関連セクションを相互参照
- 例やコードスニペットを含める
- 仮定を明確にマーク
開発フェーズ
- フェーズ開発ワークフローを厳密に従う
- 学んだことに応じてドキュメント更新をスキップしない
- 明確なメッセージで頻繁にコミット
- 次のフェーズに移る前に十分にテスト
中止して簡素化すべき場合
大規模な変更が過剰な場合があります。以下の場合はフェーズ開発への切り替えを検討：
- 再構築が当初考えていたより限定的
- 時間の制約により完全なドキュメントが不可能
- アプリの特定部分のみが変更が必要
- 既存のドキュメントがほぼまだ有効
終わりのない計画に行き詰まるより、部分的な再構築で動くソフトウェアを提供する方が良いです。