2026-10-17 아틀리에 대문과 결정 기록 나누기
2026-10-17의 두 번째 세션이다 (← 2026-10-17-01-inbox-theme). 메인테이너의 첫 말은 “안녕하세요”였다.
inbox 원문
1. 일하는 방식
- README:
- 아틀리에는 기록 뿐만이 아닙니다. 현재 진행 중인 일들이 다 여기서 일어납니다. 만드는 방입니다. 방문자는 제목에서 즉각적인 정보를 얻을텐데 이 부분을 개선해주세요.
- “아키텍처 결정 기록 (ADR)“을 “세션 기록 목록” 위로 옮겨주세요. repo 방문자의 관점을 고려해보면 ADR에 관심이 더 많을 것입니다.
논의 흐름
- 아틀리에의 제목. Claude가 “아틀리에: 만드는 방”을 추천하고, 첫 문단과
docs/와 견준 표에 “지금 하는 일”을 넣자고 함. 메인테이너: “1: 작업 공간” → 제목을 “아틀리에 (작업 공간)“으로. 첫 문단은 status · backlog · debt · prototype을 가리키며 “지금 하고 있는 일이 모두 여기서 일어난다”로, 표의 “대상” · “내용” 칸도 고침. 같은 뜻으로 저장소 맨 위 README의 폴더 표와 CLAUDE.md의 폴더 표도 “작업 공간”으로 고침 - ADR을 세션 기록 위로. 추천(구성 → ADR → 검토 문서 → 세션 기록)에 메인테이너: “2: 추천 수용”
atelier/README.md의 속성 아래에1한 글자가 커밋되지 않은 채 들어가 있어 지움. 메인테이너: “잘못 눌린 글자”
결정
- 아틀리에의 제목은 “아틀리에 (작업 공간)” → index
- 아틀리에 색인의 순서: 구성 → ADR → 검토 문서 → 세션 기록
- inbox의 다섯째 제목은
5. 질문/요청(메인테이너가 inbox에서 바꿈). CLAUDE.md의 고정 목록과 inbox 머리의 설명도 같게 고침(메인테이너: “ok”)
inbox 원문 (둘째)
1. 일하는 방식
- ADR은 아키텍처 결정을 기록한 것인데, “편집 모델과 조작”, “모습”, “이름 · 로고 · 라이선스”는 아키텍처가 아닌데도 ADR로 작업했습니다. 이게 적절한지 의문스럽습니다. 다른 엔지니어들은 어떻게 하고 있나요?
ADR의 범위
- Claude가 관행을 찾아 답함: ADR 템플릿 MADR은 3.0판(2022)에서 “Any Decision Records”로 이름을 넓혔다가 4.0판(2024)에서 “Architectural”로 되돌렸고, 다른 결정에도 쓸 수 있다는 입장. 추천: 이름은 그대로 두고 범위를 적기
- 메인테이너: “ADR은 아키텍처 관련만 하고, 동일한 구조로 다른 결정 기록을 남기도록 구성을 바꾸고 싶습니다.” → 시안 M21(결정 기록 나누기: DR1 이름과 자리, DR2 옮기는 ADR의 번호, DR3 애매한 넷) https://claude.ai/artifact/6rrnQ2NBf5kWYXkJkrC6kM
- DR1을 묻자 메인테이너: “그대로 둡시다. atelier/README.md 에서 아키텍처 관련 결정과 그외 결정을 구분해주세요.” → 파일과 번호는 그대로, 목록만 “아키텍처 결정”(기록하는 법, 배포 대상과 기술, 편집 모델, 파일 형식과 저장)과 “그 밖의 결정”(일하는 순서, 조작과 모습, 이름 · 로고 · 라이선스)으로 나눔. 애매한 넷은 M21 DR3의 추천대로 둠: 0006 · 0008은 아키텍처, 0013 · 0025는 그 밖. ADR-0001의 “이후 변경”에 한 줄을 더함
- 목록만 나눈 뒤 메인테이너: “M21: 모두 추천 수용”. “그대로 둡시다”와 어긋나 Claude가 되물음(1. 실제로 나눔 / 2. 지금처럼) → 메인테이너: “1”
- 아키텍처가 아닌 열 개(앞서 “9개”라 한 것은 Claude가 잘못 셈)를
atelier/decisions/의 결정 기록 DR로 옮기고 DR-0002~0011을 매김. DR-0001은 이 결정. 스크립트journal/assets/2026-10-17-split-decision-records.py로 링크(모든 문서)와 글자 번호(세션 기록과journal/을 뺀 문서)를 고침. DR 템플릿, README의 두 목록, CLAUDE.md의 규칙,docs/README, ADR-0001의 “이후 변경”을 고침
결정
- ADR은 아키텍처 결정만, 그 밖의 결정은 같은 형식의 결정 기록 DR(
atelier/decisions/) → DR-0001 - 옛 번호 → 새 번호: 0011→DR-0002, 0013→0003, 0015→0004, 0019→0005, 0020→0006, 0023→0007, 0024→0008, 0025→0009, 0027→0010, 0028→0011
아키텍처 제안 확인 (시안 M20)
- 아키텍처 문서 8절의 일곱 가지를 그림으로 견주는 시안 M20을 만듦 https://claude.ai/artifact/R8RJxg8V1qweiMfusMKk87 . 만들며 6번(셸의 인터페이스)에서 빠진 것 둘(다른 문서 읽기, 설정 보관)을 찾아 고친 제안으로 넣음
- 메인테이너: “AskUserQuestion을 다시 사용해주세요. 저는 이게 더 편해요.” → 메모리
use-ask-user-question. 2026-10-11 이후 글로만 묻던 것을 고르는 창으로 바꿈. 메인테이너는 창의 “되묻기”로 물음을 끊고 질문함 - “wasm이 무엇인가요?” → JVM 바이트코드에 견주어 설명. 우리는 저장할 때 글꼴을 추리는 HarfBuzz를 wasm으로 씀 → wasm-and-shell
- A1 · 1번(
packages/fonts), A2 · 1번(id로) + “그대로 같은 이름의 Method는 허용하지 않게 해주세요”(이미 02-interaction-rules의 규칙이라 고친 것 없음), A3 · 1번(줄에 붙은 표시), A4 · 1번(불변 문서와 실행 취소) - A5에서 메인테이너: “지금은 1번으로 결정하지만 나중에 결정을 2번으로 바꾸더라도 비용이 많이 발생하지 않는 아키텍처를 구성합니다.” → Claude가 렌더러를 “장면 만들기”와 “그리기”로 나누는 구조를 제안 → ADR-0030
- A6에서 “셀은 블록을 말하나요?” → 셸(shell)은 배포 대상마다의 바깥 프로그램, 백엔드의 저장소 어댑터에 견주어 설명 → wasm-and-shell (wasm은 text-width-and-bundled-fonts에도). A6을 다시 묻는 창에서 메인테이너가 멈추고 “오늘은 여기까지. 안녕히”
결정 (이어서)
- A1 → 4. 구성 요소, ADR-0026 이후 변경
- A2 → 3.1 문서 모델, ADR-0022 이후 변경
- A3 → ADR-0017 이후 변경
- A4 → ADR-0029
- A5 → ADR-0030, 01-architecture의 의존 규칙
발견한 위험
- 셸의 인터페이스가 “파일 입출력 하나”라는 초안은 다른 문서의 Method 부르기(#P2)와 사용자 설정을 빠뜨렸다. 웹은 사용자가 고르지 않은 파일을 읽을 수 없어, 다른 문서를 부르는 호출 블록이 웹에서는 늘 끊길 수 있다
- 결정 기록을 나누며 “9개”라고 잘못 셌다가 옮길 때 10개로 바로잡음