2026-10-31 ~ 11-01 프로토타입 64 ~ 66번째 판, MVP 전 물음을 모두 정함(M43 · M44 · M45), 문서 검사 훅
(← 2026-10-31-02-readme-polish-activation) 메인테이너: “안녕하세요? 잠깐 들어왔어요. inbox만 체크해주세요.” inbox의 다섯 항목을 보여 드리고 처리 방향을 제안했다. 메인테이너: “3번은 프로토타입에만 적용해주세요. 나머지는 UX설계에 반영할 부분이 있으면 해주세요. 프로토타입 반영해주세요.”
inbox
다섯 항목을 모두 처리해 원문을 옮기고 지웠다. 원문:
3. 기능
프로토타입
- 머리모양 선택을 기억하게 해주세요
- 머리모양 디폴트를 “제목처럼”으로
- 처음 방문하면 Raft 예제를 보여줄 것
- 화면이 열리면 선택된 블록 없을 것
- 모바일에서 메뉴랑 옵션 선택 부분이 고정되어있어서 다이어그램을 보여줄 공간이 없음
결정
- 머리 모양의 기억과 기본값 → HS1, 규칙 헤더 모양. 머리 모양은 그대로 문서 설정이고, 마지막으로 고른 것을 사용자 설정으로 기억해 새 문서의 처음 값으로 쓴다. 파일을 열면 파일의 값, 연다고 기억이 바뀌지 않음, 머리 모양이 없는 예전 파일은 “모자 · 아치”는 Claude가 정함
- 처음 방문하면 Raft 예제: 메인테이너의 말대로 프로토타입에만. 제품의 처음 화면은 정하지 않음
- 열면 고른 것이 없다 → OP1, 규칙 키보드로 이동하고 삽입하기. “새로”(빈 문서)는 빈 블록을 고른 채로 두는 것은 Claude가 정함
- 좁은 화면 → MB1, 원칙 “화면은 다이어그램에게”(2. UX 원칙). 단추의 자리와 모양은 편집기 설계로 미룸
프로토타입 64번째 판
- 바꾼 스크립트
journal/assets/2026-10-31-prototype-64-patch.py, 시험 239개 통과(새로 18) → prototype - 처음엔 프로그램이 캔버스로 포커스를 옮길 때마다(화면이 열릴 때, 단추를 누른 뒤) 첫 블록이 골라지고 있었다. 키보드
Tab으로 들어올 때만 고르게 바꿨다 - 헤드리스 Chrome의 휴대폰 흉내에서 폭이 980px로 잡혀 좁은 화면 규칙이 듣지 않았다. 페이지에
viewport줄이 없어서였다. 저장소의 사본을 휴대폰에서 직접 열 때도 같은 문제였을 것이라 더했다
MVP 전에 정할 조작 물음 (2026-11-01로 넘어감)
push 뒤 메인테이너: “mvp 전에 결정해야할 것들을 결정합시다”. MVP 전에 정할 것 가운데 메인테이너가 정할 것은 조작 규칙의 미결정이었다(나머지는 Claude가 쓰고 확인받을 상세 설계). 2026-10-11의 M09는 키가 Vim으로 바뀌기 전이라 맞지 않는 곳이 많아, 프로토타입 64번째 판이 그린 SVG로 새 시안 M43을 만들었다(https://claude.ai/artifact/N7GhRyH47c5qs98V1N9uqH, 사본 journal/assets/2026-10-31-mvp-ux-questions-study.html, 그림을 뽑는 스크립트 …-shots.mjs, 만드는 스크립트 …-build.py). 아직 없는 동작(옮기기, 앞에 갈래 넣기)은 모델을 고쳐 결과를 그렸다.
- 물음 여덟 묶음을 고르는 창으로 하나씩 물었다. 모두 Claude의 추천대로 정함 → 10. 2026-11-01의 결정
- 메인테이너가 두 번 되물었다: Q2에서 “1번으로 한다면 접고 펴는 것은 어떻게 하나요?”(→ 이미 그려진 세모를 단추로, 키와 메뉴는 그대로), Q10-c에서 “갈래 안의 블록을 선택하고 oOx하면 어떻게 되나요?”(→ 고른 것이 블록이면 블록에, 갈래 이름이면 갈래에)
- Q8 · Q11은 처음(10-11)의 추천을 바꿔 물었다: Q8은 45번째 판에서
ds를 Vim에 맞춘 뒤라, Q11은 이미 들어 있어 MVP의 일이 늘지 않아서 - 반영: 02-interaction-rules(글자 고치기 · 옮기기 · 갈래 이름 고르기 절을 새로, 미결정 절에는 Q20과 If ↔ Case만 남음), 03-keymap, 3. 공통 규칙, ux-decisions. Claude가 정한 세부는 outbox의 “확인해 주세요”
- 처음 만든 M43은 퀵소트 그림의 오른쪽 다이어그램이 카드 밖으로 잘렸고, Case 예제의 갈래 이름을 “1 · 2 · 3”으로 잘못 적었다. 찍어 보고 고쳐서 게시함
프로토타입 65번째 판
메인테이너: “프로토타입 만들어주세요 / 근데 웹버전의 메뉴와 리본메뉴 구성같은 화면 레이아웃은 언제 만드나요?” 화면 레이아웃은 MVP 전에 정할 것의 2번(편집기 설계와 함께 웹 화면 설계, 시안으로 견줌)이라 다음 차례라고 답했다.
- 정한 조작을 넣은 65번째 판을 게시함. 바꾼 스크립트
journal/assets/2026-11-01-prototype-65-patch.py, 시험 264개 통과 → prototype - 갈래 이름을 고른 상태는 블록 선택과 따로 두었다(
lsel). 갈래 이름의 키(oOxhjkli)는 이 상태에서만 듣는다 - 처음 패치에서 함수 이름이 이미 있던 이름(
laneKey)과 겹쳐 페이지 전체가 돌지 않았다. 시험이 첫 검사부터 실패해 알았고 이름을 바꿨다
MVP에 넷을 더함
메인테이너: “mvp에 안 들어가는 기능은 무엇인가요?” 요구사항에서 P0이 아닌 것을 묶음별 표로 보이고, 처음 써 보는 사람이 바로 아쉬워할 넷을 다시 볼 것으로 짚었다. 처음 표에서는 그 넷을 굵은 글자로 가렸는데 메인테이너가 “표에서 굵게 썼다는 것이 잘 알아볼 수가 없어요”라고 해 ★ 칸으로 다시 보였다. 메인테이너: “넷을 포함합시다”.
- 끌어 놓기(R-EDIT-09), 도움말(R-EDIT-21), 임시 보관(R-WEB-03), 자동 저장 · 최근 파일(R-EXP-04)을
P0으로 올림 → DR-0015의 이후 변경 - 끌어 놓기의 규칙이 MVP 전에 정할 것이 되었다 → MVP 전에 정할 것
매듭 (2026-11-01)
메인테이너: “중간 마무리”. 세션 기록 · status · outbox · 타임라인 253~258 · 배운 것 둘 · TIL(viewport-meta)을 정리하고 push했다. 세션은 이어 간다.
웹 화면 설계 (시안 M44, 매듭 뒤)
메인테이너: “웹 화면 설계 합시다”. 시안 M44(https://claude.ai/artifact/VpocjhpW3vtPJ8UHvoyFgX, 사본 journal/assets/2026-11-01-web-screen-study.html)를 일곱 판까지 고치며 W1 ~ W6을 하나씩 정했다 → 11. 웹 화면 (2026-11-01), 화면 배치
- W1: 첫 판은 SequenceDiagram.org식 왼쪽 아이콘 막대를 추천했다. 메인테이너가 Structorizer를 참고하자고 해(“structorizer의 아이콘바에 블록들이 있는 것이 편해보입니다”) 블록 모양 아이콘을 넣어 다시 그렸고, 메뉴 막대 + 블록 아이콘 도구 모음으로 정함
- W2: 메인테이너가 끌어 놓는 자리의 규칙을 직접 제안했고, 누르기 규칙은 Claude의 추천(누르기는 언제나 넣기,
Ctrl+클릭은 감싸기)을 받아들임 - 메인테이너가 중간에 “설계 문서에 반영해주세요”, “VSCode나 IntelliJ 같은 IDE를 참고해봅시다”, “w3도 다른 ide를 참고해서 의견 주세요”라고 해, 정할 때마다 문서에 옮기고 IDE의 모습을 표로 견주었다. W3은 “탭이 하나 뿐일 때는 탭을 안보이게 하는 UI도 쓰이는 사례가 있나요?”에서 macOS식(하나면 탭을 숨김)으로
- W3-b 자동 저장 기본 켬, W4 새 탭의 사용법과
?겹창, W5 설정 창 둘(Claude의 추천은 창 하나였음), W6 명령 찾기를 새 요구사항 R-EDIT-24로 MVP에 - Claude가 정한 세부 가운데 셋을 짚어 물었고 메인테이너가 확인함: “확인 요청한 세가지 모두 ok입니다” (빈 블록 위에 놓으면 그 빈 블록을 바꿈, 자동 저장은 고치고 2초 뒤, 명령 찾기에서 듣지 않는 명령은 흐리게). 나머지 세부(W2의 넷, W3의 셋, W3-b · W5 · W6의 키와 최근 명령)도 이어서 확인함: “모두 ok입니다”
- M43의 그림 묶음에 W2 장면을 더할 때, 다시 뽑으면 65번째 판의 동작(빈 머리 이름)이 M43의 그림에 섞여 예전 그림을 지켰다
편집기 · 웹 설계 초안, UX 용어
메인테이너: “설계 이어 합시다”. 03-editor를 뼈대에서 초안으로 채움(화면의 레이어, 상태와 선택, 입력에서 명령까지의 시퀀스, 히트 테스트, 드래그 앤 드롭, 클립보드, 인라인 에디터, 키 처리, 명령 목록과 메뉴 구성, 셸 인터페이스의 TypeScript 시그니처). 06-web에 파일 열기 · 저장(Chromium과 그 밖의 두 흐름), 최근 파일, 임시 보관의 흐름. 절 번호가 바뀌어 “5. 셸과의 연결” 링크 넷(승인된 ADR 둘 포함, 주소만)과 지난번에 바뀐 “갈래 순서 바꾸기” 링크 둘을 고침. Claude가 정한 세부는 outbox
메인테이너: “‘겹’은 ‘레이어’를 말하는 것 같습니다. UX에 관련된 것은 보편적으로 많이 쓰이는 UX 전문가의 용어를 써주세요. 굳이 순한국어를 고집할 필요 없습니다.” 범위를 물어 “UI 요소 이름 + 선택”으로 정하고 docs/ 전체(18개 문서, 330줄)를 바꿈: 층 → 레이어, 도구 모음 → 툴바, 메뉴 막대 → 메뉴 바, 오른쪽 클릭 메뉴 → 컨텍스트 메뉴, 명령 찾기 → 커맨드 팔레트, 상태 줄 → 상태 표시줄, 겹창 → 모달, 끌어 놓기 → 드래그 앤 드롭, 놓을 자리 → 드롭 위치, 세모 → 펼침 삼각형, 고른 표시 → 선택 하이라이트, 글자 칸 → 인라인 에디터, 안내 상자 → 키 힌트, 마우스 올림 → 호버, 고르다 → 선택하다. 받침에 따라 틀어진 조사를 고치고, 바뀐 절 제목을 가리키는 링크를 맞춤(docs → UX 결정 모음은 결정 모음의 제목 그대로, atelier → docs는 새 제목으로). atelier/의 지난 기록은 그때의 말 그대로 둠. 방침은 Claude의 메모리에도 남김
docs 검토와 캡처, 66번째 판
메인테이너: “/docs 전반적으로 정합성과 추적성이 맞는지 검토해주세요. 캡처가 필요한 부분은 삽입해주세요. 기존에 있던 캡처가 현행화 필요하면 해주세요.”
- 검토자 셋(요구사항 · UX · 아키텍처와 상세 설계)에게 나눠 맡겨 100건 남짓을 찾았다. 가장 급한 것은 Claude가 앞서 저지른 손상이었다:
sed의\|가 “또는”으로 읽혀 요구사항 표 21줄의 “상세” 링크가 망가졌고, 용어 바꾸기에서 “광고를”이 “광선택할”로 바뀌었다. 되돌리고, 표 안 위키링크의|14줄과 시안 목록의 칸도 고쳤다. 표의 칸 수와 절 링크를 검사하는 스크립트를 함께 돌렸다 - 기계적으로 고칠 것은 정확한 목록을 적어 에이전트에게 맡겼다. 요구사항을 바꾸는 넷은 메인테이너가 정함(모두 추천대로): R-EDIT-04 · R-EDIT-12 · R-LAY-09를
P0으로, 블록 아이콘 드래그와 키로 옮기기는 R-EDIT-09 · R-EDIT-03을 넓혀서, 새 요구사항 R-ALL-03 “새 문서 만들기”(P0), 비기능 요구사항에 우선순위 칸 - 캡처: 시각 디자인 그림을 다시 찍고 새 그림(머리 모양 견줌, 갈래 이름 선택, 키 힌트, 웹 화면 배치, 커맨드 팔레트)을 넣었다. 메인테이너가 짚은 것을 고쳤다: “다이어그램 캡처들이 모두 헤더 윗 부분이 잘렸어요”(캡처할 때
captureBeyondViewport가 배치를 다시 계산해 자리가 밀림), “많은 다이어그램이 캔버스 바깥의 영역까지 캡처가 됐네요”(다이어그램이 그려진 자리만 자름), “헤더를 모자,아치로 한 것과 제목으로 한 것이 섞여있네요”(모두 모자 · 아치, 설정 설명에만 견줌 그림 둘), 첫 그림의 글자가 상자 밖으로 나간 것(글꼴이 준비되기 전에 셈) - 메인테이너: “원칙4의 캡처는 프로토타입 현행화 하고 캡처를 다시 받아주세요” → 프로토타입 66번째 판(정한 웹 화면: 메뉴 바, 블록 아이콘 툴바, 파일 이름과 ●, 설정 모달 둘, 커맨드 팔레트,
?모달,Tab은 선택하지 않음). 시험 282개 통과. 캡처를 찍다가Tab의 동작이 조작 규칙과 다른 것을 찾아 함께 고침
요구사항 넷 반영, 문서 검사 훅
- 위의 요구사항 넷을 01-requirements에 반영: R-EDIT-04 · R-EDIT-12 · R-LAY-09를
P0으로, R-EDIT-03(키로 블록 · 갈래 · 다이어그램 옮기기)과 R-EDIT-09(툴바의 블록 아이콘 드래그)를 넓힘, 새 R-ALL-03(UC-01에도 링크), 비기능 표에 우선순위 칸(R-NFR-01 ~ 06은P0). 접근성 R-NFR-05는 둘로 나눠 키보드 전용 조작만P0에 두고 고대비 화면은 새 R-NFR-07(P1)로. MVP 목록과 DR-0015의 이후 변경에도 - Claude Code를 더 잘 쓰는 법을 물은 데 대한 조언(세션 나누기,
/model·/fast, 훅, 프로젝트 스킬,/btw)에 메인테이너: “해주세요 - journal/learning-claude-code.md에 정리 - 3. 훅으로 자동 검사” → learning-claude-code 187 ~ 194 - 문서 검사 훅:
.claude/hooks/doc-check.py(설정.claude/settings.json, PostToolUse의 Edit · Write · Bash). Claude가 파일을 고칠 때마다 바뀐 문서의 표 칸 수와[[문서#제목|제목]]링크를 검사하고, 잘못이 있으면 Claude에게 알려 바로 고치게 한다. 처음 돌렸을 때 이미 있던 잘못 셋(배움 기록 187 · 188의 빠진 칸, 연표 97번의 이스케이프하지 않은|)을 찾았고, 일부러 표를 깨 훅이 듣는 것을 확인했다. 같은 세션에서 Claude의 실수(시안 목록 표의|)를 한 번 더 잡았다. 코드 표기 안의 예시 링크와README링크는 검사하지 않는다. CLAUDE.md에 한 줄
MVP를 만들 수 있나, 시작 전 셋
메인테이너: “mvp를 만들 수 있나요? 아직 미결이라든지 부족한 부분이 있나요?” docs의 미결정 · 미완성 콜아웃, outbox, backlog를 모아 답했다: 개발을 막는 큰 물음은 없고, 시작 전에 정할 것은 셋(파일에 남는 이름, 서브셋 글꼴 형식, 편집기와 셸의 경계). 나머지(드래그의 띠 크기, 아이콘 그림, 맥의 키 겹침, 저장 실패 처리, 가짜 DOM 등)는 만들면서 정해도 된다. 메인테이너: “스스로를 이름으로 부르면 어색하네요. ^^ 권고한 순서로 진행합시다” (그 뒤로 대화에서 “제가”로 씀, Claude의 메모리에 남김)
- 편집기와 셸의 경계: 6. 셸과의 연결을 채움.
createEditor·OpenedDocument·EditorHandle, 새로 · 열기 · 최근 파일은 셸이CommandRegistry.register로 더하는 명령, 자동 저장 · 임시 보관의 타이머는 셸, 임시 보관은 가벼운snapshot()(모델 JSON), 읽기 전용은edits: true인 명령만 막음, 명령 이름은 형편에 따라 바뀜(“저장” → “내려받기”), 화면 밝기 · UI 글꼴은Appearance로(미결정 하나를 닫음). 4.2 editor와 셸의 인터페이스, ADR-0031 · ADR-0033의 이후 변경 - 파일에 남는 이름: 3.3 노드별 필드. 모델 요소
ans:document, 필드 이름은 모델 1장 그대로, 줄(Seq)은 주인의body·folds에 펼침, 생략 규칙, v1의textKind"plain"·theme"default", 작은 예. 열기 흐름(5장의 시퀀스)을 셸이 읽어open으로 넘기게 고침. Claude가 정했으므로 outbox에서 확인을 기다림 - 서브셋 글꼴: WOFF 크기를 새로 재(한글 300자 TTF 51 KB · WOFF 29 KB · woff2 23 KB) 시안 M45(https://claude.ai/artifact/F5tWhj2q6X6uSGGjrAezRE, 사본
journal/assets/2026-11-01-subset-font-format-study.html)로 물음. 메인테이너가 추천(2 WOFF)을 고름 → ADR-0039. 압축은 판을 고정한 JS zlib 라이브러리, 브라우저에 든 압축기는 브라우저마다 바이트가 다를 수 있어 쓰지 않음
다음 할 일
- 새 세션에서 MVP 코딩을 시작한다:
src/아래 pnpm 모노레포 뼈대(ADR-0036, 도구 ADR-0038), 그다음core의 모델 → 불변식 · 직렬화 → 레이아웃 → SVG 렌더러를 시험과 함께 → MVP 개발 - 메인테이너가 확인할 것: 파일에 남는 이름, 편집기와 셸의 경계 → 확인해 주세요
- 메인테이너가 65번째 판을 써 보기
- 메인테이너가 휴대폰에서 64번째 판을 열어 보기(실제 휴대폰은 시험하지 못함 → 시험한 곳과 못 한 곳)