2026-11-17 아키텍처 정의서에서 본받기: C&C 뷰, BUG-16, 펴 보인 호출 블록 시안
메인테이너가 다른 프로젝트(A-Cert)의 아키텍처 정의서를 보여 주며 시작한 세션이다. 우리 아키텍처 문서에 “실행 중의 모습”(C&C 뷰)을 새 장으로 넣었고, 중간에 inbox에 들어온 결함 하나를 고치고 디자인 변경 하나를 시안으로 만들었다.
아키텍처 정의서를 읽고 견줌
메인테이너: “C:\Obsidian\A-Cert-PJT\ArchitectureSpecification에있는 아키텍처정의서를 읽을 수 있나요?” 이어서 “우리의 문서와 비교해서 이 정의서는 어떤 장점이 있나요. 우리가 아키텍처를 설명할 때 본받을 점이 있나요?”
정의서는 SDS BatchService의 Hazelcast를 대신할 분산 코디네이션 엔진의 설계다. 문서 61개, 그림은 C:\Obsidian\A-Cert-PJT\assets\drawio\의 draw.io SVG 38개(원본 내장). 우리도 이미 하고 있는 것: QAS 6요소, ADR의 대안 비교, QAS → 테스트 ID. 본받을 점으로 Claude가 든 것(중요한 차례):
- 목표 숫자의 근거(정의서 QAS의 “측정 목표의 객관적 근거” 칸). 우리 QA-07의 100ms에는 근거가 없다
- 측정 구간 나누기(정의서 5.3.3). AT-05 프로파일링의 기준이 됨
- 민감점과 상충점(정의서 6.4, ATAM)
- 품질 목표별로 묶은 설계 결정 지도(정의서 6.2)
- 양방향 추적표(정의서 6.1)
- 실패 시나리오까지 넓힌 런타임 뷰(정의서 5.3.2)
메인테이너: “저는 C&C View가 눈에 뜨입니다. 처음 우리 문서를 보는 사람에게 전체적인 모습을 쉽게 설명할 수 있을 것 같아요.” 나머지 다섯은 설계에 둠.
C&C 뷰 (시안 M58 → 아키텍처 3장)
- Claude가 웹 앱의 실제 코드(브라우저 API를 쓰는 곳)를 보고 시안 M58(https://claude.ai/artifact/SdY22rP1VtVofLojccBd87,
journal/assets/2026-11-17-cc-view-study.html)을 Mermaid로 그림: 한눈에 · 자세히, 표기법, 컴포넌트 16 · 커넥터 C-01 ~ C-26, 스레드(메인 스레드 하나, Worker 없음), 품질 속성 대응 - 메인테이너: “머메이드도 좋지만 전통적인 C&C View 노테이션을 쓰면 좋겠어요. draw.io나 그냥 달님이 svg로 만드는 것은 어떨까요?” Claude가 draw.io의 원본 내장 SVG를 추천(메인테이너가 A-Cert에서 이미 쓰는 방식, 이 PC에 draw.io 데스크톱과 CLI가 있음)
- 메인테이너: “컴포넌트와 커넥트 연결이 적절하게 배치되어서 복잡하지 않고 가시성이 좋게하실 수 있으세요? 중요한 부분은 가운데에, 연관성 있는 것들은 가급적 서로 가까이에, 연결은 최대한 크로스되지 않게…” Claude가 원칙 8가지와 확인 방법(PNG로 뽑아 직접 보기, 교차 수를 스크립트로 세기)을 답함
- 메인테이너: “선은 직각이 아니어도 됩니다. 보기 좋다면 꺽이는 부분이 살짝 둥글어도 좋아요. 다만 컴포넌트는 둥근 모서리를 자제해주세요. 선의 교차를 피하기 위해서 좀 돌아서 이어져도 좋습니다.”
- 에이전트가 생성 스크립트(
journal/assets/2026-11-17-cc-view-build.mjs)로 두 안을 그림: A 웹 셸이 위(교차 7, 상자를 지나는 선 12), B 웹 셸이 아래(교차 0). B를 고름. 메인테이너가 A를 보인 까닭을 물음: “A를 굳이 보여주신 것은 A가 더 좋은 점이 있어서인 것 같네요.” Claude: 견준 과정으로 넣었을 뿐, A의 장점은 패키지 그림(4.1)과 위아래가 같다는 것 하나. 문서에 “의존의 방향은 4.1의 그림을 보세요” 한 줄을 둠 - 정함: CV1 1번(구성 요소 앞 새 장), CV2 1번(그림 둘), CV3 draw.io의 편집할 수 있는 SVG, 배치 B. 메인테이너: “네, 03-architecture에 새 장으로 넣어 주세요.” → 3. 실행 중의 모습. 장 번호가 하나씩 밀려 링크 92개(46개 파일)를 고침. 커밋
273bd58,e5ae511 - 메인테이너: “스크립트가 사라지나요? 내가 직접 고치는 것 보다 달님에게 고쳐달라고 부탁하는게 더 좋을까요?” 스크립트는 기록으로 남고 다시 돌리지 않음. 자리 · 간격은 메인테이너가 draw.io로, 컴포넌트 · 커넥터의 추가 · 이름은 Claude에게(카탈로그 표와 함께 맞추려고). 그림의 원본은 이제
docs/03-architecture/assets/*.drawio.svg - 메인테이너: “아키텍처 개요 > 시스템 컨텍스트에서 독자는 AriadneNSD 한 인스턴스가 옵시디언 플러그인, 데스크톱앱, 웹을 모두 처리하는 것 처럼 오해할 것 같아요. C&C view는 웹만 그린 것이지요? 그렇다면 웹만 표현했다고 설명하는게 좋겠어요.” 컨텍스트 그림에서 세 앱을 묶던 상자를 없애고 “따로 설치하고 실행하는 프로그램” 문단을 더함. C&C 장 맨 앞에 “웹만 그렸습니다” 콜아웃. 커밋
d32c0b3 - 메인테이너: ""고칠 때는 draw.io로 엽니다” 문단은 그곳에 기술할 내용이 아닙니다. 아뜰리에 쪽에 적당한 곳으로 옮겨주세요.” → 3. 문서의 문서 도구 표. 커밋
2d51c0e
inbox
원문(지운 항목):
6. 결함
MVP는 접기영역을 만들고 폈을 때, 제목 아래 선이 빠졌습니다.
프로토타입과 비교해보시지요.
- BUG-16으로 고침(에이전트, 커밋
048cff6): 이름 띠의 테두리를 띠 배경색으로 칠해 첫 블록의 윗선을 덮었다. 테두리를line.structure로. 회귀 테스트 T-1174 → BUG-16 - “3. 기능”의 펴 보인 호출 블록 항목은 inbox에 남김. 지금 모습은 설계대로(Q15-a). 시안 M59(https://claude.ai/artifact/KTe26Cy95dmanC62gL7xSx,
journal/assets/2026-11-17-call-peek-study.html, 커밋2868275)를 만들었고, 메인테이너: “M59는 다음 세션에서 결정하겠습니다.” - 메인테이너가 inbox에 1레벨 제목 “6. 결함”을 더함. 고르는 창에서 “고정 제목으로 삼기”를 골라 CLAUDE.md를 맞춤(커밋
cb64a2f) - 메인테이너: “M59를 못 찾겠어요. 내게 정할 것을 요청할 때는 tui에서 선택할 수 있으면 최대한 그렇게 해주세요.” Claude가 아직 만들지 않은 시안을 이름으로 불렀고, 정할 것 셋을 글 목록으로 남겼다. 기억(고르는 창으로 묻기)에 더함
발견한 것
- 문서의
size.peek-inset(4px)은 “펴 보인 블록이 안으로 들어가는 깊이”인데, 코드(placePeek,framed: false)는 안쪽 블록을 들이지 않는다. M59를 반영할 때 함께 맞춤 → 설계 - draw.io가 내보낸 SVG는
light-dark()색이라 어두운 테마에서 색이 바뀌고 포트 ■ □의 구별이 흐려진다 → 설계 - BUG-16 에이전트가 QA-07의 “fold-layout 테스트 14개”를 15개로 고쳐 두고 커밋하지 않았다(새 T-1174는 성능 테스트가 아님). 마무리에서 14개로 되돌림
- draw.io가 내보낸 SVG의 DOCTYPE 줄이 있으면 Artifact가 SVG를 받지 않는다(스크립트 밖에서 지움)
다음 할 일
- 다음 세션 처음: M59의 CP1을 정함(inbox “3. 기능”), 그리고 M57
- 메인테이너: C&C 그림을 draw.io로 조금 고침. 고친 뒤 Claude가 PNG로 보고 카탈로그 표와 맞춤
- 본받을 점 다섯 → 설계
마무리 뒤
메인테이너: “A-Cert 아키텍처 정의서에서 우리 쪽에 도입하기로한게 더 있었나요? 내가 깜빡깜빡하네요” 정한 것은 C&C 뷰뿐이고 나머지 다섯은 backlog의 후보였다고 답함. 메인테이너: “측정 구간 진행합시다. 혹시 도중에 내가 결정해야할 부분이 있다면 일단 달님이 생각하는 최선을 적용해주시고 다음 세션에서 내가 결정하겠습니다.” 이어서 “나머지도 진행하시지요. 마찬가지로 내 결정은 다음 세션으로 미루겠습니다.” Claude가 정한 것은 모두 확인해 주세요에 둠.
- 측정 구간(에이전트, 커밋
b6fb45b,7bc6cc9): QA-07을 C&C 커넥터로 여덟 구간으로 나누고 예산(합 100ms)을 둠, 점검 모드?perf가 구간별 p95를 보임 → QA-07 편집 반응 시간. 다른 에이전트 없이 잰 값: 감속 없이 p95 34 ~ 35ms(합격), CPU 4배 감속에서 173 ~ 267ms(불합격).core는 작고 시간은 DOM 반영(문서 레이어를 통째로innerHTML)과 브라우저 그리기가 먹음. 고칠 곳은 증분 레이아웃이 아니라 “바뀐 블록만 DOM에 반영”. 11-10의 280 ~ 750ms는 에이전트가 나란히 돌 때의 값. BUG-16이 바꾼 그림 탓에 예제 썸네일 테스트 T-0529가 깨져 있어 다시 만듦 - 나머지 넷(에이전트, 커밋
50b0c7e): QAS 21개에 “목표의 근거”(근거 없는 값은 “근거 없음(제안값)”), 목록에 중요도 · 난이도, 8.1 민감점 S-01 ~ 05 · 8.2 상충점 T-01 ~ 05, 10.1 품질 목표별 결정 지도, 10.2 추적, 실패 흐름 5.3 깨진 파일 열기 · 5.4 저장 실패 · 5.5 시작이 막힘 - C&C의 어긋남: 측정하다 드러남. 레이아웃 · 렌더러를 부르는 것은 캔버스 뷰가 아니라 세션(C-07 · C-09의 출발을 세션으로, ID는 그대로). 그림의 내장 모델을 고쳐 CLI로 다시 뽑음. M58에는 옛 그림이 남음(과정의 기록)
- 메인테이너가 C&C 그림을 draw.io로 고침: 탭 경계 · 범례의 점선, C-24. Obsidian 플러그인으로 저장하면 SVG의 흰 배경이 없어져, 사이트(
site/custom.scss)와 Obsidian 스니펫drawio-white에 “draw.io 그림은 흰 바탕”을 둠(메인테이너가 추천안을 고름). 커밋3e96765 - A-Cert 볼트에서 단축키(
hotkeys.json), draw.io 플러그인(설정 포함), Refresh Any View 플러그인을 이 볼트로 가져옴. Obsidian Git의 A-Cert 설정(1분마다 자동 push)은 메인테이너가 “가져오지 않기”를 고름..obsidian/은 git 밖
프로토타입과 비교해보시지요.
