quad/.claude/question.md
qwreey 470f188d0f
로드맵 인수인계 라운드(2026-08-04) 결과 반영 — ROADMAP.md 신설, 설계 단계 종료
component-composition-plan을 research/에서 base/로 승격하고, 구현 착수 전
리스크 감사에서 나온 M0 스파이크 항목(Store/State propagation, dispatch,
컴포넌트 경계 named-parameter 전달)을 문서에 반영. quad-base 테스트 mock
방향(Vide 선례 채택) 확정.
2026-08-04 17:11:23 +09:00

5.6 KiB

확인/결정 필요 목록

2026-08-04 세션 말미에 전체 재정리함. 예전엔 라운드(1차~6차)별로 문서가 계속 쌓이면서 순서가 시간순도 우선순위순도 아니게 됐고, 이미 해소된 라운드 기록이 새로 열린 질문보다 위에 있는 등 혼동을 유발했음(문서 감사에서 발견). 그 상세 히스토리는 지우지 않았음 — git log로 이 파일의 이전 버전을 보거나, 각 base//research/ 문서 안의 라운드 표시("2026-08-04 3차 라운드" 등)를 따라가면 그대로 남아있음. 이 문서는 이제 "지금 열려있는 것" 우선으로만 구성.

지금 열려있는 것 (우선순위순)

1. 용어 정리 (사용자 요청, 진행 중)

사용자 원 메모: "quad는 register라던가 좀 부정확하거나 느낌이 바로 와닿지 않던 용어들이 많음 — 전체적 용어를 보고 생각해볼래? 제안을 줘, 나도 같이 볼게." 1차 제안 완료, 아래는 우선순위순 요약 — 최종 판단은 사용자와 계속 논의 필요:

  • State(1순위, 위험도 높음): 지금 정의는 "읽기 전용, 파생/캐시 뷰"인데 React/Vue 등 업계 전반에서 "state"는 거의 항상 "쓸 수 있는 로컬 슬롯"을 뜻함 — 처음 보는 사람이 정반대로 오해할 위험이 큼. Computed/Derived (Vue computed(), Svelte 5 $derived가 정확히 같은 의미로 씀)가 실제 의미에 더 맞아 보임. 단, v1의 "register"를 이미 한 번 "State"로 리네임한 지 얼마 안 됐다는 점 고려 필요.
  • DI(Declarative Instance, 1순위): "Dependency Injection"의 업계 표준 축약어와 완전히 겹침 — 4차 라운드에서 이미 한 번 실제로 오해가 있었던 전례(base/bind-system-plan.md의 "인스턴스 생성" 절 참고).
  • PerInstanceState(2순위): 핵심 프리미티브 State와 이름이 겹쳐서 실제로는 완전히 무관한 유틸(인스턴스별 weak-keyed 저장소)인데 혼동 유발 가능 — PerInstanceStorage/InstanceData 등 대안.
  • Slot(2순위): Vue의 "slot"(콘텐츠 주입 지점)과 이름은 같지만 의미가 다름(quad의 Slot은 자식 배열 재조정 프리미티브) — Vue 배경 있는 사람이 헷갈릴 수 있음.
  • CreatedRef/canExecute(3순위, 사소함): CreatedRef는 과거분사형이라 생성자처럼 안 읽힘. canExecute는 실제로 "이 핸들이 아직 살아있나" 확인인데 이름이 범용 권한 체크처럼 들림 — isAlive 쪽이 더 직접적.
  • 이미 지나간 사례로 참고: register(v1) → State(v2) 리네임은 "모호함"은 풀었지만 "다른 뜻으로 이미 쓰이는 단어"라는 새 문제를 만든 셈 — 이번 정리에서 같은 패턴을 조심할 것.
  • Store/Source/Modifier/Ref/process/retract/isHandlable은 업계 선례와 잘 맞거나 이미 신중하게 결정된 이름들이라 특별한 문제 없음.

2. 낮은 우선순위

  • research/existing-instance-bind-plan.md — 스코프 논의만 필요, 구현 착수를 막지 않음.
  • v1 objectListClass.__newIndex 오타 기능의 재현 테스트 필요base/quad-v1-architecture.md에 남겨진 v1 내부 동작 확인 사항, 마이그레이션 가이드 작성 시점에 필요. 지금은 그냥 백로그로만 기록.
  • 여러 Slot이 형제로 섞일 때 순서 보장base/slot-plan.md의 "여러 Slot이 섞일 때 순서 보장" 절 참고. Roblox 단일 백엔드로는 급하지 않음 (LayoutOrder/ZIndex로 대부분 해결), 다른 백엔드(웹 DOM 등) 재사용성과 직결되는 문제라 Slot 코어 로직 구현 시점에 재검토.

참고: 지금까지 확정된 것 (요약)

전부 base/에 문서화되어 더 이상 열려있지 않음 — 상세 근거/논의 과정이 필요하면 아래 문서를 열어볼 것(라운드별 세부 히스토리는 각 문서 안에 "2026-08-04 O차 라운드" 식으로 표시돼 있음):

주제 문서
전체 아키텍처 결정(디스패치 모델, DOMless, 태그/Ref, Signal 미채택 등) base/architecture.md
Store/State/Source 온톨로지, 인스턴스 생성/이벤트 인체공학, Ref, 남은 API 이름 base/bind-system-plan.md
Store 부작용 허용, :With+:Compute, dot-access 문법 base/store-semantics.md
프로바이더 패턴, bind/store 구현 책임 분리 base/module-lifecycle-plan.md
Slot 재조정, 재마운트 시 throw, retract=폐기 base/slot-plan.md
Connected+GC 라이프사이클 패턴 base/lifecycle-pattern.md
Modifier(정적 merge, immutable 체이닝, State 필드 지원) base/modifier-plan.md
컴포넌트화(플레인 함수, State/Source 경계, 컴포넌트 경계 modifier/Ref는 named parameter로 전달, multi-root 개념 폐기, Modifier.Merge) base/component-composition-plan.md
컴포넌트 이식성(전역 store 참조 시 재사용성 문제) base/purity-and-effects-plan.md
Fusion/Vide 비교 리서치(주의: 일부 서술은 이후 라운드에서 뒤집힘, 문서 내 정정 표시 참고) base/comparison-fusion-vide.md
v1 내부 동작 스냅샷 base/quad-v1-architecture.md
트윈 오버라이드(기본값 Cancel), 세부 옵션만 남음 research/tween-plan.md
quad2-try(폐기된 이전 시도) 리서치 — OOP 상속/커스텀 파서/Slot 스텁/Pipe COW 전부 죽은 접근으로 확인, 반복 조사 금지 base/bind-system-plan.md

전체 순서/우선순위는 루트 CLAUDE.md가 최종 소스 — 위 표는 힌트일 뿐 그쪽이 바뀌면 이 문서도 갱신할 것.