Files

altair823 5428412688 docs(p9): decompose dogfooding feedback into 20 task specs + reset plan

P9-1~P9-4 머지 후 사용자가 직접 도그푸딩 하며 수집한 16 항목 UX
피드백을 20 개 single-PR 사이즈 task spec 으로 분해. 각 spec 은
frontmatter (depends_on / unblocks / source_feedback), Goal,
Allowed deps, Public surface, Behavior contract, Test plan, DoD,
Out of scope 절 포함.

추가:
- p9-fb-01 ~ 20-*.md: 분해된 task spec 20 개
- p9-dogfooding-feedback.md: master index + 우선순위 + 권장 실행 순서
  + spec PR vs impl PR 절
- INDEX.md: p9-fb-01 ~ 20 link 추가
- docs/superpowers/plans/2026-05-02-p9-fb-06-reset-command.md:
  첫 후속 작업 (kebab reset 명령) 의 6-task 구현 plan
- .gitignore: .worktrees/ 추가 (superpowers worktree skill 용)

피드백 항목 → task spec 매핑은 p9-dogfooding-feedback.md 의 표 참조.
실행 시작 task: p9-fb-06 (reset 명령) — 도그푸딩 막힘 강도 1위.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-02 17:54:15 +00:00

2.3 KiB

Raw Blame History

phase, component, task_id, title, status, depends_on, unblocks, contract_source, contract_sections, source_feedback

phase

component

task_id

title

status

depends_on

unblocks

contract_source

contract_sections

source_feedback

kebab-cli + kebab-tui

p9-fb-20

Citation full path + scrollable pane (CLI block + TUI pane + jump)

planned

p9-fb-09

p9-fb-16

../../docs/superpowers/specs/2026-04-27-kebab-final-form-design.md

§7 RAG

§10 UX

p9-dogfooding-feedback.md item 16

p9-fb-20 — Citation surface

Goal

ask 답변의 citation 을 사용자가 풀 경로로 보고, scroll 하고, 원본으로 점프 가능. CLI / TUI 둘 다.

Allowed dependencies

기존 deps. p9-fb-09 의 editor restore helper 재사용.

Public surface

CLI:

kebab ask "Q" [--show-citations | --hide-citations] (default: show).

출력 형식 (사람-친화):

답변:
...

근거:
[1] crates/kebab-app/src/lib.rs#L120-L140  (score=0.78, doc_id=abc123)
[2] notes/foo.md#L12-L34                    (score=0.71, doc_id=def456)

--json 은 항상 citations 포함 (answer.v1.citations, 변경 X).

TUI ask pane (p9-fb-16 conversation 위에):

화면 분할: 위 transcript / 아래 input. 추가로 옵션 우측 1/3 citation pane (c 키 toggle).
citation pane 내부:
- 각 항목 한 줄 (full path + line range + score). truncate 안 함 — long path 는 wrap.
- turn 별로 group (▾ Turn 2 (3)). fold/unfold.
- 선택 + Enter 또는 o → 외부 editor 로 path 점프 (p9-fb-09 helper).
- 선택 + i → P9-4 inspect pane 으로 (Doc 또는 Chunk).

Behavior contract

TUI citation pane 의 c toggle 은 NORMAL 모드 (p9-fb-12 에 등록).
citation pane 자체 scroll (j/k, PageUp/Down) — focus 가 citation pane 일 때.
focus 이동: Tab 으로 transcript / citation 사이.
editor jump 시 line range 의 시작 line 으로 (+L120 옵션 vim/code).

Test plan

kind	description
unit	CLI 출력 형식 snapshot (full path 포함)
unit	TUI citation pane fold/unfold
unit	`o` 키 → editor spawn (mock)
unit	`i` 키 → InspectTarget::Chunk 진입

DoD

cargo test -p kebab-cli -p kebab-tui 통과
README ask 절에 citation 동작 안내
HOTFIXES X (신규)

Out of scope

citation 의 inline preview (path 위에 마우스 hover 같은) — 터미널 한계
citation 의 PDF page render (P9-5 desktop 용)

2.3 KiB Raw Blame History