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