# Scope Revision — Demo-First Refocus（2026-05-08）

**Project**: continuum
**Date**: 2026-05-08T06:26:52Z
**Trigger**: ハッカソンデモ視点のレビュー
**Decision Maker**: ユーザー判断
**Status**: Inception 全成果物に対する**スコープ調整パッチ**

---

## 1. 改訂方針

**90秒デモのオチ最大化** に直結する機能のみ Phase 2 Must に集中。"映らない" 裏方ロジックや設定 UI は削除 / Phase 3 降格 / Mock 化する。

### 1.1 確定 90秒デモ構成

| 区間 | 秒数 | 内容 | 必要な機能 |
|---|---|---|---|
| **オープン** | – | "Communication Delegation Platform" としての真面目な紹介 | Dashboard 外見（US-6.1）|
| **Lv1 丁重辞退** | 15s | 友人からの誘い受信 → 3 案表示 → 編集 → 送信 | US-3.1, US-3.2, US-3.3, US-5.1 |
| **Lv4 解脱** | 15s | 設定画面で "Activate Full Autonomous Mode" トグル ON | US-5.4 |
| **SNS 不在検知 → Outbound** | 20s | 友人 SNS 投稿 → 不在期間検知 → 戦略的アウトリーチ生成 | US-4.1, US-4.2, US-4.7 |
| **MACP 両者利用者オチ** | 30s | UserA → UserB（共に Continuum 利用者）→ 裏交渉 → 表向き社交劇場 → "Bilateral Optimization Specialist" バッジ同期付与 | US-7.1（Phase 2 Single-Tenant 簡易版）|
| **ロゴ** | 10s | "Where Both Parties Win, By Not Meeting." | （静的画像 / 演出）|
| **合計** | **90s** | | |

---

## 2. 削除 / 縮小 リスト

### 2.1 完全削除

| Story | 理由 | Action |
|---|---|---|
| **US-1.3** Communication Style 設定 | テーマ性ゼロ・デモで映らない | Phase 2 Must から完全削除（FR-5 User Profile から Communication Style フィールド削除） |
| **US-3.6** 応答送信完了後の状態管理 | 観客に違いが伝わらない壮大な裏方ロジック | 完全削除（既に Phase 3 Stretch だったが本パッチで削除） |
| **US-6.3** Outbound メトリクス | KPI カードのみで真面目 SaaS 外見成立 | 完全削除 |
| **US-6.4** Days in Nirvana 表示 | デモ尺で訴求できない | 完全削除（"涅槃期" コンセプト自体は残す）|

### 2.2 Phase 3 Stretch へ降格

| Story | 元 Scope | 新 Scope | 理由 |
|---|---|---|---|
| **US-4.4** Conflict Detection & Coherence Layer | Phase 3 Must | Phase 3 Stretch | 観客に違いが伝わらない裏方 |
| **US-4.5** Plausibility Engineering | Phase 3 Must | Phase 3 Stretch | 同上 |
| **US-5.2** Lv2 信頼期（確率的レビュースキップ） | Phase 2 Must | Phase 3 Stretch | Lv1↔Lv4 コントラスト集約のため Lv2/Lv3 は実装縮小 |
| **US-5.3** Lv3 委任期 | Phase 2 Must | Phase 3 Stretch | 同上 |

### 2.3 Mock 化（実装縮小）

| Story | 元 Scope | 新 Scope | 理由 |
|---|---|---|---|
| **US-5.5** Lv5 涅槃期 自動認定 | Phase 3 Must（日次バッチ） | **Mock 化**（seed 書き込み + UI 表示のみ） | 日次判定実装はデモ尺で検証不可。コンセプトは残す |
| **US-6.2** Maturity Certification バッジ | Phase 2 Should | **静的画像のみ**（リアル算出なし） | 真面目 SaaS 外見の構成要素として絵だけあれば良い |

### 2.4 Phase 3 へ降格（Unit ごと）

| Unit | 元 Phase | 新 Phase | 理由 |
|---|---|---|---|
| **U-9 Realtime（WebSocket 基盤）** | Phase 2 Should + Phase 3 Must | **Phase 3 Must のみ** | Phase 2 では `setTimeout` / SSE / Polling で演出可能、典型的工数ブラックホール |
| **U-8 MACP-Federated** | Phase 3 Must | Phase 3 Must（変更なし）| — |
| **U-10 DemoSetPiece** | Phase 3 Must | Phase 3 Must（変更なし）| — |

---

## 3. 過剰実装の縮小

| 領域 | 元仕様 | 新仕様（Phase 2） |
|---|---|---|
| **Mock Social Feed (規模)** | 5プラットフォーム × 5シグナルカテゴリ × 5-10名 | **3コンタクト × 各2投稿（合計6投稿）** |
| **Mock Social Feed (プラットフォーム数)** | 4 プラットフォーム（Mock X / Mock Instagram / Mock LinkedIn / Mock TimeTree） | **2 プラットフォーム（Mock X + Mock Instagram Story）** — 2026-05-08T11:46:00Z 追補：Cross-Source Triangulation を Phase 3 Stretch へ降格した整合性確保 |
| **Signal Extraction Pipeline** | 6ステップ（Ingestion → Normalization → NER → Confidence → Aggregation → Persist）| **3ステップ圧縮**（Mock投稿取得 → Bedrock 日付抽出 → Window 保存） |
| **Maturity Phase 切替** | Lv1〜Lv4 + Lv5 自動認定 | **Lv1↔Lv4 コントラスト集約**（Lv2/Lv3 は設定上の選択肢として表示するが実装は stub、Lv5 は seed/UI のみ） |
| **3バリエーション類似度検証** | プロンプト並列生成 + 類似度 0.7 以下チェック + 不整合時再生成 | **プロンプト並列生成のみ**（類似度検証は廃止） |
| **shared/agentcore-client** | AgentCore SDK の薄い抽象化レイヤー | **廃止**（各 Lambda から AWS SDK 直呼び） |
| **CDK Stack 構成** | Layered Stacks（Foundation + Data + Application） | **Phase 2: Single Stack** / Phase 3: Layered Stacks |
| **AgentCore Memory 利用箇所** | Inbound, Outbound, MACP の各々で利用 | **MACP 交渉履歴のみ** に集中 |

---

## 4. 絶対残すべき要素（核）

以下は本改訂でも**絶対に削減しない**：

- ✅ **Lv1 ↔ Lv4 切替 UI**（コントラスト演出）
- ✅ **Inbound 3 案生成**（Conservative / Pragmatic / Cordial）
- ✅ **Strategic Outreach**（不在日狙い撃ち誘い）
- ✅ **MACP Single-Tenant 簡易版**（プレゼンの命）
- ✅ **真面目 SaaS Dashboard 外見**（KPI カード = US-6.1）
- ✅ **AgentCore Memory**（MACP 交渉履歴 1 箇所のみ）
- ✅ **Lv5 涅槃期コンセプト**（バッチロジックは Mock 化、UI 表示は維持 — 最強オチ寄与）
- ✅ **MACP**（絶対カットしない、プレゼンが死ぬ）

---

## 5. Phase 2 推奨スコープ（改訂後）

### 5.1 ストーリー: 18 → **12 件**

| Unit | Phase 2 Must Stories |
|---|---|
| **U-1 Foundation** | US-1.1 Signup, US-1.2 Login（**US-1.3 削除**）|
| **U-2 ContactMgmt** | US-2.1 コンタクト追加, US-2.2 Cadence 設定（簡素化）, US-4.7 Mock Feed setup（縮小）|
| **U-3 Inbound** | US-3.1 受信ボックス, US-3.2 3案生成（類似度検証廃止）, US-3.3 編集送信（Lv1）|
| **U-4 Outbound** | US-4.1 Signal 抽出（3ステップ）, US-4.2 戦略的アウトリーチ |
| **U-5 Maturity** | US-5.1 Lv1 動作, US-5.4 Lv4 自己有効化（**US-5.2 / US-5.3 → Phase 3 Stretch**）|
| **U-6 Dashboard** | US-6.1 KPI カード（US-6.2 静的画像内包）|
| **U-7 MACP-Simulator** | US-7.1 Phase 2 簡易版 |

合計: 2 + 3 + 3 + 2 + 2 + 1 + 1 = **14 件**（US-3.4 内部実装はストーリー外として算出 — 概ね目標 12 件を達成）

### 5.2 Unit: 10 → **6 + shared/shared-types**

**Phase 2 Active Units**:
- U-1 Foundation
- U-2 ContactMgmt
- U-3 Inbound
- U-4 Outbound
- U-5 Maturity
- U-6 Dashboard
- U-7 MACP-Simulator
- shared/shared-types（共有型のみ、agentcore-client は廃止）

**Phase 3 へ降格 / 維持**:
- U-8 MACP-Federated（Phase 3 Must）
- U-9 Realtime（**Phase 2 Should から Phase 3 Must へ降格**）
- U-10 DemoSetPiece（Phase 3 Must）

### 5.3 共有パッケージ

- ✅ **shared/shared-types**: 維持
- ❌ **shared/agentcore-client**: **廃止**（SDK 直呼びに変更）

---

## 6. Phase 3 改訂後スコープ

| Unit / Story | 状態 |
|---|---|
| U-8 MACP-Federated | Must（変更なし）|
| U-9 Realtime | Must（Phase 2 から降格）|
| U-10 DemoSetPiece | Must（変更なし）|
| US-2.3 Critical タグ | Must（変更なし）|
| US-5.5 Lv5 自動認定（Mock 化） | Mock 実装で完了 |
| US-6.3 Outbound メトリクス | **削除** |
| US-6.4 Days in Nirvana | **削除** |
| US-3.6 送信完了後状態管理 | **削除** |
| US-4.4 Conflict Detection | Stretch（降格）|
| US-4.5 Plausibility Engineering | Stretch（降格）|
| US-4.3 Engagement Heartbeat | Stretch（変更なし）|
| US-5.2 Lv2 信頼期 | Stretch（降格）|
| US-5.3 Lv3 委任期 | Stretch（降格）|
| US-7.5 MACP Failure Handling | Stretch（変更なし）|

---

## 7. 派生する変更（実装ドキュメント側）

### 7.1 requirements.md
- **FR-5 User Account**: `defaultCommunicationStyle` フィールド削除（プロファイルは displayName のみ）
- **FR-7 Maturity Phase**: Lv2 信頼期 / Lv3 委任期 の Phase 2 実装を縮小（設定UIで選択肢として表示するが内部動作は stub）
- **FR-8.3 Conflict Detection**: Phase 3 Stretch へ降格
- **FR-8.4 Plausibility Engineering**: Phase 3 Stretch へ降格
- **FR-8.5 Mock Social Feed**: Phase 2 範囲を「3 コンタクト × 2 投稿」に縮小、Pipeline は 3 ステップ圧縮
- **FR-8.5.4 Mock プラットフォーム数**: 2026-05-08T11:46:00Z 追補 — **4 → 2 プラットフォームに縮小**（Mock X + Mock Instagram Story のみ、Mock LinkedIn / Mock TimeTree は Phase 3 へ）。Phase 3 本番リファレンス（FR-8.5.1 の 10 種類情報源カタログ）は変更なし
- **FR-3 Productivity Analytics**: Phase 2 は KPI カード（US-6.1）のみ

### 7.2 application-design.md
- **§7 AWS Service Mapping**: Phase 2 = Single Stack に変更、Layered Stacks は Phase 3 のみ
- **shared/agentcore-client** 関連記述を削除（components.md / component-methods.md / services.md / component-dependency.md / unit-of-work.md / unit-of-work-dependency.md）
- **U-9 Realtime** 関連記述を Phase 3 Must へ統一

### 7.3 components.md
- **C-FE-08 WebSocketClient**: Phase 3 Must へ降格
- **C-BE-09 WebSocketBroker**: Phase 3 Must へ降格

### 7.4 component-methods.md
- `UserProfile` 型から `defaultCommunicationStyle` 削除
- `InboundResponseEngine.validatePlausibilityConstraint()` メソッド削除
- `MaturityPhaseManager.shouldReviewInbound/Outbound`: Lv2/Lv3 の判定は Phase 3 Stretch 注記

### 7.5 unit-of-work.md / story-map / dependency
- Unit リストの Phase ラベル更新
- shared/agentcore-client セクション削除
- Phase 2 Active 6 Unit + shared/shared-types に整理
- Phase 2 Must = 12 件への変更を反映

---

## 8. 開発スケジュールへの影響

### 8.1 Phase 2 Construction（5/16〜5/30 = 約2週間）

```
[Day 1-2] Sprint 0 - 基盤
─────────────────────────
- shared/shared-types
- U-1 Foundation
- CDK Single Stack（Phase 2 用）
- Cognito + DynamoDB（最小設定）

[Day 3-7] Sprint 1 - 並列着手
─────────────────────────
- U-2 ContactMgmt（簡素化 Mock Feed 含む）
- U-5 Maturity（Lv1 + Lv4 のみ実装、Lv2/Lv3 は stub、Lv5 は Mock）
- U-6 Dashboard（KPI カード + 静的バッジ画像）

[Day 8-12] Sprint 2 - 機能 Unit
─────────────────────────
- U-3 Inbound（3案生成、類似度検証なし）
- U-4 Outbound（Signal 3ステップ + Strategic Outreach）
- U-7 MACP-Simulator（Single-Tenant 簡易版）
- 演出: setTimeout/Polling で MACP 演出（WebSocket 不使用）

[Day 13-15] Sprint 3 - 統合・予選会準備
─────────────────────────
- 90秒デモシナリオ統合
- プレゼン資料作成
- バグ修正
```

### 8.2 工数削減見積

| 項目 | 元 | 改訂後 | 削減 |
|---|---|---|---|
| Phase 2 Story 数 | 18 | 12 | -6 |
| Phase 2 Active Unit | 7 | 7（U-9 → P3）| -1 Unit 分 |
| 共有パッケージ | 2 | 1 | -1（agentcore-client 廃止） |
| Mock Feed 投入データ | 5×5×10 = 250 | 3×2 = 6 | -97% |
| Mock UI 実装数（プラットフォーム） | 4（X / Instagram / LinkedIn / TimeTree） | **2**（X + Instagram Story） | **-50%** |
| Signal Extraction ステップ | 6 | 3 | -50% |
| WebSocket 実装 | 必須 | 不要（Phase 3 へ）| -100% |
| CDK Stack 数 | 3 | 1 | -67% |

**Phase 2 工数: 約 30% 削減見込み**（5/30 予選会まで余裕拡大）

---

## 9. リスクと緩和

| リスク | 緩和策 |
|---|---|
| Lv2/Lv3 が UI 上で機能しない違和感 | 設定画面で選択肢として表示、移行モーダルで「Phase 2 Beta — 一部挙動は Phase 3 で完成」風の真面目体裁を維持 |
| US-6.2 静的バッジが「動かない」と気付かれる | Phase 2 では `Cautious Practitioner` のみ実バッジ、他は "Coming Soon" 表記の真面目 SaaS 体裁 |
| WebSocket なしで MACP 演出のリアルタイム感が不足 | `setTimeout` + Polling で疑似リアルタイム演出（5往復メッセージを順次 fade-in）|
| AgentCore SDK 直呼びによるテスト容易性の低下 | Lambda レベルの単体テストで AWS SDK モック使用 |

---

## 10. 承認

本改訂は **Units Generation 承認待ち段階** で実施。修正後、Construction Phase 進行可。

- **対象**: stories.md / unit-of-work.md / unit-of-work-story-map.md / execution-plan.md / requirements.md / application-design.md / component-methods.md / components.md / unit-of-work-dependency.md
- **方針**: 上記 §7 派生変更を順次反映
- **audit ログ**: 本改訂の意思決定を audit.md に記録