Execution Plan — continuum

Project: continuum Date: 2026-05-08 Phase: INCEPTION — Workflow Planning

1. Detailed Analysis Summary

1.1 Project Characteristics

1.2 Change Impact Assessment（Greenfield）

1.3 Risk Assessment

1.4 Mitigations（ハッカソン制約への対応）

• 5/10 応募: 本ドキュメント作成と並行してリポジトリ公開、応募フォーム提出
• 5/15 書類審査: Inception 5 ステージ（Workspace / Requirements / User Stories / Workflow Planning / Application Design）を 5/15 までに完了。Units Generation は時間あれば
• 5/30 予選 MVP: Phase 2 Must（18件）+ できれば Should（3件）= 21件 / 約2週間（5/16-5/30） で実装。AI フル実装で並列処理
• 6/26 決勝: Phase 3 Must（13件）+ Stretch（4件）= 17件 / 約4週間（5/31-6/26）

2. Workflow Visualization

flowchart TD
    Start(["User Request"])

    subgraph INCEPTION["🔵 INCEPTION PHASE"]
        WD["Workspace Detection<br/><b>COMPLETED</b>"]
        RE["Reverse Engineering<br/><b>SKIP</b>"]
        RA["Requirements Analysis<br/><b>COMPLETED</b>"]
        US["User Stories<br/><b>COMPLETED</b>"]
        WP["Workflow Planning<br/><b>IN PROGRESS</b>"]
        AD["Application Design<br/><b>EXECUTE</b>"]
        UG["Units Generation<br/><b>EXECUTE</b>"]
    end

    subgraph CONSTRUCTION["🟢 CONSTRUCTION PHASE (per Unit)"]
        FD["Functional Design<br/><b>EXECUTE per unit</b>"]
        NFRA["NFR Requirements<br/><b>EXECUTE per unit</b>"]
        NFRD["NFR Design<br/><b>EXECUTE per unit</b>"]
        ID["Infrastructure Design<br/><b>EXECUTE per unit</b>"]
        CG["Code Generation<br/>(Planning + Generation)<br/><b>EXECUTE per unit</b>"]
        BT["Build and Test<br/><b>EXECUTE</b>"]
    end

    subgraph OPERATIONS["🟡 OPERATIONS PHASE"]
        OPS["Operations<br/><b>PLACEHOLDER</b>"]
    end

    Start --> WD
    WD --> RA
    RE -.->|Skipped| RA
    RA --> US
    US --> WP
    WP --> AD
    AD --> UG
    UG --> FD
    FD --> NFRA
    NFRA --> NFRD
    NFRD --> ID
    ID --> CG
    CG -.->|Next Unit| FD
    CG --> BT
    BT -.->|Future| OPS
    BT --> End(["Complete"])

    style WD fill:#4CAF50,stroke:#1B5E20,stroke-width:3px,color:#fff
    style RA fill:#4CAF50,stroke:#1B5E20,stroke-width:3px,color:#fff
    style US fill:#4CAF50,stroke:#1B5E20,stroke-width:3px,color:#fff
    style WP fill:#4CAF50,stroke:#1B5E20,stroke-width:3px,color:#fff
    style CG fill:#4CAF50,stroke:#1B5E20,stroke-width:3px,color:#fff
    style BT fill:#4CAF50,stroke:#1B5E20,stroke-width:3px,color:#fff
    style RE fill:#BDBDBD,stroke:#424242,stroke-width:2px,stroke-dasharray: 5 5,color:#000
    style OPS fill:#BDBDBD,stroke:#424242,stroke-width:2px,stroke-dasharray: 5 5,color:#000
    style AD fill:#FFA726,stroke:#E65100,stroke-width:3px,stroke-dasharray: 5 5,color:#000
    style UG fill:#FFA726,stroke:#E65100,stroke-width:3px,stroke-dasharray: 5 5,color:#000
    style FD fill:#FFA726,stroke:#E65100,stroke-width:3px,stroke-dasharray: 5 5,color:#000
    style NFRA fill:#FFA726,stroke:#E65100,stroke-width:3px,stroke-dasharray: 5 5,color:#000
    style NFRD fill:#FFA726,stroke:#E65100,stroke-width:3px,stroke-dasharray: 5 5,color:#000
    style ID fill:#FFA726,stroke:#E65100,stroke-width:3px,stroke-dasharray: 5 5,color:#000
    style INCEPTION fill:#BBDEFB,stroke:#1565C0,stroke-width:3px,color:#000
    style CONSTRUCTION fill:#C8E6C9,stroke:#2E7D32,stroke-width:3px,color:#000
    style OPERATIONS fill:#FFF59D,stroke:#F57F17,stroke-width:3px,color:#000
    style Start fill:#CE93D8,stroke:#6A1B9A,stroke-width:3px,color:#000
    style End fill:#CE93D8,stroke:#6A1B9A,stroke-width:3px,color:#000

    linkStyle default stroke:#333,stroke-width:2px

Text Alternative（フォールバック）

🔵 INCEPTION PHASE:
  - Workspace Detection ........... COMPLETED
  - Reverse Engineering ........... SKIP (greenfield)
  - Requirements Analysis ......... COMPLETED
  - User Stories .................. COMPLETED
  - Workflow Planning ............. IN PROGRESS
  - Application Design ............ EXECUTE (新規アーキ + コンポーネント)
  - Units Generation .............. EXECUTE (3層+Federated を複数 unit へ分解必要)

🟢 CONSTRUCTION PHASE (Per-Unit Loop, then Build & Test):
  - Functional Design ............. EXECUTE per unit (複雑な業務ロジック)
  - NFR Requirements .............. EXECUTE per unit (Bedrock/AgentCore tech stack 選定含む)
  - NFR Design .................... EXECUTE per unit (パフォーマンス/コスト最適化)
  - Infrastructure Design ......... EXECUTE per unit (AWS リソース設計)
  - Code Generation ............... EXECUTE per unit (常時実行)
  - Build and Test ................ EXECUTE (全 unit 完了後)

🟡 OPERATIONS PHASE:
  - Operations .................... PLACEHOLDER

3. Phases to Execute

🔵 INCEPTION PHASE

• Workspace Detection — COMPLETED (2026-05-08T00:53:40Z)
• Reverse Engineering — SKIP（greenfield のため対象なし）
• Requirements Analysis — COMPLETED (approved 2026-05-08T02:39:59Z)
• User Stories — COMPLETED (approved 2026-05-08T03:06:02Z)
• Workflow Planning — IN PROGRESS（本ドキュメント）
• Application Design — EXECUTE
  • Rationale: 完全な greenfield プロジェクトで、新規コンポーネントの定義・サービス層設計・コンポーネント間依存関係の明文化が必須。3層アーキテクチャ（Inbound / Outbound / Federated）+ 共通基盤（Auth / Dashboard / Mock Feed）の論理設計が次フェーズの基盤となる
  • Depth: Comprehensive（複雑な多層アーキ、コンポーネント数 10+ 想定）
• Units Generation — EXECUTE
  • Rationale: システムを並列開発可能な複数の独立 Unit に分解する必要あり（Frontend PWA / Inbound Service / Outbound Service / MACP Service / Dashboard / Infrastructure / Mock Data Loader 等）。AI フル実装+1ヶ月の制約下で並列処理を最大化するため、Unit 境界の明確化が肝要
  • Depth: Standard（Unit 数は 5〜8 程度を見込み、依存関係のマッピング含む）

🟢 CONSTRUCTION PHASE（Per-Unit Loop）

各 Unit に対して以下のステージを実行：

• Functional Design — EXECUTE per unit (条件付き)

  • Rationale: Inbound（応答生成 + Relational Calibration）/ Outbound（Signal Extraction + Plausibility Engineering）/ MACP（Federated Negotiation Protocol）など、複雑な業務ロジックの単位ではEXECUTEする。Foundation（認証・プロファイル）等の単純CRUD unit ではSKIPの判断もありうる
  • Depth: Unit ごとに判定（Standard〜Comprehensive）

• NFR Requirements — EXECUTE per unit (条件付き)

  • Rationale: 技術スタック選定（Q13=D 委任）が必須。最初の Unit でAWSサービス全体の構成を決め、以降の Unit はそれを継承。応答生成5秒以内、月額数千円のコスト目標、PWA クロスプラットフォーム要件などの NFR が複数 Unit に影響
  • Depth: Standard（コアテックスタック決定の Unit のみ Comprehensive）

• NFR Design — EXECUTE per unit (条件付き)

  • Rationale: NFR Requirements の決定に基づく具体的設計（キャッシュ戦略、Bedrock 呼び出しの最適化、CloudFront 配信戦略等）が必要。NFR Requirements が SKIP の Unit ではこれも SKIP
  • Depth: Standard

• Infrastructure Design — EXECUTE per unit

  • Rationale: AWS インフラ設計（DynamoDB スキーマ / Lambda 関数 / API Gateway / Cognito / EventBridge / AgentCore Gateway/Identity/Memory 等）が必須。すべての Unit に対し、関連する AWS リソースを CDK 形式でマップする
  • Depth: Standard〜Comprehensive（Federated/MACP Unit は Comprehensive）

• Code Generation — EXECUTE per unit (ALWAYS)

  • Rationale: AI フル実装のため、各 Unit で Planning + Generation を実施。コードは workspace root に配置（aidlc-docs/ には配置しない）
  • Depth: Comprehensive（テスト含む）

• Build and Test — EXECUTE (ALWAYS, 全 Unit 完了後)

  • Rationale: 全 Unit 統合後のビルド・統合テスト・パフォーマンステスト・MACP の Federated 動作テストが必要
  • Depth: Standard（ハッカソンPoCのため網羅的E2Eは限定）

🟡 OPERATIONS PHASE

• Operations — PLACEHOLDER
  • Rationale: 現フレームワーク上は将来拡張用プレースホルダ。AWS デプロイ（Phase 3）は Build and Test に含める

4. Hackathon Milestone-Driven Construction Strategy

ハッカソンの 4フェーズ（応募 / 書類審査 / 予選 / 決勝）に応じて、Construction 内の Unit 実行順序を最適化する：

4.1 Pre-Apply（〜5/10、残り2日）

• 本 Workflow Planning 完了
• Application Design ドラフト着手
• リポジトリ公開（コードは空でも可、Inception ドキュメント公開が主目的）
• 応募フォーム送信

4.2 Inception Completion（〜5/15、残り1週間）

• Application Design 完了
• Units Generation 完了
• 書類審査用に Inception 全成果物を公開リポジトリに整備

4.3 Phase 2 MVP Construction（5/16〜5/30、約2週間）

🔄 SCOPE REVISION 2026-05-08T06:26:52Z: デモ視点見直しにより Phase 2 を 12件 / 6 Active Unit + shared-types に集中。詳細は scope-revision-2026-05-08.md。

Phase 2 Must（12件 — ユーザー操作可能ストーリー）+ できれば Should（3件）に対応する Unit を実装：

• Unit 1 Foundation: Cognito 認証 + プロファイル（Communication Style 削除）
• Unit 2 ContactMgmt: コンタクト CRUD + Mock Feed（3 コンタクト × 2 投稿 = 6 件）
• Unit 3 Inbound: 受信ボックス + Bedrock 3案生成（類似度検証廃止）+ 編集送信
• Unit 4 Outbound: Strategic Outreach + Signal Extraction（3 ステップ圧縮）
• Unit 5 Maturity: Lv1 ↔ Lv4 切替に集中（Lv2/Lv3 は stub、Lv5 は Mock 表示のみ）
• Unit 6 Dashboard: KPI カード（US-6.1）+ 静的バッジ画像（US-6.2 の絵のみ）
• Unit 7 MACP-Simulator: Single-Tenant 簡易版（WebSocket 不使用、setTimeout/Polling 演出）
• shared/shared-types: 共有型（agentcore-client は廃止 — SDK 直呼び）
• CDK Single Stack（Phase 2、Layered は Phase 3 へ）

Phase 2 から除外:

• U-9 Realtime（WebSocket 基盤） → Phase 3
• Conflict Detection / Plausibility Engineering → Phase 3 Stretch
• Lv5 自動認定バッチ → Mock 化
• US-1.3 Communication Style 設定 → 削除
• US-3.6 / US-6.3 / US-6.4 → 削除

並列実装可能な Unit（U-1, U-2, U-6, U-5）から着手、依存性のある Unit（U-3, U-4, U-7）は順序付き

4.4 Phase 3 Final Construction（5/31〜6/26、約4週間）

• AWS デプロイ環境（CDK Layered Stacks 本番化）
• Phase 3 Must:
  • Unit 8 MACP-Federated: AgentCore Gateway/Identity/Memory 本実装
  • Unit 9 Realtime: WebSocket 基盤（Phase 2 から降格）
  • Unit 10 DemoSetPiece: Split-Screen 演出 UI
  • US-2.3 Critical タグ
• Phase 3 Stretch（降格分含む、時間あれば）:
  • US-4.4 Conflict Detection（降格）
  • US-4.5 Plausibility Engineering（降格）
  • US-5.2 Lv2 信頼期 / US-5.3 Lv3 委任期（降格 — stub から本実装へ）
  • US-4.3 Engagement Heartbeat
  • US-7.5 MACP Failure Handling

4.5 Build and Test Timing

• Phase 2 Build/Test: 5/28-5/30（予選会前）
• Phase 3 Build/Test: 6/22-6/26（決勝直前）

5. Estimated Timeline

6. Success Criteria

6.1 Primary Goal

ハッカソン書類審査（5/15）通過 → 予選会（5/30）通過 → 決勝（6/26）でのインパクト最大化。

6.2 Key Deliverables

• 5/10 応募: 公開リポジトリ + 応募フォーム
• 5/15 書類審査: 公開リポジトリ + Inception 成果物（requirements / user-stories / application-design）
• 5/30 予選会: Phase 2 Must 18件 動作デモ + プレゼン資料
• 6/26 決勝: Phase 3 Must 13件 含む完成品 AWS 上動作 + MACP Demo Set Piece + プレゼン

6.3 Quality Gates

• 各 Unit Code Generation 後にユーザー承認
• 各 Per-Unit Construction ステージで標準2択（"Request Changes" / "Continue"）の承認ゲート
• Phase 2 / Phase 3 の各境界でビルド・統合テスト

6.4 Hackathon Specific Quality Gates

• 5/15 提出物: 公開リポジトリで誰が見ても Inception 段階の品質を確認できる状態
• MVP 動作デモ: ローカルで Phase 2 Must 機能が一通り動作（特に MACP Single-tenant 簡易シミュレーション）
• 決勝 AWS 動作: 実際の AWS 環境（Bedrock + AgentCore + Lambda + DynamoDB + Cognito + CloudFront）で全機能動作

7. Recommendations & Notes

7.1 Inception 内のスコープに対する判断

7.2 Construction 内のスコープに対する判断

7.3 リスク対応

• AgentCore 学習コスト: Phase 2 では Single-Tenant 簡易シミュレーションに留め、Federated 本実装は Phase 3 に分離することでリスク低減
• タイムライン制約: AI フル実装で並列開発、各 Unit を独立性高く設計
• デモ品質: Mock データ駆動でデモシナリオを明確化、ハッピーパス中心のテスト