2026-11-01 확인 여섯, 용어 정리, 기술 스택 · 코딩 가이드, MVP 코딩

새 세션(/clear 뒤). 메인테이너: “세션이 새로 시작됐나요?” → 세션 시작 요약. inbox는 비어 있었다.

확인해 주세요 여섯을 닫음

메인테이너: “확인할 것들 먼저 하겠습니다.” outbox의 “확인해 주세요”를 하나씩 물어 모두 “그대로”로 닫았다.

  • 파일에 남는 이름(ans:document, 필드 이름, kind 값, 생략 규칙) → 그대로. 파일 형식 3장의 절 순서를 3.1 · 3.2 · 3.3으로 바로잡음
  • 편집기 · 웹 설계 초안의 여섯 묶음 → 그대로. 메인테이너: “궁금한게 이런 결정들이 문서에 반영되고 있나요?” → 문서에 먼저 쓰고 확인만 기다리는 것이라고 답함
  • 프로토타입 64번째 판의 세부, M43의 세부 여섯(메인테이너: “M43은 모두 결정하지 않았나요? 헷갈리네요.” → 정한 답 위에 Claude가 덧붙인 세부라고 표로 설명), 62번째 판의 세부(1은 미결정에 둠, 5는 지나감), 레이아웃 1장 · 테스트 전략의 세부 일곱
  • 문제 알리기 절의 첫 문장 → 요구사항 R-REP-04로 올림. 메인테이너: “2로 하되, ‘다시 일으켜 볼 수’ → ‘재현할 수’로 고쳐주세요.”
  • 프로토타입 질문 6(선택한 채 바로 치면 편집?) → “아니요로 닫기”(Vim 키 → DR-0009)

outbox에서 옮긴 항목의 원문:

  • (2026-11-01 세션 01, 메인테이너: “그대로”) 편집기 · 웹 설계 초안에서 Claude가 정한 것 (2026-11-01 → 03-editor, 06-web)
    • 화면: 층 넷(문서 · 편집 표시 · 글자 칸 · 떠 있는 것), 확대 40% ~ 300%(10% 단위, 어디에도 저장하지 않음), 화면 이동은 브라우저 스크롤
    • 드래그 앤 드롭: 4px 넘게 움직여야 끌기, 블록 위아래 8px 띠가 “사이”(24px보다 낮은 블록은 반씩), 가장자리 32px에서 저절로 스크롤, 놓기 전 Esc는 그만두기
    • 클립보드: 글자(들여쓴 줄)와 모델 JSON을 함께 씀. 다른 프로그램의 글을 붙이면 줄마다 처리 블록
    • 메뉴 구성(파일 · 편집 · 다이어그램 · 보기 · 도움말의 항목, 5.1 메뉴 구성), 메뉴에는 표준 키를 적고 Vim 키는 커맨드 팔레트와 단축키 한눈에서
    • 셸과의 경계(6. 셸과의 연결): editor는 문서 하나만 알고, 새로 · 열기 · 최근 파일 명령과 자동 저장 · 임시 보관의 타이머는 셸이 맡음. 임시 보관은 가벼운 모델 JSON(스냅숏)으로, 저장은 서브셋 글꼴을 넣은 SVG로. 읽기 전용이면 문서를 바꾸는 명령만 막고 선택 · 복사 · 줌 · 접기는 됨(뷰 상태가 바뀌어도 ●를 켜지 않음). 화면 밝기 · UI 글꼴은 설정이 아니라 호스트에서 받음. 저장 안 된 문서를 다른 문서로 바꿀 때 웹은 묻지 않음(임시 보관이 있어서) 대신 원래 파일에 들어가지 않았음을 알림
    • 웹: 파일을 페이지에 끌어다 놓아 열기, Firefox · Safari에서는 “저장”을 “내려받기”로 부르고 처음 한 번 알림, 최근 파일 열 개(Firefox · Safari는 “브라우저 사본”), 같은 파일을 두 탭에서 열면 나중 탭은 보기만, 원래 파일에 저장되면 임시 보관을 지움, 쓰기 권한이 끊기면 자동 저장을 멈춤
  • (2026-11-01 세션 01, 메인테이너: “그대로”) 프로토타입 64번째 판에서 Claude가 정한 세부 (2026-10-31 → 9. 2026-10-31의 결정): 파일을 열면 파일의 머리 모양을 따르고 기억한 모양은 바뀌지 않음 · 머리 모양이 적히지 않은 예전 파일은 “모자 · 아치” · “새로”(빈 문서)는 빈 블록을 고른 채로 엶 · 좁은 화면은 폭 860px 이하, 머리 줄의 “메뉴” · “안내” 단추로 폄
  • (2026-11-01 세션 01, 메인테이너: “그대로 확정해 주세요”) 2026-11-01 MVP 조작 물음에서 Claude가 정한 세부 (M43 → 10. 2026-11-01의 결정): 이름 없는 접힌 줄(”⋯ 블록 n개”)의 더블클릭은 펼치기 · 세모(▸ ▾)는 저장되는 그림에 넣지 않음 · 옮기기 키 Alt+방향키(Alt+h j k l) · If의 참 · 거짓을 맞바꿀 때 조건은 그대로 두고 알리기만 · 갈래 이름에서 h l은 옆 갈래 이름, j는 첫 블록 · Shift+L은 갈래 안 블록에서 바로 이름을 고치는 지름길로 남김
  • (2026-11-01 세션 01, 메인테이너: “그대로”. 1의 정식은 미결정에 그대로, 5의 설정 줄은 66번째 판에서 설정 모달로 바뀌어 지나감) 프로토타입 62번째 판에 결정을 넣으며 Claude가 정한 것 (2026-10-31) → 지금 판
    • MD3에서 묻는 모양(고르는 목록)과 바꿀 때 글자를 옮기는 법은 임시: Case → If는 조건 = Case의 글자 · 참 갈래 이름 = 남은 갈래의 이름 · 거짓 갈래 = default, If → Case는 참 갈래가 첫 갈래 · 새 갈래(이름 2)를 사이에 · 거짓 갈래가 default. 정식은 미결정 → 9. 미결정 사항
    • If 갈래 이름에 처음 이름(“참” · “거짓”)을 그대로 적으면 고치지 않은 것으로 봄(모델에 남기지 않음). 긴 이름은 그 갈래를 넓힘(Case와 같은 셈)
    • r로 “새 Method를 만들고 호출”을 하면 이름을 처음 적는 동안 괄호가 없어 인자가 지워질 뻔함. 그 칸에서 괄호 있는 이름을 적으면 인자를 되살림
    • 호출 블록의 칸은 한 줄이라 Enter는 Shift와 함께여도 받아들이기. 칸의 자리는 이름 앞(결과) · 이름 뒤 괄호 안(인자)
    • 키 안내 상자를 끄는 “키 안내”와 “머리 모양” · “결과 기호”를 캔버스 위 설정 줄에 둠
  • (2026-11-01 세션 01, 메인테이너: “그대로”, 절 순서만 3.1 · 3.2 · 3.3으로 바로잡음) 파일에 들어가는 이름 (2026-11-01 → 3.3 노드별 필드): 모델 요소 ans:document, 필드 이름은 모델 1장의 것 그대로(kind 값 process · if · case · while · doWhile · for · call), 줄(Seq)은 따로 객체를 두지 않고 주인의 body · folds에 펼침, 머리가 없으면 head를 적지 않음, v1의 textKind는 "plain", theme은 "default"이고 모르는 값은 기본으로 그리되 그대로 저장. 공개한 뒤에는 바꾸기 어려우니 이름이 어색하면 지금 알려 주세요
  • (2026-11-01 세션 01, 메인테이너: “그대로”) 레이아웃 설계 1장을 쓰며 Claude가 정한 것 (2026-10-25) → 1. 레이아웃 알고리즘
    • 여러 다이어그램의 배치 계산: 두 무리(Event와 머리 없는 것 · Method)가 같은 줄 높이를 쓴다. 줄 높이의 후보(4px씩 올림) 가운데 16 : 10에 가장 가까운 것을 고르고, 같으면 낮은 줄 높이. M38의 그림이 이 셈으로 그린 것이고, 메인테이너는 무리 사이 넓이만 골랐음(DA1). 규칙(5. 여러 다이어그램의 배치)에는 “비율을 보고 고른다”까지만 있었음
    • LayoutResult에 블록의 상자와 따로 누르는 자리(제어 블록은 머리만, 접기 영역 · 펴 보기는 띠만, 갈래 이름 줄)를 담는다. 프로토타입이 하던 대로
    • 빈 글자도 한 줄 높이로 잰다
    • 테스트 전략 초안(02-test-architecture)에서 Claude가 정한 것: 층마다의 시험 표, 골든 파일은 .ns.svg 하나가 입력이자 기대 출력, MVP 인수 시험 열 개(AT-01 ~ AT-10)의 고름, CI의 순서와 “10분 안” 목표, 문서 사이트 빌드와 따로 둠
    • 프로토타입에 숫자로만 있던 값 여덟에 토큰 이름을 붙여 시각 디자인 명세의 치수 표에 옮김(값은 그대로): size.if-head-extra 70 · size.case-head-extra 90 · size.label-room 18 · size.hat-room 24 · size.diagram-min-w 160 · size.band-text-x 10 · size.fold-icon-room 20 · size.fold-extra-h 4 → 5. 기하와 해부도
    • default가 없는 Case의 빈 default 칸(CD1)에서의 동작: 빈 블록처럼 고를 수 있고, 글자를 적거나 블록을 넣으면 그때 default 갈래가 생긴다(실행 취소 한 번). 지우기 · 잘라내기는 아무 일도 하지 않는다. 레이아웃은 그 칸을 “없는 default”로 표시해 넘긴다 → Case 블록
    • 짧은 갈래를 고르게 늘릴 때(SB1)의 세부: 나머지 px은 마지막 블록이 받는다. 제어 블록이 더 받은 높이는 머리가 아니라 안쪽 줄에 가서 다시 나뉜다(If · Case는 갈래마다, 반복은 본문). 글자는 늘어난 블록의 위쪽에 둔다

용어 정리

메인테이너: “대한민국에서 일하고 있는 SW엔지니어로서 어색한 한국어 용어들이 많습니다. 영어를 직역한 것 아닌가 싶은데, SW엔지니어가 사용하는 언어를 사용해주세요.”

  • 첫 묶음(네 물음): 시험 → 테스트, 판 → 버전, 고치기 → 편집, 넣기 → 삽입, 지우기 → 삭제, 옮기기 → 이동, 글자 → 텍스트, 임시 보관 → 로컬 백업, 갈래 → 분기, 머리 → 헤더 등. “펴 보기”는 그대로. 제목 25개를 바꾸고 저장소 전체의 링크를 스크립트로 고친 뒤, 본문은 에이전트 다섯에게 규칙 표와 함께 나눠 맡김(1,500곳 남짓, 코드 블록 주석까지)
  • 둘째 묶음 36개: 메인테이너가 “하나씩 물어봐주세요”, 이어서 “앞으로 변경전, 변경후 비교해서 보여주세요”, “36개 다 연속해서 물어봐주세요”, “내 결정을 다 받은 다음에 작업을 해주세요. 내가 기다리는 시간이 너무 많습니다.” → 결정을 모두 받은 뒤 에이전트 셋이 반영. 손잡이 → 핸들, 누르는 자리 → 클릭 영역, 들임 → 들여쓰기, 맞춤 형식 → 사용자 정의 형식, 껍데기 → 래퍼, 블록 텍스트의 종류 → 언어, 돌리다 → 실행하다 등. 자판의 자리 · 덩어리는 그대로
  • 용어집이 기준. 옛 이름은 용어집에 “예전에는”으로 남김. atelier/의 지난 기록은 그대로

우선순위는 태그가 아니라 글자

메인테이너: “우선순위는 옵시디언 태그(#)로 할 필요가 없을 것 같습니다. 옵시디언 태그는 문서에 속하는 것이거든요.” 2026-10-25의 태그 페이지 요청과 부딪히는 것을 보이고 확인받음 → 표의 121칸을 P0으로, CLAUDE.md 규칙, DR-0013 이후 변경, github-pages-site

기술 스택 · 코딩 가이드

  • 메인테이너: “사용하는 기술이나 라이브러리, 패키지들을 정리해서 문서에 기록해주세요.” → 9. 기술 스택(MVP 칸은 메인테이너가 빼라고 함)
  • 메인테이너: “코딩 인벤션을 정의해주세요. 내가 개발할 때는 코딩가이드 문서같은게 쥐여졌었는데 있는게 좋을까요?”, “도구에 위탁하는 부분이 있다면 그 도구에 대한 정의도 있어야겠네요” → 07-coding-guide, DR-0017(주석은 영어, 커밋은 Conventional Commits에 한국어 본문, 가이드는 docs/07-coding-guide)
  • pnpm을 메인테이너가 직접 설치함(npm install -g pnpm, 12.16.1)

MVP 코딩

메인테이너: “mvp 코딩 해주세요. 드디어!”, “완료되면 마무리 해주세요”, “마무리 끝나면 pc를 종료해주세요.”, “중간 중간 진척률을 알려주세요”, “에상 시간도 함께 알려주세요”

설계 문서를 계약으로, 단계마다 에이전트를 나란히 돌렸다(모든 에이전트가 읽는 안내 한 장 + 단계마다 지시). 처음 예상 3~5시간, 실제 약 2시간 30분.

단계내용걸린 시간
1뼈대: pnpm 모노레포, 도구 설정(코딩 가이드 1장), CI, D2Coding에서 블록 글꼴과 advance 폭 테이블, 모델 타입16분
2core 넷을 나란히: 불변식 · 편집 명령 / 파일 형식 / 텍스트 폭 · 레이아웃 · SVG 렌더 / 서브셋 글꼴(hb-subset + 직접 구현한 WOFF)21분
3editor 엔진 / editor UI(React) / 웹 셸 셋을 나란히44분
4인수 테스트 26개와 버그 여섯 / 골든 파일 완성 · /app/ 배포 · 크기 예산 / 개발 결정을 설계 문서에45분
  • 끝의 숫자: 단위 테스트 369개(core 195, editor 114, web 43, fonts 17), E2E 33개(인수 테스트 AT-01 ~ AT-17), pnpm check 통과. 블록 500개를 그리는 데 2ms가 안 됨, 첫 내려받기 450 KB(gzip)
  • 글꼴 이름: OFL의 Reserved Font Name 때문에 “AriadneNSD Block”으로. 메인테이너: “‘D2Coding’이 아니라 ‘AriadneNSD Block’이 된 이유가 무엇인가요?” → OFL 3항 원문으로 설명, outbox 확인으로
  • 개발 중 메인테이너의 요청:
    • 화면 배치의 텍스트 그림 → “텍스트 그림을 이래서 나는 싫어합니다. 좋은 방법 없을까요?” → Mermaid로 바꾸고 CLAUDE.md에 텍스트 그림 금지 규칙. 이어서 “Mermaid는 화면배치를 더 알아보기 힘드네요” → 실제 MVP 화면에 번호 딱지를 얹은 주석 단 스크린숏으로
    • “src/README.md 의 용어들을 고쳐주세요. ‘뿌리’ 같은거 안 쓰기로 했잖아요.” → 고침(화면 문자열의 “고치기”도)
    • “ADR은 과정입니다. 문서들에 최종 결과가 있어야합니다.” → src/README에 폴더 구성을 결과로 직접 적음
    • “mvp 코딩 끝나면 REAME의 ‘AriadneNSD 프로토타입’을 MVP로 바꿔주세요.” → README 버튼을 MVP(/app/)로
  • 개발하며 정한 것(설계와 다르게 한 곳 포함)은 설계 문서와 ADR 11개의 이후 변경에 반영함. 사용자에게 보이는 것은 확인해 주세요

마무리 중에 더한 것

  • 메인테이너: “@src/README.md 의 코드 를 다시 써주세요. 폴더 얘기하다 코딩가이드 얘기하고 다시 폴더 얘기를 하네요.” → 소개 → 폴더 구성 → 정한 과정 순서로
  • 메인테이너: ""빌드 크기 예산 검사”가 무엇인가요? 용어가 생소합니다.” → 설명하고, 메인테이너가 고른 “번들 사이즈 체크(bundle size budget)“로 문서 · CI를 바꿈. bundle-size-budget
  • 메인테이너: “웹의 화면배치는 ux디자인 쪽에 설명하는게 맞나요? web 설계 문서에 두는게 맞나요?” → UX 설계의 새 문서 05-screen-layout로 옮기고, 7. 웹에서의 화면에는 웹에서만의 것만 남김
  • 메인테이너: “ADR은 과정이고 현재 시점의 최종 결론이 문서에 포함되어야합니다. ADR에만 있는 결정을 찾아보세요.” → ADR 34개 · DR 16개를 대조해 문서에 없던 결론 여섯을 적음(Drive 연동, dist는 CI가 빌드, IntelliJ 셸의 언어, 키 입력은 editor, 글꼴 값이 없는 파일, 데스크톱의 미결정, Obsidian 플러그인 id)
  • 메인테이너: ”### 커맨드 팔레트 에 삽입된 그림이 blank입니다.” → 처음부터 빈 그림(3 KB)이었음. MVP 실제 화면의 팔레트 그림으로 바꾸고 빈 파일을 지움
  • push 전 마지막 E2E에서 AT-11(드래그)이 가끔 실패함: 다시 그려지는 중에 글자 위치를 읽음. 나타날 때까지 기다리게 고쳐 다섯 번 연속 통과, 전체 33개 통과

발견한 위험

  • pages.yml · ci.yml은 GitHub에서 처음 돈다(push 뒤). 실패하면 README의 MVP 버튼이 깨진 주소를 가리킨다
  • Firefox · Safari, 실제 휴대폰, 기준 기기의 성능은 사람이 시험해야 한다(AT-05 · AT-08 · AT-10 · AT-14)
  • 저장 파일의 고정 문구가 화면 언어를 따라, 언어가 다르면 다시 저장한 바이트가 달라진다

다음 할 일