[P1][UX][IA] 初心者向けのタスク進行ナビゲーションと段階的な分析画面を設計する

[tuzuminami]

背景 / 現状

初回オンボーディングと各機能画面はあるが、非エンジニアにとって「案件を選ぶ → 収集する → 安全性/品質を確認する → 分析する → 共有する」という現在地と次の一手が一貫して見えない。複数の専門タブを同列に表示するだけでは、未完了の理由や安全に進める順序が分からず、import/exportを早すぎる段階で選ぶリスクがある。

目的

専門機能を隠さずに整理し、初心者がUIだけで安全な分析journeyを完走できるprogressive disclosure/navigationを設計する。

対象

• project → collect/import → review/privacy/quality → analyze → share/exportのtask-oriented navigation
• current stage、next recommended action、blocked reason、safe recovery link、completed state
• empty/sample/real/recording/importing/error/analysis-ready/export-readyの状態別home
• advanced viewへの明示遷移と、既存URL/keyboard navigationの互換性
• 日英、keyboard/VoiceOver、small-screen/long-label UI、journey analyticsを使わないlocal-only test

非対象

• hidden telemetry/behavior tracking、外部product tour、LLM assistant
• 分析algorithm、project isolation、import safety、privacy rule、background jobそのものの実装
• 専門機能の削除や、expert userを一本道に閉じ込めること

Claude Code実装契約

1. stageはevent件数などの推測だけで決めない。#40のactive project、#118のorigin、#116のimport receipt、#97のjob state、#63のrecovery errorなどのdurable/safe stateから判定する。
2. 各stageに目的、完了条件、次action、未実施/blocked理由を日英で表示する。blockの解決先は実在する画面/actionだけにし、存在しない設定やTerminal操作を指示しない。
3. sample、real record、mixed/unknown provenance、recording中、import preview中、cancelled/failed、empty projectを区別する。実dataをsample cleanupする操作や、mode/confirmationなしの破壊的import/exportをshortcutとして出さない。
4. analysis/exportは必要なscope、privacy review、quality/coverage、job completionを確認する。未準備ならブロック理由と安全な遷移先を表示し、強引にsuccess表示しない。
5. 既存の全機能はkeyboard、screen reader、deep link/routeで到達可能に保つ。新navigationはfocus order、ARIA current、error announcement、translation key parityを満たす。
6. navigation stateにraw event/title/URL/path/secretを保存・送信しない。runtime network、telemetry、LLMを追加しない。

受け入れ条件

• fresh installから、project作成/選択→recordまたはFinder import→preview/review→analysis→safe exportまで、UIだけで現在地と次actionを理解して進められる。
• sample/real/mixed/recording/job/errorの各fixtureで、表示stage・blocked reason・遷移先がdata stateと一致する。
• 既存dataの削除、import replace、LLM handoffは必要なpreview/confirmation/reviewを経ずに進めない。
• expert userは既存専門ビューへ迷わず直接到達でき、keyboard/VoiceOver/日本語/英語で全journeyを完走できる。
• stage誤判定、stale project switch、failed job/restart、malicious display nameで安全側に表示される。

検証

state-machine test、UI component/E2E、locale parity、keyboard/VoiceOver smoke、sample/real provenance、project switch、job cancel/retry、no-network check。

依存関係

#40、#59、#60、#63、#79、#97、#100、#116、#118、#122、#85。各Issueのdomain behaviorはここで再実装しない。

PR運用

1 Issue = 1 branch / PR。state model、advanced-view互換性、accessibility evidence、更新したdocs/translation、残余riskを記載する。