codeforjapan / codeforjapan/workflow-interviewer

UX改善トラッカー: 固定資産税デモで見えたインタビュー体験の課題(春日井市職員デモ向け)

Open
#40 0 comments 0 reactions 0 assignees View on GitHub
enhancement
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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.