tooling: 핸드오버 준비 — session-summary.md 색인 공백 + ROADMAP/CLAUDE.md stale 정정

session-summary.md에 오늘 세션 04~08 색인 항목이 통째로 빠져 있던 걸 발견해
신설. 더 크게는 CLAUDE.md/project-context.md/ROADMAP.md가 "구현 아직 시작
전"이라는 낡은 전제를 깔고 있었는데, 실측해보니 M0 스파이크 4개와 M1
스캐폴딩 대부분이 이미 완료돼 있어 전부 정정(ROADMAP 체크박스 갱신 포함,
wally.toml→pesde.toml 표기도 같이 정정). quad-roblox-types 백로그는
todos.md/ROADMAP.md M5에 짧은 포인터 보강.

Co-authored-by: qwreey <me@qwreey.moe>

2026-08-19 20:47:31 +09:00

2.8 KiB

Raw Blame History

CLAUDE.md

Roblox 엔진용 DOMless UI 렌더러 quad를 처음부터 다시 짜는 프로젝트. [2026-08-19 기준] M0(스파이크 검증)/M1(스캐폴딩)까지 완료, M2(디스패치 엔진)부터 착수 예정 — 같은 상태를 .claude/project-context.md도 서술하니 마일스톤이 넘어갈 때 두 곳을 같이 고칠 것. 진행 상황의 소스는 항상 루트 ROADMAP.md.

이 파일에 내용을 직접 쌓지 말 것 — 짧은 진입점으로 유지한다. 새 서술은 아래 import된 파일 중 맞는 곳에 넣을 것(어디에도 안 맞으면 그건 매 세션 로드될 내용이 아닐 가능성이 높음 — .claude/ 아래 해당 문서로).

항상 로드되는 컨텍스트

관례와 작업 방식 @.claude/conventions.md

프로젝트 컨텍스트와 문서 구조 @.claude/project-context.md

지금 할 일 @.claude/todos.md

온디맨드 자료 (자동 로드 안 됨 — 필요할 때 직접 열 것)

무엇이 궁금할 때	어디를 볼 것
지금 유효한 설계 — 어떤 결정이 확정돼 있는가	`.claude/base/` (먼저 `.claude/base/architecture.md`)
문서 전체 색인 — 어느 파일이 뭘 다루는가	`.claude/README.md`
사용자가 답해야 할 열린 질문	`.claude/question.md`
구현 순서 / 마일스톤	루트 `ROADMAP.md`
사람만 할 수 있는 일	루트 `HUMAN_TODO.md`
어떤 결정이 왜 그렇게 됐나 / 전에 뒤집힌 적 있나	`.claude/session-summary.md`를 grep (세션별 2~4줄 요약 색인)
그 결정의 논쟁 과정 원문	`.claude/session/YYYY-MM-DD-NN-slug.md`
뒤집히거나 기각된 설계의 원문	`.claude/archive/`

주의: session-summary.md는 의도적으로 @import 안 함 — 계속 자라는 히스토리 문서라 통째로 올릴 이유가 없음(그 문서 스스로 "항상 읽을 필요 없음, 지금 유효한 설계는 base/가 소스"라고 명시). 필요해지면 그때 가서 열 것.

충돌 시 우선순위: .claude/base/ > 여기 요약이나 session-summary.md. 후자들은 과거 시점 서술이라 더 최근 결정이 안 반영돼 있을 수 있음.

2.8 KiB Raw Blame History

CLAUDE.md

항상 로드되는 컨텍스트

온디맨드 자료 (자동 로드 안 됨 — 필요할 때 직접 열 것)

2.8 KiB

Raw Blame History