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>
This commit is contained in:
2026-05-02 17:54:15 +00:00
parent 8691bfe381
commit 5428412688
24 changed files with 2660 additions and 1 deletions

View File

@@ -0,0 +1,59 @@
---
phase: P9
component: kebab-tui + README
task_id: p9-fb-13
title: "Cheatsheet popup (?) + README keymap table + verb hint line"
status: planned
depends_on: [p9-fb-12]
unblocks: []
contract_source: ../../docs/superpowers/specs/2026-04-27-kebab-final-form-design.md
contract_sections: [§10 UX]
source_feedback: p9-dogfooding-feedback.md item 11
---
# p9-fb-13 — Cheatsheet
## Goal
vim 비익숙 사용자도 TUI 조작 가능. `?` modal popup + 동사구 hint line + README keymap 표.
## Allowed dependencies
- 기존 kebab-tui deps.
## Public surface
`kebab-tui::cheatsheet::Cheatsheet` widget. mode + 현재 pane 별 분기.
## Behavior contract
- `?` 키 (NORMAL 만) → modal popup. 화면 중앙 70% box, 키 + 동사구 설명 표.
- popup 안에서 `?` 또는 `Esc` → close.
- pane 별 cheatsheet 분리 — Library / Search / Ask / Inspect 각각 다른 키. 공통 키 (Tab pane 이동, q quit) 는 footer 영역.
- hint line (status bar 위 1 줄) — 동사구로:
- 기존: `j/k=move`
- 신규: `↑/k 위로 ↓/j 아래로 Enter 선택 Esc 취소`
- mode 따라 hint line 다름 (p9-fb-12 와 wire). NORMAL = navigation, INSERT = `Esc 로 명령모드`.
README 갱신:
- **TUI 키 매핑** 표 (전역 + pane 별).
- vim 비유 안내 한 줄 ("vim 처럼 i 로 입력, Esc 로 명령").
## Test plan
| kind | description |
|------|-------------|
| unit | `?` press → cheatsheet visible flag |
| unit | mode + pane 변경 시 hint line 텍스트 변화 |
| snapshot | popup 의 키 표 snapshot (Library / Search / Ask / Inspect) |
## DoD
- [ ] `cargo test -p kebab-tui` 통과
- [ ] README **TUI** 절에 키 매핑 표 + cheatsheet 안내
- [ ] 도그푸딩: 첫 사용자가 `?` 만 알면 나머지 발견 가능
## Out of scope
- 사용자 정의 keymap 파일 (P+)
- popup 의 검색 (`/` 로 키 찾기) — 우선 skip