2026-11-03 에이전트에게 일을 맡기며: 버그 다섯, 커버리지 하한, 그림 문구의 언어, US1, 조건 칸, 새 Method로 빼기 · 브라우저 안의 문서 시안
시작할 때 inbox는 비어 있었고, 다음에 할 것은 세션 05가 남긴 버그 후보 1 · 2를 고치는 것이었다. 이 기록은 세션 중간의 매듭에서 썼다. 새 Method로 빼기의 구현은 에이전트가 하고 있어 여기에 들지 않는다.
일은 에이전트가, 대화는 멈추지 않게
Claude가 버그 후보 1 · 2를 직접 고치는 동안 메인테이너가 기다렸다. 메인테이너:
“버그 고치는 것은 에이전트에게 시키면 달님과 나는 대화를 계속 이어갈 수 있지 않나요?”
이때부터 정한 일은 백그라운드 에이전트에게 맡기고, Claude는 메인테이너와 결정 · 확인을 이어 갔다. 뒤에 두 번 더 짚었다:
“에이전트에게 시키세요. 달님은 계속 나랑 대화하면서 진도 나갑니다.”
“다시 말씀드리지만 에이전트에게 시킬 수 있으면 최대한 에이전트에게 시켜주세요. 달님과 내가 시간을 허비하지 않고 바로 대화를 할 수 있도록이요”
- 규칙을 CLAUDE.md와 how-we-work 2절에 적음. 세션의 리듬 그림에 에이전트 둘이 나란히 도는
par를 넣음. 메인테이너가 항목의 머리를 보고 “무슨 뜻인가요?”라고 물어 “일은 에이전트가, 대화는 멈추지 않게”로 바꿈. 커밋4df30bc·016f1d8·c975e8a - 이 세션에 에이전트가 한 일: 버그 다섯, 테스트 목록의 번역, 커버리지 하한, ADR-0041 · US1 구현, 예제의 영어판, 상표 검색, 사용법 고침, 시안 M54 · M55, outbox 바로잡기, 새 Method로 빼기(진행 중)
버그 후보 일곱
세션 05가 찾은 버그 후보(테스트를 더하다 찾은 버그 후보)를 하나씩 정했다. 다섯을 고치고 둘은 그대로 → defects
| 후보 | 정함 | 결함 · 커밋 |
|---|---|---|
| 1 빈 default 칸의 복사 · 잘라내기 | 고침: “빈 칸에는 복사할 블록이 없습니다.” · “빈 칸에는 잘라낼 블록이 없습니다.” | BUG-10, 000d934 |
| 2 헤더의 붙여넣기 · 감싸기 · 풀기 | 고침: 헤더 거절의 까닭을 알림 | BUG-11, 000d934 |
3 분기 라벨 · 빈 default 칸에서 Ctrl+← → | 고침: 그 분기에서 출발 | BUG-12, 819ac43 |
| 4 호출 블록을 텍스트로 복사 | 고침: 그려진 대로 ys ← MergeSort(xs) | BUG-13, b69094c |
| 5 상태 표시줄 질문의 다른 키 | 그대로 | - |
| 6 제자리 드롭이 “바뀜”을 돌려줌 | 고침: “바뀌지 않음” | BUG-14, 1776749 |
| 7 인라인 편집 중 캔버스 포커스 | 그대로 | - |
정한 답의 기록은 312f864.
테스트 목록의 번역
99-test-list의 한국어 204곳을 용어집의 말로 맞춤(fd5ebc1). 번역 에이전트가 짐작해 옮긴 이름 둘은 메인테이너가 고른 말로(92381f0).
커버리지 하한
- CI에 따로 된 job
coverage, 패키지마다 하한 90%. Claude는 지금 값보다 1%p 낮게를 추천했고, 메인테이너는 “모두 90%“를 고름(cdab701) - 하한에 모자라던
apps/web에 단위 테스트 T-0802 ~ T-0809(리스너 · 화면 밝기 · 저장용 글꼴,50e4f2b) - E2E 쪽이 낮게 나오던 까닭: 여러 줄 문장의 첫 줄만 세었음. 가장 안쪽 문장으로 세게 고침(
75f5bec). 합친 값 core 95.0 · editor 97.3 · fonts 96.8 · web 97.9% → coverage - 인수 테스트 T-0002가 커버리지 실행에서 한 번 실패, 다시 돌리면 통과 → MVP 개발에서 지켜봄(
627bf37)
ADR-0041과 US1을 만듦
- ADR-0041 승인(
71cbb1b), 구현: 그림의 고정 문구는 문서 설정의 “그림 문구의 언어”(settings.locale)를 따름(2604f6d) - US1 구현: 한 번도 저장하지 않은 새 문서를 두고 다른 문서를 열면 먼저 물음(버리고 열기 · 취소 · 저장,
95e40eb) - 구현 에이전트가 정해 둔 문구 · 차례는 확인해 주세요
outbox의 “확인해 주세요”를 거의 다 봄
메인테이너와 항목마다 보고 거의 모두 “그대로”였다(acbb7d8 · b801080 · e7230c0 · d9552cb · ab73c8d · 81201fb · deb8336 · 5edd9b1 · 0f16b44). 그대로가 아닌 것:
- R-IDE-08(논리 · 물리 뷰)은
P2로 올림, IDE 플러그인과 함께(329c00d) - 예제는 영어 화면에서 영어로(메인테이너: “영어판은 영어가 나와야지요”). 한국어가 든 일곱 예제에 영어판, 썸네일도 언어마다(
25aa39c·b315901) - requirements-rework의 Q18은 닫고, Q23은 제어 블록 위쪽을 “조건 칸”으로(
8957372·3efb7ff·6245d2d). Claude가 처음에 “용어집이 조건 칸이라 했다”고 잘못 말했다가(용어집은 “헤더”였음) 바로잡은 뒤 메인테이너가 “조건 칸”을 고름. “헤더”는 다이어그램의 것만 → 06-glossary - “받아들이기” → “편집 완료”: 사용법은 inbox의 메모대로 고침(아래). 설계 문서는 새 Method로 빼기 에이전트가 함께 고치는 중
- MVP 뒤 기능의 물음(접기의 물음 1 · 2, Q20, 이름이 겹친 헤더의 표시, 헤더 “뒤에” 삽입)은 MVP 개발으로: 그 기능을 만들 때 시안으로 물음(
0c9a2cf)
옮긴 원문은 아래 “outbox에서 옮긴 것”.
상표 검색
에이전트가 KIPRIS · USPTO · WIPO Madrid Monitor를 검색함. 위험 낮음 ~ 중간(법률 자문이 아님) → 상표 검색 (2026-11-03) (252e736). EUIPO는 직접 조회하지 못해 메인테이너가 보기로 했고, 때는 “1.0 출시 이후에” → 출시 무렵과 그 뒤 (ff7ef8e)
사용법
src/apps/manual을 용어집의 말과 오늘의 동작(ADR-0041, US1, 화면 언어의 예제, BUG-13)에 맞추고, 메인테이너가 inbox에 적은 메모 넷을 모두 반영(1bb7872). 메모는 먼저 원문 그대로 커밋해 둠(e19a6a1).
새 Method로 빼기: 시안 M54
R-EDIT-19. 시안 M54(https://claude.ai/artifact/J11wWw9DVKUZkUP2ubT94n, journal/assets/2026-11-03-extract-method-study.html, f692fe0)
- XM1 새 Method는 원래 Method 바로 다음, XM2 빼고 나면 호출 블록이 선택됨(
e9ececd) - XM3 처음에는 1번이었으나 메인테이너가 3번(헤더 없는 다이어그램에서
m은 고르는 목록)으로 바꿈(107e277·6d0e1b4) - Claude가 정해 둔 것(M54의 표)은 확인해 주세요. 구현은 에이전트가 하는 중
브라우저 안의 문서: R-WEB-09와 시안 M55
메인테이너: “브라우저 storage에 저장하는 기능은 언제 개발하나요?” 그리고 “SequenceDiagram.org에도 있는 기능인데, WebStorage(localStorage)라는 메뉴에 있습니다”
- 요구사항 R-WEB-09 브라우저 안의 문서(
P1, 웹 베타의 문턱,e447ac9). 저장소는localStorage가 아니라 IndexedDB(로컬 백업과 같은 곳) → 문서를 둘 곳: localStorage와 IndexedDB (2026-11-03) - 시안 M55(https://claude.ai/artifact/CLz2Y1yXLYJfdn6q27Y1PV,
journal/assets/2026-11-03-browser-storage-study.html,58430f7). BS1은 추천과 달리 2번(앱의 열기 · 저장 창 안에서 파일 · 브라우저를 고르고, 마지막에 쓴 쪽으로 열림), BS2 ~ BS4는 추천안(92c9201) - 구현은 새 Method로 빼기 다음
접기는 언제
메인테이너가 접기(R-EDIT-13 · R-EDIT-14 · R-EDIT-23)를 언제 하는지 물었고, “접기는 지금 하던 것을 완료하고 합시다”로 정함. 순서: 새 Method로 빼기 → 브라우저 안의 문서 → 접기(만들기 전에 시안으로 물음)
알림
메인테이너: “달님도 운영체제를 통해서 나한테 알림을 보낼 수 있나요?” Claude가 시험 삼아 데스크톱 알림을 하나 보냄. 휴대폰으로 받으려면 Remote Control이 필요하다 → learning-claude-code
실수
- Claude가 한 번
git commit -a로 커밋해, 다른 에이전트가 고치던 커밋하지 않은 파일까지 쓸어 담음. push 전에 soft reset으로 되돌리고 나눠 커밋함. 규칙: 에이전트가 함께 일하는 동안은git add <경로>로만 담는다 - Claude가 outbox에
sed로 답을 덧붙이다 답을 엉뚱한 줄에 붙임. 에이전트가 바로잡음(b084186) - Q23에서 용어집의 내용을 잘못 말함(위 “outbox의 확인해 주세요”)
inbox
처리한 항목의 원문(2026-11-03, 6. 기타 아래에 메인테이너가 # 매뉴얼로 적음). 모두 사용법에 반영(1bb7872). 1레벨 제목은 여섯으로 고정이라 # 매뉴얼은 6. 기타 아래의 ## 매뉴얼로 남김(사용법 메모를 계속 적으실 것 같아서):
매뉴얼
첫 블록 적기
- 선택한 블록에 글자를 적으려면 편집을 시작합니다. 적고 나서 Enter를 누르면 받아들입니다. Esc도 적은 대로 받아들입니다. → 선택한 블록에 글자를 적으려면
Enter를 눌러 편집을 시작합니다. 적고 나서 다시 Enter를 누르면 편집이 완료됩니다. Esc도 편집 완료입니다.- 받아들이기 → 편집 완료
블록 더 넣기
- 새 블록은 선택한 블록의 뒤에 들어갑니다. → 새 블록은 선택한 블록의 다음에 들어갑니다.
- 처리 블록을 넣으면 바로 편집이 시작되니, 적고 Enter, 다시 넣고 적기를 되풀이합니다. ← 무슨 말인지 나도 모르겠군요.
발견한 위험
- 에이전트 여럿이 한 작업 트리에서 일하면, 한 쪽의 커밋이 다른 쪽의 고치던 파일을 담거나 테스트가 그 사이의 코드로 돌 수 있다(T-0002의 한 번 실패가 그 탓일 수도). 경로를 밝혀 커밋하고, 겹치는 폴더를 나눠 맡긴다
- 셸 명령으로 문서를 고치면 자리가 어긋나기 쉽다. 문서는 Edit로 고친다
다음 할 것
- 새 Method로 빼기를 마침(에이전트 진행 중), 그다음 브라우저 안의 문서, 그다음 접기
- 메인테이너: 로컬 앱(http://localhost:5173/)에서 ADR-0041 · US1 · 영어 예제 · 조건 칸 · 사용법을 써 보기, 확인해 주세요
매듭 뒤 (2026-11-03 밤 ~ 11-04)
매듭(8999ceb) 뒤에 이어 간 일이다. 위 “다음 할 것”은 매듭 때의 것이고, 지금의 다음 할 것은 이번과 다음 세션에 할 것에 있다.
매듭 뒤에 만들고 push한 것 (차례대로)
- 새 Method로 빼기(R-EDIT-19):
5f543b4. 사용법 · 설계 문서의 “받아들이기”를 “편집 완료”로(293b194). XM3는 메인테이너가 3번(고르는 목록)으로 바꿈 → XM3. 에이전트가 정한 것은 outbox에(ba5305f) - Windows 알림 훅:
2c385a9(.claude/hooks/toast.ps1, 개인 설정.claude/settings.local.json은 git에서 뺌). 밤에는 메인테이너의 요청(“이번에는 알림을 주시 마세요. 잘거에요”)으로settings.local.json의hooks를 비워 둠. 다시 켤지는 내일 → 이번과 다음 세션에 할 것 - 브라우저 안의 문서(R-WEB-09):
8f6dbca. BS1은 메인테이너가 추천과 다른 2번(열기 · 저장 창 안에서 고르기)을 고름 → BS1 - 메인테이너: “웹버전 1.0 출시 전에 개발할 기능이 어떤게 남아있나요?” Claude가 웹의
P1가운데 남은 것을 다섯 묶음으로 보여 드림. 메인테이너: “모두 지금 개발해주세요. 나의 선택이 필요한 부분은 일단 달님의 추천안을 수용하겠습니다. push도 해주세요. 써보면서 내 판단을 정하겠습니다.” - 레인 다섯을 git worktree(
.claude/worktrees/agent-*)에서 나란히 돌리고, 합치는 에이전트(integrator) 하나가 차례로main에 합쳐 push함:793be08레인 2: 블록 텍스트의 언어 · 구문 강조(R-LAY-06, R-LAY-07)7e62971레인 4: 공유 링크 · 보기 모드(R-WEB-05, R-WEB-06)fa56b0e브라우저 안의 문서(R-WEB-09)를 레인 4와 함께 합침05deb73레인 3: 문서 테마 · 고대비 화면(R-LAY-08, R-NFR-07)605264e+b75acb9레인 5: 그림만 담은 SVG · PDF · 인쇄 · 그림 지문 · 텍스트 외곽선(R-EXP-02, R-EXP-03, R-FMT-09, R-FMT-10)abc4a4b레인 1: 접기 · 호출 블록(R-EDIT-13, R-EDIT-14, R-EDIT-23, R-FMT-11, R-EDIT-15, R-EDIT-16, R-EDIT-08, R-BLK-08)
- 0.2.0을 냄:
daa71af(패키지 다섯과version.ts, 도움말 › 이 버전에서 바뀐 것을 목록으로), 주석 태그v0.2.0, GitHub Releases에 Pre-release “AriadneNSD 0.2.0”(https://github.com/reddiana/AriadneNSD/releases/tag/v0.2.0).pnpm check(단위 · 통합 1,520개), 빌드와 크기(첫 내려받기 213.9 KB, 한도 230 KB),pnpm e2e(76개), 문서 검사가 모두 통과함
레인이 추천안으로 정한 것은 ux-decisions의 레인별 절(2026-11-03 레인 1 ~ 5)에 있고, 확인 요청은 확인해 주세요에 있다. 새 ADR 넷은 모두 제안됨: ADR-0042(텍스트 종류는 블록 글꼴을 바꾸지 않음), ADR-0043(공유 링크는 fragment), ADR-0044(문서 테마), ADR-0045(내보내기 파이프라인). 합치는 에이전트가 첫 내려받기 한도를 212 KB에서 230 KB로 올림(레인 1 뒤 213.4 KB → 06-web).
밤사이의 준비
- 화면이 잠겨도 일이 이어지도록 전원 연결 때의 절전을 이 밤만 “안 함”으로(
powercfg). 되돌리는 것은 메인 세션이 함 - 사용 한도에 걸려도 이어 가도록 사용자 설정에서
autoContinueAtUsageLimit를 켬
앱의 크기 (2026-11-04, v0.2.0)
git ls-files로 센 줄 수(빈 줄 포함). 제품 코드는 src/ 아래의 .ts · .tsx · .css · .mjs에서 테스트와 생성 파일을 뺀 것.
| 패키지 | 제품 코드 | 테스트(단위 · 통합) |
|---|---|---|
packages/core | 10,097 | 6,345 |
packages/editor | 15,008 | 7,376 |
packages/fonts | 905 | 525 |
apps/web | 4,419 | 4,630 |
E2E(apps/web/e2e) | 2,360 | |
| 합계 | 30,429 | 21,236 |
발견한 위험과 배운 것
- 나란히 도는 레인들이 E2E 서버의 포트 4173 · 4175를 두고 다툼. 잠금 폴더로 차례를 지켰으나 R-WEB-09 에이전트는 그 잠금을 몰라 서버와 씨름함. 다음에는 레인마다 포트를 나눠 주거나 잠금 규칙을 처음 지시에 넣는다
- 부하가 클 때 T-0171과 인수 테스트 AT-05(시간을 잼)가 흔들림. 다시 돌리면 통과
- 레인 모두가 다음 ADR 번호 0042를 가져감. 합치는 에이전트가 0042 ~ 0045로 다시 매김. 테스트 ID도 겹쳐 push 전에 다시 매김. 다음에는 번호대를 레인마다 미리 나눠 준다
- 텍스트 외곽선과 PDF에서 기울임 텍스트가 바로 선 글자로 나옴 → BUG-15
outbox에서 옮긴 것
답을 받아 outbox에서 지운 항목의 원문(체크한 채로):
outbox에서 옮긴 원문
정해 주세요 › MVP · 테스트 (2026-11-03 세션 05, 묻기 전에 세션이 끊김)
- 테스트를 더하다 찾은 버그 후보 일곱 가운데 고칠 것을 골라 주세요. → 모두 정함(2026-11-03 세션 06). 1 · 2 · 3 · 4 · 6은 고침(BUG-10 ~ BUG-14 → defects), 5 · 7은 그대로 지금은 고치지 않고 지금 동작대로 테스트에 적어 두었습니다. 자세한 것과 코드 자리 → 테스트를 더하다 찾은 버그 후보
빈 default 칸에서 복사 · 잘라내기를 하면 “삭제할 default 분기가 없습니다”라고 알림→ 정함(2026-11-03): 고침. 복사는 “빈 칸에는 복사할 블록이 없습니다.”, 잘라내기는 “빈 칸에는 잘라낼 블록이 없습니다.”, 삭제는 그대로. 두 빈 칸(default가 없는 칸, default에 빈 블록만 든 칸)이 똑같이 보이는 것은 그대로(CD1). 고치는 일은 이번과 다음 세션에 할 것같은 거절에 다른 까닭→ 정함(2026-11-03): 고침. 헤더에서 붙여넣기는 “헤더에는 붙여넣을 수 없습니다.”, 감싸기는 “헤더는 감쌀 수 없습니다.”, 풀기(unwrap)도 헤더 거절로(Claude가 더함)분기 라벨에서→ 정함: 고침. 라벨과 빈 default 칸을 그 분기 안으로 봄(BUG-12)Ctrl+←/Ctrl+→가 If · Case 블록에서 출발호출 블록을 텍스트로 복사하면 Method 이름이 빠짐→ 정함: 고침. 그려진 그대로ys ← MergeSort(xs)(BUG-13)상태 표시줄의 질문에서 고르는 키가 아닌 키는 질문을 닫고 제 일도 함→ 정함: 그대로드래그 앤 드롭으로 제자리에 놓으면 “바뀜”을 돌려줌→ 정함: 고침(BUG-14)인라인 편집 중 밖에서 캔버스에 포커스를 주면 텍스트가 확정됨→ 정함: 그대로- 테스트 목록(99-test-list)의 한국어가 용어집과 다릅니다. 용어집은 2026-11-01부터 “로컬 백업 · 삽입 · 삭제 · 텍스트 · 드래그 앤 드롭”인데 테스트 이름의 번역은 옛말(“임시 보관” 등)이고, “명령 팔레트”와 “커맨드 팔레트”가 섞였습니다. 용어집대로 모두 맞출지(추천), 그대로 둘지 → 정함(2026-11-03 세션 06): 용어집대로 모두 맞춤
확인해 주세요 › 2026-11-03 세션 05에 Claude가 정한 것 (→ 2026-11-03-05-tests-before-refactoring)
- 일하는 방식 문서 how-we-work의 내용과 자리 → 그대로(2026-11-03 세션 06). 에이전트 항목과 그림의 병렬을 더함(inbox의 “로컬에서 보기”를 둘 곳으로 새로 만듦)
- ADR-0041을 승인으로 바꿀지 → 승인(2026-11-03 세션 06). 구현은 에이전트에게
- 커버리지:
pnpm coverage(단위 Vitest V8 + E2E Chromium, 줄마다 합침), 숫자는 coverage에 손으로 옮김(생성 문서로 하지 않음) → 그대로, 더해 CI의 coverage job에 패키지마다 하한 90%(2026-11-03 세션 06)- QA-13: JSX에 글자를 직접 쓰면 막는 ESLint 규칙, 화면 언어 목록을
core의locales하나로 → 07-coding-guide 8장 → 그대로(2026-11-03 세션 06)- 번역 에이전트가 뜻을 짐작해 옮긴 테스트 이름 몇(예: “두 번째 비춤은 1초를 처음부터 다시 센다”, “줄이 옮겨진 범위는 새 소유자로 다시 적힌다”) → 99-test-list → 둘을 테스트 코드에 맞춰 고치기로(2026-11-03 세션 06)
확인해 주세요 › 요구사항 · 범위
- 2026-11-03 세션 02에 Claude가 정한 것 (→ 2026-11-03-02-inbox-atelier-til-views) → 답(2026-11-03 세션 06): R-IDE-08은
P2로 올림(IDE 플러그인과 함께), 5.2의 AT 표는 그대로
- 논리 · 물리 뷰 R-IDE-08의 우선순위를
P3(IDE 플러그인P2의 기본기 뒤)로- 요구사항 5.2 “MVP의 인수 기준”은
R-ID가 아닌AT-ID의 표(블록 ID^at). 표와 주 둘은 07-testing 4장에서 그대로 옮김- 1.2 유형과 구성 요소의 그림을 SVG로 다시 그린 모양 (2026-11-03 세션 02의 매듭 뒤 → 2026-11-03-02-inbox-atelier-til-views): 720 × 368,
visual-design-anatomy.svg와 같은 글꼴 · 바탕. 배치는 Mermaid 판과 같게(E2E ⊃ 통합 ⊃ 단위(core · fonts · editor의 순수 함수) · editor · 웹 셸, 그 밖에 브라우저). 사이트에서는 확인함, Obsidian에서 봐 주기 →docs/04-design/assets/testing-types-components.svg→ 그대로(2026-11-03 세션 06)- MVP 다음의 단계에서 Claude가 정한 것 (2026-11-02 → 2026-11-02-01-release-stages, DR-0018) → 모두 그대로(2026-11-03 세션 06)
- 웹 베타와 웹 1.0의 문턱에 넣은 항목(DR-0018의 “결정”). 고르신 것은 다섯 물음이고, 문턱의 목록은 Claude가 짰음
- 우선순위
P3의 뜻 “출시 뒤”를 “웹 베타 뒤”로 → 01-requirements- 1.0 전 파일 알림의 문구(“AriadneNSD는 아직 1.0 전입니다. 지금 저장한 파일은 뒤의 버전에서 열리지 않을 수 있습니다.“)와 자리(첫 방문 모달의 맨 아래, 도움말 › AriadneNSD에 대하여, README)
- 판을 내는 법: 1.0 전에는 기능을 더하면
0.y.0, 고치기만 하면0.y.z, 주석 태그와 GitHub Releases →src/README.md. 지금 커밋에v0.1.0- GitHub Releases의 v0.1.0을 Pre-release로 표시하고 본문을 씀(2026-11-02 → 2026-11-02-02-release-yaml-review). https://github.com/reddiana/AriadneNSD/releases/tag/v0.1.0
- README의 로드맵 표(단계마다 한 줄, 날짜 없음, 배포 순서 문단을 표로 합침) →
README.md확인해 주세요 › MVP
- MVP에 예제와 헤더를 넣으며 Claude가 정한 것 (2026-11-01 → 2026-11-01-02-docs-current-examples) → 답(2026-11-03 세션 06): 1 · 2는 그대로, 묻지 않음은 US1로 바뀜, 3은 영어판을 만듦(→ backlog)
- 헤더의 모양 고르기(R-LAY-10)도 함께
P0으로 올림. 예제는 프로토타입처럼 “제목처럼”으로 그렸고, 헤더를 넣으면 모양이 하나는 있어야 해서- 예제의 순서: 병합 정렬 · 다익스트라 · UART 명령(Case) · 타이머 인터럽트 · 이진 탐색 · 퀵소트 · 미로 찾기 · 자판기 · 엘리베이터 · Raft (쉬운 것에서 어려운 것으로)
- 예제를 열 때 저장 안 된 문서가 있어도 묻지 않음(웹의 규칙대로, 임시 보관이 있어서)
- 자판기 · 엘리베이터 · Raft는 블록 글자가 한국어 문장이라 영어 화면에서도 한국어로 보임(예제의 영어판은 backlog)
- 예제 모달의 문구 “저장하지 않은 내용은 임시 보관에 남습니다” (2026-11-01, MVP). 내용은 남지만, 다시 꺼내는 길은 페이지를 다시 열 때의 “지난번 내용을 복원할까요?”뿐이다(그것도 가장 최근의 임시 보관 하나). 세션 안에서 꺼내는 메뉴는 없다. 문구를 그대로 둘지, “페이지를 다시 열면 복원할 수 있습니다”처럼 고칠지, 저장 안 된 문서가 있으면 예제를 열기 전에 물을지 → US1로 정함(2026-11-03, US1)
- MVP에 헤더 · 호출 블록을 넣으며 Claude(에이전트)가 정한 것 (2026-11-01 → 2026-11-01-02-docs-current-examples). 설계 문서에 반영함 → 모두 그대로(2026-11-03 세션 06)
- 키:
em(선택에 따라 헤더 달기 · 종류 바꾸기),EM(새 Event · Method 다이어그램),a c·A c(호출 블록 넣기 → Method 목록), 헤더에서xddDelete는 헤더 제거,Shift+Delete는 다이어그램 삭제(묻지 않고 지우고 “실행 취소로 되돌릴 수 있습니다”를 알림, 다이어그램 안 어디서나), 헤더에서Alt+방향키는 다이어그램 순서- 헤더 없는 다이어그램에서는 블록을 선택했어도
em이 헤더 달기. 헤더가 있는 다이어그램의 블록에서m은 “새 Method로 빼기는 아직 지원하지 않습니다”를 알림- 헤더에서
↑는 움직이지 않음,Ctrl+↓는 첫 블록,gg는 헤더. 옆 다이어그램은 그려진 순서(Event · 헤더 없는 것 먼저, 그다음 Method)- “새 Method를 만들고 호출”은 Method 목록의 끝, 고르면 새 Method의 이름 편집이 열림. 호출 블록의 빈 칸에 “인자” · “결과”가 흐리게 보임. 헤더 위에는 끌어 놓을 수 없음
- “제목처럼” 헤더의 선택 테두리는 헤더 바깥으로 4px 넓힘(글자가 왼쪽 선에 붙어 있어 덮지 않게)
- 사용자가 마지막에 고른 헤더 모양은 사용자 설정
editor.headStyle. 예제도 이 모양으로 열림. 첫 방문 여부는examples.welcomed- 썸네일 비율 16 : 9(4 : 3이면 노트북 화면에서 셋째 줄이 잘림)
- 맨 아래에서
↓로 담은 블록을 선택한 뒤, 거기서↓를 또 누르면 다시 안으로 들어가 둘을 오감(ND1. 담은 블록을 선택하는 것은 메인테이너가 확인함)- MVP 개발에서 Claude(에이전트)가 정한 것 가운데 사용자에게 보이는 것 (2026-11-01 → 2026-11-01-01-confirmations-terms-mvp). 설계 문서에 반영함 → 모두 그대로(2026-11-03 세션 06). 고정 문구의 언어는 ADR-0041로 바뀜
- 열기에는 단축키가 없음(
Ctrl+O는 브라우저와 겹침). 줌 키는+-만(브라우저 줌Ctrl+=를 가로채지 않음),Ctrl+휠은 마우스 자리를 중심으로- Chromium에서 방금 연 파일은 읽기 권한만 있어, 자동 저장은 한 번 저장(
Ctrl+S)한 뒤부터- 저장 성공은 알리지 않음(자동 저장 때문). 실패와 “다른 이름으로 저장” 성공만 알림. 알림은 상태 표시줄 하나(info 6초, warn은 닫을 때까지)
- 실행 취소 500단계,
Backspace도 삭제, 인라인 편집 중에도Ctrl+S·Ctrl+Shift+P·F1이 들음- 저장 파일의 고정 문구(If의 “참” · “거짓”)는 저장할 때의 화면 언어를 따름(조작 규칙대로). 그래서 한국어로 저장한 파일을 영어 화면에서 다시 저장하면 바이트가 달라짐. 이대로 둘지
- 웹 첫 내려받기의 번들 사이즈 체크(bundle size budget) 한도 540 KB(gzip, 지금 450 KB). 넘으면 CI가 실패
- 새 Case의 분기 라벨은
1·2· default, 새 분기는 쓰이지 않은 가장 작은 정수확인해 주세요 › 조작 · 키
- 2026-11-03 세션 03에 작은 구멍을 고치며 Claude가 정한 것 (→ 03-keymap, 03-editor 1장, 05-screen-layout): → 모두 그대로(2026-11-03 세션 06)
- 맨 위 메뉴에서
h는←처럼 메뉴를 닫음(하위 메뉴의l/h는 써 보고 확인함)- 하위 메뉴가 오른쪽에 자리가 없으면 왼쪽으로 열고, 양쪽 다 없으면(좁은 화면) 메뉴 위로 겹쳐 엶. 아래로 넘치면 위로 올림. 메뉴 바의 하위 메뉴도 같음
- 좁은 화면 툴바의 줄 맨 앞 구분선은 없애고, 줄 맨 끝 구분선은 보이지 않게만 함(자리는 남김: 없애면 줄이 다시 바뀌어 오락가락할 수 있어서)
- 2026-11-03에 Claude가 정한 것 (→ 2026-11-03-01-site-home-keys-focus): → 모두 그대로(2026-11-03 세션 06)
- 감싸기의
sp는 두지 않음(처리 블록은 다른 블록을 담지 않음) → KP1- 빈 블록에서
o·O를 삽입으로 바꾼 범위: 툴바의 처리 블록 아이콘도 같이 바뀜. 제어 블록(a i등)과 끌어 놓기는 그대로 빈 블록을 바꿈. Case의 빈 default 칸(∅)에서는 블록 하나만 생김 → KP2- 캔버스 포커스 테두리의 “아무 일도 하지 않은 키”: 누른 뒤에도 선택한 것이 없고 편집도 두 키 대기도 아닌 키. 사라질 때 0.3초에 걸쳐 흐려짐. 환경 설정의 이름 “캔버스 포커스 테두리 늘 보이기”(기본 꺼짐). 이 설정 항목을 환경 설정 창에서 직접 보지는 못함 → CF2
- 문서 사이트 탐색기의 “앱 열기”는 맨 위, 이름은 “앱 열기”. “사용자 도움말”은 그 아래, 한국어 사용법(
/manual/ko/)으로- 빈 캔버스의 컨텍스트 메뉴는 하위 메뉴 없이 파일 · 도움말 명령을 한 목록에. 선택한 것이 없을 때
Shift+F10으로는 열리지 않음 → CM1- 키 힌트를 선택 아래로 옮기며 Claude가 정한 것 (2026-11-02 → K3): 선택한 것이 없으면 캔버스 왼쪽 위, 아래에 자리가 없으면 선택 위로 뒤집음, 맨 위 줄에 첫 키와 묶음 이름 → 모두 그대로(2026-11-03 세션 06)
확인해 주세요 › 문서 · 저장소 · 일하는 방식
- 테스트 목록에서 Claude가 정한 것 (2026-11-03 세션 02 → 2026-11-03-02-inbox-atelier-til-views, DR-0022) → 모두 그대로(2026-11-03 세션 06)
- 기능 영역 일곱(인수 테스트, 편집 명령과 모델, 키 · 마우스 · 선택, 메뉴 · 화면 · 시작, 파일, 레이아웃 · 그리기 · 글자, 성능)과 파일을 나눈 자리(예: 헤더 이동
diagrams.test.ts는 키 · 마우스 · 선택, 셸 계약create-editor.test.ts는 파일)- 처음 매긴 테스트 ID의 차례(영역 → 유형 → 파일 → 파일 안의 차례), 테스트 이름 꼴
T-0412 · BUG-03 · QA-19: …- 번역 570여 개는 Claude가 옮김. 파일 설명 속의 ID는 “파일 전체가 확인하는 것”과 겹쳐 번역에서 뺌
- 요약 표의 숫자 열도 가운데 정렬
- QAS의 “테스트 ID” 줄: 이름에 그 QA를 적은 테스트, 파일 전체가 확인하는 파일(테스트 범위), 인수 테스트, 테스트가 아닌 검사, 없으면 “없음”
mobile.spec.ts와acceptance.spec.ts의 첫 주석을 고침(스크립트가 ID를 잘못 읽거나, 옮긴 문서를 가리켜서)- 사용법에서 Claude가 정해 둔 것 (2026-11-02, M48의 “정해 둔 것” → DR-0020): 한 페이지(넓은 화면은 왼쪽 목차), 설계 문서 사이트가 아닌 따로 된 페이지, 단축키 전체 표는 앱의 키 표에서 빌드, 그림은 앱을 조작하며 찍거나 렌더러로 그림 → 모두 그대로(2026-11-03 세션 06)
- README의 “어떻게 만들고 있나”에 “시안과 프로토타입”을 합친 문구 (2026-11-02 → 2026-11-02-03-readme-how-we-build). 설계 → 시안과 프로토타입 → MVP(v0.1.0)의 세 줄. 프로토타입 직접 링크와 시안 라이선스 줄은 뺌 →
README.md→ 모두 그대로(2026-11-03 세션 06)- README 첫 화면에 넣은 것 (2026-10-31): 소개 아래에 그림 둘(M41의 5 · 7번, 머리 모양 “제목처럼”)을 나란히, 사이트 본문 폭에 맞게 폭 300 · 291px, 그 아래 버튼(TIP 콜아웃, 2026-10-31 세션 02에 채운 버튼 그림으로 → 시안 M42. 2026-11-01에 프로토타입 버튼을 MVP 버튼(
/app/)으로 바꿈). 7번의mid = (lo + hi) // 2는 프로토타입의 구문 강조가//를 C 주석으로 칠해>> 1로 바꿈. 5번의 안쪽 반복은 For 블록으로 그림 →README.md→ 모두 그대로(2026-11-03 세션 06)- Obsidian에서 시퀀스 다이어그램의 활성 막대가 연해졌는지 봐 주기 (2026-10-31 세션 02). CSS 조각
.obsidian/snippets/mermaid-activation.css를 만들어 켜 두었음. 그대로면 설정 → 모양 → CSS 조각에서mermaid-activation을 켜기..obsidian/은 git에 들지 않아 다른 PC에는 없음 → 2026-10-31-02-readme-polish-activation → 쓰며 문제 없어 닫음(2026-11-03 세션 06)- 요구사항 ID를 바꾼 것을 Obsidian에서 봐 주기 (2026-10-25 세션 06) → 2026-10-25-06-requirement-ids, DR-0016 → 쓰며 문제 없어 닫음(2026-11-03 세션 06)
- 다른 문서의 요구사항 링크(예: 01-architecture의 R-NFR-01)를 누르면 그 표로 가는가, 마우스를 올리면 표가 미리 보이는가. 사이트에서는 그 줄로 가는 것을 로컬 빌드로 확인함
- 요구사항인지 Claude가 가른 것: 절의 소개, 참고 모델, MVP 범위, 미결정 사항은 ID를 매기지 않음. 절 머리글 속 문장 아홉은 요구사항으로 보고 표로 옮김(R-ALL-02, R-GD-05, R-CF-02, R-IDE-07, R-EDIT-22, R-EDIT-23, R-FMT-11, R-REP-03, 그리고 핵심 원칙
R-CORE· 배포 대상R-TGT)- 블록은 블록 종류 표와 합치며 처리 · If · While · Do-While · Case · For · 호출 … 순서로 번호를 매김(
R-BLK-01~14)- DR-0016은 같은 세션에서 다듬어 push 전에 고쳐 씀(새 DR을 따로 만들지 않음). 체크박스는 없앰(구현의 진행은 개발 때 정함)
- 사이트를 손본 것이 펴낸 사이트에서 맞는지 봐 주기 (2026-10-25 세션 05) → 2026-10-25-05-site-journal-explorer → 쓰며 문제 없어 닫음(2026-11-03 세션 06)
- 왼쪽 목록의 폴더를 펼쳐 스크롤바가 생긴 뒤, 펼친 폴더 위에서 마우스 휠이 듣는가(브라우저에서 굴려 보지 못함)
/journal/name-story·/journal/logo-source의 그림이 보이는가. 왼쪽 목록의 맨 끝(til 다음)에journal을 둔 것은 Claude가 정함- 세션 목록(
/atelier/sessions/)의 2026-10-10 inbox 검토 · 로고 두 줄이 링크인가확인해 주세요 › 아키텍처 · 기술
- 예제 썸네일을 미리 그리며 Claude가 정한 것 (2026-11-03 세션 03 → 2026-11-03-03-small-holes-font-slices-thumbnails, 06-web 7장): 예제 · 화면 언어마다 하나씩 20개를 저장소에 둠(
src/apps/web/src/examples/thumbnails/), 낡으면 테스트가 실패하고 스크립트로 다시 만듦. 형식은 처음에 서브셋 글꼴을 넣은 SVG였다가 2026-11-03 세션 04에 WebP 그림(최대 440 × 248)으로 바꿈: SVG는 브라우저가 메인 스레드에서 글자를 배치해 열 개에 CPU 6배 느림으로 1.5초쯤 더 들었음. 크기는 같음 → 그대로(2026-11-03 세션 06)