2026-10-13 아키텍처 앞에서: 정할 것을 정하고, 시안을 공개하다

2026-10-13의 셋째 세션이고 이튿날(10-14)까지 이어졌다 (← 2026-10-13-02-fold-border). 지난 세션을 “결정 필요 사항을 처리합시다”로 닫고 /clear한 뒤, 메인테이너의 첫 물음에서 시작했다.

아키텍처를 정의하기 전에 확정해야할 일 들이 있나요? 부채나 열린 질문 등 내가 결정해야할 사항 중 미리 처리해야할 일이 있나요?

논의 흐름

  1. 아키텍처에 닿는 것만 추리다. 부채 목록은 백 줄이 넘었지만 대부분 조작 규칙의 세부였다. Claude가 아키텍처를 가르는 것 여덟을 추려 물었다(주 사용자, 블록 글자, 글자 폭, 저장된 그림의 색, 그림 글자의 언어, 숨긴 인자, 펴 보인 곳의 접기 영역, 실행 취소의 대상).
  2. “4: 질문을 이해 못 함 / 6: 질문을 이해 못 함 / 8: 질문을 이해 못 함” 여덟 가운데 셋은 글로만 물어서 전해지지 않았다. Claude가 “아키텍처 전 물음 시안”을 만들어 그림으로 다시 물었다(A4 · A6 · A8 · A8-가).
  3. 글자 폭 스파이크. 번들 글꼴(Pretendard)로 재면 Chrome과 Edge에서 브라우저가 잰 값과 글꼴 파일로 셈한 값이 0.015px 안에서 맞았다. 스파이크에서 물음이 하나 더 나왔다: 저장된 그림을 글꼴이 없는 곳에서 열면(F1).
  4. “Obsidian 노트나 GitHub에서는 번들을 해도 소용이 없다면 번들하려는 의미가 없습니다. 번들은 하지 맙시다” Claude의 설명이 번들의 쓰임을 잘못 전한 탓이었다. 번들은 그 문제를 푸는 길의 전제라는 것(브라우저는 기기에 깔린 글꼴의 파일을 읽을 수 없다)을 바로잡았고, 메인테이너가 그림을 보고 **“F1 · 2번 채택”**으로 바꿨다.
  5. “…에 카드가 없습니다” 스파이크 페이지의 그림 카드가 claude.ai에서만 그려지지 않았다. Claude는 저장소의 파일로만 확인했었다. 고치다가 스크립트가 통째로 멈춘 판을 한 번 더 올렸다.
  6. 휴대폰의 지문. 메인테이너가 휴대폰(Chrome / Android)에서 값을 보냈다. 같은 엔진, 같은 글꼴인데 브라우저가 잰 값이 0.08px 달랐다(폭을 맞추는 단위가 화면 배율을 따른다). “폭은 브라우저에 묻지 않고 셈한다”의 근거가 됐고, 메인테이너가 ADR-0026을 승인했다. 지문에 글꼴에 없는 글자(▾)의 줄이 섞여 있던 것은 Claude의 흠이었다.
  7. “1: 추천 수용 / 2: 문서 / 3: 병행 진행”, “Q10 · 2번 채택 / Q21 · 2번 채택” 뒤의 둘은 Claude의 추천(1번)과 다른 답이다.
  8. 아키텍처 문서를 다시 쓰다. 새 모델(문서 = 다이어그램 여러 개, 내용과 보기 상태)과 이날의 결정을 담았다. Claude가 정해 적은 일곱 가지는 확인받지 못했다.
  9. “힘드네요. 확인 및 결정은 다음 번 만났을 때 하겠습니다. 지금은 inbox 체크해주세요.” 여기서 결정을 멈췄다.
  10. inbox의 세 항목. 시안을 방문자에게 공개하는 방법, 로고 문서의 “미소” 절, 길어진 “바로 가기”. 공개 방법은 GitHub Pages와 claude.ai의 공개 링크를 세 번 견준 끝에 ""나”로 합시다”(claude.ai의 공개 링크).
  11. “Obsidian에서는 표 앞에 빈줄이 없으면 표를 렌더링하지 않습니다. 알고 있었나요?” Claude가 다시 쓴 “바로 가기”의 표였다. 메인테이너가 직접 고쳤다.
  12. “내 의도는 가급적 과정은 시안에만 남겨두는 것입니다.” logo-source를 한 번 더 줄이고 규칙을 CLAUDE.md에 적었다.
  13. “방문자에게 공개된 시안들도 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 Pagessketchbook
시안의 라이선스시안과 스파이크 페이지는 CC BY 4.0, 프로토타입과 스크립트는 Apache-2.0dr-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, 25ecdd7ADR-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

마무리