2026-10-31 README에 그림과 프로토타입 링크, 프로토타입 62번째 판(정한 것을 모두 넣음)

(← 2026-10-25-06-requirement-ids) 메인테이너: “안녕하세요? 잠깐 들어왔어요.” 잠깐이라던 세션이 README와 프로토타입 한 판으로 이어졌다.

inbox

두 항목을 함께 검토했고, 마무리 때 “둘 다 세션 기록으로 옮기고 지우기”를 골랐다. 원문:

5. 질문/요청

6. 기타

  • 방문자가 AriadneNSD에 대해 잘 알 수 있도록 README 상단에 삽입해주세요
    • 프로토타입의 링크
    • 다이어그램 샘플 캡쳐 (적당한 규모에 그럴듯 하게 멋있는 것으로)

논의 흐름

  1. 3.2의 인터페이스는 순환 참조를 피하려는 것인가. 반은 맞다고 답했다. 중심은 의존 역전(포트와 어댑터)이다. editor가 필요한 I/O를 인터페이스(DocumentStore, SettingsStore)로 정의하고 셸이 구현해 넣어 주므로, 의존이 모두 editor 쪽으로만 향하고(순환 없음), editor는 플랫폼을 모르며, 시험에서 가짜를 넣을 수 있다. 백엔드의 Repository 인터페이스(도메인)와 JPA 구현(인프라)에 빗댔다. 반대 방향(CommandRegistry · SettingsSchema)은 셸이 명령 목록을 받아 자기 메뉴에 그리게 하려는 것. 메인테이너: “til에 정리하지 마세요.”
  2. README 그림의 후보(시안 M41). 프로토타입을 복사해 같은 그리는 코드로 후보 넷(자판기, 이진 탐색, 엘리베이터, Raft)을 그렸다. 메인테이너: “이진탐색처럼 알고리즘을 그린 nsd가 좋기는 한데, 한군데에서만 쓰이는 메소드는 별로인 것 같습니다.” 알고리즘 넷(다익스트라, 미로 찾기, 병합 정렬, 이진 탐색 한 장)을 더했다. Claude의 추천은 미로 찾기(아리아드네의 실 = 되추적)였다.
  3. 빈 갈래의 ∅. 메인테이너: “우리 제어블록의 브랜치에 아무것도 없으면 기호를 넣기로 하지 않았나요?” E1(2026-10-18)에서 정했으나 프로토타입에 아직 없어 시안에도 빠졌다. 시안에 그려 넣었고, “∅가 너무 커요. 조금 줄여주세요”로 지름 10px → 7px, 선 1.3 → 1.1px.
  4. “지금까지 결정된 것들을 프로토타입에 반영해주세요.” 2026-10-18 · 10-25에 정하고 넣지 못한 것을 한 판(62번째)에 모두 넣었다(→ 지금 판). 2026-10-11의 “프로토타입으로 하나씩 리뷰”와 달리 이번에는 메인테이너가 한꺼번에를 청했다. 단계마다 바꾸는 스크립트(journal/assets/2026-10-31-prototype-62-patch.py)로 고치고 시험을 돌렸다.
  5. README에 넣기. 작업 중에 메인테이너: “M41 5번, 7번 마음에 듭니다. 둘 다 병렬로 삽입해주세요. 7번에서 접기영역 설정은 빼주세요.” 5번의 안쪽 반복은 방금 넣은 For 블록으로, 7번의 // 2는 구문 강조가 C 주석으로 칠해 >> 1로 찍었다. 소개 아래에 그림 둘, 그 아래 프로토타입 링크.
  6. “푸시해주세요. 퍼블리싱 결과를 확인하고 싶습니다.” 사이트 빌드를 기다려 첫 화면을 찍어 보니 그림이 위아래로 쌓였다. 가로 놓기만으로는 모자랐고(본문 폭 약 650px < 두 그림 706px), 그림 폭을 300 · 291px로 줄여 나란히 서게 했다.
  7. “포로토타입의 예제에 M41의 후보들을 모두 넣어주세요. M41 훌륭합니다.” Raft를 뺀 일곱을 예제 줄의 “더 보기…”에 넣었다.
  8. 마무리 중에: “README의 예제 2개에서 헤더를 “제목처럼”으로 바꿔주세요.” 62번째 판의 머리 모양 “제목처럼”으로 다시 찍었다(시안의 찍는 자리에 &title). 처음 다시 찍을 때 # 뒤만 바꿔 불러 앞 그림이 섞였고, 파이썬 문자열 속 가 보이지 않는 글자가 되어 제목처럼이 켜지지 않았다. 찍을 때마다 새 문서로 열고 정규식을 바꿔 고쳤다.

결정

  • README 첫 화면: 소개 아래에 M41의 5번(다익스트라)과 7번(병합 정렬, 접기 영역 없이)을 머리 모양 “제목처럼”으로 나란히, 그 아래 프로토타입 링크 → README.md, sketchbook의 M41
  • ∅의 크기: 지름 7px(반지름 3.5), 선 1.1px(메인테이너가 줄여 달라고 함). 시각 디자인 명세의 “글자 크기에 맞춤”과 어긋나지 않음
  • 프로토타입 62번째 판: 정한 것을 모두 넣음. 임시로 정한 것은 outbox의 “확인해 주세요”

한 일

  • 시안 M41(README 그림 후보) https://claude.ai/artifact/VfXVPTtneN9KBFjEB5bz9j (사본 journal/assets/2026-10-31-readme-sample-study.html, 만드는 스크립트 …-readme-sample-build.py, 찍는 스크립트 …-readme-sample-shots.mjs)
  • README: 그림 둘(journal/assets/2026-10-31-readme-dijkstra.png · …-merge-sort.png, 2배 해상도), 프로토타입 링크(TIP)
  • 프로토타입 62번째 판: For, ∅, If 갈래 이름, Case 이름 자리, 조건 글자 뒤 바탕, 짧은 갈래 고르게, MD3, 제목처럼, 두 키 안내, 다이어그램 배치(16 : 10), 호출 블록의 칸 둘과 Tab, 결과 기호, 괄호를 지우면 인자 지우기, M41의 예제 일곱. 시험 217개 통과(새로 36)
  • 문서: 1.8 지금 프로토타입과 다른 곳, 11. 지금 프로토타입과 다른 곳, prototype, status, outbox
  • push 세 번(메인테이너의 요청), 사이트 첫 화면을 찍어 확인

발견한 위험과 실수

  • 시안이 프로토타입의 빈 곳을 물려받는다. 프로토타입을 복사해 시안을 만드니, 정해 놓고 넣지 못한 것(∅)이 시안에도 빠졌다. 메인테이너가 짚고서야 알았다. 시안을 프로토타입에서 만들 때는 정해 놓고 아직 넣지 못한 것을 먼저 본다.
  • 이 셸에 node가 PATH에 없다. 시험 스크립트는 ms-playwright-go에 딸린 node(%LOCALAPPDATA%\ms-playwright-go\1.57.0\node.exe)로 돌렸다. 헤드리스 Chrome의 --screenshot은 명령이 끝난 뒤에 파일을 쓰므로 잠깐 기다려야 한다(처음에는 옛 그림을 보고 헤맸다).
  • 새 규칙이 옛 동작과 부딪힘: “괄호가 없으면 인자를 지운다”가 r로 새 Method를 만들 때(이름을 적기 전 잠깐 괄호가 없음) 인자를 지웠다. 이름 칸에서 괄호 있는 이름을 적으면 되살리게 함. 시험이 잡았다.
  • 사이트와 GitHub의 그림 놓기가 다르다. GitHub에서 나란히 서는 그림이 사이트에서는 쌓였다. 펴낸 결과를 찍어 보아 찾았다.

다음 할 일

  • 메인테이너: 프로토타입 62번째 판을 써 보기, outbox의 “확인해 주세요”(62번째 판에서 Claude가 정한 것, README)
  • 다음의 첫 일은 그대로 편집기 · 웹 설계 → status