altair823-org/kebab
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 40 Wiki Activity

docs: v0.20 image+pdf handoff + sub-item 3 spec/plan backfill #188

Merged
altair823 merged 1 commits from docs/v0-20-image-pdf-handoff into main 2026-05-26 23:36:52 +00:00
Conversation 1 Commits 1 Files Changed 3 +2177
altair823 commented 2026-05-26 23:35:27 +00:00
Owner
Copy Link

요약

v0.19.0 release 후 다음 Claude session 에 인계할 handoff 문서 + PR #187 머지 시 누락된 spec/plan 사후 backfill.

handoff 문서 신설

docs/superpowers/handoffs/2026-05-26-v0.20-image-pdf-normalize-handoff.md (540 lines, 9 main section).

  • §1 컨텍스트: sub-item 1/2/3 머지 결과 / 도그푸딩 baseline (1781 doc / 9050 chunks) / user memory / OMC workflow / 빌드 환경
  • §1.6 현재 구현 상태 (v0.19.0, image+pdf): 정확한 file:line + struct/fn signature + flow
    • ImageExtractor (kebab-parse-image/src/lib.rs:55), OllamaVisionOcr (ocr.rs:82), apply_caption (caption.rs:162), ImagePipeline (kebab-app/src/lib.rs:756)
    • PdfTextExtractor (kebab-parse-pdf/src/lib.rs:37)
    • App.extractors registry 11 entry (kebab-app/src/app.rs:225-240)
    • dead struct 3 future surface (kebab-parse-md/src/types.rs:85-94)
  • §2 TODO 8건 (우선순위 순):
    1. PDF scanned OCR path (HIGHEST — 사용자 P9 책+PDF use case 직접 unblock)
    2. PDF normalize integration (ParsedPdfPage lift, cross-page reference)
    3. Multi-region image dispatch (ParsedImageRegion + OCR bbox)
    4. Per-page image / table extraction
    5. OCR/caption Enricher trait 통합
    6. MarkdownExtractor 신설 (sub-item 3 §11)
    7. Chunker dispatch unification (sub-item 3 §11)
    8. outer 4-arm match 통합
  • §3 우선순위 + sequencing 권장: TODO #1 + #3 을 v0.20.0 의 첫 2 sub-item 으로
  • §4-9: 새 session 의 첫 단계 / 핵심 파일 위치 / 모델 routing / release 계획 / 검증 invariant

Backfill (PR #187 의 spec + plan 사후 commit)

docs/superpowers/specs/2026-05-26-extractor-dispatch-unification-spec.md (702 lines, 2 round APPROVE) + docs/superpowers/plans/2026-05-26-extractor-dispatch-unification-plan.md (935 lines, 3 round ACCEPT).

PR #187 머지 시 commit 2c05dbd 가 source code 만 포함하고 spec/plan file 가 누락됨. PR body 의 cross-link 가 main 에서 404 — 본 commit 으로 backfill.

다른 sub-item 의 spec/plan (PR #185 / #186) 은 정상 머지 확인.

변경 없음

  • source code 변경 0 (docs only)
  • wire schema 변경 0
  • design contract 변경 0
  • workspace.version 변경 0
  • ARCHITECTURE.md / HANDOFF.md / README.md 변경 0

검증

  • git log --name-only main..HEAD → 3 file (handoff + sub-item 3 spec + sub-item 3 plan)
  • handoff = 540 lines, 9 main section + 6 sub-section in §1.6
  • handoff 내용 self-contained (새 Claude session 이 본 file 만 read 해도 sub-item 시작 가능)

시험 항목 (Test Plan)

  • 새 session 에서 cat docs/superpowers/handoffs/2026-05-26-v0.20-image-pdf-normalize-handoff.md 후 sub-item 시작 가능성 확인
  • PR #187 의 spec/plan cross-link (main 에��� reachable) 확인

Assisted-by: Claude Code

## 요약 v0.19.0 release 후 다음 Claude session 에 인계할 handoff 문서 + PR #187 머지 시 누락된 spec/plan 사후 backfill. ### handoff 문서 신설 `docs/superpowers/handoffs/2026-05-26-v0.20-image-pdf-normalize-handoff.md` (540 lines, 9 main section). - **§1 컨텍스트**: sub-item 1/2/3 머지 결과 / 도그푸딩 baseline (1781 doc / 9050 chunks) / user memory / OMC workflow / 빌드 환경 - **§1.6 현재 구현 상태** (v0.19.0, image+pdf): 정확한 file:line + struct/fn signature + flow - ImageExtractor (`kebab-parse-image/src/lib.rs:55`), OllamaVisionOcr (`ocr.rs:82`), apply_caption (`caption.rs:162`), ImagePipeline (`kebab-app/src/lib.rs:756`) - PdfTextExtractor (`kebab-parse-pdf/src/lib.rs:37`) - App.extractors registry 11 entry (`kebab-app/src/app.rs:225-240`) - dead struct 3 future surface (`kebab-parse-md/src/types.rs:85-94`) - **§2 TODO 8건** (우선순위 순): 1. PDF scanned OCR path (HIGHEST — 사용자 P9 책+PDF use case 직접 unblock) 2. PDF normalize integration (ParsedPdfPage lift, cross-page reference) 3. Multi-region image dispatch (ParsedImageRegion + OCR bbox) 4. Per-page image / table extraction 5. OCR/caption Enricher trait 통합 6. MarkdownExtractor 신설 (sub-item 3 §11) 7. Chunker dispatch unification (sub-item 3 §11) 8. outer 4-arm match 통합 - **§3 우선순위 + sequencing 권장**: TODO #1 + #3 을 v0.20.0 의 첫 2 sub-item 으로 - **§4-9**: 새 session 의 첫 단계 / 핵심 파일 위치 / 모델 routing / release 계획 / 검증 invariant ### Backfill (PR #187 의 spec + plan 사후 commit) `docs/superpowers/specs/2026-05-26-extractor-dispatch-unification-spec.md` (702 lines, 2 round APPROVE) + `docs/superpowers/plans/2026-05-26-extractor-dispatch-unification-plan.md` (935 lines, 3 round ACCEPT). PR #187 머지 시 commit 2c05dbd 가 source code 만 포함하고 spec/plan file 가 누락됨. PR body 의 cross-link 가 main 에서 404 — 본 commit 으로 backfill. 다른 sub-item 의 spec/plan (PR #185 / #186) 은 정상 머지 확인. ## 변경 없음 - source code 변경 0 (docs only) - wire schema 변경 0 - design contract 변경 0 - workspace.version 변경 0 - ARCHITECTURE.md / HANDOFF.md / README.md 변경 0 ## 검증 - [x] `git log --name-only main..HEAD` → 3 file (handoff + sub-item 3 spec + sub-item 3 plan) - [x] handoff = 540 lines, 9 main section + 6 sub-section in §1.6 - [x] handoff 내용 self-contained (새 Claude session 이 본 file 만 read 해도 sub-item 시작 가능) ## 시험 항목 (Test Plan) - [ ] 새 session 에서 `cat docs/superpowers/handoffs/2026-05-26-v0.20-image-pdf-normalize-handoff.md` 후 sub-item 시작 가능성 확인 - [ ] PR #187 의 spec/plan cross-link (main 에��� reachable) 확인 Assisted-by: Claude Code
altair823 added 1 commit 2026-05-26 23:35:28 +00:00
docs: v0.20 image+pdf handoff + sub-item 3 spec/plan backfill 574e1b1ca1 
v0.19.0 release 후 다음 session 인계용 handoff 문서 + 사후 backfill.

- docs/superpowers/handoffs/2026-05-26-v0.20-image-pdf-normalize-handoff.md (540 lines, 9 section)
  - sub-item 1/2/3 머지 결과 + 도그푸딩 baseline (1781 doc / 9050 chunks) + user memory + OMC workflow + 빌드 환경
  - 현재 구현 상태 (v0.19.0, image+pdf) — 정확한 file:line + struct/fn signature + flow
  - 8 TODO 상세 (problem + scope + affected files + risk + trigger 조건)
  - 우선순위 + sequencing 권장 + 새 session 첫 단계 제안

- docs/superpowers/specs/2026-05-26-extractor-dispatch-unification-spec.md (sub-item 3 spec)
- docs/superpowers/plans/2026-05-26-extractor-dispatch-unification-plan.md (sub-item 3 plan)

PR #187 머지 시 source code 만 들어가고 spec/plan 누락 — 동일 PR 의 reference link 가 main 에서 404. 본 commit 으로 backfill.

Assisted-by: Claude Code
claude-reviewer-01 approved these changes 2026-05-26 23:36:06 +00:00
claude-reviewer-01 left a comment
Member
Copy Link

회차 1 — docs only PR 검토.

3 file 추가 (handoff 540 lines + sub-item 3 spec 702 lines + sub-item 3 plan 935 lines = 2177 lines). source code 변경 0, wire schema 변경 0, design contract 변경 0.

칭찬 (산문):

  1. handoff 의 self-containment — 새 Claude session 이 본 file 만 read 해도 sub-item 시작 가능. user memory (gemma4 default / -j 4 default / model routing / no caveman / PR workflow), OMC team workflow (Phase A/B/C/D + model routing), 빌드 환경, dogfood baseline (1781 doc / 9050 chunks) 모두 §1.1-1.5 에 포함. 다른 session 의 cold-start cost 최소화.

  2. §1.6 현재 구현 상태의 정확한 file:line — image / pdf 의 모든 struct + fn + flow 가 정확한 line number 로 명시. ImageExtractor (lib.rs:55) / apply_ocr (ocr.rs:82) / apply_caption (caption.rs:162) / ImagePipeline (lib.rs:756) / PdfTextExtractor (lib.rs:37) / App.extractors registry 11 entry (app.rs:225-240) / dead struct 3 (types.rs:85-94). 새 session 이 "어디서 변경 / 확장 시작할지" 즉시 파악.

  3. 8 TODO 의 priority + sequencing 권장 — 각 TODO 의 problem + scope + affected files + risk + trigger 조건 명시. TODO #1 (PDF scanned OCR) 이 사용자 P9 책+PDF use case 직접 unblock 으로 HIGHEST priority. TODO #5-#8 은 v0.21+ defer 명시 — scope creep 회피.

  4. Backfill 의 정직한 명시 — PR #187 머지 시 spec + plan 누락이 process 미스였음을 commit message + PR body 에 명시. 다른 sub-item (PR #185 / #186) 의 spec/plan 은 정상 머지 확인 cross-check. process improvement 의 evidence.

  5. wire / 변경 0 의 정합 확인 — source / wire schema / design contract / workspace.version / ARCHITECTURE / HANDOFF / README 모두 변경 0. release tag v0.19.0 의 post-release docs cleanup 의 lowest-risk pattern.

추가 actionable 없음. 머지 OK. 머지 후 새 session 의 v0.20.0 첫 sub-item 시작 시 cat docs/superpowers/handoffs/2026-05-26-v0.20-image-pdf-normalize-handoff.md 으로 시작점 확보.

회차 1 — docs only PR 검토. 3 file 추가 (handoff 540 lines + sub-item 3 spec 702 lines + sub-item 3 plan 935 lines = 2177 lines). source code 변경 0, wire schema 변경 0, design contract 변경 0. 칭찬 (산문): 1. **handoff 의 self-containment** — 새 Claude session 이 본 file 만 read 해도 sub-item 시작 가능. user memory (gemma4 default / -j 4 default / model routing / no caveman / PR workflow), OMC team workflow (Phase A/B/C/D + model routing), 빌드 환경, dogfood baseline (1781 doc / 9050 chunks) 모두 §1.1-1.5 에 포함. 다른 session 의 cold-start cost 최소화. 2. **§1.6 현재 구현 상태의 정확한 file:line** — image / pdf 의 모든 struct + fn + flow 가 정확한 line number 로 명시. `ImageExtractor` (lib.rs:55) / `apply_ocr` (ocr.rs:82) / `apply_caption` (caption.rs:162) / `ImagePipeline` (lib.rs:756) / `PdfTextExtractor` (lib.rs:37) / `App.extractors` registry 11 entry (app.rs:225-240) / dead struct 3 (types.rs:85-94). 새 session 이 "어디서 변경 / 확장 시작할지" 즉시 파악. 3. **8 TODO 의 priority + sequencing 권장** — 각 TODO 의 problem + scope + affected files + risk + trigger 조건 명시. TODO #1 (PDF scanned OCR) 이 사용자 P9 책+PDF use case 직접 unblock 으로 HIGHEST priority. TODO #5-#8 은 v0.21+ defer 명시 — scope creep 회피. 4. **Backfill 의 정직한 명시** — PR #187 머지 시 spec + plan 누락이 process 미스였음을 commit message + PR body 에 명시. 다른 sub-item (PR #185 / #186) 의 spec/plan 은 정상 머지 확인 cross-check. process improvement 의 evidence. 5. **wire / 변경 0 의 정합 확인** — source / wire schema / design contract / workspace.version / ARCHITECTURE / HANDOFF / README 모두 변경 0. release tag v0.19.0 의 post-release docs cleanup 의 lowest-risk pattern. 추가 actionable 없음. 머지 OK. 머지 후 새 session 의 v0.20.0 첫 sub-item 시작 시 `cat docs/superpowers/handoffs/2026-05-26-v0.20-image-pdf-normalize-handoff.md` 으로 시작점 확보.
altair823 merged commit e7a4330798 into main 2026-05-26 23:36:52 +00:00
altair823 deleted branch docs/v0-20-image-pdf-handoff 2026-05-26 23:36:52 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
claude-reviewer-01
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
altair823 claude-reviewer-01
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: altair823-org/kebab#188
Delete Branch "docs/v0-20-image-pdf-handoff"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?