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-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한 것 (차례대로)

  1. 새 Method로 빼기(R-EDIT-19): 5f543b4. 사용법 · 설계 문서의 “받아들이기”를 “편집 완료”로(293b194). XM3는 메인테이너가 3번(고르는 목록)으로 바꿈 → XM3. 에이전트가 정한 것은 outbox에(ba5305f)
  2. Windows 알림 훅: 2c385a9(.claude/hooks/toast.ps1, 개인 설정 .claude/settings.local.json은 git에서 뺌). 밤에는 메인테이너의 요청(“이번에는 알림을 주시 마세요. 잘거에요”)으로 settings.local.json의 hooks를 비워 둠. 다시 켤지는 내일 → 이번과 다음 세션에 할 것
  3. 브라우저 안의 문서(R-WEB-09): 8f6dbca. BS1은 메인테이너가 추천과 다른 2번(열기 · 저장 창 안에서 고르기)을 고름 → BS1
  4. 메인테이너: “웹버전 1.0 출시 전에 개발할 기능이 어떤게 남아있나요?” Claude가 웹의 P1 가운데 남은 것을 다섯 묶음으로 보여 드림. 메인테이너: “모두 지금 개발해주세요. 나의 선택이 필요한 부분은 일단 달님의 추천안을 수용하겠습니다. push도 해주세요. 써보면서 내 판단을 정하겠습니다.”
  5. 레인 다섯을 git worktree(.claude/worktrees/agent-*)에서 나란히 돌리고, 합치는 에이전트(integrator) 하나가 차례로 main에 합쳐 push함:
  6. 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/core10,0976,345
packages/editor15,0087,376
packages/fonts905525
apps/web4,4194,630
E2E(apps/web/e2e)2,360
합계30,42921,236

발견한 위험과 배운 것

  • 나란히 도는 레인들이 E2E 서버의 포트 4173 · 4175를 두고 다툼. 잠금 폴더로 차례를 지켰으나 R-WEB-09 에이전트는 그 잠금을 몰라 서버와 씨름함. 다음에는 레인마다 포트를 나눠 주거나 잠금 규칙을 처음 지시에 넣는다
  • 부하가 클 때 T-0171과 인수 테스트 AT-05(시간을 잼)가 흔들림. 다시 돌리면 통과
  • 레인 모두가 다음 ADR 번호 0042를 가져감. 합치는 에이전트가 0042 ~ 0045로 다시 매김. 테스트 ID도 겹쳐 push 전에 다시 매김. 다음에는 번호대를 레인마다 미리 나눠 준다
  • 텍스트 외곽선과 PDF에서 기울임 텍스트가 바로 선 글자로 나옴 → BUG-15

outbox에서 옮긴 것

답을 받아 outbox에서 지운 항목의 원문(체크한 채로):