codeforjapan / codeforjapan/workflow-interviewer
UX改善トラッカー: 固定資産税デモで見えたインタビュー体験の課題(春日井市職員デモ向け)
- Dominant language
- TypeScript
- Stars
- 0
- Forks
- 0
- Avg merge
- 30m
- Merged PRs (30d)
- 2
Description
## 目的
固定資産税の標準フロー(`kotei-shisan-zei`)を使ったデモ画面のレビューをもとに、インタビュー体験(UX)の課題を整理し改善する。来週予定の**春日井市職員向けデモ**で、職員が「何を確認するための質問か」を理解でき、投下した労力に見合うギャップ抽出が得られる状態を目指す。
デモURL: https://workflow-interviewer-dusky.vercel.app/
## 背景
固定資産税フローのデモで、以下が観察された。
- フローの本筋(評価額計算 → 税額計算 → 非課税判定)ではなく、終盤(ターン20/20)まで抵当権がらみの枝葉を深掘りし続けた。
- 20ターン聞いて抽出できた全体ギャップは「独自ルール・運用がある」1件のみ(KB の `gap-notes.md` には既知ギャップが4件あるにもかかわらず)。
- 「ターン20/20・完了」と出るが、なぜ20か・残り何問かが分からない。
これらを踏まえ、6つの課題を子Issueに分割した。
## 6課題(子Issue)
デモ前に効く順に並べている。
- [ ] #34 UX1. 質問がフローの本筋から脱線しないよう、標準フロー主要ステップに沿った質問選択にする 【最優先】
- [ ] #35 UX3. インタビューの進捗・残り質問数を可視化し、ターン数上限の決め方を見直す 【高】
- [ ] #36 UX2. ギャップ抽出の質・粒度を上げる(既知ギャップ照合と差分検出の改善)【高】
- [ ] #37 UX4. 選択肢ボタンを複数選択に対応させる 【中】
- [ ] #38 UX5. LLM応答のストリーミング表示で体感速度を改善する 【中】
- [ ] #39 UX6. チャットとフロー図ノードの連動ハイライト 【中】
## 優先度
デモ前に効く順で **UX1 → UX3 → UX2** が高い。
1. **UX1(脱線を止める)** — 本筋に沿った質問選択にする。これが土台。
2. **UX3(ターン数を有効活用)** — 進捗を可視化し、限られたターンを本筋に使わせる。
3. **UX2(ギャップ抽出の質向上)** — 上記2つで質の良い聞き取りができた上で、最終価値であるギャップ抽出の粒度を上げる。
UX4 / UX5 / UX6 は体験を底上げする中優先。特に UX6 は UX1 の「対象ノード追跡」と実装を共有できる。
## 補足(調査メモ)
- `kotei-shisan-zei/gap-notes.md` には既知ギャップが4件(相続未登記/評価替え説明/農地転用/新築軽減申告漏れ)記載済み。UX2 の照合改善で拾えるようにする。
- `lib/server/interview/followup.ts` が参照する `docs/workflow` ディレクトリはリポジトリに存在せず、当該スニペットは常に空。質問生成の文脈は実質 `loadStandardFlowSummary(taskSlug)` のみ(UX1 で要確認)。
> このIssueは Slack #gov_ai_agent での議論(Yuki Kawabe / sunagawa)に基づき起票されました。
Contributor guide
No contributing guide indexed for this repository
Research direction
Treat this as a tracker and start by reviewing child issues #34–#39, then inspect lib/server/interview/followup.ts and loadStandardFlowSummary(taskSlug) for the current question context. Work should be taken from a scoped child issue; the tracker is complete when the selected UX improvements are implemented and the fixed-asset-tax demo addresses the stated interview and gap-extraction problems.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- backend, frontend
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100