2026-11-03 inbox(아뜰리에, til의 방법론, 논리 · 물리 뷰), 테스트 목록(영역 · 한국어 · 테스트 ID DR-0022), 결함 기록, 인수 기준을 요구사항 5.2로
메인테이너: “inbox 체크해주세요”. inbox에 네 항목이 있었다. Claude가 항목마다 방향을 내고, 메인테이너가 고르는 창에서 정했다.
inbox 원문
1. 일하는 방식:
- 99-test-list는 많은 테스트들이 단순히 열거되어 있습니다. 분류를 해야 독자에게 유용한 정보가 될 수 있습니다. 사람 독자에게 유용하지 않다면 문서화할 필요도 없지요.
- page의 “작업 공간”을 “아뜰리에”로 바꿔주세요. “아틀리에”도 모두 “아뜰리에”로.
3. 기능:
- IDE 플러그인을 고려할 때, ER-Win 처럼 논리적, 물리적 뷰가 도입되면 좋겠습니다. 이 부분은 아키텍처에 변경이 클까요? 그렇다면 미리 고려가 되어야하겠습니다.
6. 기타:
- two-worker-scheduling은 오픈소스 운영에 관한 것이 아니라 방법론(일하는 방식)입니다. til을 검토해서 방법론에 관련된 것이 있는지 찾아주세요.
정한 방향
| 항목 | 메인테이너가 고른 것 |
|---|---|
| 테스트 목록 | 기능 영역으로 묶음(Claude 추천). 영역마다 한 줄 설명, 파일 → 영역의 표는 생성 스크립트에 |
| 아뜰리에 | ”작업 공간” · “아틀리에”를 모두 “아뜰리에”로. 승인된 DR은 링크 글자만(Claude 추천), 세션 기록 · 연표는 그대로 |
| 논리 · 물리 뷰 | 뜻 A: 블록 하나를 설명 문장(논리)과 코드(물리)의 두 얼굴로 봄 |
| til의 방법론 | 새 주제 “방법론”(메인테이너: “1로 하되 일하는 방식 → 방법론으로”)에 two-worker-scheduling · spike-prototype-mvp, “오픈소스 운영”에 잘못 든 셋은 “테스트와 빌드”로 |
한 일
- 테스트 목록: 99-test-list를 기능 영역 일곱(인수 테스트, 편집 명령과 모델, 키 · 마우스 · 선택, 메뉴 · 화면 · 시작, 파일, 레이아웃 · 그리기 · 글자, 성능)으로 묶음. 요약은 영역 × 유형의 테스트 수, 영역마다 한 줄 설명과 그 문서의 링크, 파일 표, ID가 있는 테스트 표. 파일 → 영역은
src/scripts/test-list.mjs의areas가 정하고, 어느 영역에도 들지 않는 새 테스트 파일은 스크립트가 실패한다. “테스트가 없는 ID”는 4장 → 3장(backlog의 링크도 고침) - 아뜰리에:
atelier/README.md의 제목(사이트의 목록과 탭), README · CONTRIBUTING · CLAUDE.md ·docs/README· UX 개요 · ADR · DR 목록의 링크 글자, dr-0008의 링크 글자,pages.yml·quartz.layout.ts의 주석. dr-0013의 표(승인된 DR), 세션 기록, 연표, 시안 HTML은 그대로 - til: TIL에 “방법론”(spike-prototype-mvp, two-worker-scheduling)과 “테스트와 빌드”(test-types-and-doubles, bundle-size-budget, yaml-and-json) 주제
- 논리 · 물리 뷰: R-IDE-08과 요구사항의 미결정 “논리 · 물리 뷰의 범위”, 미결정 사항에 담는 자리. Claude의 답: 아키텍처를 지금 바꿀 필요는 없다. 블록에 선택 필드 하나를 더하고 보이는 얼굴은 뷰 상태에 두면 되며, 레이아웃은 보이는 글자를 잴 뿐이다. 웹 1.0 전에는 파일 형식이 바뀌어도 되고, 뒤에도 선택 필드를 더하는 것은 옛 파일을 깨지 않는다
Claude가 정한 것 (확인받지 못함)
- R-IDE-08의 우선순위를
P3(IDE 플러그인P2의 기본기 뒤)로 - 테스트 목록의 영역 일곱과 그 이름, 파일을 나눈 자리(예: 헤더 이동
diagrams.test.ts는 키 · 마우스 · 선택, 셸 계약create-editor.test.ts는 파일)
테스트 목록: ID마다 한 줄
메인테이너가 로컬 사이트에서 테스트 목록을 보고: “어떤 버그를 해결한 후 그 버그가 재발되지 않도록 테스트를 만든다면 이 목록에서 그 테스트가 해당 버그를 방지하고 있다는 것을 알아볼 수 있나요?” Claude: 이름의 BUG- 번호로 영역의 ID 표와 “테스트가 없는 ID”에 나온다. 다만 영역마다 흩어진다(결함 순 보기와 결함 기록의 칸 검사를 제안, 답은 아직).
이어서 “BUG-03 경우는 이상하네요. ID는 유니크해야하지 않나요?” 결함 하나를 테스트 둘이 지켜 두 줄로 나왔고, 첫 칸 이름이 “ID”라 테스트의 ID처럼 읽혔다. 메인테이너가 1번(ID마다 한 줄)을 고름 → 영역마다 ID 한 줄, “지키는 테스트” 칸에 그 테스트들, “다른 근거” 칸. 같은 ID가 다른 영역에 또 나올 수는 있다(AT-12: 인수 테스트와 편집 명령의 통합 · 단위 테스트).
테스트 목록: 테스트 중심의 표와 한국어 번역
메인테이너: “ID가 유니크하지 않다는 말인가요? 설명을 들을 수록 혼란스럽습니다. 현재의 이름 규칙도 이상합니다. 안 맞아요.” Claude: 테스트에는 ID가 없고, 이름 앞의 AT- · BUG- · R-는 그 테스트가 확인하는 것의 ID다. 표의 첫 칸 “ID”가 그것을 테스트의 ID처럼 보이게 했고, ID마다 한 줄로 묶은 것은 증상만 가렸다.
메인테이너: “1. “지키는 테스트”는 매우 어색한 한국어입니다. 2. 영어를 번역해주세요. 나중에 영문버전 문서를 만들 수도 있지만, 일단 나는 한국어 사용자입니다. 문서는 app과 달리 한국어가 기준입니다.” 이어서 “코드는 그대로 두세요. 문서에만 한국어로 번역해달라는 말입니다. 참고로, 나중에 문서의 영어버전을 만들 때는 그대로 코드의 내용을 적을 수 있겠지요.”
- 표의 첫 칸은 테스트(한국어), 둘째 칸은 “확인하는 것”(ID들). 파일 표의 칸은 “무엇을 확인하나” · “확인하는 것”. “지키는”은 모두 뺌
- 번역은
src/scripts/test-list-ko.json(영어 글 → 한국어, 351개, Claude가 옮김). 빠지거나 쓰이지 않는 번역이 있으면 스크립트가 실패하고,--add-missing이 빈 번역을 더함. 코딩 가이드와 02-test-architecture에 적음 - 함수 이름만 있던 파일 설명(
checkInvariants등)은 한국어 설명을 앞에 붙임
테스트 ID와 파일마다 한 표 (DR-0022)
메인테이너가 “테스트 목록 문서화에 여러번의 대화가 오갔습니다. 예전과는 다르게 말이지요. 내가 합리적이지 않은 요청을 하고있나요?”라고 물었다. Claude: 요청은 합리적이었고, 표를 잘못 짠 것(참조 ID를 첫 칸 “ID”로), 문서는 한국어라는 규칙을 놓친 것, 규칙으로 답이 나는 것을 다시 물은 것이 Claude의 잘못이다. Claude의 기억에 적음.
메인테이너: “테스트ID가 있으면 좋겠어요. ID가 있으면 어떤 테스트에 대해 정확하게 지목하고 논의를 할 수 있습니다.” → 고르는 창에서 T-0001 차례 번호, 모든 테스트(Claude 추천 둘 다).
이어서 메인테이너: “packages/core/src/commands/new-document.test.ts의 경우, 첫번째 표에서는 “확인하는 것”에 아무 것도 없고, 두번재 표에서는 여러개가 있습니다. 리던던시가 있을 뿐만 아니라 앞뒤도 안 맞습니다. 공간도 많이 차지하구요. 보기 매우 불편합니다.” → 파일 표와 테스트 표를 합침.
- 테스트 519개에
T-0001~T-0519(스크립트--assign-ids, 목록의 차례대로). 다음 번호는src/scripts/test-ids.json. ID가 없거나 겹치면 검사가 실패 - 목록: 영역 안에서 파일마다 제목(경로)과 한 줄(무엇을 확인하나 · 유형 · 방법 · 테스트 수 · 파일 전체가 확인하는 것), 그 아래 표 하나(ID · 테스트 · 확인하는 것). 모든 테스트가 한 줄씩
- 번역 222개를 더 옮김. 파일 설명의 ID는 “파일 전체가 확인하는 것”과 겹쳐 번역에서 뺌. 쉼표로 이은 ID(
AT-04, R-NFR-05: …)도 확인하는 것으로 읽음 - 결정 → DR-0022, 코딩 가이드 · 02-test-architecture, ADR-0038의 이후 변경
- 단위 · 통합 560개, E2E 51개 통과
테스트 ID와 파일마다 한 표 (DR-0022)
메인테이너가 “테스트 목록 문서화에 여러번의 대화가 오갔습니다. 예전과는 다르게 말이지요. 내가 합리적이지 않은 요청을 하고있나요?”라고 물었다. Claude: 요청은 합리적이었고, 표를 잘못 짠 것(참조 ID를 첫 칸 “ID”로), 문서는 한국어라는 규칙을 놓친 것, 규칙으로 답이 나는 것을 다시 물은 것이 Claude의 잘못이다. Claude의 기억에 적음.
메인테이너: “테스트ID가 있으면 좋겠어요. ID가 있으면 어떤 테스트에 대해 정확하게 지목하고 논의를 할 수 있습니다.” → 고르는 창에서 T-0001 차례 번호, 모든 테스트(Claude 추천 둘 다).
이어서 메인테이너: “packages/core/src/commands/new-document.test.ts의 경우, 첫번째 표에서는 “확인하는 것”에 아무 것도 없고, 두번재 표에서는 여러개가 있습니다. 리던던시가 있을 뿐만 아니라 앞뒤도 안 맞습니다. 공간도 많이 차지하구요. 보기 매우 불편합니다.” → 파일 표와 테스트 표를 합침.
- 테스트 519개에
T-0001~T-0519(스크립트--assign-ids, 목록의 차례대로). 다음 번호는src/scripts/test-ids.json. ID가 없거나 겹치면 검사가 실패 - 목록: 영역 안에서 파일마다 제목(경로)과 한 줄(무엇을 확인하나 · 유형 · 방법 · 테스트 수 · 파일 전체가 확인하는 것), 그 아래 표 하나(ID · 테스트 · 확인하는 것). 모든 테스트가 한 줄씩
- 번역 222개를 더 옮김. 파일 설명의 ID는 “파일 전체가 확인하는 것”과 겹쳐 번역에서 뺌. 쉼표로 이은 ID(
AT-04, R-NFR-05: …)도 확인하는 것으로 읽음 - 결정 → DR-0022, 코딩 가이드 · 02-test-architecture, ADR-0038의 이후 변경
- 단위 · 통합 560개, E2E 51개 통과
결함 기록의 모양
메인테이너: ”@..\atelier\defects.md 에 bug 목록표에는 ID, 찾은 날, 증상, 상태까지만 남겨주시고, 자세한 내용은 표 아래에 기술해주세요. 회귀테스트에 테스트ID도 함께 알려주세요.” → defects의 표는 네 칸(ID는 그 절로 가는 링크), 결함마다의 절에 찾은 사람 · 원인 · 고친 곳 · 회귀 테스트(테스트 ID, 한국어 이름, 유형, 파일). 테스트 목록의 BUG- 링크는 그 절로 감([[defects#bug-03|BUG-03]]), 스크립트는 링크 꼴의 첫 칸에서도 결함 번호를 읽음.
- 메인테이너: ”@..\atelier\defects.md “목록”, “결함마다”는 불필요한 제목입니다. 지워주세요.” → 지우고 결함 절을
## BUG-01로 올림 - 메인테이너: “@atelier/defects.md 에서 테스트ID에 링크를 걸 수 있나요?” → 테스트 목록의 파일 표마다 블록 ID(
^t-apps-web-e2e-boot-spec-ts), 결함 기록의 테스트 ID는[[99-test-list#^t-|T-0278]]. Obsidian은 그 표로, 사이트는 빌드(site/prepare-content.mjs)가 그 줄로 돌림(요구사항 ID와 같은 방법). 링크가 다른 표를 가리키면 테스트 목록 검사가 실패 - 메인테이너: “QAS의 테스트 부분에 있다면 테스트ID를 넣어주세요.” → 03-quality-attribute-scenarios의 시나리오마다 “테스트” 줄 아래에 “테스트 ID” 줄. 테스트 목록 스크립트가 채우고 낡으면
pnpm check가 실패. 이름에 그 QA를 적은 테스트, 파일 전체가 확인하는 파일(테스트 범위), 그 QA를 맡은 인수 테스트, 테스트가 아닌 검사, 없으면 “없음”.mobile.spec.ts의 첫 주석에 “QA-19 is in boot.spec.ts”가 있어 QA-19로 잘못 읽혀, 주석을 고침
인수 테스트의 자리: 요구사항 5.2
메인테이너: “@docs/04-design/99-test-list.md 의 “2.1 인수 테스트”와 @docs/04-design/07-testing.md 의 “4. MVP의 인수 테스트”는 리던던시 같습니다. 정리해주세요.” Claude가 07에 모으기를 추천했고, 메인테이너는 “08에 모음”을 고른 뒤 “2번으로 하되 내용이 사라지지 않게 해주세요.” Claude가 08의 2.1을 AT 표 하나로 합쳐 그렸으나, 메인테이너: “08로 옮겨서 표를 하나로 합치자 08의 다른 표들과 모양이 다르게 되었습니다. 08은 원복하고 07 4장을 다른 곳으로 옮길만한데가 잇나요? 우리에게 MVP 문서가 있나요?” → 커밋하지 않은 그 변경을 모두 되돌림. MVP만의 문서는 없고 5. MVP 범위가 MVP의 자리. 메인테이너가 “요구사항 5.2로”(Claude 추천)를 고름.
- 5.2 MVP의 인수 기준: 07 4장의 표와 주 둘을 그대로 옮김(블록 ID
^at). 07 4장은 그리로 가는 한 줄, 1.6의 “(4장)“도 링크로 - AT 링크(테스트 목록 스크립트, QAS, backlog, TIL)는
[[01-requirements#at-04|AT-04]]. 사이트 빌드가 그 줄로 돌림. 08의 모양은 그대로
테스트 유형 그림을 가로로
메인테이너: “@docs/04-design/07-testing.md “1.2 유형과 구성 요소”의 다이어그램이 폭은 좁고 위아래로 깁니다. 전체적으로 직사각형이나 좌우가 더 길게 배치해주세요.” → 881 × 893에서 1400 × 609로. Mermaid는 이어지지 않은 상자를 direction TB면 옆으로, LR이면 아래로 놓아서, 단위 묶음만 LR(세 상자를 세로로)로 두고 나머지는 TB로 함. 묶음 제목은 줄을 나누고(<br/>) subGraphTitleMargin으로 잘리지 않게 함. 그림을 사이트와 같은 판으로 찍어 보는 도구 site/tools/render-mermaid.cjs를 더함
- 이어서 메인테이너: “1. E2E, 통합, 단위를 가운데 정렬로 2. editor, 웹셀을 위 아래로 배치” → editor와 웹 셸을 테두리 없는 묶음(APP)에. 제목은 사이트 판에서 이미 가운데라 물었더니 메인테이너: “어쩌면 옵시디언 머메이드가 가운데 맞춤을 제대로 못하는 것잊니도 모르겠네요. 그냥 둡시다” · “단위 박스가 왼쪽, editor, 웹셀이 그 오른쪽에 위아래로”. Mermaid 10.9.1(Obsidian과 비슷한 판)로 그려 보니 좌우가 뒤집히고 제목이 왼쪽에 붙음 →
UNIT ~~~ APP로 순서를 고정, 통합 제목은 두 줄로. 두 판 모두 같은 배치를 확인.render-mermaid.cjs에MERMAID_VERSION. 정리 → mermaid-layout
테스트 목록 다듬기
- 메인테이너: “확인하는 것 컬럼에서 내용이 비었으면 비었다는 표시를 해주세요. 가운데 정렬된
-, “n/a” 어떤게 좋을까요?” · ""1. 요약”, “2. 영역마다” 제목 빼주세요.” → Claude는 줄표(—)를 추천, 메인테이너가 “가운데의 -“를 고름. 열 전체를 가운데 정렬. 두 제목을 빼고 영역을 1 ~ 7절로, 끝 절은 8, 요약 표는 문서 머리로(07-testing · 요구사항 5.2 · backlog의 링크도). 요약 표의 빈칸도-(“네, 거기도 -로 해주세요”), 숫자 열도 가운데 정렬(Claude) - 메인테이너: “테스트들에 “테스트 유형”이 없습니다. 어떻게 알아볼 수 있나요?” · “요약표에서 “모두”는 “합계”를 말한 것 같습니다. 한국어 문서의 표에서는 그렇게 합니다.” → “합계”로. 유형은 파일마다라 파일 제목에 붙이기를 추천, 메인테이너: “1” 뒤 “제목 앞에 유형 말머리를 붙여주세요.” →
### [E2E] apps/web/e2e/boot.spec.ts, 아래 줄에서는 유형을 뺌
결정
| 결정 | 반영한 곳 |
|---|---|
| ”작업 공간” · “아틀리에”는 “아뜰리에” | atelier/README.md 외 |
| til에 “방법론” · “테스트와 빌드” 주제 | TIL |
| 논리 · 물리 뷰(뜻 A), 아키텍처는 지금 바꾸지 않음 | R-IDE-08, 01-model |
테스트 목록은 기능 영역, 파일마다 표 하나, 한국어 번역, 빈칸은 - | 99-test-list, src/scripts/test-list.mjs |
테스트마다 ID T-0001(불변, 다시 쓰지 않음) | DR-0022 |
| 결함 기록은 네 칸 표와 결함마다의 절, 테스트 ID는 링크 | defects |
| QAS의 시나리오마다 “테스트 ID” 줄(스크립트가 채움) | 03-quality-attribute-scenarios |
| MVP의 인수 테스트는 요구사항 5.2 “MVP의 인수 기준” | 01-requirements |
발견한 위험
- 테스트를 더할 때 ID(
--assign-ids)와 번역(--add-missing)을 함께 채우지 않으면pnpm check가 실패한다. 코딩 가이드에 적었지만 처음 하는 사람(또는 에이전트)이 놓치기 쉽다 - 테스트 목록 스크립트가 다른 문서(QAS의 “테스트 ID” 줄)를 고쳐 쓴다. 그 줄을 손으로 고치면 다음 생성 때 사라진다(QAS 머리말에 적음)
- Obsidian의 Mermaid는 사이트보다 오래되어 같은 그림이 다르게 그려질 수 있다 → mermaid-layout
회고
테스트 목록을 사람이 읽을 문서로 만드는 데 대화가 여러 번 오갔다. 메인테이너: “테스트 목록 문서화에 여러번의 대화가 오갔습니다. 예전과는 다르게 말이지요. 내가 합리적이지 않은 요청을 하고있나요?” 요청은 합리적이었다. Claude가 다른 문서의 ID를 표의 첫 칸 “ID”로 두어 테스트의 ID처럼 보이게 했고, 문서는 한국어라는 규칙을 놓쳤고, 규칙으로 답이 나는 것을 다시 물었다. 또 “08에 모음”을 그릴 때 08의 다른 표와 모양이 달라지는 것을 미리 보이지 않아 되돌렸다. 큰 모양을 바꾸기 전에는 그 결과를 먼저 보여 주어야 한다.
다음 할 것
- 메인테이너가 테스트 목록 · 결함 기록 · QAS의 테스트 ID · 요구사항 5.2를 사이트에서 봄
- 확인할 것 → 확인해 주세요
매듭 뒤: 사이트에서 그림이 깨짐
메인테이너: “페이지에서 테스트 전략 > 1.2 유형과 구성 요소의 다이어그램이 Syntax error in text mermaid version 11.4.0”. Quartz가 Obsidian 주석 를 지우며 코드 블록 안의 와 “를 글자로 적어 주석이 거기서 끝났고, 그림은 1633px가 본문 750px에 맞춰 45%로 줄었음. 메인테이너: “복잡하게 머메이드로 할 것 없이 svg로 하시는 건 어떠세요?” → docs/04-design/assets/testing-types-components.svg(720 × 368, 기존 visual-design-anatomy.svg와 같은 글꼴 · 바탕)로 그리고 Mermaid와 주석을 지움. 사이트에서 720px 그대로 보임을 확인. Quartz는 새 그림 파일을 첫 빌드에서 못 찾아 경로가 틀렸고, 다시 빌드하니 바름
- 기억에 적음: Mermaid는 빌드한 사이트의 페이지에서 확인하고, 상자를 겹쳐 담기만 하는 그림은 처음부터 SVG로
- 다음 할 것: 메인테이너가 사이트와 Obsidian에서 SVG 그림을 봄 → 확인해 주세요
두 번째 매듭 뒤: README의 순서
메인테이너: “대문 readme에 “이 저장소를 읽는 법”을 “로드맵” 앞으로 옮겨주세요” → README.md의 두 절을 바꿈(내용은 그대로, GitHub에만 보이는 안내도 함께)