オンボーディング計画 総点検 2026-07
3月からの検討4系統（設計SoT・Linear・実装・本番）を1枚に突き合わせた総点検（§1〜§5 = 7/21 時点の診断・記録として保持）。最新の現在地と計画は直下の「現在地 2026-07-22」を見る。
TL;DR（2026-07-22 現在）
7/21 の総点検で見つかった不整合16件はすべて解消。6/29「AI取込起点」を正と宣言し PRD v3.0 に一本化、未決5点も裁定済み。 ウィザード本体は実装・コードレビュー・design-lock 突き合わせ（10/10）まで完了（A案 Warm Studio 採用・背景 #f4f7f5）。 残るは「スタートガイド中核（サイドバー常駐＋チェックリスト4項目＋1/4リビール）」を実装し、ウィザードと束ねて1リリースすること（姉崎判断: ガイド無しでは出さない）。実UIは claude.ai/design「nanco onboarding スタート」が既にあり、それを正とする。 その後に計測 → 磨き。次の関門は OnboardingProgressDB の db:push と、3リポジトリの未push解消・実機確認。
現在地 2026-07-22 — 実装は完了、リリースはスタートガイドと合流待ち
総点検（§1〜§5）は「4層が別時点で止まっている」診断だった。それが解けて、いまは実行フェーズ。下が最新の進捗と計画。
整合化
ウィザード実装
スタートガイド
合流
いま残っていること（完遂まで）
① 出す前: スタートガイド中核を実装（別セッション）＋ OnboardingProgressDB db:push。 ② 合流リリース: 実機（サインアップ→ウィザード→M6→ガイド1/4リビール→チェックリスト／経路A・B／招待エッジ）→ MR → release。 ③ その後: 計測（HogQL引き直し・観察）→ 磨き（進捗バー・メール・デザイン追い込み）。 名称: ✅「はじめにやること」に決定（2026-07-22。"start" の二度感回避）。スタートガイドの実UIは4者パネル（PLG/art-director/brand-check/Codex）レビュー→修正反映済み（1/4スタート・CTA主役1つ化・コピー修正）。
30秒で分かる現在地 — 4層がそれぞれ別の時点で止まっている 7/21 の診断・解決済み
※ これは 7/21 総点検時点の診断で、記録として残す。この 4層の乖離は Phase 0 で解消済み（最新は上の「現在地 2026-07-22」）。オンボーディングには「設計SoT」「Linear」「実装」「本番」の4層があり、当時それぞれの最終更新時点が異なっていたのが「わかりにくさ」の正体だった。
nanco-knowledge
MARK / NANCO
nanco-next
staging / release
診断
やるべきことは「新しく計画を作る」ではなく、6/29 の決定を正と宣言して4層を揃え、止まっている実装を仕上げてリリースすること。設計資産（業種マスタ・計測設計・メール・空状態5型）は方向転換後もほぼ流用できる。
経緯タイムライン — 検討はどう積み重なってきたか
4つの系統が順に登場し、後の系統が前の系統を部分的に上書きしてきた。太字が各時点の「正」。
-
2026-03-26系統① Empty State 起点案（nanco-next docs）
docs/onboarding-redesign.md。実測ファネルを根拠に「モーダル＋ツアー廃止 → Empty State インライン追加＋チェックリスト＋メール15通」を提案。未実装のまま次の系統に事実上上書きされたが、supersede 宣言はされていない。
-
2026-04-27PLG 基盤構築 — 74%脱落の発見
TTV計測パイプライン稼働と同時に「サインアップ→初回アイテム追加 通過率 26%（= 74%が離脱）」「招待メンバー活性化 0%」を特定（baseline-2026-04 v0.5）。オンボ刷新が Q2 PLG の最重要施策に昇格し MARK-1 起票。
-
2026-05 全月系統② 6ステップウィザード体系（nanco-knowledge）
PRD v2.0→v2.5、実装spec v0.3、業種プリセット v0.3（8業種＋その他=9択・CEO裁定）、観察モード計測 v0.5（22イベント＋HogQL 6本）、Path D v0.4（専用オンボ廃止・ウェルカムのみ）、メールv2（Knock 9 Workflow）、モバイル spec v0.2。5/27 にウィザード v3 デザイン close（decision-log 記録）。
-
2026-06-18系統③ 空状態5型システム（decision-log）
空状態を型A〜E に体系化。型A（初回未作成）がオンボ完了後の受け皿になる設計。系統①の Empty State 思想はここに引き継がれて生存。
-
2026-06-29系統④ 方向転換の決定 — 「AI取込起点に寄せる」（姉崎決定）
6月に AIインポート（在庫モーダル内・画像/PDF vision）が急成長したため、ウィザード Step④業種選択→⑤属性プリセットの中身を「手持ちデータあり/なし分岐 → AI取込 or 業種サンプル」に置換する統合フローを確定。スコープは「ウィザード本体まで実装」。統合プラン: ~/.claude/plans/onboarding-ai-import-integration.md v0.1。
-
2026-06-30実装完了（ローカルのみ）＋デザイン検討着手
ウィザード本体（542行）＋業種プリセット移植を4コミットで実装、code-reviewer 通過、新規サインアップでの表示まで実機確認。同時に「UIがのっぺり」指摘 → claude.ai/design で A案（Warm Studio）/ B案（Premium Depth）を作る方針にしたが、生成JSXは未受領のまま停止。
-
2026-07-01〜21停止期間（他案件優先）→ 本総点検
課金 Phase 5・ext/v1・AI取込スライス群を優先しオンボは手つかず。7/11 に NANCO-779（boxhero型オンボ）を Canceled（新方向と整合する正しい整理）。本レポートで4層を突き合わせ。
検討資産マップ — どこに何があるか・どれを信じるか
参照優先度: nanco-knowledge の markdown が正本。nanco-reports の HTML は共有用レンダリングで1〜2版古い（§5 C-2）。
| 系統 / 場所 | 代表物 | 状態 |
|---|---|---|
| 設計SoT nanco-knowledge strategy/deliverables/ |
PRD prd-2026-05-empty-state-and-onboarding.md v2.5 ／ 実装spec v0.3 ／ 業種プリセット v0.3（9択） ／ 観察モード計測 v0.5 ／ Path D v0.4 ／ メールv2 ／ モバイル v0.2 ／ 業種アイコンPNG 8枚（sessions/） | 正本だが 6/29 転換未反映 |
| 意思決定記録 nanco-knowledge/decision-log/ |
TTV再定義（05-11）／ 5論点＋Path D KPI裁定（05-22）／ ウィザードv3 close（05-27）／ 業種9択確定（05-27）／ 空状態5型（06-18） | 6/29 決定の記録が無い |
| 共有レンダリング nanco-reports/*.html |
マスター計画 ／ UXフロー v2.0 ／ PRD ／ 業種プリセット ほか | md より1〜2版 古い |
| 統合プラン ~/.claude/plans/ |
onboarding-ai-import-integration.md v0.1（6/29 決定の実体・統合フロー定義） | 最新の正（ただし個人環境のみ） |
| 実装 nanco-next |
ブランチ feat/anezaki-202606-onboarding-ai-import: OnboardingWizard.tsx（542行）＋ src/lib/onboarding/industryPresets.ts（231行）＋旧モーダル削除。現行本番: src/pages/folder/component/OnboardingModel.tsx（2問） | 新実装は未push |
| デザイン素材 claude.ai/design ほか |
v3ウィザード生成プロンプト（knowledge に保存）／ チャットUI版 zip ~/Downloads/nanco onboarding (Template).zip（現存）／ 6/30 A案/B案ブリーフ提供済み・生成JSX未受領 | 磨き素材が宙ぶらりん |
| Linear 2チーム |
Marketing「Q2 オンボーディング刷新」16 issue（MARK-1 中核）／ nanco チーム側に散発（NANCO-779 は 7/11 Canceled、NANCO-733 は別トラック） | 旧スコープ・実装issue不在 |
実体の検証結果 — git・コードで確認した事実
2026-07-21 に git（merge-base / show）とコード grep で直接検証。記憶やドキュメントの記述ではなく、現物ベース。
現行フロー（本番・staging で稼働中） 旧2問モーダル
完了判定はハードコード false のため init 着地のたびに再表示される。回答はサンプル生成にもメールにも使われていない。
新フロー（ブランチ実装済み・未リリース） AI取込起点ウィザード
点線 = 仮実装。完了判定は API 参照に修正済み（旧モーダルの再表示バグを解消）。計測は 30_setup_industry_selected / 30_setup_branch_chosen / 30_setup_sample_generated の3種を発火。
ブランチの実状態（git 検証）
feat/anezaki-202606-onboarding-ai-import は origin/staging に対し 4コミット先行・未push（merge-base で確認）。差分は +775/−471行・4ファイル。staging との衝突リスクは配線1ファイル（folder/[folderId].tsx）程度と小さい。
AI取込本体の成熟度
在庫モーダル内の AI取込（CSV/Excel/画像/PDF）はリリース済みで成熟。ただしオンボ転用4点 — フルスクリーン独立ページ／空状態CTA／ImportSessionDB.isOnboarding のサーバー側実装／業種→AIプロンプト結線 — は未着手。
本番の回答フロー稼働状況
Slack #nn_notify_新規登録情報 に「オンボーディング回答送信」が7/20 も多数着信。旧2問モーダルは現役で、方向転換の恩恵がまだ誰にも届いていない。
検証方法
git merge-base / git show による実ブランチ検査、nanco-next・nanco-knowledge・nanco-reports の全文探索（サブエージェント2体）、Linear 全 issue 検索、Slack 検索、claude.ai/design プロジェクト一覧・成果物の実在確認。
不整合 16件 — 重要度順に3グループ
A = 方向性（計画の根幹）、B = 実装の中身（リリース前に潰す）、C = ドキュメント衛生（放置すると再発する）。
A. 方向性レベル — 3件
これを解消しない限り、どのドキュメントを開いても「正解」が分からない。
B. 実装の中身レベル — 7件
ウィザード v1 をリリースする前に潰す（または明示的に見送る）項目。
C. ドキュメント衛生レベル — 6件
今回の混乱の温床。放置すると次の設計サイクルで同じ事故が起きる。
これからの計画 — 実装済み＋合流リリース（2026-07-22 更新）
正 = 6/29 決定（AI取込起点ウィザード）＋ PRD v3.0。リリース単位の変更（7/22 姉崎）: ウィザード単体では出さず、スタートガイド中核と束ねて1リリース。役割分担: 設計・レビュー = Fable ／ 実装 = Opus ／ 実機・push・MR・リリース = 姉崎。
- 6/29 決定を decision-log に正式起票／PRD v2.5 → v3.0（§4.5 全面・計測イベント正本化）
- MARK-1 改訂＋NANCO-1708 起票＋MARK-60 クローズ／旧 docs superseded 注記（実装ブランチに同乗）
- 不整合16件すべて解消・未決#1〜#5 裁定済み
- (a) デザイン: A案（Warm Studio）採用・背景 #f4f7f5（クリーム排除）・暖色→寒色化。B案は不採用（将来ダークモード参照）
- (b) 実装: feat/anezaki-202607-onboarding-v5（staging起点・3コミット）。ウィザード骨格／流入経路チップ／計測イベント全件／industry 専用フィールド／Path D ガード／業種→AI結線／旧モーダル削除。code-reviewer 2巡 + design-lock 10/10 突き合わせ合格（飲食ラベル1件修正）
- ⚠️ 単体リリースはしない → 下の Phase 2 中核と合流
担当: 姉崎（デザイン）→ Opus（実装）→ code-reviewer 2巡 → Fable（design-lock 突き合わせ）
- OnboardingProgressDB 新設 → db:push → PlanetScale Deploy Request（ウィザード単体には無かった新関門）
- サイドバー常駐ガイド＋チェックリスト完了検知（4項目）＋M6クローズで 1/4 リビール（アイテム追加✓ が既にチェック済み＝ウィザードで追加）。実UI = claude.ai/design「nanco onboarding スタート」を正とする（入場1/4とリビールは実装で追加）
- M6の「次の一手3カード」の遷移先をガイド起点に確定（単体先行時の直リンク暫定を最初から回避）
- 合流リリース: 実機（サインアップ→ウィザード→M6→ガイド1/4リビール→チェックリスト進行／経路A・B／招待エッジ）→ push・MR・staging → release
担当: Opus（実装）→ Fable（レビュー）→ 姉崎（db:push・実機・リリース）／ 名称: ✅「はじめにやること」・実UIレビュー反映済み
- イベント着弾確認 → HogQL 6本を新イベント名で引き直し（改善判定 +10pt / +5pt 目安）／ スタートガイド完走率
- MARK-22（Layer 2/3）確定 ／ MARK-77（業種コホート）／ MARK-10 ベースライン更新（26% → どこまで動いたか）
担当: Opus（クエリ・計装）＋ analyst（集計・解釈）
- ダッシュボード進捗バー（§4.8）／ ガイドページ作り込み（§4.7 詳細）／ オンボメール v2 = Knock 連動（§4.9）
- デザイン追い込み／完了体験の祝福演出／空状態・型A 接続・離脱ハッチ（MARK-75）
- Flutter 方針決定／ Path D の残り（ウェルカム最小対応）
担当: 観察結果を見て優先度を再判定（Fable）
着手前に決めること 5点 全裁定済み（7/21〜22）
当初の5点はすべて裁定済み（下記）。その後 7/22 に追加決定: デザイン A案（Warm Studio）採用・背景クリーム排除（#f4f7f5）／リリース単位はウィザード＋スタートガイド中核のバンドル／スタートガイドは A案=4項目・1/4（既存の実UIデザイン発見→5項目案撤回）／スタートガイド設計を4者パネル（PLG/art-director/brand-check/Codex）でレビュー→修正反映／UI表示名「はじめにやること」に確定。オンボ関連の未決事項はこれで解消。
#1「正」の宣言 — 6/29 決定を正とし、PRD v3.0 に一本化するか 決定済み 7/21: (a) 一本化
- (a) 一本化する（Phase 0 を実行）← 姉崎決定・同日実行済み
- (b) 6ステップウィザード（v2.5）に戻す ／ (c) もう一度ゼロから方向を議論する
決定に伴い実施済み: decision-log 2026-06-29 遡及起票／PRD v2.5 → v3.0 改訂（§4.5 全面・計測イベント正本化・§8 Phase計画）／実装spec・A/B doc へ凍結注記／Path D・A/B・業種プリセットの旧記述パッチ。
#2実装ブランチの扱い 決定 7/21: (b) ゼロから作り直す
- (a) rebase して仕上げる（推奨だった）
- (b) staging から新規実装 ← 姉崎決定。旧ブランチ feat/anezaki-202606-onboarding-ai-import は参照実装として保持
決定の背景 — #5 デザイン先行と組み合わせ、新デザイン + Phase 1 修正を最初から織り込むクリーンな実装を選択。
#3流入経路質問（どこで知りましたか）（B-2） 決定 7/21: (a) 完了画面に残す
- (a) 完了画面に任意1タップで残す ← 姉崎決定（推奨どおり）
- (b) 捨てて UTM / PostHog の行動データに一本化
実装 — 完了モーダルに選択チップを配置、イベント 30_setup_referral_answered（PRD v3.0 §4.5.5 に追加済み）。
#4業種の選択肢数（B-1） 解消 7/21: 誤検出だった
- 正本（presets v0.3 §1.4）= 7業種＋その他 = 8択で、実装と ID・ラベル・表示順・アイコンまで完全一致（三点照合済み）
- 「9択」という表記の側が誤り（物流削除前の名残）→ ドキュメント修正のみ実施
判断不要となった。実装修正なし。B-1 の訂正も参照。
#5デザイン（B-6） 決定 7/21: (b) A案/B案を先に受領
- (a) 現状UIでリリースし、磨きは Phase 3（推奨だった）
- (b) claude.ai/design の A案/B案 JSX を先に受領・反映してからリリース ← 姉崎決定
決定の帰結 — Phase 1 のクリティカルパスは姉崎のデザイン生成作業になる（ブリーフは 6/30 提供済み・AIが数字を盛る P-011 フィルタ必須）。#2 の新規実装は新デザイン準拠で行う。
付録 — 数値・Linear 処遇表・参照一覧
ベースライン（2026-04-28 計測・コホート n=23）と目標
サインアップ→初回アイテム追加
26%
= 74% が離脱（最大の壁）。目標 50%（v1後）→ 65% → 80%
24h 活性化率
34.8%
7日活性化率と同値 = 初日で決まる。目標 50% → 60% → 70%
TTV 中央値
11分
Mobile 3.4分 / Web 24.9分。活性化率は Web 57% vs Mobile 31%
招待メンバー活性化（Path D）
0%
n=2。目標 15%（N≥10）→ 25%（N≥15）→ 40%
出典: baseline-2026-04.md v0.5。判定は観察モード（A/B なし・前後コホート比較・+10pt=改善 / +5pt=傾向）。
Linear 処遇表（提案）
| Issue | 現状 | 提案 |
|---|---|---|
| MARK-1（エンプティ＋ウェルカム＋ツアー） | Urgent / In Progress / 期限 7/4 超過 | 新スコープ（AI取込起点オンボ刷新の親）に書き換え・期限再設定。ツアーは 5/22 に除外済みなのでタイトルからも落とす |
| （新規）ウィザード v1 実装 | 存在しない | nanco チームに実装 issue を起票（Phase 1 のタスク一式・B群 7件を本文に） |
| MARK-60（Path D 設計） | In Progress / 期限 6/27 超過 | 設計は v0.4 で完了済み。残作業（B-7 の除外ガード確認）を実装 issue に移してクローズ |
| MARK-22（Layer 2/3 イベント） | Backlog（新オンボ設計待ち） | Phase 2 で着手可能になる。PRD v3.0 確定後にブロック解除 |
| MARK-75（「今やるのはまだ面倒」離脱対策） | Backlog | Phase 3 の離脱ハッチ設計に統合 |
| MARK-3 / 20 / 59（オンボメール系） | Backlog / Todo | 方向転換の影響なし・独立継続（Phase 3 で接続） |
| MARK-4（残り3バンパー）・MARK-23（オンボ動画観察）・MARK-21（Engagement Score）・MARK-77（業種コホート） | Backlog / Todo | Phase 2〜3 に配置換え。MARK-23 は「新オンボの観察」に目的を更新 |
| MARK-10（B軸ベースライン） | In Progress / 期限 7/11 | 継続。Phase 2 でリリース後データを追記 |
| NANCO-779（boxhero型オンボ） | Canceled（7/11） | そのまま（新方向と整合する正しい整理） |
| NANCO-733（アンケートで期間延長） | Backlog | 別トラック（トライアル転換）として維持 |
主要参照（正本の場所）
| 物 | 場所 |
|---|---|
| PRD（改訂対象） | nanco-knowledge/strategy/deliverables/prd-2026-05-empty-state-and-onboarding.md（v2.5） |
| 6/29 統合フローの実体 | ~/.claude/plans/onboarding-ai-import-integration.md（v0.1） |
| 実装ブランチ | nanco-next: feat/anezaki-202606-onboarding-ai-import（4コミット・未push） |
| 現行本番の2問モーダル | nanco-next: src/pages/folder/component/OnboardingModel.tsx ＋ pages/api/v1/company/onboard.ts |
| 業種マスタ（9択の正） | nanco-knowledge/strategy/deliverables/onboarding-industry-presets-2026-05.md（v0.3） |
| 観察モード計測（改名対象） | nanco-knowledge/strategy/deliverables/onboarding-ab-test-design-2026-05.md（v0.5） |
| 意思決定の記録場所 | nanco-knowledge/decision-log/（6/29 決定をここに起票する） |
| 3月の旧設計（superseded 予定） | nanco-next/docs/onboarding-redesign.md |