Reports
nanco — Session 2026-05-22 オンボ UX フロー作成 → 5 論点判断 → SoT 同期 → 実装 spec まで(16 タスク完了)

Session / 2026-05-22 / オンボ UX 一括整理

セッション成果物(5/22 オンボ UX)

「画面を作るのが時間かかるから、 オンボ UX 進めたい」 という発火から、 nanco-reports に俯瞰フロー HTML を作成 → 整合性チェックで SoT 矛盾 2 件発覚 → 5 論点を 1 件ずつ判断(即決 4 件 + 3 役者諮問 + CEO 裁定 1 件) → 4 SoT 同期 + 学習ループ反映 + Linear 反映 + 実装 spec 作成 までを 1 セッションで完走。 19 件の成果物を上から順に確認できる索引。

TL;DR 5/22 オンボ UX 一括整理。 19 件の成果物(HTML 1 + SoT 4 + 学習 + Playbook + spec + Linear 3 件 + 整合性反映 28 HTML)。 全 5 論点クローズ、 実装 spec まで揃った。

完了タスク

16/16

UX 作成 → 5 論点判断 → 4 SoT 同期 → 学習ループ → Linear → 実装 spec

判断クローズ

5/5

即決 4 件 + CEO 裁定 1 件(3 役者諮問プロセス)

SoT 同期

4SoT

PRD v2.3 / Path D v0.3 / A/B v0.4 / Layer 2/3 v0.3

学習反映

P-009

win-pattern + strategic-decision Playbook v0.1 構築

00 Overview

セッションの流れ(5 つの Phase)

時系列で 5 Phase が走った。 各 Phase の成果物が下の A〜E セクションに対応。

時系列

Phase 1-5

  • Phase 1 UX フロー HTML 作成(v0.1 → v0.6)
  • Phase 2 5 論点判断(即決 4 件 + 3 役者諮問 + CEO 裁定 1 件)
  • Phase 3 SoT 同期 4 ファイル + decision-log 起票
  • Phase 4 学習ループ + 索引 + Linear 反映
  • Phase 5 仕上げ(PRD 残記載修正 / Layer 2/3 doc / Playbook 構築 / 実装 spec)

確認の順序

A → B → C → D → E

  • A. 新規アウトプット(UX フロー / Playbook / 実装 spec / decision-log)
  • B. 5 論点の判断結果(採用方針と影響範囲)
  • C. SoT 同期更新(4 ファイル、 改訂履歴つき)
  • D. 学習ループ + 索引(pattern-library / decision-log.html / index.html)
  • E. Linear 反映 + 整合性(3 MARK にコメント + 26 HTML 同期)
A Outputs

新規アウトプット(4 件)

本セッションで新規に書き起こした 4 つのドキュメント。 仕様の中核。

  1. A1

    オンボーディング UX フロー v2.0(v0.6)

    HTML 索引

    本セッションの出発点。 PRD v2.2 + Path D doc + 7 つの周辺 doc を横断して、 Owner / Member 両系統を 1 枚で俯瞰する UX フロー図 + 主要 8 画面ワイヤー + 遷移条件一覧 + 5 論点の判断結果を収録。

    • 俯瞰フロー 1 枚(Owner / Member 並列、 スキップ / 分岐含む)
    • 画面ワイヤー 8 種(S1 ウェルカム / S2-4 質問 3 段 / S5 プリセット / S6 ダッシュボード / S8 スタートガイド / M3 Path D ウェルカム)
    • 04 Spec 一覧表(画面 × 遷移 / スキップ可否 / 計測イベント)
    • 05 論点 5 件すべて ✅ 決定済(緑帯)
    • 06 Next(残作業の段階)

    原典: なし(本 HTML 自体が新規索引)/ 関連: PRD v2.3 + Path D v0.3

    確認 →
  2. A2

    strategic-decision Playbook v0.1(新規構築)

    Playbook

    本セッションの判断プロセス(5 論点判断 + 3 役者諮問 + CEO 裁定 + SoT 同期チェック)を 汎用 Playbook として結晶化。 P-009 win-pattern + 反例の教訓を組み込み。 これまで「📅 計画」 だった 11 Playbook の 1 つを ✅ v0.1 化。

    • 6 Phase 構成(入力整理 → 並列諮問 → 集約 → CEO 裁定 → SoT 同期チェック → 学習反映)
    • Phase 4 = SoT 同期チェックが核(反例の教訓を Playbook で強制解消)
    • アンチパターン 6 件を明示(Director 全員一致で CEO スキップ NG 等)
    • 実走例: 2026-05-22 Path D KPI 判断を参照

    場所: playbooks/strategic-decision.md / README 反映済(「📅 計画」 → 「✅ v0.1」)

    MD →
  3. A3

    オンボ実装 spec 2026-05 v0.1(Cursor / エンジニア渡し用)

    実装 spec

    PRD v2.3 + Path D v0.3 + UX フロー v0.6 + プリセット v0.2 + Layer 2/3 v0.3 + A/B v0.4 を統合した 実装着手判断資料。 nanco-next / nanco-flutter の「どのファイルに何を足すか」 まで落とした粒度。

    • 30 秒サマリ + 関連 SoT 索引 + 着手判定(§9)まで
    • v0.1 / v2.0 の境界リスト(実装する / しない)
    • 計測イベント全仕様(Owner / Path D / Layer 2/3 統合)
    • ファイル想定(nanco-next / nanco-flutter 別)
    • 受け入れ基準(QA / レビュー観点)

    場所: strategy/deliverables/onboarding-implementation-spec-2026-05.md / MARK-1 の着手判定資料として機能

    MD →
  4. A4

    decision-log/2026-05-22-path-d-kpi-consolidation.md(新規起票)

    判断記録

    CEO 推奨で起票。 Compiled Truth + Timeline モデル。 5 論点の判断結果 + 諮問プロセス + SoT 同期更新の経緯 + 学習ループ反映を 1 ファイルに集約。 将来同じ議論の再発を防ぐためのメモ。

    • 5 論点の判断結果一覧(誰がどう判断したか)
    • 論点 4 の 3 役者諮問プロセスの経緯(PLG → Traction → CEO)
    • Compiled Truth: pattern-library に win-pattern として残す価値 / 反例の教訓
    • Open Questions(観察モードで補正する論点)

    場所: decision-log/2026-05-22-path-d-kpi-consolidation.md / nanco-reports/decision-log.html の 18 エントリ目に追加済

    確認 →
B Decisions

5 論点の判断結果

UX フロー作成過程で発覚した 5 つの論点。 即決 4 件 + 3 役者諮問 1 件で全件クローズ。

  1. B1

    論点 1: プロダクトツアー(S7)を v0.1 から外す

    姉崎即決

    「D 採用」 = プロダクトツアー(3 step)を v0.1 スコープから外し、 ウェルカム + スタートガイド で全体像を伝える設計に切り替え。 24h 勝負(baseline)+ ツアー = 割り込み の原則と整合。

    • v0.1 で実装するバンパー: ウェルカム / エンプティ / スタートガイド の 3 種(旧: ウェルカム / エンプティ / ツアー)
    • PRD v2.3 §1.4 で「~~プロダクトツアー~~ → 見送り」 として記録
    • v2.0 効果観察後に再評価(v2.0 でも復活する判断は保留)

    影響: PRD v2.3 §1.4 / UX フロー v0.6 §5 論点 1 緑帯

    確認 →
  2. B2

    論点 2: Path D 役割選択(viewer/editor/co_owner)を廃止 → 単一フロー化

    姉崎即決

    「ワークスペースを最初に作った人 = オーナー = 管理者、 招待されたメンバーは全員非管理者として同じ扱い、 出す出さないは管理者かどうかでいい」 という姉崎の整理。 役割選択 UI 自体を廃止し、 全員に共通の「最初のアクション」 を提示。

    • M3 ウェルカム: 役割選択 3 ボタン UI 撤回 → 「最初のアイテムを開く」 CTA に統一
    • M4 最初のタスク: 役割別 3 種を統合 → 全員共通の「+1 / -1 を試す」
    • M5 スタートガイド: 役割別出し分けを撤回 → 全員共通 3 項目
    • イベント 30_path_d_role_selected を廃止、 30_path_d_welcome_shown を追加

    影響: Path D doc v0.3 §2.1-§3.5 / §5.1-§5.2 / UX フロー v0.6 §5 論点 2 緑帯

    確認 →
  3. B3

    論点 3: 質問駆動スキップ後の戻り口 = エンプティに 30 秒リンク

    姉崎即決

    「C 採用」 = アイテム 0 個時のダッシュボード(エンプティステート)に「業種を選んでサンプル生成 ・ 30 秒」 リンクを併設。 アイテム 1 個以上で自動消去(時限的)。 UI 永続的に複雑化させず、 スキップした人の戻り口を確保。

    • v0.1 で実装する(v2.0 質問駆動の前出し導線)。 v0.1 期はリンク先「準備中」 でも OK
    • 新規計測 30_empty_state_preset_link_clicked
    • S6 wire の「経路で表示が変わる」 注記は次回更新(残作業)

    影響: PRD v2.3 §4.5.1 / UX フロー v0.6 §5 論点 3 緑帯 + Owner Lane SKIP ブロック

    確認 →
  4. B4

    論点 4: Path D 活性化率目標 = 候補 B(15/25/40 + 母数 N≥10/15)

    CEO 裁定

    3 役者諮問プロセス(director-plg-review + director-traction-review 並列 → nanco-ceo-review 集約)。 両ディレクター一致で候補 B、 CEO 裁定 APPROVE。 旗印整合性: 候補 A の「6 月 20%」 は到達手段が 6 月時点で存在しない = 旗印核 5「現場に足を運んで作る」 の対極 と判定。

    • 採用: 0% → 15%(v0.1 後 1 ヶ月、 N≥10)→ 25%(v2.0 後 1 ヶ月、 N≥15)→ 40%(Phase 2)
    • タイミング軸: 月別 → リリース版別 に変更
    • Traction との関係明示: PLG 健全性指標、 Owner SEM 獲得が月 30 件超えるまで Traction 一次 KPI ではない
    • パターン化: pattern-library/win-patterns.md に P-009 として追加

    影響: PRD v2.3 §2 / Path D v0.3 §5.3 / A/B v0.4 §3.2 §3.4.2 / Layer 2/3 v0.3 §8 / UX フロー v0.6 §5 論点 4 緑帯

    経緯 →
  5. B5

    論点 5: 業種数 7 → 8(設計建築・施工 を v0.1 から追加)

    姉崎即決

    「A 採用」 = プリセット v0.2 を正本、 PRD v2.3 で設計建築・施工 を加えた 8 業種に揃える。 v0.1(6 月応急処置)から 8 業種で公開。 設計建築のサンプルデータはプリセット v0.2 §2.7 に既存。

    • Q1 業種選択: 7 択 + その他 → 8 択 + その他
    • 追加業種: 設計建築・施工(プリセット v0.2 §2.7)
    • 卸売(プリセット v0.2 §2.9)は参考扱い、 v2.0 で正式追加検討

    影響: PRD v2.3 §4.5.2 / UX フロー v0.6 S2 ワイヤー + §5 論点 5 緑帯

    確認 →
C Sync

SoT 同期更新(4 ファイル)

CEO 裁定の修正指示 6 段階に従って、 4 つの SoT を順次更新。 全てに改訂履歴 + バージョン付き。

  1. C1

    Path D doc v0.2 → v0.3

    SoT

    最も影響が大きい SoT 更新(9 章を変更)。 役割選択廃止 + CEO 裁定(候補 B)を反映。 計測基盤の整合性が最優先(CEO 指示の優先度 1)。

    • §2.1 設計原則 (2)(4) / §2.2 比較表: 役割選択廃止
    • §3.3 ウェルカム: 役割選択 3 ボタン UI 撤回
    • §3.4 最初のタスク: 役割別 3 種を統合
    • §3.5.1 チェックリスト: 全員共通 3 項目
    • §5.1 イベント: 30_path_d_role_selected 廃止 + 30_path_d_welcome_shown 追加
    • §5.2 HogQL: role 分岐削除 + 母数判定列追加
    • §5.3 目標 KPI: 候補 B 確定 + 母数条件併記
    • §5.4 期待値: 役割別削除 → 単一フロー期待値
    • §10 改訂履歴 v0.3 + ヘッダー更新

    場所: strategy/deliverables/onboarding-path-d-invited-member-2026-05.md

    旧 HTML →
  2. C2

    PRD v2.2 → v2.3

    SoT

    UX フロー 5 論点の判断結果を 5 箇所に反映。 §1.4 バンパー 6 種からツアー外し / §2 ゴール表 Path D 行 / §4.5.1 スキップ戻り口 / §4.5.2 8 業種化 / §4.9 通知連携 / §5.2 観察設計 / §6.1 主要 KPI。

    • §1.4: バンパー 6 種から「2. プロダクトツアー」 を v0.1 外へ降ろす(論点 1)
    • §2: Path D 行を候補 B + 母数条件 + リリース版別 で再設計(論点 4)
    • §4.5.1: スキップ後のエンプティ戻り口を明記(論点 3)
    • §4.5.2: 業種を 7 → 8 + その他、 設計建築追加(論点 5)+ A/B 検証 → 観察モード v0.3 表現修正
    • §4.9: 役割質問 → 最初のアクション提示(論点 2 派生)
    • §5.2 観察設計: Path D KPI を候補 B + N≥10 条件付き判定 に更新
    • §6.1 主要 KPI: Path D 行を候補 B に更新
    • §9 改訂履歴 v2.3 追記

    場所: strategy/deliverables/prd-2026-05-empty-state-and-onboarding.md

    旧 HTML →
  3. C3

    A/B doc v0.3 → v0.4

    SoT

    論点 4 CEO 裁定 + Traction の母数条件追記を反映。 §3.2 観察 2(v2.0 リリース効果)の Path D KPI を候補 B 数値 + N≥10 条件付き判定 に。 §3.4.2 改善判定目安表に Path D 2 行(v0.1 後 / v2.0 後)+ N 閾値追加。

    • §3.2 観察 KPI: 0% → 15%(v0.1) → 25%(v2.0) → 40%(Phase 2)
    • §3.2 観察判断ルール: 「N≥10 充足時のみ判定、 N<10 は計測不可・継続観察」
    • §3.4.2 改善判定目安: Path D 2 行(v0.1 後 / v2.0 後)+ 母数条件
    • §9 改訂履歴 v0.4 追記

    場所: strategy/deliverables/onboarding-ab-test-design-2026-05.md

    旧 HTML →
  4. C4

    Layer 2/3 イベント doc v0.2 → v0.3

    SoT

    残課題 #3「チームメンバー視点の Layer 2/3」 を「Path D v0.3 で単一フロー化 + 統合済み」 として **解消済**に更新。 役割プロパティでの分岐は廃止、 全員 30_update_count 1 回以上を Layer 1 到達条件として共通化。

    • §8 残課題 #3 を解消済に更新
    • Path D doc §5.2 HogQL(単一フロー版)への参照を明示
    • §9 改訂履歴 v0.3 追記

    場所: strategy/deliverables/onboarding-layer-2-3-events-2026-05.md

    旧 HTML →
D Meta

学習ループ + 索引(3 件)

判断と SoT 更新を「次回の Playbook 実行時に取り込むメモ」 として残す層。

  1. D1

    pattern-library/win-patterns.md に P-009 追加

    学習

    「ディレクター 2 名一致でも CEO 裁定で旗印整合性を確認すると核軸が出る」 を win-pattern として結晶化。 CEO が出した独自の判断軸(到達手段と目標の誠実な紐づけ)が、 ディレクター単体では出にくいことを記録。 反例として「PRD と詳細設計 doc の更新タイミングずれで古い目標値が公式 KPI 風に残る」 教訓も併記。

    • パターン概要 + 実走したフロー + CEO 独自の判断軸 を構造化
    • このパターンが効くシーン / 使うべきでないシーン
    • 関連 pattern: P-001(PDCA 10 ループ)と同じ多軸最適確認の構造
    • 反例として「SoT 同期プロセスを Playbook に組み込む」 提案 → A2 strategic-decision Playbook に直結

    場所: pattern-library/win-patterns.md

    MD →
  • D2

    nanco-reports/decision-log.html に 18 エントリ目を追加

    索引

    本セッションの decision-log(A4 で起票)を判断履歴 HTML に追加。 hero / TLDR / TOC / index hub-card / brand-context を全て 18 エントリに同期更新。

    場所: nanco-reports/decision-log.html#d-2026-05-22-path-d-kpi

    確認 →
  • D3

    nanco-reports 26 HTML 全件の reports-rail に UX フローリンク追加

    索引

    DESIGN-PATTERNS.md「全 HTML で同じ reports-rail snippet」 規約に従い、 全 26 HTML の「KPI / Deep Dive」 グループに「オンボ UX フロー v2.0」 リンクを sed で一括挿入。 ナビゲーションの一貫性を確保。

    影響: 全 26 HTML(daily-sync / weekly-plan / onboarding-* / strategy-* / kpi-dashboard / ttv-deep-dive 等)

    index →
  • E Linear

    Linear 反映(3 MARK にコメント追加)

    既存 MARK にコメントを追加して、 チーム / Cursor / エンジニアが「いま何が決まっているか」 を Linear で追える状態に。

    1. E1

      MARK-1(オンボ中核実装)にコメント追加

      Linear

      本セッションで影響する判断 3 件(論点 1 ツアー外し / 論点 3 エンプティ戻り口 / 論点 5 業種 8 種)を整理。 Cursor / エンジニア着手前の確認事項を明示。

      • 論点 1 = v0.1 から ツアー外し → 実装範囲が「エンプティ + ウェルカム + スタートガイド」 に
      • 論点 3 = エンプティに preset リンク + アイテム 0 個判定ロジック追加
      • 論点 5 = Q1 選択肢を 8 + その他 に拡張
      • PRD v2.2 → v2.3 改訂済を明示
      MARK-1 →
    2. E2

      MARK-60(Path D 設計)にコメント追加

      Linear

      Path D doc v0.3 改訂の全変更点を 8 行テーブルで整理 + CEO 裁定の要旨 + Traction との関係明示。

      • §2.1 / §2.2 / §3.3 / §3.4 / §3.5.1 / §5.1 / §5.2 / §5.3 / §5.4 の 9 章を変更
      • 役割選択 UI を撤回(単一フロー化)
      • 目標 KPI を候補 B + 母数 N≥10/15 で確定
      • Path D は PLG 健全性指標、 Owner SEM 月 30 件超まで Traction 一次 KPI ではない
      MARK-60 →
    3. E3

      MARK-22(Layer 2/3 イベント)にコメント追加

      Linear

      30_path_d_role_selected 廃止 + 関連イベント変更を整理。 Layer 2/3 doc v0.3 への影響範囲を明示。

      • 廃止: 30_path_d_role_selected
      • 変更: 30_path_d_activation = 30_update_count 1 回以上 で統一
      • 変更: 30_path_d_first_action = role プロパティ削除
      • 追加: 30_path_d_welcome_shown
      • Layer 2/3 イベント定義への影響: 単一フロー版 HogQL に差し替え必要なら Path D doc §5.2 参照
      MARK-22 →
    → Next

    次のステップ

    本セッションは「設計と判断の完走」。 次は実装着手フェーズ。

    1. 実装着手判定(MARK-1)

    実装 spec doc(A3)§9 着手判定を読んで、 ① エンジニア側リソース確保 ② M-0 凍結(MARK-16)の発火タイミング が確認できれば着手 OK

    2. Cursor 引き継ぎ(必要なら)

    nanco-next / nanco-flutter の Cursor に実装 spec を渡す。 引き継ぎ doc を decision-log/ に置いて Cursor 起動時に参照させる(既存パターン)

    3. 観察モード起動

    v0.1 リリース後 1 ヶ月で Path D 活性化率を観察(N≥10 充足時のみ判定)。 月次レビュー(MARK-40)と統合

    4. 残作業(次回更新)

    UX フロー HTML v0.7 で残り 5 画面ワイヤー(S7 / M1 / M4 / M5 / S6 エンプティ二分岐)追加 + Next セクション更新。 全 26 HTML reports-rail は完了済