2026-11-01 문서 현행화, MVP에 예제 넣기

메인테이너: “잠깐 들어왔어요. inbox만 체크해주세요.” → inbox의 둘(문서 현행화)을 보고 처리 방향을 알림. 메인테이너: “1, 2 다 진행해주세요”. 그 사이 inbox에 하나(MVP에 예제 넣기)를 더함.

inbox에서 옮긴 원문

6. 기타:

  • 최상위 README에 Note로 코드는 없다고 되어있네요. 현행화 해주세요.
  • 이참에 다른 문서도 현행화 점검해주세요.

3. 기능 › ## MVP:

  • 프로토타입에 있었던 예제들 삽입하는 기능을 가져옵시다.
    • 메뉴 위치는 “도움말>예제”. 모든 예제가 같은 레벨.
    • 툴바에도 예제를 넣고 드롭다운으로 고를 수 있게
    • 첫 방문이면 예제를 보시겠느냐 물어봐줍시다.

문서 현행화

  • 코드가 없던 때의 문장을 고침: README.md의 Note(지금은 MVP 웹을 개발 중, 코드는 src/), CONTRIBUTING.md(MVP 써 보고 버그 알리기를 더함, 코드는 src/README.md, 코드 Pull Request는 아직 받지 않음), CLAUDE.md의 CONTRIBUTING.md 줄, 03-quality-attribute-scenarios의 읽는 법, model-layout-render-theme에 MVP 코드의 자리를 덧붙임
  • DR-0005 · DR-0008의 “코드가 아직 없다”는 그때의 결정 근거라 그대로 둠
  • 저장소 전체 점검(에이전트 둘: 찾는 쪽, 근거를 확인하고 고치는 쪽): 확실한 것 33과 덧붙인 6을 고침, 22개 파일. 03-keymap(MVP에 없는 키를 keys.ts로), 04-visual-design(기준을 MVP 코드로, 7.1 상태 표의 칸을 “MVP”로, 분기 라벨 높이 If 16 · Case 28), 02-layout(66번째 판, 3장의 구현된 셋), 03-architecture(core 안은 순환만 막음, 설정 자리는 src/), 품질 속성 시나리오(woff2 약 328 KB, 테스트 기반은 만들었음), 07-coding-guide(DocumentStore), 06-web(base ./), 07-testing(매일 밤 CI는 아직), 01-model · 01-file-format · 02-use-cases, til 일곱, backlog(끝난 것 지움), prototype.md(리뷰 순서는 Q20만), site/custom.scss(MVP 버튼 선택자)
  • 판단이 필요해 남긴 것은 MVP 개발의 “문서 현행화 점검”에 모음

MVP에 예제 넣기

  • 예제는 프로토타입의 열둘 가운데 겹치는 둘(“문장식”: “코드식”과 같은 로직, “이진 탐색(한 장)”: “이진 탐색”과 같은 알고리즘)을 뺀 열(메인테이너: “겹치는 것 빼고 10개 (추천)”)
  • 메뉴는 도움말 › 예제 ▸, 모두 같은 레벨. 툴바에도 예제 드롭다운
  • 첫 방문이면 모달로 묻되, 드롭다운이 아니라 예제 목록을 한 번에 다 보여 줌(메인테이너: “1.번이 좋은데 드롭다운 말고 예제 목록을 한번에 다 보여주세요. 34나 43이면 한번에 다 보여줄 수 있겠네요.“)
  • 예제를 열면 “새로”와 같음: 저장 안 된 문서를 바꿀 때 웹은 묻지 않음(임시 보관이 있어서, 6. 셸과의 연결)
  • 예제 여섯(퀵소트, Raft, 자판기, 엘리베이터, 이진 탐색, 미로 찾기)과 코드식은 MVP 밖의 Event · Method 헤더 · 여러 다이어그램을 쓴다. 물으니 메인테이너: “헤더 그리기를 MVP에 넣기”. → R-BLK-10 · R-BLK-11 · R-LAY-10 · R-BLK-07 · R-EDIT-18을 P0으로, 예제는 새 R-EDIT-25 → DR-0015의 “이후 변경”
  • 예제의 순서(메인테이너: “예제의 순서도 신경써주세요. 알아서 잘 해주세요.“): 쉬운 것에서 어려운 것으로, 새 블록 · 새 개념이 하나씩 늘게. 1 병합 정렬(README 그림) · 2 다익스트라(README 그림) · 3 UART 명령(Case) · 4 타이머 인터럽트(Event 하나, Do-While, 프로토타입의 “코드식”) · 5 이진 탐색(Event와 Method, 결과를 받는 호출) · 6 퀵소트(Method 둘이 서로 부름) · 7 미로 찾기(아리아드네의 실) · 8 자판기(문장식, Event 둘) · 9 엘리베이터(가장 넓음) · 10 Raft(가장 큼)
  • 시안 M46(예제 고르기, https://claude.ai/artifact/UCv5JocwUAvNxL5KjKf9ri, journal/assets/2026-11-01-example-picker-study.html)의 E1 → 1번: 4×3, 남는 두 칸은 “빈 문서로 시작” · “파일 열기…” 카드. 썸네일은 프로토타입이 그린 그림을 찍음(journal/assets/2026-11-01-example-thumbs.mjs)
  • 메인테이너: “1번으로 하고 도움말>예제를 클릭해도 이 모달이 뜨면 좋겠네요. 그 때는 맨 위 문구를 어떻게 해야할까요?” → 도움말 › 예제는 하위 메뉴 대신 같은 모달을 여는 “예제…” 하나. 메뉴에서 열면 제목 “예제 열기”, 안내 “예제는 새 문서로 열립니다. 지금 문서는 닫히고, 저장하지 않은 내용은 임시 보관에 남습니다.”, 카드 “빈 문서로 시작 / 다시 묻지 않습니다”는 “빈 문서 / 새 문서”로(Claude의 추천을 고름). 툴바의 “예제 ▾” 드롭다운은 그대로
  • 결정을 문서에 적음: 05-screen-layout의 예제 · 예제 모달 · 툴바, 5.1 메뉴 구성의 도움말 › 예제…, 5.2 툴바의 예제 ▾, 12. 예제 (2026-11-01)의 EX1 ~ EX3

매듭 (2026-11-01)

메인테이너: “이어서 하시지요. 중간중간 진행상태와 예상 종료시간 알려주세요.” → 설계 문서(02-layout 1.5 ~ 1.7, 02-interaction-rules의 헤더 · 호출 블록 · 여러 다이어그램)를 읽던 중 메인테이너: “중간매듭 합시다”. 코드는 아직 손대지 않음.

다음 할 일: 이번과 다음 세션에 할 것의 “MVP에 예제와 헤더 넣기”

매듭 뒤: 예제와 헤더를 MVP에 (코드)

메인테이너: “이어서 하시지요. 중간중간 진행상태와 예상 종료시간 알려주세요.” 처음 어림은 4시간 30분 ~ 5시간, 실제로는 약 2시간 40분(에이전트 셋을 나란히).

  • core: 헤더 그리기(모자 · 아치 · 제목처럼)와 여러 다이어그램의 배치(02-layout 1.5 · 1.7, 16 : 10), 장면의 path 요소, 골든 하나 갱신(Claude). 편집 명령 10개(editHead · setHead · newDiagram · deleteDiagram · moveDiagram · editCall · setCallTarget · insertCall · newMethodAndCall · setSettings), ReasonCode 여섯(에이전트)
  • editor: 예제 데이터 10개(에이전트, 프로토타입의 코드를 실제로 돌려 견주어 10개 모두 같음). 헤더 선택 · 이동 · 이름 편집, e m E M, 호출 블록 넣기(Method 목록, 새 UI picker-menu) · 두 칸 편집 · 대상 바꾸기, 헤더 모양 설정과 기억(editor.headStyle)(에이전트). 예제 모달(첫 방문 · 도움말 › 예제…), 툴바의 “예제 ▾”, 예제마다 명령(커맨드 팔레트에서도), OpenedDocument.doc(Claude)
  • web: 예제를 깨끗한 새 문서(예제 이름.ns.svg)로 열기, 첫 방문(examples.welcomed), 첫 방문이면 포커스를 모달에(Esc가 닫게), E2E는 환영을 건너뜀 + 예제 E2E 넷
  • 화면으로 확인: 노트북(1366 × 768)에서 4 × 3이 다 보이도록 썸네일 16 : 9. “제목처럼” 헤더의 선택 테두리가 글자를 덮어 바깥으로 넓힘
  • 검사: pnpm check 통과(core 261, editor 226, fonts 17, web 43), E2E 37 통과
  • 문서: 01-requirements의 MVP 범위, 03-editor(open의 doc, 5.1 메뉴, 3.4 칸, 6장 Picker), 06-web 7장(첫 방문), 03-keymap, 02-layout 1.7, 04-visual-design 7.1
  • Claude가 정한 것은 확인해 주세요, 못 한 것은 MVP 개발

매듭 뒤: 반영 시간 재기 (ND1)

  • 메인테이너: “작은 변경하나 해봅시다. mvp에 반영되는 시간 정도가 궁급합니다. 포커스를 마지막 아래로 이동하려고 하면 부모블록을 포커스하도록 해주세요.” → ↓로 더 갈 곳이 없으면 담은 블록을 선택, 맨 바깥 줄에서는 그대로 → ND1, 키보드로 이동하고 삽입하기
  • 시각: 13:09:46 시작 → 13:11:50 고치고 전체 검사 · E2E 통과 → 13:12:02 push → 13:13:00 Pages 배포 끝(사이트의 파일이 바뀐 것을 확인) → 13:14:06 CI 통과. 요청부터 사이트까지 약 3분 15초
  • 담은 블록에서 ↓는 다시 안으로 들어가므로 맨 아래에서 둘을 오간다(Claude가 정함). 메인테이너: “맨 아래의 While 안 마지막 블록에서 ↓를 누르면 While이 선택 ← 이게 좋습니다.”

마무리

메인테이너: “마무리하고 pc를 종료해주세요. 수고하셨습니다.”

다음 할 일: 이번과 다음 세션에 할 것 — 메인테이너가 예제와 헤더를 써 보기, 확인해 주세요의 MVP 항목들