メインコンテンツへスキップ
大規模な機能の実装には、複雑さを避けるために慎重な計画と体系的な実行が必要です。このガイドでは、巨大なプロジェクトを管理可能なフェーズに分割し、計画にはspecification mode、実装には頻繁な検証を伴う反復的アプローチを使用する実証済みのワークフローを説明します。

体系的な計画

複雑な機能を、明確な境界を持つ管理しやすい個別フェーズに分割します

段階的な進捗

各ステップで検証とテストを行いながら、一度に1フェーズずつ実装します

バージョン管理戦略

gitコミットとPRで進捗を追跡し、安全なロールバックを可能にします

継続的な検証

最後まで待たずに機能を段階的にテストします

このワークフローを使用するタイミング

このアプローチは以下の場合に最適です: 大規模なリファクタリング - コードベース全体の100以上のファイルに影響を与える場合
主要コンポーネントの移行 - コアシステムの依存関係を置き換える場合
大規模機能の実装 - 30以上のファイルにまたがる新機能の場合

ワークフロー

1

マスタープランを作成

仕様モードを使用して、プロジェクトを主要フェーズに分割する包括的なドキュメントを作成します プロジェクトを主要フェーズに分割します。
2

フェーズごとの実装

マスタープラン文書を参照しながら、各フェーズごとに新しいセッションを開始します。
3

頻繁なコミットとPR

完了した各フェーズに対応するgitコミットとプルリクエストを作成します。
4

段階的な検証

最後ではなく各フェーズ後に機能をテスト・検証します。
5

計画を更新

完了したフェーズをマークし、学びに基づいて残りの作業を調整します。

フェーズ1:Specification Modeによるマスタープラン策定

Shift+Tabを使用してSpecification Modeに入り、包括的な分析を作成することから始めます: プロンプト例:
Specification Modeは以下を生成します:
  • フェーズの分割 - 4-6の主要な実装フェーズ
  • 依存関係のマッピング - どのフェーズが他のフェーズの前に完了する必要があるか
  • テスト戦略 - 各フェーズが正しく動作することを検証する方法
  • リスク評価 - 潜在的な問題と軽減策
  • ロールバック計画 - 必要に応じて安全に元に戻す方法
計画を保存 - 仕様を承認し、プロジェクトルートにIMPLEMENTATION_PLAN.mdとして保存します。

フェーズ2:反復的実装

計画の各フェーズについて:

新しいセッションを開始

各フェーズを新しいdroidセッションで開始し、集中力とクリーンなコンテキストを維持します。

マスタープランを参照

フェーズ1のプロンプト例:

複雑なフェーズではSpecification Modeを使用

重要な変更を伴うフェーズでは、Shift+Tabを使用して詳細な計画を立てます:

頻繁にコミット

各フェーズ完了後、Droidに変更をコミットするよう依頼します:
Droidはすべての変更をステージングし、適切な共同執筆者の帰属を含むコミットを作成します。

フェーズ固有のPRを作成

Droidに完了した各フェーズのプルリクエストを作成するよう依頼します:
Droidはブランチを作成し、変更をプッシュし、コミットと行われた変更に基づいて詳細なPR説明を生成します。

フェーズ3:検証とテスト戦略

各フェーズを独立してテスト

最後まで待つのではなく、各フェーズ後に機能を検証します: フェーズ1完了:
フェーズ2完了:

段階的ロールアウトにフィーチャーフラグを使用

フェーズ境界での自動テスト

ベストプラクティス

読み取り専用の変更から始める - 変更を行う前に分析と準備でフェーズを開始します。 後方互換性を維持する - 新しいシステムを構築している間、古いシステムが動作し続けるようにします。 フィーチャートグルを使用する - 段階的ロールアウトと必要に応じた迅速なロールバックを可能にします。 学習を文書化する - 実装中の発見に基づいて計画を更新します。 境界条件をテストする - 古いシステムと新しいシステム間のインターフェースにテストを集中します。 ロールバックを計画する - 各フェーズは重大な問題が発見された場合に元に戻せるようにします。 進捗を伝達する - 定期的な進捗レポートでステークホルダーを最新の状態に保ちます。

回復戦略

フェーズで重大な問題が発生した場合:
  1. 即座のロールバック - gitを使用して最後の安定状態に戻す
  2. 問題分析 - 何が間違っていて、なぜそうなったかを文書化
  3. 計画調整 - 学習に基づいて残りのフェーズを更新
  4. ステークホルダーとのコミュニケーション - タイムラインと期待値を更新
体系的なアプローチにより、プロセス全体を通じてコード品質とシステムの安定性を維持しながら、大規模機能を確実に提供することができます。 次の大規模機能に取り組む準備はできましたか?Shift+Tabでマスター実装計画の作成を開始しましょう!