Files
viberoom-web/docs/work.md

87 lines
3.0 KiB
Markdown

# Work Order
이 파일은 이번 세션에서 처리할 작업을 적는 실행 입력서다.
## 작성 규칙
- 작업은 가능한 한 "주제별"로 분리해서 작성한다.
- 한 주제는 가능하면 한 커밋으로 끝낼 수 있게 범위를 좁힌다.
- `finding -> fix -> docs -> validation -> commit`까지 한 라운드에서 닫는다.
- browser QA가 필요한 작업은 반드시 완료 조건에 명시한다.
## 우선순위
- 위에서 아래 순서대로 높은 우선순위로 간주한다.
- `작업 1`을 먼저 처리하고, 완료 시 다음 작업으로 넘어간다.
---
## 작업 1
- 제목: `Product Alignment Audit` findings ledger 시작
- 목적:
- `16_product_alignment_audit_plan.md` 기준으로 core loop 전반의 기획-구현 불일치를 하나의 ledger로 수집한다.
- 더 이상 발견 즉시 감으로 수정하지 않고, severity와 affected flow 기준으로 정리한다.
- 변경 범위:
- `/app`
- `/space`
- `/stats`
- 관련 카피 / query handoff / plan tier
- 제외 범위:
- visual redesign 직접 착수 금지
- 새로운 feature spec 확장 금지
- `/settings`, `/admin` 구현 변경 금지
- 완료 조건:
- `17_product_alignment_findings.md`가 생성된다
- 최소한 P1 / P2 finding이 route, promise, actual behavior, affected file 기준으로 정리된다
- 이미 수정된 항목과 아직 열린 항목이 분리된다
- 검증:
- 문서 self-review
- 커밋 힌트:
- docs(product): alignment findings ledger 시작
## 작업 2
- 제목: `Core Loop Alignment Audit` static slice
- 목적:
- `/app`, `/space`, `/stats`의 route-flow matrix와 state contract matrix를 만든다.
- primary/secondary entry, CTA promise, 실제 상태 전환이 맞는지 정리한다.
- 변경 범위:
- route/flow inventory
- state contract matrix
- copy-behavior mismatch 정리
- 제외 범위:
- visual polish 직접 수정 금지
- recovery browser QA 금지
- 완료 조건:
- `/app`, `/space`, `/stats`의 primary CTA와 secondary CTA가 표로 정리된다
- pause / return / complete / review handoff의 상태 의미가 문서화된다
- static mismatch가 severity와 함께 분류된다
- 검증:
- source-of-truth 문서 대조
- 커밋 힌트:
- docs(flow): core-loop alignment matrix 추가
## 작업 3
- 제목: `Core Loop Alignment Audit` browser slice
- 목적:
- static audit에서 나온 핵심 흐름을 브라우저에서 실제로 검증한다.
- 문서와 코드가 맞더라도 실제 체감이 어긋나는지를 잡는다.
- 변경 범위:
- `/app` first entry
- `/app` resume
- `/app -> /stats -> /app`
- `/space` pause / return / next beat / complete
- `/space` complete -> setup -> weekly review teaser
- 제외 범위:
- bulk visual redesign 금지
- new feature 추가 금지
- 완료 조건:
- browser QA findings가 ledger에 반영된다
- P1/P2 mismatch는 수정 대상 라운드로 분리된다
- 검증:
- manual browser QA
- 커밋 힌트:
- docs(qa): core-loop browser audit 기록