2026-10-25 outbox 비우기, 레이아웃 설계(M33 ~ M39, ADR-0037), 테스트 전략(M40, ADR-0038)

(← 2026-10-25-03-inbox-structure-code-layout) 같은 날 네 번째 세션이다. 밀린 outbox를 비우고, 레이아웃 설계 02-layout의 1 ~ 3단계(규칙 쓰기, 시안 여섯, 스파이크 둘)를 했다. 세션 중간에 매듭을 지었고, 그 뒤 레이아웃 4단계(ADR-0037), 테스트 전략(M40, ADR-0038, 02-test-architecture), inbox 한 항목을 하고 마무리했다.

시작

메인테이너: “마지막 커뮤니케이션에 문제가 있었습니다. 내가 많은 부분을 놓쳤을 것 같아요.” Claude가 지난 세션(세션 03)과 매듭 뒤의 이야기(토큰이 드는 곳, outbox 비우기에 “그럽시다”)를 다시 요약했다.

이어서 메인테이너가 /auto-mode-setup을 실행했고, 그 안내가 영어로 나왔다. 메인테이너: “나는 한국어 사용자입니다. 영어는 내가 판단하기가 너무 힘들어요.” 판단할 영어는 항목마다 한국어로 옮기고 뜻과 추천을 붙이기로 했다(Claude의 메모리에 적음). 자동 모드 초안은 나오면 붙여 받아 풀기로 하고, outbox 비우기부터 했다(메인테이너: “outbox 비우기부터 시작합시다”).

outbox 비우기

“확인해 주세요” 전체(2026-10-11부터 쌓인 묶음 약 45개)를 주제별로 일곱 번의 고르는 창에서 물었다. 창의 미리보기에 묶음마다 한국어로 줄인 목록을 넣었다. 메인테이너는 모든 주제에서 **“모두 그대로”**를 골랐다. 따로 물어야 한다고 적어 두었던 것 하나도 추천대로 정해졌다: “다이어그램 지우기는 단축키 없음”은 Vim 키 X만 두지 않는 것이고 Shift+Delete는 남긴다.

“알아만 두세요”의 보고 넷도 “읽었음, 지움”을 골랐다.

그 결과 outbox에는 “정해 주세요”만 남았다(약 2만7천 자 → 약 2천5백 자). 아래는 옮긴 원문이다.

”정해 주세요”를 하나씩

메인테이너: “하나씩”. 남은 “정해 주세요”를 한 번에 하나씩 물었다.

  1. 글자 폭 측정을 P0으로 올림. 메인테이너가 추천(“P0으로 올림”)을 골랐다. MVP의 R-FMT-03(P0)과 QA-03이 번들 글꼴의 폭 표로 재는 것을 전제로 해서, 기대는 쪽이 P0인데 기대는 것이 P1인 순서를 바로잡았다. 요구사항 R-LAY-04의 태그를 바꾸고, MVP 범위가 달라져 DR-0015에 “이후 변경”을 달았다.

  2. GitHub 조직 ariadne-nsd도 만듦. 메인테이너가 고르는 창 대신 글로 물었다: “GitHub 조직 ariadne-nsd을 만들어두는게 좋을까요?” “둘 다 만들면 사람들이 혼란스러워하지 않을까요?” Claude의 답: 저장소 없이 소개에 공식 주소를 적은 빈 이정표로 두면 헷갈림은 작고, 남이 가져가는 쪽이 더 헷갈린다. 메인테이너: “만들기”. 메인테이너가 만들었고(“내가 제대로 만들었나요?”), Claude가 GitHub의 공개 API로 확인했다. 처음에는 소개와 URL이 비어 있어 다시 안내했고, 두 번째에 이정표가 붙었다(소개 “This is a placeholder. AriadneNSD lives at github.com/reddiana/AriadneNSD”, URL은 공식 저장소, 저장소 0개). names-and-registries를 고치고 outbox에서 닫았다.

  3. 데스크톱 프레임워크(ADR-0009)는 데스크톱을 설계할 때 정함. Claude가 Electron과 Tauri를 표로 견주어 글로 먼저 설명했다. 저장되는 파일은 어느 쪽이든 같고, 데스크톱은 셋째 순서이며 MVP(웹)에 닿지 않는다. 메인테이너가 추천(“데스크톱 때 정함”)을 골랐다. outbox에서 빼 뒤의 배포 대상을 설계할 때로 옮겼고, ADR은 “제안됨” 그대로 둔다.

  4. AI 대화창 스파이크는 MVP 뒤로. P3이고 MVP에 없으며, AI가 우리 형식으로 쓰는지는 파일 형식이 굳은 뒤에 봐야 뜻이 있다. 메인테이너가 추천(“MVP 뒤로 미룸”)을 골랐다. outbox에서 빼 출시 무렵과 그 뒤로 옮겼다.

  5. Google Drive 연동은 세 대상을 모두 만든 뒤. Claude가 자리 셋(웹 바로 다음 · Obsidian 다음 · 셋 다 만든 뒤)을 표로 견주고, Google 심사가 있다는 것을 덧붙였다. Claude의 추천은 “MVP 반응을 보고 정함”이었으나 메인테이너는 **“셋 다 만든 뒤”**를 골랐다. 순서는 웹 → Obsidian → 데스크톱 → Drive. DR-0002 · ADR-0012에 “이후 변경”, 요구사항 2장 표의 “언제”와 README의 문장을 고쳤다.

  6. “주홍 = 실의 색”을 바로잡음. 처음에 Claude는 “권함”과 “주홍”을 “그때의 기록이니 그대로”로 묶어 요약만으로 물었다. 메인테이너: “링크 주세요 내가 너무 막 추천을 그대로 수용하는 것 같네요. 그렇다고 대충 물어보시면 안돼죠”. 링크를 찾다가, “주홍은 실의 색”이 옛 말이 아니라 타임라인 92에서 틀렸다고 밝혀진 사실이고 두 곳이 고쳐지지 않고 남은 것을 알았다. 이어서 메인테이너: “뭘 결정하라는지 잘 모르겠어요.” 두 가지를 나눠 하나씩, 고치기 전과 뒤의 문장을 표로 보여 물었다. 메인테이너: “고치기”. 타임라인 72번은 문장을 두고 “(실의 색은 신화에 없음 → 92)“를 덧붙였고, 로고 시안 M04의 W3 설명에서 “(실의 색)“을 지웠다. claude.ai의 M04도 다시 올림(올라가 있던 판이 저장소 사본과 같은지 먼저 견줌).

  7. 시안 M05 · M06 · M07의 “권함”은 그대로 둠. 링크와 바꾸기 전후의 표를 보여 물었다. 틀린 말이 아니라 읽을 때 걸리는 말이고, 결정이 끝난 페이지다. 메인테이너: “그대로”. 새로 쓰는 글에는 전처럼 “추천”을 쓴다.

레이아웃 설계 1단계

메인테이너: “레이아웃 설계”. 프로토타입의 measure · place · layout과 그리는 코드를 읽고, 합의한 규칙(시각 디자인의 토큰과 배치 규칙, 접기 영역, 여러 다이어그램의 배치, UX 결정 Q25 · E1 · H1)을 기준으로 1. 레이아웃 알고리즘을 썼다: 두 단계(크기 재기 · 자리 잡기), 글자, 줄, 블록, 머리, 테두리가 있는 것, 여러 다이어그램의 배치, 프로토타입과 다른 곳. 문서의 상태를 “작성 중”으로.

발견한 것:

  • 프로토타입은 Case의 갈래 이름을 칸의 오른쪽에, default를 왼쪽에 붙인다. 시각 디자인 명세는 반대다(Q25).
  • 두 빗금 사이의 가로 폭은 깊이 d에서 w·(1 − d/H)로, 꼭짓점의 자리와 상관없다. 조건 글자가 빗금과 겹치지 않게 머리 높이를 셈할 수 있다(미결정에 적음).
  • 굵은 글꼴이 없다. 기본 블록 글꼴은 D2Coding 보통 하나인데(ADR-0034), 호출 블록의 Method 이름은 굵게 그린다. 굵은 글꼴을 더 실을지, 합성 굵게로 그리고 폭은 같다고 셀지 미결정에 적음.
  • 토큰이 없는 프로토타입의 값 여섯(18 · 70 · 90 · 24 · 160 · 20/4px)을 미결정에 모음.

레이아웃 설계 2단계: For 블록 (M33)

메인테이너가 2단계의 물음을 “순서대로” 하자고 했다. 첫째는 For 블록. 시안 M33(F1 모양 세 안, F2 넣는 키 두 안)을 만들었다. 메인테이너: “f1: 2 / f2: 1”. F1은 Claude의 추천(1번 띠에 눈금)과 달리 2번 While과 같은 모양, 글자로만(NS 차트 표준). 시각 디자인 원칙 2에 For · While의 예외를 적었다. F2는 f. 반영: FB1 · FB2, 시각 디자인의 모양 표와 원칙 2, 조작 규칙의 For 블록, 키 표, 레이아웃 1.4, 프로토타입 할 일, DR-0015 이후 변경. 시안 ID F1 · F2는 M12의 F1과 겹쳐 UX 결정 모음에서는 FB1 · FB2로 적었다.

레이아웃 설계 2단계: If 머리의 폭과 높이 (M34)

둘째 물음. 시안 M34의 B1(겹치지 않게 머리 폭을 글자의 2.1배 · 1.5배 · 1.25배까지, 그리고 지금 프로토타입)을 만들었다. 두 빗금 사이의 폭이 깊이 d에서 w·(1 − d/H)라는 셈으로 안을 나눴다. 메인테이너: “1”. 반영해 커밋까지 했는데 메인테이너가 “잠깐”으로 멈추고: “지금 프로토타입이 좋습니다. 1번은 너무 넓네요. 2번, 3번은 단연코 반대입니다.” 그 커밋을 되돌렸다(git revert).

프로토타입은 긴 조건이 빗금과 겹치고, 명세는 겹치지 말라고 적고 있어서, 겹치는 곳의 모습을 B2로 다시 그렸다(1. 글자 뒤 바탕, 2. 겹쳐도 그대로, 3. 두 줄). 그리다가 3번은 프로토타입 폭에서 겹침이 풀리지 않는 것을 알았다(줄이 늘면 글자의 아래 끝이 내려가 빗금 사이가 더 좁아짐). 메인테이너: “지금의 1번 좋습니다”. 반영: BH1, 레이아웃 1.4, 시각 디자인 5장(새 토큰 size.text-halo)과 11장, 프로토타입 할 일.

배운 것: 셈으로 깔끔한 안(높이 고정)이 보기에 좋은 안은 아니었다. 시안에 지금 모습을 “참고”로 두었기에 메인테이너가 그것을 고를 수 있었다.

레이아웃 설계 2단계: 긴 글자 (M35)

셋째 물음. 시안 M35(L1: 폭을 늘림 = 지금 프로토타입, 저절로 줄 바꿈, 자르고 ”…“)를 만들었다. 메인테이너: “L1: 1번”. 반영: LT1, 레이아웃 1.2, 키 표에 Shift+Enter(줄 바꾸기). 이 키는 프로토타입에 있었으나 키 표에 없던 것을 시안을 만들며 찾았다.

레이아웃 설계 2단계: 짧은 갈래 (M36)

넷째 물음. Claude가 “이어서 시안을 만들까요?”라고 묻자 메인테이너: “시안이 필요하다 싶으면 묻지말고 바로 만들어주세요.” (메모리에 적음.) 시안 M36(S1: 마지막 블록을 늘림 = 지금 프로토타입, 아래에 빈 칸, 블록들을 고르게)을 만들었다. 메인테이너: “3번”. Claude의 추천(1번)과 달랐다. 반영: SB1, 레이아웃 1.3(나머지는 마지막 블록, 제어 블록은 안쪽 줄로 다시 나눔 → outbox 확인), 프로토타입 할 일. 2026-10-10의 프로토타입 질문 4가 이것으로 닫혔다.

레이아웃 설계 2단계: default 없는 Case (M37)

다섯째 물음. 시안 M37(C1 default가 없을 때: 긴 빗금이 끝까지 · 빈 default 칸, C2 default만 있을 때: 짧은 빗금 하나 · 빗금 없음)을 만들었다. 메인테이너: “C1: 2 / C2: 1”. C1은 Claude의 추천(1번 표준)과 달랐다. 모델에 없는 칸을 그리게 되어, 그 칸을 고르고 적으면 default가 생기는 동작을 Claude가 정했다(→ outbox 확인). 반영: CD1 · CD2, 레이아웃 1.4, 시각 디자인 모양 표, 조작 규칙 Case 블록, backlog의 항목 체크.

레이아웃 설계 2단계: 굵은 글꼴 (시안 없음)

여섯째 물음을 준비하며 ADR-0034를 다시 읽었다. 굵은 글자와 기울임을 쓰는 곳(호출 블록의 이름, 접기 영역의 이름, “제목처럼” 머리)은 MVP 범위에서 모두 뒤로 미룬 것이었다. 그래서 MVP에는 굵은 글꼴이 필요 없고, 레이아웃의 미결정을 “그것들을 넣을 때 정함”으로 고쳤다. 1단계에서 “굵은 글꼴이 없다”를 발견으로 적은 것은 ADR-0034를 끝까지 읽지 않아서였다.

레이아웃: 토큰 정리와 다이어그램 배치 (M38)

메인테이너: “계속 진행”. 프로토타입에만 있던 치수 여덟에 토큰 이름을 붙여 시각 디자인 5장에 옮겼다(값은 그대로, outbox 확인). 이어서 시안 M38(두 무리 사이 88 · 132 · 66px, 지금 프로토타입)을 만들었다. 그림은 Claude가 정한 줄 높이 셈으로 그렸다. 메인테이너: “1”. 반영: DA1, 새 토큰 space.kind-gap, 레이아웃 1.7(미결정을 지움), 프로토타입 할 일.

레이아웃 설계 3단계: D2Coding 폭 표 스파이크

이 컴퓨터에 깔린 D2Coding(…-all.ttc, 보통 · 굵게)과 Python 3.14의 fonttools로 쟀다(스크립트 journal/assets/2026-10-25-d2coding-metrics-spike.py, 결과 .json). 기본 python(3.15)에는 fonttools가 없어 py -3.14로 돌렸다.

  • 글자 폭은 반각 500 · 전각 1000 두 가지뿐. 폭 테이블은 구간 50개, JSON 약 0.8 KB
  • D2Coding Bold의 폭은 보통과 모든 글자에서 같다(굵은 글자의 폭 걱정은 사라짐)
  • D2Coding에는 한자가 있다(ADR-0034대로 싣지 않음). 이모지는 없다. 테이블에 없는 글자는 전각으로 세기로 Claude가 정함(→ outbox 확인)
  • 서브셋: 영어만 9.6 KB, 한글 300자 51 KB, 800자 114 KB(TTF). woff2는 절반쯤. 편집기 번들의 글꼴은 327 KB(woff2)
  • 반영: 2. 텍스트 폭 측정, 아키텍처 7장의 위험, ADR-0026 · 0034 이후 변경

레이아웃 설계 3단계: 속도 스파이크 (M39)

이 컴퓨터에 Node가 없어, 레이아웃의 두 단계와 장면 → SVG를 그대로 돌리는 페이지 M39를 만들어 메인테이너가 Edge에서 돌렸다. 메인테이너: “할 때 마다 결과다 다른데 몇번 수행하고 평균을 내나요?” → 한 번에 30번 돌린 중앙값과 느린 5%를 보인다고 답하고, 세 번 돌려 가장 느린 값을 기준으로 보기로 했다. 결과(journal/assets/2026-10-25-layout-perf-spike-results.txt): 블록 500개 합계 9 ~ 11ms(느린 5% 16 ~ 29ms), 2,000개 39 ~ 47ms. 레이아웃은 1ms 안팎이고 대부분은 화면에 넣는 시간. 그래서 증분 레이아웃을 하지 않기로 Claude가 정함(→ outbox 확인). 반영: 4. 성능, 아키텍처 7장(펴 보기와 성능).

매듭 뒤: 레이아웃 설계 4단계 (ADR-0037)

메인테이너: “이어서”. 구조를 정한 것 셋을 ADR-0037(제안됨)으로 썼다: 두 단계의 순수 함수(대안: 한 번에, 제약 풀이기), 고칠 때마다 전체를 다시 셈(대안: 증분), 폭 테이블은 구간 목록이고 없는 글자는 전각(대안: 반각, East Asian Width). M39의 숫자를 시퀀스 다이어그램에 적었다. 메인테이너: “승인”. ADR-0029 · 0030에 이후 변경, outbox의 해당 확인(증분 없음, 전각)도 닫음.

매듭 뒤: 테스트 전략 (M40, ADR-0038)

메인테이너: “테스트 전략”. 시험 종류와 도구 후보는 품질 속성 시나리오 3장에 있었으므로, 남은 고를 것 셋을 시안 M40으로 물었다(Java에 빗댄 설명과 폴더 나무). 메인테이너: “T1: 1 / T2: 1 / T3: 1”(모두 추천). ADR-0038(승인)과 02-test-architecture(초안: 층마다의 시험, 골든 파일, 인수 시험 AT-01 ~ 10, CI)을 썼다. ADR-0036 이후 변경, 문서 지도, QAS 3장의 “도구 (후보)” → “도구”, backlog 정리.

매듭 뒤: inbox 한 항목 (packages/와 src/ 구조)

메인테이너: “inbox 체크해주세요”. 세션 중에 적어 둔 항목이었다(Claude의 git add -A 커밋에 함께 들어가 git에도 남아 있음). 원문:

5. 질문/요청

  • 4.1 패키지 의존
    • 패키지 다이어그램에서 apps/web 등은 알겠는데 packages/core 등은 모르겠어요. packages/가 뭔가요?
    • src/ 디렉토리 구조는 이 문서에 명시하나요? 다른 문서를 새로 만드나요?

답: packages/는 여러 앱이 함께 쓰는 라이브러리(Maven 멀티 모듈의 공통 모듈), apps/는 내놓는 프로그램. 폴더 나무는 ADR-0036(atelier/)에만 있었다. 메인테이너가 고르는 창에서 추천(“아키텍처 3장 첫머리”)을 골라, 4. 구성 요소에 apps · packages의 뜻(표)과 src/ 폴더 나무를 넣었다. inbox 항목은 옮기고 지움(제목은 남김).

결정 (매듭까지)

  • 글자 폭 측정을 P0으로(DR-0015 이후 변경), GitHub 조직 ariadne-nsd를 이정표로 만듦, ADR-0009와 AI 대화창 스파이크는 뒤로(backlog), Google Drive는 세 대상 뒤(DR-0002 · ADR-0012 이후 변경), “주홍 = 실의 색” 바로잡음, “권함”은 그대로
  • 레이아웃: FB1 · FB2(For는 While 모양 + 글자, 키 f), BH1(프로토타입 폭 + 글자 뒤 바탕), LT1(폭을 늘림, Shift+Enter), SB1(고르게 늘림), CD1 · CD2(빈 default 칸, 짧은 빗금 하나), DA1(88px)
  • 치수 토큰 아홉(여덟 + size.text-halo, space.kind-gap), 증분 레이아웃 없이 전체를 다시 셈(M39), 테이블에 없는 글자는 전각

발견한 위험과 배운 것

  • 메인테이너가 추천을 그대로 받는 일이 잦았다. 요약만 주고 물으면 판단할 재료가 없다. 링크와 원문을 보여 주자 Claude의 추천이 틀렸던 것(주홍)이 드러났다 → 메모리 show-sources-when-asking
  • 셈으로 깔끔한 안이 보기에 좋은 안은 아니었다(M34). 지금 모습을 “참고”로 그려 두면 메인테이너가 그것을 고를 수 있다
  • 다섯 물음 가운데 셋(F1, S1, C1)에서 메인테이너는 Claude의 추천과 다른 안을 골랐다
  • 이 컴퓨터의 기본 python(3.15)에는 fonttools가 없고 py -3.14에 있다. Node는 없다. Windows의 Python이 쓴 파일은 CRLF가 되기 쉽다(newline=' ')

결정 (매듭 뒤)

  • ADR-0037 승인: 레이아웃은 두 단계의 순수 함수, 고칠 때마다 전체를 다시 셈, 폭 테이블은 구간 목록 · 없는 글자는 전각
  • ADR-0038 승인: Vite(웹) · esbuild(Obsidian), Vitest · fast-check · Playwright · dependency-cruiser, ESLint + Prettier, 시험 파일은 소스 옆(M40 T1 · T2 · T3 1번)
  • 아키텍처 3장에 apps · packages의 뜻과 src/ 폴더 나무(inbox)

다음 할 일

  • 편집기 · 웹 설계(웹의 화면은 시안부터) → 이번과 다음 세션에 할 것
  • outbox의 “확인해 주세요”(세션 04에서 Claude가 정한 것: 치수 토큰의 이름, CD1의 동작, SB1의 세부, 테스트 전략의 표들 등) → outbox

원문: “정해 주세요”에 있던 확인 묶음 (문서 · 저장소 · 일하는 방식)

  • 2026-10-25 세션 03에서 Claude가 정한 것 → 2026-10-25-03-inbox-structure-code-layout
    • ADR-0036의 세부: 워크스페이스 도구 pnpm, 패키지 이름 @ariadne-nsd/fonts · core · editor, 나중의 Claude skill 자리 src/skills/ariadne-nsd(셸이 아니라 apps/ 밖), Google Drive는 src/apps/web 안. M32의 배포 대상 표(코드의 자리와 내보내는 곳)
    • TIL 목록의 주제 여섯과 노트를 나눈 것(브라우저, 그림과 글자, 설계와 기술 선택, 배포 대상, git과 GitHub, 오픈소스 운영)
    • 문서 지도(M31)의 표의 열: 문서 · 답하는 질문 · 상태 · 바뀌는 때. “상태”는 각 문서 속성의 값
    • 링크 공유 그림(site/og-image.png)의 모양: 크림 바탕(#F7F1EA)에 왼쪽 로고, 오른쪽 문자 로고, 다른 글자 없음
  • 2026-10-25 문서 전체 정합성 검토에서 Claude가 고친 것 가운데 뜻에 닿는 것 → 2026-10-25-03-inbox-structure-code-layout
    • 요구사항의 문구: R-NFR-02 “세 배포 대상” → “배포 대상들이 만든 파일(.ns, .ns.svg)”, R-NFR-05 “고대비 테마” → “고대비 화면”, 2.5의 “네 번째 배포 대상” → “뒤에 붙는 배포 대상(셸)”
    • For 블록은 MVP에 들지만 조작과 모습의 규칙이 없어 02-interaction-rules · 04-visual-design · 03-keymap에 “미완성”으로 밝힘
    • 파일 형식 명세가 “woff2”로 적은 글꼴 조각의 형식을 미결정으로 돌림(ADR-0026은 압축하지 않은 TTF를 말함) → 6. 미결정 사항
    • 아키텍처 3.3의 “core 안 폴더 사이의 방향”은 적혀 있지 않아 “미완성”으로 두고 레이아웃 · 편집기 설계에서 정하기로 함 → MVP 전에 정할 것
    • 상세 설계 문서의 제목 뒤 경로(모델 (packages/core) 등)를 빼고 첫 문단에 src/… 경로로 옮김. 시험 · 예시의 경로는 src/를 붙인 것과 붙이지 않은 것(아키텍처의 이름)이 섞여 있음
    • status의 “지금 단계”에서 지나온 경과 문단을 지우고 지금 상태만 남김(경과는 세션 기록에 있음)
    • ADR · DR 목록의 묶음을 옮김: ADR-0034 · 0035는 “파일 형식과 저장”, DR-0012는 “기록하는 법”, DR-0014는 “일하는 순서”
    • 남겨 둔 것: 요구사항 · 조작 규칙의 “선택”과 “고른”이 섞인 낱말(→ requirements-rework), 요구사항 2.6과 2.7의 순서가 표와 반대인 것(번호를 바꾸면 링크가 바뀜), 용어집에 없는 낱말(→ backlog)

원문: 확인해 주세요

요구사항 · 범위

  • 품질 속성 시나리오(QAS)를 쓰며 Claude가 정한 것 (2026-10-22, 메인테이너 inbox: “비기능요건에 대한 품질속성시나리오(QAS)들을 도출해주세요”) → 03-quality-attribute-scenarios

    • 자리: 요구사항 폴더의 셋째 문서. 아키텍처의 품질 목표에서 QA ID로 링크, “변경 용이성”을 품질 목표 6으로 더함(ADR-0002 · 0030과 메인테이너의 A5 말씀에서 끌어냄)
    • 시나리오 열일곱의 나눔과 “우선”(높음 · 중간 · 낮음). 요구사항에 없던 QA-08 여는 시간, QA-09 크기, QA-17 저장 실패를 더함
    • 시험 도구의 후보(fast-check, Playwright, Vitest, dependency-cruiser). 제안값은 그 문서의 미결정 절에 있음
  • 유즈케이스 문서를 쓰며 Claude가 정한 것 (2026-10-22) → 02-use-cases, DR-0014

    • 유즈케이스 열 개의 나눔과 이름, 액터 셋(작성자 · 독자 · 호스트 플랫폼)
    • 목록의 MVP 열(웹 P0에서 기본 흐름이 되는지): UC-01 · 02 · 03 · 06은 됨, UC-05는 확대 · 이동만, UC-08은 PNG만
    • UC-01의 “새 문서는 다이어그램 하나와 빈 블록 하나” (01-model의 불변식에서 끌어냄)
    • 자세히 쓴 셋(UC-02 · 06 · 07)의 이해관계자, 최소 보장, 성공 보장의 문장. 거기서 드러난 빈 곳 아홉을 6. 미결정 사항에 둠
    • “실패가 비싼 흐름”의 기준을 “실패하면 사용자의 파일이나 글이 상하는 흐름”으로 적음 → DR-0014
  • inbox 여섯 항목을 하며 Claude가 정한 것 (2026-10-14) → 2026-10-14-01-inbox-ide-plugin

    • IDE 플러그인의 접기 영역(R-IDE-05)에서 메인테이너가 고른 것은 “이름은 코드의 영역 주석으로”임. “접힘 상태는 IDE가 기억한다”와 우선순위 P2는 Claude의 추천을 그대로 적은 것이고 따로 답을 받지는 않음
    • IDE 플러그인은 무료로 적음. IntelliJ의 우선순위도 VSCode와 같은 P2로 두고 “VSCode 다음”이라고만 적음. 리버스 엔지니어링과 코드 생성은 3.6의 항목을 가리키는 줄로 2.7에도 둠
    • AI 대화창의 요구사항 문장(“사용자가 자기 API 키를 넣고, 키는 그 브라우저에만 보관한다”)과 미결정 절의 “AI 대화창의 키 보관”(광고 스크립트가 키를 읽을 수 있음)은 Claude가 씀
    • 2장의 표에 넣은 “언제” · “값” · “저장하는 것” 칸과 대상의 순서. Confluence의 저장은 “페이지 안의 다이어그램”이라고만 적음(아키텍처에는 “정하지 않음”)
  • 2026-10-13에 정한 것을 문서에 옮기며 Claude가 정한 것

    • “실무용”을 요구사항 1장에 “주 사용자는 실무에서 설계 문서를 쓰는 사람이다”로 적음. 교육용 기능은 “그 뒤”라고 적었고 없앤 것은 아님
    • “저장할 때의 언어를 따름”을 “저장하는 사람의 화면 언어”로 읽음. 언어가 다른 두 사람이 번갈아 저장하면 “참” · “거짓” 같은 글자가 바뀌어 git에 변경으로 남음
    • 블록 글자의 종류와 구문 강조의 우선순위는 P1 그대로 둠. 종류가 “문장”이면 강조하지 않는다고 적음
    • 요구사항 R-FMT-08의 우선순위 P0은 Claude가 붙임
    • 요구사항의 외곽선 옵션(R-FMT-10, P1)은 그대로 둠. 글꼴 조각을 읽지 않는 도구(일부 문서 도구)를 위한 길로 남김

모델 · 파일 형식

  • 결과 기호의 문서 설정: 파일에 저장하는 것은 Claude가 정함. 설정을 고르는 자리는 정하지 않음. 프로토타입에는 넣지 않음(지금은 늘 ←) (2026-10-11)
  • 2026-10-13에 정한 것을 문서에 옮기며 Claude가 정한 것
    • A6을 옮기며 승인된 ADR-0022의 “이후 변경”에 한 줄을 더함(2026-10-11의 줄은 그대로 둠)

조작 · 키

  • 목록에서 j k로 옮기기를 오른쪽 클릭 메뉴에도 넓힘 (2026-10-25). 메인테이너는 a c의 Method 목록을 말했고, 프로토타입에서 두 목록의 키 처리가 한 곳이라 Claude가 함께 넓힘. 오른쪽 클릭 메뉴에서 j는 전에는 메뉴를 닫고 블록을 옮겼다 → K2

  • 2026-10-15 inbox를 하며 Claude가 정한 것 → 2026-10-15-01-inbox-repo-name

    • Esc 두 번: 사이에 다른 키를 누르면 처음부터 셈. 시간 제한은 없음. 글자를 고치다 누른 Esc(받아들이기)는 세지 않음. 두 번 누르기를 그만둔 Esc(예: d 다음 Esc)와 영역 고르기를 끝낸 Esc도 첫 번째로 세지 않음
    • 풀린 뒤 이동 키를 누르면 마지막에 골랐던 블록부터 다시 고름(그 블록이 접혀 숨었거나 지워졌으면 첫 다이어그램의 처음). 메인테이너의 말에는 없던 것
    • 휠: 터치패드의 작은 움직임은 50px만큼 쌓여야 한 칸. v 영역 고르기 중에는 영역을 넓힘. 가로 휠과 Shift+휠은 늘 스크롤. 아래 블록이 없으면 휠을 굴려도 아무 일도 없음(스크롤도 하지 않음)
    • k로 가장 왼쪽 갈래에 들어갈 때 그 블록이 또 If · Case이면 더 들어감. 펴진 접기 영역과 펴 보인 호출 블록 안으로도 들어감. ↑와 위로 굴린 휠에도 같음
    • 고른 블록을 화면이 따라가게 한 것(요청에는 없었음. 휠로 내려가다 블록이 화면 밖으로 나가면 쓸 수 없어서). j k 같은 키에도 듣음
    • ux-decisions Q19(언제나 무언가 골라져 있다, 추천 1)에 “고른 것을 푸는 방법이 생겨 1번은 그대로 둘 수 없다”를 적고 “정하지 않음”으로 둠
  • 접기 영역의 테두리와 펴 보인 곳의 접기 영역에서 Claude가 읽거나 정한 것. M11(접기 영역 테두리 시안)의 “확인 3 · 4”와 그 밖의 것 (2026-10-13)

    • 확인 3: “펴 보인 블록은 고칠 수 없다”(Q13)는 그대로이고, 접기 영역 만들기 · 풀기 · 이름 고치기 · 접기와 펴기만 더해짐. 안쪽에서 za는 가장 가까운 것(이 자리의 접기 영역, 없으면 펴 보인 호출 블록)을 접음. Method에 원래 있던 접기 영역은 여기서 풀 수 없음
    • 확인 4: 호출 블록을 ds로 풀면 이 자리의 접기 영역은 보통 접기 영역이 되어 함께 들어옴
    • 접기 영역의 테두리는 누를 수 없고 띠만 누름(막대는 누르면 영역이 골라졌음). 이 자리의 접기 영역을 만들고 푸는 것은 실행 취소의 대상. 요구사항 R-EDIT-16의 우선순위 P1
    • 블록 하나짜리 접기 영역(메인테이너: “블록 하나도 접기영역을 만들 수 있게 해주세요”)도 다른 접기 영역처럼 만들면 바로 접히고 이름을 묻는다. 강조 대용으로는 펴진 채로 두는 편이 맞을 수 있음. 바꾸지 않음
    • 오른쪽 클릭 메뉴에 함께 적은 키는 셋: za · f, x · Del, i · Enter. Ctrl+X · C 같은 조합 키는 넣지 않음
    • ux-decisions Q15 · Q15-a를 “다시 정함”으로, Q15-b를 “없어진 물음”으로 적음. 승인 ADR 가운데 막대를 말하는 것이 있는지는 찾아보지 않음
  • Vim에 맞추며(메인테이너: “1~7 모두 추천 수용”) Claude가 정한 세부 (2026-10-13)

    • 여러 블록을 고르고 ds를 눌러도 그것들을 담은 가장 가까운 제어 블록이 벗겨진다. 접기 영역(접힌 칸, 이름 띠)을 고르고 ds를 눌러도 마찬가지다(접기 영역은 zd)
    • 안쪽에서 벗긴 뒤에는 고르고 있던 블록이 그대로 골라져 있다. 빈 갈래에 있던 빈 블록을 고르고 있었다면 그 블록은 함께 사라진다
    • 호출 블록을 풀면 들어온 블록들이 모두 골라진다. 복사된 블록 안의 접기 영역은 펴진 채로 들어온다
    • cc는 호출 블록에서는 비우지 않고 인자를 고른 채로 연다(이름을 지울 수 없어서). i는 호출 블록에서 커서를 인자의 맨 앞에 둔다
    • zo · zc는 za가 듣는 것에 듣고, 이미 그 상태면 “이미 펴져 있습니다” · “이미 접혀 있습니다”라고 알린다
    • zR · zM(메인테이너: “zR, zM도 합시다”)에서 Claude가 정한 것: 다이어그램 하나가 아니라 문서 전체에 듣는다. 모두 접기는 접기 영역 전부 + 제어 블록의 안쪽 가운데 za로 접을 수 있는 것(블록이 둘 이상) + 펴 보인 호출 블록을 접는다. 모두 펴기는 호출 블록을 펴 보이지 않는다. 고르고 있던 블록이 접힌 접기 영역 안으로 숨으면 가장 바깥의 그 접기 영역이 골라진다. 요구사항 R-EDIT-17은 P2 그대로 두었고, “깊이 n까지 펼치기”는 넣지 않았다
    • 요구사항에 한 줄을 더했다: “#P1 호출 블록 풀기” R-EDIT-08. 우선순위 P1은 Claude가 붙임(Method로 빼기와 짝이라서)
    • 도구 모음의 “제어 블록 풀기” 단추를 “풀기”로 바꿨다
    • ux-decisions Q7에 고를 것 3을 더해 “정함”으로 적었다. Q8(내용을 바꾸는 명령은 고른 것에만)의 추천 1과 어긋나는 곳이 생겼고, Q8은 “정하지 않음”으로 두었다
  • inbox의 항목을 프로토타입 40번째 판에 넣으며 Claude가 정한 것 (2026-10-13)

    • “다이어그램 지우기는 단축키 없음”을 Vim 키(X)를 두지 않는다로 풀이함. 전부터 있던 Shift+Delete는 그대로 듣는다. 이것까지 없애라는 뜻이었는지 확인 필요
    • 영역 고르기(v) 중의 x도 잘라내기에서 지우기로 바꿨다(x는 어디서나 Delete와 같게)
    • 갈래의 끝에서 아래로 갈 때, 그 If · Case가 바깥 If · Case의 갈래 끝이기도 하면 바깥 것의 다음 블록까지 한 번에 간다(옆 갈래로 넘어가지 않으려고). 다음 블록이 없으면 움직이지 않는다
    • 이 규칙은 j k와 ↑ ↓에 같이 듣는다. { }(Ctrl+↑ ↓)와 Shift로 영역을 넓히는 것은 그대로다
    • 영역을 넓힐 수 없을 때의 안내는 “접기 영역 보기”가 꺼져 있기만 하면 덧붙인다(막힌 까닭이 접기 영역이 아닐 때도). 문구는 Claude가 씀: “꺼져 있어 접기 영역의 경계가 보이지 않습니다. 켜면 어디까지가 같은 부모인지 보입니다”
    • 요구사항과 UX 설계 문서에는 이 설정의 이름이 적혀 있지 않아 프로토타입의 글자만 바꿨다
  • Vim 키에서 Claude가 정한 것. 메인테이너가 정한 것은 넷뿐임(키 배열 하나, Esc는 받아들임, a + 종류, dd는 잘라내기 → DR-0009) (2026-10-13) → 03-keymap

    • 표의 나머지 키 전부: { }, gg G, [[ ]], gd, v, i, p P, u U, ds, za zf zd, f를 접기 · 펴기로 남긴 것, e m r + -를 그대로 둔 것. 2026-10-13의 제안에 적었고 반대는 없었음
    • 다시 하기는 U (Vim의 Ctrl+R이 아님)
    • 받아들일 수 없어 다시 열린 칸(머리 이름이 겹치거나 빔, 호출 블록의 이름을 고침)에서만 Esc가 그만두기다. 이렇게 하지 않으면 그 칸에서 나올 수 없다
    • dd · yy는 Shift로 고른 영역 전체에 듣는다. v로 고르는 중에만 d y 한 번으로 듣는다
    • 영역 고르기(v)를 끝내면 마지막에 있던 블록 하나만 고른 채로 남는다
    • 갈래 이름 고치기(L)는 키를 주지 않았다 (더블클릭만)
    • 한글 입력기 스파이크 페이지는 만들지 않았다. 프로토타입이 글자를 자판의 자리로 읽고 있어서 프로토타입으로 대신했고, 메인테이너가 한글 입력 상태에서 j, dd, zf가 듣는 것을 확인함(2026-10-13)
    • 프로토타입에서 스위치와 옛 키를 없앤 것. 메인테이너는 “한글 입력 상태에서 vim 단축키 j, dd, zf가 잘 동작합니다”라고만 했고, 없애라고 하지는 않았다. Claude가 바로 앞에서 “확인하신 뒤 스위치와 옛 키를 없애는 것”을 추천했기에 그대로 했다. 옛 키가 필요하면 커밋 4b563a4의 38번째 판으로 되돌릴 수 있다. 2026-10-17에 메인테이너가 접기 영역의 옛 키를 되살리라고 함(“옛키도 살려주세요”) → 58번째 판에서 Shift+F(만들기)를 되살림. Ctrl+Shift+F(풀기)는 그동안에도 듣고 있었음. 이어서 메인테이너: “겹치지 않는 것들은 되살리되, 혼란스러울 것들이 있는지 검토해주세요” → 59번째 판에서 w / W(While 넣기)와 Shift+L(갈래 이름)을 되살림. w / W는 Vim의 “다음 낱말로”와 헷갈릴 수 있어 60번째 판에서 다시 뺌(메인테이너: “w은 뺍시다”). 겹쳐서 되살리지 않은 것: p i k d c(넣기), u(풀기), g(따라가기), 소문자 l. 대문자만 비어 있는 I K D C는 “앞에 넣기”만 되살리면 소문자와 짝이 맞지 않아 되살리지 않음
    • 안내 글과 도구 모음 풍선말의 키를 Vim 키로 바꿔 적은 문구(“펴려면 za”, “gd로 원래 블록으로” 등)는 Claude가 씀
    • ux-decisions Q3에 고를 것 3을 더하고 “정함”으로 바꿨다. Q5(붙여넣기를 앞에도)는 P가 생겼지만 “정하지 않음”으로 두었다
  • 프로토타입 37번째 판(접기 영역의 막대, 호출 블록 펴 보기)을 만들며 정한 것 (2026-10-11)

    • 재귀를 세는 법: 다이어그램 자신이 첫 번째. quicksort 다이어그램에서 quicksort 호출을 펴면 두 겹째(알림 없음), 그 안의 것을 펴면 “세 겹째” 알림
    • 접기 영역 안의 호출 블록에서 F를 누르면 호출 블록이 펴진다(전에는 그 접기 영역이 접혔음). 접기 영역을 접으려면 다른 블록이나 띠를 고른다
    • 이어진 곳이 없는 호출 블록에서 F는 알림만 띄운다(전에는 바깥 접기 영역이 접혔음)
    • 펴 보인 쪽에서는 접기 영역과 제어 블록을 접거나 펼 수 없다. Method에 저장된 접힘 그대로 보인다. (2026-10-13: 펴 보인 안쪽에서 za를 누르면 그것을 담은 가장 가까운 펴 보인 호출 블록이 접히게 바꿈. 메인테이너가 정함. 안쪽의 접기 영역과 제어 블록을 따로 접을 수 없는 것은 그대로)
    • “이름 띠 보기” 설정(2026-10-13부터 이름은 “접기 영역 보기”)은 접기 영역에만 듣는다. 펴 보인 호출 블록의 띠와 막대는 끄지 않는다
    • G로 원래 블록에 가도 화면이 그쪽으로 움직이지 않는다
    • 머리를 떼어 풀린 펴짐은 실행 취소로 다시 이어져도 접힌 채다
    • 경고 문구는 “quicksort을(를) 세 겹째 폈습니다”처럼 조사를 둘 다 적는다
  • “3번 이상 재귀 펼치기”를 Claude는 “같은 Method가 펴 보인 겹 안에 세 번째로 펴지는 때부터”로 풀이함 (2026-10-11) → ux-decisions Q14

시각 디자인

  • MVP는 글꼴 하나라, 시각 디자인 명세가 “비례폭”으로 정한 자리(If 갈래 이름 참 · 거짓, Case의 갈래 이름)도 D2Coding으로 그리기로 Claude가 정함 (2026-10-25). 비례폭 글꼴은 블록 글자의 종류에 “문장”이 들어올 때 고름 → 4.3 글꼴, ADR-0034
  • 시각 디자인 명세를 현행화하며 Claude가 정한 것 (2026-10-18) → 04-visual-design, 2026-10-18-02-pages-visual-design. 메인테이너는 써 보았을 때의 느낌만 보면 됨
    • 머리 모양 “제목처럼”(H1): 딱지는 보조 12px text.muted(시안 M24는 10.5px였으나 그림 안의 가장 작은 글자 12px 규칙을 따름), 이름은 본문 13px 굵게, 아랫줄은 구조선과 같은 1px line.structure(M24는 더 옅은 화면 구분선 색), 바탕 없음, 머리 높이 40px(딱지 줄 16 + 이름 줄 18 + 6), 글자는 다이어그램 왼쪽 선에 맞춤, 고르면 머리 전체를 두름
    • 두 키 조합의 안내 상자(K1): 캔버스 아래 상태 줄 바로 위, 캔버스 폭만큼, 바탕 ui.panel · 테두리 1px ui.line · 모서리 6px · 여백 10px, 키는 고정폭 굵게 ui.accent, 0.4초 뒤 한 번에 나타남(서서히 나타나지 않음)
    • 빈 갈래의 ∅는 본문 크기의 도형, text.muted. 구문 강조의 네 갈래(ADR-0032)를 색 셋에 맞춤: 글자열과 숫자는 같은 syntax.literal
  • 접기 영역 색을 S3, 이어서 S1로 정하며 Claude가 정한 것 (2026-10-17) → 원칙 3. 문서의 표시와 편집의 표시는 다른 층이다
    • 주황은 시안의 #e8590c가 반복 · 호출 블록 바탕 위에서 3:1에 못 미쳐(2.85:1) 같은 색상에서 조금 진한 #d0500b(orange.600)로 함
    • 고른 표시만이 아니라 편집 층의 표시 넷(고른 것, 마우스 올림, 글자를 고치는 칸, 끌어 놓을 자리)을 모두 주황으로 바꿈. 화면의 포커스(ui.accent)는 파랑 그대로
    • 접기 영역 이름 띠의 글자는 blue.600(#2c55c9, 예전에 고른 표시가 쓰던 값), 띠 바탕은 52번째 판의 #e6ecfb를 새 원시 토큰 fill.ice로
    • 접기 영역의 파랑과 고른 표시의 주황은 밝기가 같아(L* 51) 흑백으로는 갈리지 않음. 색상(반대색)과 모양(띠, 굵기 3px · 2px)으로 가른다고 명세에 적음
    • 펴 보인 호출 블록 안의 들임(size.peek-inset)은 접기 영역의 굵기와 떼어 4px 그대로 둠(점선과 그 안의 테두리 사이 1px을 지키려고)
    • 시각 디자인 명세의 화면 그림(docs/02-ux-design/assets/)은 2026-10-18에 60번째 판으로 다시 찍음
  • 시각 디자인 명세를 Claude가 정함 (2026-10-16 · 17) → 04-visual-design. 메인테이너: “UX/UI 전문가들이 이해하고 납득할 만한 문서를 알아서 만들어 주세요.” 전문 판단은 Claude와 독립 검토 에이전트가 했으므로, 메인테이너는 써 보았을 때의 느낌만 보면 됨
    • 갈래 이름 “참” · “거짓”이 파랑에서 회색으로, 펴 보기의 점선이 1.5px에서 1px로 바뀜. 어색하지 않은지
    • 고른 블록에 옅은 파란 바탕이 없어지고 테두리만 남음. 무엇을 골랐는지 잘 보이는지
    • 프로토타입에 없는 상태(마우스 올림, 끌어 놓기, 받아들일 수 없는 입력)의 모습은 명세만 씀
    • 그림은 docs/02-ux-design/assets/에 둠(docs/에 그림 폴더가 처음 생김). 52번째 판으로 찍었던 그림은 journal/assets/2026-10-16-p52-*.png
  • 접기 영역의 테두리와 펴 보인 곳의 접기 영역에서 Claude가 정한 모습 (2026-10-13, M11)
    • 맨 아래 블록도 양옆처럼 테두리에 붙임. 이어진 테두리 사이의 틈도 1px. “점선”을 둘레 전체에 두르는 점선으로 읽음. 띠의 색 값 #ddd4ef, 점선의 무늬(6px 긋고 4px 띄움)
    • “호출 확장도 1픽셀 내부로”를 “점선을 블록의 바깥 선에서 1px 안으로 들인다(바깥의 가는 선은 그대로 둔다)“로 읽음. 어디에 펴든 그렇게 그림
  • 프로토타입 37번째 판에서 정한 모습 (2026-10-11): 펴 보인 글자는 회색 한 가지이고 구문 강조가 없다

아키텍처 · 기술

  • 아키텍처 제안 A1~A5를 확인받아 옮기며 Claude가 정한 것 (2026-10-17) → 시안 M20, 01-architecture
    • A5(메인테이너: “지금은 1번 … 나중에 2번으로 바꾸더라도 비용이 많이 발생하지 않는 아키텍처”)를 이루는 구조: 렌더러를 “장면 만들기”와 “그리기”로 나누고, editor는 “장면을 화면에 그린다” 인터페이스 하나로만 그리며, 화면의 SVG를 뒤지지 않고 레이아웃 결과로 블록을 찾는다 → ADR-0030
    • A4 · A5를 새 ADR 0029 · 0030으로, A1 · A2 · A3은 새 ADR 없이 본문과 승인 ADR 0026 · 0022 · 0017의 “이후 변경”으로 옮김. 0029 · 0030은 “승인”으로 적음. ADR 목록에 새 묶음 “편집 엔진과 화면”
    • A3: 줄에 붙은 범위의 블록을 줄 밖으로 옮길 때의 규칙 → 2026-10-18에 01-model의 규칙 F로 적음(아래 “모델 상세 설계 초안”)
    • 승인된 ADR들이 가리키는 절 이름(“3. 구성 요소”, “7. 위험과 검증이 필요한 사항”)은 링크가 끊기지 않게 그대로 둠. 문서 모델은 3.1과 3.2로 넣음
    • 아키텍처 문서의 그림(Mermaid) 넷은 Obsidian 화면으로 열어 보지 않음
  • 결정을 한곳에 모으며 Claude가 정한 것 (2026-10-18) → DR-0012
    • UX 결정 모음의 항목은 ADR · DR과 달리 고칠 수 있게 둠(다시 정하면 “다시 정함 (날짜)“을 덧붙임. 05에서 하던 대로)
    • 2026-10-18에 정한 inbox 1 · 2에 물음 번호 Q24 · Q25를 붙임. M23 · M24의 ID(MD · E · H · K)는 그대로 씀
    • 세션 기록과 journal/의 옛 링크도 새 파일 이름으로 바꿈(DR-0001과 같은 방식)
  • 2026-10-18 inbox의 1 · 2를 옮기며 Claude가 정한 것 → inbox 원문
    • If 갈래 이름 고치기의 우선순위를 P1로 붙임(요구사항 R-EDIT-12). 고치는 키는 Case 갈래 이름과 같은 Shift+L · 더블클릭
    • 이름을 비우면 “참” · “거짓”으로 돌아가고, 고치지 않은 이름은 저장할 때의 화면 언어를 따름. default 갈래의 이름은 고칠 수 없게 둠(늘 “default”)
    • M24(E1 · H1 · K1)를 옮기며: 새 요구사항 셋(R-LAY-09, R-LAY-10, R-EDIT-04)의 우선순위를 모두 P1로 붙임. ∅는 If · Case 갈래에만 넣고 반복의 빈 본문에는 넣지 않음. 머리 모양은 문서 설정이라 바꾸면 실행 취소의 대상. 키 안내를 끄는 사용자 설정을 둠
  • 모델 상세 설계 초안에서 Claude가 정한 것 (2026-10-18) → 01-model
    • 문서를 content(실행 취소 대상)와 view(보기 상태)로 처음부터 나눔. 보기 상태가 없는 id를 가리켜도 잘못이 아니게 함(실행 취소 뒤에 남을 수 있어서)
    • 조건 · 반복의 글자를 모두 text 한 필드에 둠. 빈 블록은 글자 없는 처리 블록. 갈래에도 id를 붙임(갈래별로 접히므로)
    • 호출 블록이 부르는 것을 네 종류로 나눔: 같은 문서(local), 이름을 적음(named), 다른 문서(external), 이어진 곳을 잃음(lost). Method를 지우거나 머리를 떼는 명령이 부르던 호출 블록을 lost로 바꿈
    • 펴 보인 곳의 접기 영역은 가장 바깥 호출 블록에 딸리고, 겹쳐 편 안쪽이면 들어간 길(via)을 적음
    • id는 종류마다 앞 글자 + 문서에서 가장 큰 수 + 1. 난수와 시각을 쓰지 않음. 복사되어 들어오면 새 id
    • 머리 이름이 겹치지 않는 것은 불변 조건이 아니라 명령의 검사로 둠(이름이 겹친 파일도 열어야 해서). 불변 조건을 어긴 파일은 고쳐서 열지 않음
    • 접기 영역의 블록이 줄 밖으로 나가면 범위가 줄고, 다 나가면 사라짐(규칙 F). 펴 보인 곳의 접기 영역과 같은 규칙. 2026-10-17의 A3에서 미뤄 둔 것
    • 명령은 실패하면 문서를 바꾸지 않고 까닭을 돌려줌. 명령 뒤의 불변 조건 위반은 버그로 보고 새 문서를 버림
  • 시안 M22의 U1(명령의 목록)을 옮기며 Claude가 정한 것 (2026-10-18) → ADR-0033
    • 설정도 같은 방법으로 “설정의 목록”을 내놓는다(메인테이너가 고른 그림에는 “IDE 설정”이 있었으나 따로 묻지는 않음)
    • Obsidian에서도 우리 도구 모음은 그대로 둔다. 다이어그램 영역 안의 키 입력은 어느 대상이든 편집기가 받고, 그 프로그램의 단축키와 겹치는 키는 셸을 설계할 때 정한다
  • 아키텍처를 SW 엔지니어의 용어로 고치며 Claude가 인터페이스의 이름을 붙임 (2026-10-22): DocumentStore, SettingsStore, CommandRegistry, SettingsSchema. 뜻은 ADR-0031 · ADR-0033 그대로이고 이름만 새로 붙임. 2026-10-25까지는 아키텍처 문서 8장에 있었으나 docs/에는 확인 요청을 두지 않으므로 여기로 옮김
  • 아키텍처 제안 A6 · A7을 확인받아 옮기며 Claude가 정한 것 (2026-10-18) → 시안 M20
    • A6 · A7을 새 ADR 0031 · 0032로 적고 “승인”으로 둠. 승인 ADR-0002에 “이후 변경” 한 줄
    • A6: 다른 문서를 읽지 못하면 “없음”을 돌려준다. 뒤에 붙는 셸(Confluence, IDE)의 구현은 그 셸을 설계할 때 정한다 → ADR-0031
    • A7: 낱말 가르는 함수를 core에 둔다(저장되는 그림에도 같은 색이 들어가므로). 낱말 갈래마다의 색은 테마의 색 토큰으로 정한다 → ADR-0032
  • 2026-10-13에 정한 것을 문서에 옮기며 Claude가 정한 것
    • 글꼴 번들에 더해 “폭은 브라우저에 묻지 않고 글꼴 파일로 셈한다”, “커닝을 끈다”, “정수 px로 올린다”는 Claude의 제안 → ADR-0026
    • 스파이크의 글꼴은 이 컴퓨터에 깔려 있던 Pretendard Regular(OFL 1.1)를 임시로 씀. 견본 글자만 추린 조각을 페이지에 넣었음
    • 글꼴을 추려 넣는 방법은 Node에서만 확인함(harfbuzz의 wasm, 10ms쯤, 늘 같은 바이트). 브라우저와 Obsidian 안에서는 돌려 보지 않음. 편집기에 652 KB가 더 실림. 한글을 많이 쓴 문서는 그림 하나에 글꼴 조각이 200 KB를 넘을 수 있음 → ADR-0026의 이후 변경
    • 스파이크를 하려고 이 컴퓨터의 Python에 fonttools와 brotli를 설치함
  • 다국어: 아키텍처 문서에 “언어를 더할 수 있게 둔다”를 Claude가 덧붙임(메인테이너의 말은 “기본은 영어 그리고 한국어를 지원”). 50번째 판에서 Claude가 임시로 쓴 영어 낱말은 backlog에 있음 (2026-10-13)

문서 · 저장소 · 일하는 방식

  • CONTRIBUTING.md 첫 판을 Claude가 씀 (2026-10-25): 지금은 설계 단계라 읽기 · 이슈 · 작은 문서 고침만 받고 코드 Pull Request는 받지 않는다고 적음, 한국어와 영어 이슈 모두 환영, 영어 요약을 붙임, 문서 규칙은 CLAUDE.md를 가리킴 → CONTRIBUTING.md

  • 설계 문서를 GitHub Pages로 펴내며 Claude가 정한 것 (2026-10-18) → DR-0013

    • Quartz v4.5.2로 고정. 사이트 짜임은 / 첫 화면(README로 빌드), /docs/…, /atelier/…, 나중에 /app/ · /manual/. Quartz가 사이트 맨 위를 차지함
    • 본문 태그(#P0 등)는 처음에 링크로 만들지 않았으나, 2026-10-25에 메인테이너의 물음으로 Quartz의 버그를 고치고 링크로 바꿈(→ DR-0013 이후 변경). 속성의 tags도 태그 페이지가 됨
    • journal/로 가는 링크는 GitHub 파일 주소로 바꿈(tech-notes/도 그랬으나 2026-10-25부터 til/로 펴냄 → DR-0013 이후 변경). 템플릿(ADR-0000, DR-0000)도 펴냄. 글꼴은 Noto Sans KR, 방문 통계 없음
    • 첫 화면: README의 “이 저장소를 읽는 법”의 TIP(받아서 Obsidian으로 열기)를 site:skip으로 감싸 사이트에서 뺌. 첫 화면의 글자 제목은 감추고 문자 로고가 대신함. 로고 사이 여백 · 문자 로고 아래 40px는 메인테이너가 보며 정함. 탭의 아이콘(favicon)은 2026-10-25에 로고의 작은 판으로 바꿈(메인테이너 요청)
    • 출처 문구가 깨진 링크가 되어 코드 모양으로 감쌀 때 승인된 DR-0011의 본문도 고침(글자는 그대로, 모양만). 규칙에 어긋난다고 보시면 되돌림
  • 결정 기록을 나누며 Claude가 정한 것 (2026-10-17) → DR-0001

    • 승인된 기록의 본문에서도 옮긴 것을 가리키는 번호와 링크는 새 것으로 바꿈(예: 남은 ADR의 “ADR-0011” → “DR-0002”). 문장은 그대로
    • 세션 기록 · journal/ · 시안 페이지(HTML)에 글자로 적힌 옛 번호는 그때의 기록이라 그대로 둠. 링크는 새 파일로 이어짐
    • 태그는 adr 대신 dr. DR-0001의 묶음 이름 “기록하는 법”
  • 2026-10-15 inbox를 하며 Claude가 정한 것 → 2026-10-15-01-inbox-repo-name

    • 출처 표기 주소를 새 주소로 바꾼 곳: README, 시안 페이지 12개(claude.ai에도 다시 올림), 안내를 넣는 스크립트. 승인된 DR-0010의 본문, 대체된 DR-0008, 세션 기록과 부채 목록에 적힌 옛 주소는 그대로 둠
    • Claude Code 메모리 폴더를 새 폴더 이름(C--myProject-AriadneNSD)으로 복사함. 옛 폴더는 지우지 않음
  • inbox 여섯 항목을 하며 Claude가 정한 것 (2026-10-14) → 2026-10-14-01-inbox-ide-plugin

    • ADR 여섯 묶음의 이름. 0026(글꼴 번들)은 “파일 형식과 저장”에, 0003(TypeScript)은 “배포 대상과 기술”에 둠
    • README의 “시안과 프로토타입”에는 프로토타입 링크 하나와 sketchbook 링크만 남김. GitHub에서 sketchbook를 열면 표의 주소는 눌리지만 위키링크는 글자 그대로 보임
  • inbox의 둘째 · 셋째 항목을 하며 Claude가 정한 것 (2026-10-14)

    • 새 문서의 이름 sketchbook와 제목 “시안과 스파이크”. 바로 가기에는 프로토타입과 답을 기다리는 페이지 셋만 남김
    • “견준 안과 그림은 시안 페이지에, md에는 정한 것과 까닭만”을 CLAUDE.md의 규칙으로 적음
  • atelier/의 문서를 다시 나누며 Claude가 정한 것 (2026-10-12)

    • 새 문서의 이름 backlog · prototype과 제목(“할 일 목록”, “프로토타입”)은 Claude가 붙임
    • 겹치던 항목은 한쪽 문장을 남기고, 다른 쪽에만 있던 말은 그 아래에 “(부채 목록에 적은 말)” · “(현재 상태에 적은 말)“로 닮. 한쪽이 다른 쪽에 모두 들어 있어 지운 것: 부채 목록의 “ADR-0018의 후속으로 남은 것”(할 일 목록의 파일 형식 줄에 있음), 현재 상태의 “ADR-0021의 후속”과 UX 물음 · 재귀의 풀이 · MVP 범위 줄(부채 목록에 있음)
    • 현재 상태의 “열린 질문” 가운데 docs/의 미결정 절에 이미 있는 여덟 줄은 옮기지 않고 링크만 둠. 원본이 없던 둘은 옮김: Drive를 언제 만들지는 “정해 주세요”로, 비공개 문제 알리기 채널은 backlog로
    • 답이 필요 없는 보고 가운데 로고 네 건은 남은 확인으로, 상표 한 건은 names-and-registries로 옮김. 시안 페이지를 어디까지 찍어 보았는지는 prototype으로
    • 현재 상태의 경과 문단과 끝난 항목, 부채 목록의 “처리함”을 지움(메인테이너: “끝난 항목은 지워도 됩니다”). 세션 기록과 git에 있음
    • 옮긴 문서들을 Obsidian 화면으로 열어 보지 않음. 링크는 검색으로만 확인함
  • 요구사항과 설계를 나누며 Claude가 정한 것 (2026-10-12)

    • “분석 또는 설계” 가운데 설계로 봄. 분석 문서를 따로 만들지 않고 UX 설계 폴더에 02-interaction-rules(모습과 조작 규칙)를 새로 둠. 파일 이름과 제목은 Claude가 붙임
    • 나누는 금: 요구사항에는 체크박스 한 줄(블록 ID가 붙은 문장)과 표를 남기고, 그 아래 달려 있던 세부 규칙과 “여러 블록 선택 규칙” · “감싸기 · 풀기” · “접기 · 펼치기”의 본문을 옮김. 세 제목은 링크가 끊기지 않게 요구사항에 한두 문장으로 남김
    • 문장은 고치지 않고 그대로 옮김(같은 문서를 가리키던 링크만 고침). 그래서 requirements-rework가 짚은 모순과 빠진 곳, 문장 속의 키는 그대로 있음
    • 옮기지 않은 것: 2장 배포 대상의 세부(후원 링크의 자리, 웹의 파일 열기 · 공유 URL · 광고, Confluence의 Forge 설명), 3.3~3.6, 4장. 모양 설명(“낮은 아치 모양”, “양옆 세로 이중선”, “모자 모양”, 표의 “역삼각형 헤더” 등)은 메인테이너의 말(“모양 설명은 옮겨주세요”)로 블록의 모양에 옮김. 표의 설명 칸에 모양 대신 적은 뜻(“조건에 따라 참 갈래나 거짓 갈래를 실행” 등 세 줄)은 Claude가 씀
    • 요구사항의 세부를 가리키던 승인 ADR들(예: [[01-requirements#접기--펼치기|접기 · 펼치기]])에는 “이후 변경”을 달지 않음. 링크는 요구사항의 짧은 절에 닿고 거기서 설계 문서로 이어짐
    • 여러 다이어그램의 배치와 문제 알리기 보고서의 내용도 UX 설계에 둠(레이아웃 설계 02-layout이나 따로 된 문서가 아니라)
  • 2026-10-12에 문서를 옮기며 Claude가 정한 것

    • atelier/로 바꾸며 그대로 둔 것: 문서 속성의 태그 plan(세션 기록 등 서른 개쯤. atelier로 바꿀지), 세션 기록 · 타임라인 · learning-claude-code · git-history-rewrite에 적힌 옛 경로 plan/…(그때의 기록), 시안 페이지에 적힌 plan/ux-review.md. 폴더 색인의 제목은 2026-10-17에 메인테이너가 “아틀리에 (작업 공간)“으로 정함(2026-10-25부터는 말머리 없이 “작업 공간”)
    • UX 설계의 자리: 처음에는 ADR이 빠진 03번 자리에 두었고, 메인테이너의 말(“docs/03-ux-design을 docs/02-architecture 위로 옮겨주세요”)로 순서를 바꿈. 지금은 요구사항(01) → UX 설계(02-ux-design) → 아키텍처(03-architecture) → 상세 설계(04). 파일 이름이 바뀌어 [[02-architecture]] · [[03-ux-design]] 링크를 모든 문서에서 새 이름으로 고침. 승인 ADR의 본문과 세션 기록 · 타임라인의 링크도 끊기지 않게 고쳤음(링크의 대상만. 문장은 그대로). 세션 기록에 글자로 적힌 02-architecture는 그대로 둠
    • ux-review를 둘로 나눈 것. 요구사항 문서를 고칠 것(짜임새 Q18, 우선순위 Q22, 낱말 Q23, 모순과 빠진 곳)은 설계 결과가 아니라 작업 목록이라 atelier/의 requirements-rework에 남김
    • UX 설계 문서에서는 “메인테이너”라는 말과 답하는 법 안내를 빼고 “정함 (날짜)” · “정하지 않음”으로 적음. 정한 과정의 인용은 세션 기록 2026-10-11-03-ux-review에 있음. 물음과 선택지, 추천의 내용은 바꾸지 않음
    • 세션 기록과 타임라인의 [[ux-review]] 링크는 끊기지 않게 [[ux-decisions|ux-review]]로 고침(보이는 글자는 그대로). 시안 페이지(journal/assets/2026-10-11-ux-rules-study.html과 claude.ai의 페이지)에 적힌 plan/ux-review.md는 그대로 둠
    • ADR 목록을 docs/README.md에서 atelier/README.md로 옮김(2026-10-25에 README로 다시 옮김). 요구사항 · 아키텍처 · ADR 템플릿의 “ADR 목록” 링크를 새 자리로 고침. ADR-0001 본문의 옛 링크(docs/README#…)는 승인 ADR이라 그대로 두고 “이후 변경”에 적음
    • inbox 머리의 “이 문서는” 설명. inbox의 “이 문서”가 어느 문서인지 확인하지 못함

이름 · 로고 · 라이선스

  • 사이트의 파비콘 모양을 Claude가 정함 (2026-10-25): 로고의 작은 판(머리 · 얼굴 · 눈)을 큰 판과 같은 비율(84/382)로 모서리를 둥글린 96px PNG → site/icon.png, logo-and-icon-assets
  • 2026-10-15 inbox를 하며 Claude가 정한 것 → 2026-10-15-01-inbox-repo-name
    • DR-0011을 “승인”으로 적음(이미 바꾸신 일이라). 바꾼 까닭은 적혀 있지 않아 “GitHub의 제목을 제품 이름과 같게”로 읽음
  • inbox 여섯 항목과 둘째 · 셋째 항목을 하며 Claude가 정한 것 (2026-10-14)
    • 지운 문자 로고 시안 SVG 넷은 2026-10-11-wordmark-variants.py를 돌리면 다시 생김
    • logo-source의 “미소” 절을 로고 시안 페이지(M04)의 새 단락으로 옮기고, md에는 다섯 줄을 남김. 문장은 거의 그대로 옮겼고 그림 넷은 같은 폴더의 PNG를 가리킴
    • 메인테이너의 말(“가급적 과정은 시안에만 남겨두는 것”)로 logo-source를 한 번 더 줄임: 문자 로고가 정해진 차례의 표, “파일 하나로 바꾼 일”의 경과, “바탕 그림을 바꾼 일”을 로고 시안 페이지로 옮기고, md의 맨 위에 시안 페이지 링크를 둠. “로고가 나온 과정”은 고른 과정이 아니라 만드는 법이라 남기고 제목을 “로고를 만드는 법”으로 바꿈. “파일 하나로 바꾼 일”은 승인 ADR이 가리키고 있어 제목과 두 문장을 남김. “남은 확인”은 손대지 않음
    • 문자 로고 바탕 시안 페이지(M10, claude.ai)는 고치지 않음. “차례 5가 생긴 까닭”은 로고 시안 페이지에 넣음
  • 시안 공개와 라이선스를 정리하며 Claude가 정한 것 (2026-10-14) → DR-0010
    • 스파이크 페이지(글자 폭 스파이크)도 시안과 같이 글로 봄. 그것을 만들고 재는 스크립트는 코드로 둠
    • 안내의 문구와 자리(페이지 맨 아래), 영어 한 문장을 함께 적은 것. 로고가 든 두 페이지에는 “로고 그림은 여기에 들지 않습니다”를, 글자 폭 스파이크에는 Pretendard의 라이선스를 덧붙임
    • 프로토타입에는 안내를 넣지 않음(화면을 가득 쓰는 편집기라 맨 아래에 붙일 자리가 없음). Apache-2.0이라는 것은 README에만 적혀 있음
    • sketchbook의 페이지를 모두 방문자에게 보이는 목록으로 둠(2026-10-14에 README의 표를 이 문서로 옮김). 메인테이너가 공개로 바꾸지 않은 페이지가 있으면 알려 주세요
    • 2026-10-14 이전에 Apache-2.0으로 올라간 판은 그 조건으로 받아 간 사람에게 그대로 유효하다고 ADR에 적음. 법률 자문이 아님
    • claude.ai의 시안 열두 페이지를 안내가 든 판으로 모두 다시 올림(2026-10-14). 올리기 전에 올라가 있던 판이 저장소의 사본과 같은지 견주었고 모두 같았음. 다시 올린 뒤에도 “링크를 가진 누구나”가 유지되는 것은 게시 결과로 확인함. 페이지 맨 아래에 안내가 실제로 보이는지는 Claude가 열어 볼 수 없어 확인하지 못함
  • 라이선스에서 Claude가 정한 것과 정하지 않은 것 (2026-10-11) → DR-0008. 2026-10-14에 “시안 페이지는 코드로 봄”이 바뀜: 시안과 스파이크 페이지는 CC BY 4.0(메인테이너: “2”) → DR-0010
    • Claude가 정함: 프로토타입 · 시안 페이지 · 스크립트는 코드로 봄. CLAUDE.md와 저장소 맨 위 README는 글로 봄. CC BY 4.0 글의 파일 이름은 LICENSE-docs. 출처 표기 문구 “AriadneNSD (https://github.com/reddiana/ariadne-nsd)“(2026-10-15에 새 주소로 바뀜 → DR-0011). 로고는 “이 프로젝트를 가리키는 데에만 쓸 수 있다”
    • 정하지 않음: 소스 파일 머리의 라이선스 표시, 기여 조건, 로고를 써도 되는 경우를 더 적을지
    • 라이선스 설명은 Claude의 일반적인 풀이이고 법률 자문이 아님. 상표는 등록하지 않았고 등록 여부도 확인하지 않음
  • 시안 페이지의 아이콘 옆 글자는 아직 옛 표기(AriadneNSD를 붙여 쓴 모양)임. 문자 로고의 글꼴과 자간은 메인테이너가 시안을 보고 정함(W4-6b). README에서의 폭(340px)과 NSD의 크기(이름 대문자 높이의 0.92배)는 Claude가 고름 (2026-10-11)

원문: 알아만 두세요

  • 커밋된 요구사항 내용이 작업 사본에서 사라졌던 원인 확인. 되살려 두었음. Obsidian이 예전 내용을 다시 저장한 것으로 추정 (보고: 2026-10-10)
  • 메인테이너의 화면에서 GitHub의 그림 바꾸는 스크립트(themed-picture)가 왜 켜지지 않았는지는 알아내지 못함. 문자 로고를 파일 하나로 바꿔서 지금은 영향이 없음 (보고: 2026-10-11) → theme-aware-images
  • 퀵소트·Raft 예제의 내용은 Claude가 씀. Raft는 교과서 수준으로 줄였고(스냅샷, 구성 변경 없음) 전문가의 검토를 받지 않음 (보고: 2026-10-11)
  • 옛 커밋 0af24f4(사진 9장)가 GitHub에서 지금도 열리는지는 확인하지 못함. 이 컴퓨터에 gh가 없어 로컬의 옛 커밋으로만 확인함 (보고: 2026-10-11)