qwreey
298dac2510
전 세션이 "재시작해야만 확인 가능"으로 남긴 3건을 전부 닫음: - @import 3개(conventions/project-context/todos) 실제 로드 확인 - quad-doc-auditor 레지스트리 등록 확인(전 세션 전멸은 .claude/agents/가 세션 도중 생긴 디렉토리였던 탓) - frontmatter model: sonnet 반영 확인(트랜스크립트에 claude-sonnet-5 기록, 워크플로에 opts.model 명시 불필요) 정의 파일은 세션 시작 시점 스냅샷으로 고정된다는 것을 1차 증거로 확정 — quad-handover-audit이 실제 실행한 스크립트가 세션 시작 시점 상태와 바이트 단위로 동일했고 같은 세션의 편집은 반영 0. 에이전트 정의도 동일. 정의를 고쳤으면 재시작 뒤에 감사를 돌릴 것(안 그러면 거짓 초록불). 전 세션 감사가 남긴 긴 가설 배너(80줄)를 검증된 것만 남겨 압축. quad-handover-audit 첫 실동: 에이전트 67개/6라운드, 수렴 실패 (새 발견 28→15→16→7→11→6, 라운드5에서 되레 증가). MAX_ROUNDS와 "연속 dry 2회" 조건 재검토 필요 — 결과 자체는 위 스냅샷 문제로 옛 스크립트가 돈 것이라 재시작 후 재실동 대상. 감사가 잡은 것 반영: slot-plan.md 정정 배너가 그 뒤 재역전(retract=언마운트)을 놓치고 있던 것, "spikes 44개"(실제 48개) 류 하드코딩 개수의 단일 소스화, doc-check.py docstring이 검사 심각도를 실제 코드와 다르게 서술하던 것 등. 인용 출처 3건 재분류 — 2건은 인용 대상만 틀린 것이라 실제 소스로 재조준 (v1-compat-plan.md→component-composition-plan.md+store-plan.md, pre-implementation-audit.md→ROADMAP.md). 진짜 출처가 없는 1건 (modifier-plan.md:536)만 question.md 3번으로 올려 사용자 판단 대기. 워크플로 개선: 반환값에 findings 추가(커밋 전 diff 리뷰 근거), totalFindingsFixed→findingsSentToFix 개명(과대계상), 반영 에이전트 sonnet 명시. .claude/agent-memory/는 의도적으로 커밋 제외(추적 여부는 사용자 판단). Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2.7 KiB
2.7 KiB
CLAUDE.md
Roblox 엔진용 DOMless UI 렌더러 quad를 처음부터 다시 짜는 프로젝트.
[2026-08-16 기준] 지금은 설계/계획 단계이고 구현은 아직 시작 전 — 같은
상태를 .claude/project-context.md도 서술하니 M0에 착수하면 두 곳을 같이
고칠 것.
이 파일에 내용을 직접 쌓지 말 것 — 짧은 진입점으로 유지한다. 새
서술은 아래 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.
후자들은 과거 시점 서술이라 더 최근 결정이 안 반영돼 있을 수 있음.