Work Index — 작업 맵 (목표 기준)
repo 전체 "무엇을·어디에" 라우터. 목표(goal.txt 4-pillar) 기준으로 작업 트랙과 산출물 위치를 모은다.
역할 분리 (중복 방지):
- 아이템 status·우선순위 =
tasks/todo/00_overview.md(SSOT). 이 인덱스는 status를 들지 않는다.- 모듈 분석 =
docs/notes/. 실제 작업물(계획·벤치·리뷰) =work/.- 갱신: 새 문서/분류·트랙이 생기면 이 맵을, 아이템 상태가 바뀌면 overview를. 절차
../CLAUDE.md.
1. 작업 트랙
| 트랙 | 성격 | 상태(요약·정답은 overview) | 진입점 |
|---|---|---|---|
| 메인 — raw_block/NVMe io_uring 성능 | upstream PR/아이템 | 진행중 (우리 PR 5 OPEN) | → 00_overview (SSOT) · work/raw_block/ |
| FDP PoC 검증 | 리서치 / PoC (서브) | 진행중 (steady-state / OP gate 계획) | work/fdp/SUMMARY.md · PLAN · steady-state 계획 · 팀 위키 |
| HC-SSD checkpoint overflow | 아이템 RB-9 + 검증 | 대기 (Daejun #3449) | overview RB-9 · work/checkpoint/ (one-pager) |
| 아이템 발굴 | 후보 풀 (상시) | — | tasks/todo/discovery/ |
| PR 리뷰 / 추적 | 리뷰 기록·외부 PR 추적 | 상시 | work/reviews/ · tracking/INDEX.md |
2. 목표(goal.txt 4-pillar) ↔ 기여
| Pillar | 기여 아이템·트랙 (overview ID) |
|---|---|
| ① I/O 경로 분석 | OBS-1(L2/TTFT 텔레메트리) · 모듈 분석노트(docs/notes/) · v2 측정 트랙 |
| ② 스토리지 스택 최적화 (io_uring·alignment) | IO-1 |
| ③ FDP / HC-SSD / Conventional | FDP PoC(work/fdp) · RB-7(RU geometry) · RB-9(HC checkpoint) · RB-8(런타임 TRIM) |
| ④ LMCache backend 기여 | 전 업스트림 PR (RB·IO·L2·FS 영역) · 발굴 풀(discovery) |
평가기준: 역할별 10%+ 성능 · 고객 공동 PoC.
3. 디렉터리 맵 (어디에 뭐가)
| 경로 | 내용 |
|---|---|
tasks/todo/00_overview.md | ★ 아이템 status·우선순위 SSOT (AREA-N ID) |
tasks/todo/discovery/ | 발굴 풀 (discovery·upstream_pool·nvme feature) |
tasks/todo/priority-landscape/ | 우선순위 tier·열린 PR landscape 상세 근거 |
tasks/todo/status-meta/ | (보관) 옛 v1/v2/v3 제안·06-24 스냅샷 |
tasks/latency_histogram_impl_plan.md | OBS-1(텔레메트리) 구현 스케치 |
work/raw_block/ | raw_block 작업 — 작업단위 폴더(put-many-batch·dispatch-rollback·batched-remove·recovery·_misc) + 성과 보드 |
work/fdp/ | FDP PoC (SUMMARY·PLAN·audit·eval redo·reports·design follow-up) |
work/checkpoint/ | RB-9 checkpoint overflow 검증·repro·one-pager |
work/reviews/ | PR 리뷰 기록 (cr-*) |
work/wiki/ | 팀 공유 위키 산출물 |
docs/notes/ | 모듈 분석 + raw_block 근거 분석 본문 |
docs/lmcache_overview.md · docs/TODO.md | 코드베이스 지도 · 모듈 분석 순서 |
tracking/ | 외부 PR·멀티디바이스·staleness 추적 |
personal/ | 동료 질문 초안 등 (Daejun 질문) |
4. 분석 백그라운드 (근거 노트)
직접 아이템은 아니지만 위 트랙의 근거가 되는 분석.
| 주제 | 설명 | 위치 |
|---|---|---|
| 코드베이스 지도 | LMCache 4-tier · storage_backend/ · l2_adapters/ 관계 | docs/lmcache_overview.md |
| 모듈 분석 노트 | l2_adapters / plugin_pipeline / mp_vs_non_mp / core_py_analysis | docs/notes/ |
| raw_block 분석 본문 (todo 근거) | perf-findings · vs #3274 · io_uring post-#3274 · stack analysis · recovery 병렬 · SSD I/O 렌즈 | • perf-findings • vs #3274 • io_uring post-#3274 • stack analysis • 라인 종단 · Py/Rust 분리 • recovery 병렬 • SSD I/O 렌즈 |
| 우선순위·landscape 근거 | tier 분류(T1..D3) · 열린 PR↔항목 매핑·Gap | priority-landscape/raw_block_priority.md · raw_block_pr_landscape.md |
| CI 커버리지 & 실장 테스트 | PR CI 사각지대 + raw_block 미커버 경로 | docs/notes/ci_test_coverage.md |
| 아키텍처 리뷰 | FDP / HC-SSD / io_uring 관점 인사이트 | architecture-review.md |
5. 보관 / 이력
| 항목 | 위치 / 비고 |
|---|---|
| 옛 제안 v1/v2/v3 · 06-24 status 스냅샷 | tasks/todo/status-meta/ — overview로 대체됨, 이력·상세 근거용 |
| 폐기 아이템 (L1·L2 dedup·M1·B2·S1·MP-C 등) | overview §5 + status-meta 원본 |
마지막 갱신: 2026-06-25 (FDP PoC steady-state / OP gate 계획 링크 추가)