2026-10-13 아키텍처 앞에서: 정할 것을 정하고, 시안을 공개하다
2026-10-13의 셋째 세션이고 이튿날(10-14)까지 이어졌다 (← 2026-10-13-02-fold-border). 지난 세션을 “결정 필요 사항을 처리합시다”로 닫고 /clear한 뒤, 메인테이너의 첫 물음에서 시작했다.
아키텍처를 정의하기 전에 확정해야할 일 들이 있나요? 부채나 열린 질문 등 내가 결정해야할 사항 중 미리 처리해야할 일이 있나요?
논의 흐름
- 아키텍처에 닿는 것만 추리다. 부채 목록은 백 줄이 넘었지만 대부분 조작 규칙의 세부였다. Claude가 아키텍처를 가르는 것 여덟을 추려 물었다(주 사용자, 블록 글자, 글자 폭, 저장된 그림의 색, 그림 글자의 언어, 숨긴 인자, 펴 보인 곳의 접기 영역, 실행 취소의 대상).
- “4: 질문을 이해 못 함 / 6: 질문을 이해 못 함 / 8: 질문을 이해 못 함” 여덟 가운데 셋은 글로만 물어서 전해지지 않았다. Claude가 “아키텍처 전 물음 시안”을 만들어 그림으로 다시 물었다(A4 · A6 · A8 · A8-가).
- 글자 폭 스파이크. 번들 글꼴(Pretendard)로 재면 Chrome과 Edge에서 브라우저가 잰 값과 글꼴 파일로 셈한 값이 0.015px 안에서 맞았다. 스파이크에서 물음이 하나 더 나왔다: 저장된 그림을 글꼴이 없는 곳에서 열면(F1).
- “Obsidian 노트나 GitHub에서는 번들을 해도 소용이 없다면 번들하려는 의미가 없습니다. 번들은 하지 맙시다” Claude의 설명이 번들의 쓰임을 잘못 전한 탓이었다. 번들은 그 문제를 푸는 길의 전제라는 것(브라우저는 기기에 깔린 글꼴의 파일을 읽을 수 없다)을 바로잡았고, 메인테이너가 그림을 보고 **“F1 · 2번 채택”**으로 바꿨다.
- “…에 카드가 없습니다” 스파이크 페이지의 그림 카드가 claude.ai에서만 그려지지 않았다. Claude는 저장소의 파일로만 확인했었다. 고치다가 스크립트가 통째로 멈춘 판을 한 번 더 올렸다.
- 휴대폰의 지문. 메인테이너가 휴대폰(Chrome / Android)에서 값을 보냈다. 같은 엔진, 같은 글꼴인데 브라우저가 잰 값이 0.08px 달랐다(폭을 맞추는 단위가 화면 배율을 따른다). “폭은 브라우저에 묻지 않고 셈한다”의 근거가 됐고, 메인테이너가 ADR-0026을 승인했다. 지문에 글꼴에 없는 글자(
▾)의 줄이 섞여 있던 것은 Claude의 흠이었다. - “1: 추천 수용 / 2: 문서 / 3: 병행 진행”, “Q10 · 2번 채택 / Q21 · 2번 채택” 뒤의 둘은 Claude의 추천(1번)과 다른 답이다.
- 아키텍처 문서를 다시 쓰다. 새 모델(문서 = 다이어그램 여러 개, 내용과 보기 상태)과 이날의 결정을 담았다. Claude가 정해 적은 일곱 가지는 확인받지 못했다.
- “힘드네요. 확인 및 결정은 다음 번 만났을 때 하겠습니다. 지금은 inbox 체크해주세요.” 여기서 결정을 멈췄다.
- inbox의 세 항목. 시안을 방문자에게 공개하는 방법, 로고 문서의 “미소” 절, 길어진 “바로 가기”. 공개 방법은 GitHub Pages와 claude.ai의 공개 링크를 세 번 견준 끝에 ""나”로 합시다”(claude.ai의 공개 링크).
- “Obsidian에서는 표 앞에 빈줄이 없으면 표를 렌더링하지 않습니다. 알고 있었나요?” Claude가 다시 쓴 “바로 가기”의 표였다. 메인테이너가 직접 고쳤다.
- “내 의도는 가급적 과정은 시안에만 남겨두는 것입니다.”
logo-source를 한 번 더 줄이고 규칙을 CLAUDE.md에 적었다. - “방문자에게 공개된 시안들도 CC BY 4.0가 적용된다는 점을 알려줄 수 있나요?” 그때의 분류로는 시안 페이지가 코드(Apache-2.0)였다. Claude가 정해 놓고 확인받지 못한 분류였다. 메인테이너가 “2”를 골라 시안을 글로 옮겼고(ADR-0027), 열두 페이지에 안내를 넣어 다시 올렸다. 아홉 페이지는 보조 에이전트가 올렸다.
결정
| 무엇 | 결정 | 어디에 |
|---|---|---|
| 주 사용자 | 실무에서 설계 문서를 쓰는 사람 | 01-requirements |
| 블록 글자 | 종류를 문서마다 하나 고른다: 문장 / C / Java / Python / Bash 등 | R-LAY-06 |
| 글자 폭 | 글꼴을 번들하고, 폭은 글꼴 파일로 셈한다. 커닝을 끄고 정수 px로 올린다 | 0026-bundled-font-metrics |
| 저장되는 그림의 글꼴 (F1) | 쓰인 글자만 추려 그림에 넣는다 | 0026-bundled-font-metrics, R-FMT-07 |
| 저장된 그림의 색 (A4) | 늘 문서의 색. 편집 화면과 보는 곳의 밝기를 따르지 않는다 | R-FMT-08 |
| 그림 글자의 언어 | 저장할 때의 언어를 따른다 | R-NFR-04 |
| 숨긴 인자 (A6) | 기억하지 않는다. 2026-10-11의 “이 기기에만 기억”을 바꿈 | 02-interaction-rules |
| 실행 취소 (A8, Q9) | 내용만 되돌린다. 접기만 해도 “저장 안 됨”은 뜬다 | ux-decisions |
| 고를 수 있는 것 (Q10) | 갈래의 이름도 고를 수 있다. 세부는 정하지 않음 | ux-decisions |
| Method가 없어질 때 (Q21) | 지금대로. Event로 바꾸기만 막는다 | ux-decisions |
| 진행 방식 | 아키텍처 설계를 프로토타입 리뷰와 나란히 | status |
| 시안 공개 | claude.ai의 공개 링크로. 견준 길은 GitHub Pages | sketchbook |
| 시안의 라이선스 | 시안과 스파이크 페이지는 CC BY 4.0, 프로토타입과 스크립트는 Apache-2.0 | dr-0010-study-pages-cc-by |
| 과정을 두는 곳 | 고른 과정은 가급적 시안 페이지에만. md에는 지금의 결과와 시안 링크 | CLAUDE.md |
| 표 앞의 빈 줄 | md의 표 앞에는 빈 줄을 둔다 | CLAUDE.md |
발견한 것과 위험
- 글로만 물은 것은 전해지지 않았다. 여덟 물음 가운데 셋이 “질문을 이해 못 함”이었다. “물음은 모두 시안에서 보이게”는 2026-10-11에 이미 배운 것인데 Claude가 지키지 않았다.
- Claude의 설명이 틀리면 메인테이너의 결정이 틀어진다. “번들해도 다른 곳에서는 다르게 보인다”만 말하고 “번들이 그것을 푸는 전제”라는 것을 말하지 않아, 메인테이너가 번들을 버리려 했다. 결정에 까닭이 붙어 있어서 바로잡을 수 있었다.
- Claude는 게시된 페이지와 Obsidian의 화면을 볼 수 없다. 그림 카드가 빠진 것, 표가 그려지지 않은 것 모두 메인테이너가 알려 주었다. 게시된 것과 같은 틀로 감싼 사본을 열어 보는 방법, 표 앞의 빈 줄을 스크립트로 훑는 방법으로 조금 메웠다.
- 번들해도 브라우저가 잰 폭은 기기마다 다르다. 휴대폰의 값이 아니었으면 “번들하고 브라우저로 잰다”로 갈 뻔했다. 셈한 폭만이 어디서나 같다.
- 글꼴 조각이 그림을 키운다. 서로 다른 한글이 수백 자면 그림 하나에 200 KB를 넘는다. 편집기에는 글꼴과 글꼴 추리기(wasm 652 KB)가 실린다. Obsidian 플러그인은 파일 하나로 배포해서 2 MB쯤 된다 → 8. 위험과 검증이 필요한 사항
- Claude가 정해 놓은 것이 메인테이너의 생각과 달랐다. 시안 페이지의 라이선스(코드로 봄)가 그랬다. “확인해 주세요”에 쌓여 있는 것 가운데 이런 것이 더 있을 수 있다.
- 공개한 페이지는 고치는 도중의 판도 방문자에게 보인다. 이날처럼 깨진 판을 잠깐 올리면 그대로 보인다 → sketchbook
- 긴 세션. 메인테이너가 “힘드네요”라고 했다. 결정을 여덟 넘게 받은 뒤였다.
커밋
| 커밋 | 무엇 |
|---|---|
3a5739e ~ 2a07b00, 25eb1d4 | 글자 폭 스파이크 (페이지, 만드는 스크립트, 재는 스크립트, 기준값, 고친 판들) |
c13b63a | 아키텍처 전 물음 시안 |
693b630, 08a55f3, 123bc40, 2f8bc80 | 정한 것을 요구사항 · UX 설계 · ADR에 |
65e46b8, aeb88f9, 5b43afc | 휴대폰의 값, ADR-0026 승인, 글꼴 추리기 스파이크 |
5f47766 | 아키텍처 개요를 다시 씀 (초안) |
2d5b1b7, 405bead, a6839c6 | 시안 목록을 나눔, 로고 문서의 과정을 시안으로, 규칙 |
ebbd5ce ~ 94c032d | 시안 공개는 claude.ai의 공개 링크로 |
b50f2ff | 표 앞에는 빈 줄 |
424b882, 25ecdd7 | ADR-0027, 라이선스 안내, README의 시안 목록 |
처리한 부채 (부채 목록과 할 일 목록에서 옮김)
- 시안을 GitHub 방문자에게 공개하는 방법 (inbox, 2026-10-14) → 정함: ""나”로 합시다” (claude.ai의 공개 링크). GitHub Pages와 한 번 더 견준 뒤 같은 답 → sketchbook
- 메인테이너가 시안 페이지를 공개로 바꾸기 → 함 (2026-10-14: “시안들은 이미 공개로 바꿨습니다”). README에 링크를 닮
- A4 · A6 · A8 · A8-가 → 정함 (2026-10-13: “1: 추천 수용”). A4 늘 문서의 색(R-FMT-08), A6 기억하지 않음(호출 블록), A8 내용만 되돌림(ux-decisions Q9), A8-가 뜬다
- F1 번들한 글꼴을 저장되는 그림에도 넣는가 → 정함 (2026-10-13): “F1 · 2번 채택”(쓰인 글자만 추려 넣음). 그 앞에 “번들은 하지 맙시다”라고 하셨다가 그림을 보고 바꿈 → ADR-0026
- 글자 폭 스파이크를 휴대폰에서 열기 → 함 (2026-10-13, Chrome 154 / Android). 번들 글꼴인데도 브라우저가 잰 값은 셈한 값과 0.083px까지 달랐고, 올림한 값은 같았음 → ADR-0026
- ADR-0026 승인 → 승인함 (2026-10-13: “승인”)
- 블록 글자의 종류를 고르는 단위 → 정함 (2026-10-13): “문서” → R-LAY-06
- 아키텍처를 프로토타입 리뷰와 나란히 진행 → 정함 (2026-10-13): “병행 진행” → 큰 순서
- 나란히 가려고 앞당겨 답할 것 둘 → 정함 (2026-10-13): “Q10 · 2번 채택 / Q21 · 2번 채택”. 둘 다 Claude의 추천(1번)과 다름 → ux-decisions
- 블록 글자가 코드인지 일반 문장인지 (질문: 2026-10-09) → 정함 (2026-10-13): “코드 종류 선택할 수 있게함. 문장/C/Java/Python/Bash 등” → R-LAY-06
- 확인 2: 이 자리의 접기 영역은 그 호출 블록에 딸려 파일에 저장됨. 같은 Method를 부르는 다른 호출 블록에서는 보이지 않음. 호출 블록을 지우면 함께 사라짐 → 확인함 (2026-10-13: “7: ok”)
- 숨긴 인자를 사용자 환경에 기억하는 일에서 Claude가 정한 것과 정하지 않은 것 (2026-10-11) → 물을 것이 없어짐 (2026-10-13: 기억하지 않기로 함)
- Claude가 정함: 기억해 둔 것이 없으면(다른 기기, 환경을 비운 뒤) 머리의 괄호 안 글자를 채움
- 정하지 않음: 어디에 기억하는지(웹은 브라우저 저장소, Obsidian은 플러그인 데이터, 데스크톱은 앱 데이터일 것), 얼마나 오래 기억하는지, 문서와 호출 블록을 무엇으로 알아보는지(파일 경로, 블록 id). 설계 문서에서 다룰 일
- 파일 밖에 편집기 상태를 두는 자리는 ADR-0018에서 접힘 상태를 파일 안으로 옮기며 없어졌는데, 이 결정으로 다시 생김. 아키텍처에 반영해야 함
- 프로토타입에는 넣지 않음(지금은 인자를 남겨 그대로 보여 줌)
- 01-architecture: 파일 밖에 두는 편집기 상태(머리에서 괄호를 지워 숨긴 인자) → 필요 없어짐 (2026-10-13: 인자를 기억하지 않기로 함)
inbox 원문 (지운 항목)
“1. 일하는 방식”에 있었다.
- 시안들을 github 방문자와 공유하고 싶습니다. 이 프로젝트에서 만든 시안들을 anonymous 사용자들에게 public으로 공개할 방법이 있나요?
- 미소 (2026-10-12) 등은 로고 시안에 들어갈 내용 같아요. 이게 md에 들어간다면 시안의 다른 내용도 md에 들어갈게 많잖아요.
- 바로 가기 내용이 길어졌네요. 문서를 분리하는게 좋을까요?
처리: 첫째는 claude.ai의 공개 링크로 정했고 메인테이너가 공개로 바꿨다. 둘째는 “미소” 절과 그 밖의 고른 과정을 로고 시안 페이지로 옮겼다. 셋째는 sketchbook를 새로 만들어 나눴다. inbox에 남은 항목은 없다.
다음 할 일
- 메인테이너가 아키텍처 초안을 읽고 Claude가 정해 적은 일곱 가지를 확인한다 → 8. 확인받지 못한 제안
- UI 프레임워크 결정 → 0010-ui-framework
- 상세 설계 01-model
- 프로토타입 리뷰 3판(고치기 규칙)을 아키텍처와 나란히 → 리뷰 순서
- 번들할 글꼴 고르기, Firefox에서 스파이크 열어 보기 → outbox
마무리
- 메인테이너의 말: “마무리”.
- 기술 설명은 text-width-and-bundled-fonts에 정리했다.