일하는 방식
이 문서는
AriadneNSD를 어떻게 만들고 있는지를 한곳에서 보여 줍니다. 만드는 사람은 둘입니다. 메인테이너(백엔드 개발자, 프론트엔드는 처음)와 Claude(Claude Code)입니다. 메인테이너가 무엇을 만들지 정하고 확인하며, Claude가 설계 · 코드 · 테스트 · 문서를 씁니다.
- 규칙 하나하나의 원본은 그 규칙이 사는 문서입니다(아래의 링크). 이 문서는 흐름을 보여 주고 원본을 가리킵니다. 단, 7. 올리기 전에 로컬에서 보기는 이 문서가 원본입니다.
- Claude가 세션마다 따르는 지시는 저장소 맨 위의
CLAUDE.md에 있습니다. 이 문서는 그것을 사람이 읽기 좋게 풀어 둔 것입니다.- 따라 해 보려는 분께: 대부분은 도구가 아니라 습관입니다. 혼자 AI와 일할 때도 그대로 쓸 수 있습니다.
- 메인테이너는 Claude를 “달”(Daedalus, 미궁을 지은 장인의 가운데 음절)이라 부르고, Claude는 메인테이너를 호(號)인 “홍월(紅月)님”으로 부릅니다(2026-10-22).
1. 큰 순서
공학의 순서를 따릅니다. 앞 단계의 결과가 다음 단계의 입력입니다.
flowchart LR R[요구사항] --> P[프로토타입<br/>요구사항 점검] P --> A[아키텍처] A --> D[상세 설계] D --> T[테스트 설계와<br/>테스트 코드] T --> C[개발] C --> M[MVP] M --> B[웹 베타] B --> V[웹 1.0]
- 아키텍처 · 상세 설계는 프로토타입 리뷰와 나란히 갔습니다. 앞 문서를 고칠 일이 생기면 그 자리에서 고치지 않고 backlog에 적어 둔 뒤 차례로 반영합니다.
- 스파이크(기술 질문 하나에 답하는 실험) · 프로토타입(요구사항이 맞는지 보려고 만들고 버림) · MVP(처음 내놓는 제품)를 나눠 씁니다 → spike-prototype-mvp
- 배포 대상의 순서는 웹 → Obsidian → 데스크톱입니다 → DR-0002. MVP 뒤의 단계와 문턱은 DR-0018에 있습니다.
2. 세션의 리듬
일은 세션 단위로 합니다. 세션은 Claude Code와 나누는 대화 하나입니다. Claude는 세션이 끝나면 기억을 잃기 때문에, 이어 가는 데 필요한 것은 모두 저장소의 문서에 남깁니다.
sequenceDiagram participant M as 메인테이너 participant C as Claude participant G1 as 에이전트 1 participant G2 as 에이전트 2 participant A as atelier/ M->>+C: 세션 시작 ("진도 나갑시다") C->>+A: status · outbox · 최근 세션 기록 · inbox를 읽음 A-->>-C: 지금 단계, 답을 기다리는 것, 새 메모 C-->>M: 지난 일과 다음 할 일을 요약 M->>C: 요청 · 결정 par 에이전트 1 C->>+G1: 정한 일 (예: 버그 고치기) G1->>G1: 코드 · 테스트 · 문서, 검사, 커밋 G1-->>-C: 결과 보고 and 에이전트 2 C->>+G2: 다른 파일을 쓰는 일 (예: CI 손보기) G2->>G2: 코드 · 테스트 · 문서, 검사, 커밋 G2-->>-C: 결과 보고 and 대화 C-->>M: 다음 물음 (시안 · 고르는 창) M->>C: 답 end C-->>M: 에이전트의 결과 (로컬 링크) M->>C: "매듭" 또는 "마무리" C->>+A: 세션 기록, status · backlog · outbox 갱신 A-->>-C: C-->>-M: 커밋하고 push
- 시작: Claude가 status(지금 어디인가), outbox(메인테이너의 답을 기다리는 것), 가장 최근의 세션 기록, inbox를 읽고 요약합니다.
- inbox와 outbox: 세션 사이에 떠오른 생각은 메인테이너가 inbox에 적습니다(메인테이너 → Claude). Claude가 묻고 답을 받지 못한 것은 outbox에 남습니다(Claude → 메인테이너). inbox 항목은 함께 검토하고, 처리하면 원문을 세션 기록으로 옮긴 뒤 지웁니다. 처리를 마친 항목은 Claude가 묻지 않고 판단해 옮깁니다(2026-10-31, 메인테이너: “처리한 inbox는 항상 스스로 판단해서 옮겨주세요.”). 2026-10-17부터 이날까지는 마무리 때마다 물었습니다. inbox의 1레벨 제목은 고정이며,
6. 결함은 2026-11-17에 메인테이너가 더했습니다. - 매듭과 마무리: “마무리”는 세션을 닫는 정리, “매듭”은 세션을 이어 가면서 하는 같은 정리입니다. 아리아드네의 실을 끊지 않고 그 자리에 매듭만 짓는다는 뜻입니다(2026-10-25). 정리할 때는 세션 기록(
sessions/)을 쓰고, 누적 토큰과 세션 시간(토큰과 세션 시간)을 집계하고(2026-11-19, 메인테이너: “비용은 빼고 누적 토큰과 누적 세션 시간만 합시다”), 상태 · 할 일 · 답을 기다리는 것을 갱신하고, 연표와 배운 것을 더한 뒤 커밋하고 push합니다. 정리는 돌고 있는 에이전트가 모두 끝난 뒤에 시작하고, 마치면 대화를 비웁니다(/clear). 비운 뒤의 대화는 새 세션으로 치고, 세션 기록도 그날의 다음 번호로 새로 씁니다. 다음 대화는 상태 문서와 세션 기록으로 이어 가므로, 긴 맥락을 끌고 가지 않습니다(2026-11-21, 메인테이너: “앞으로 매듭짓기가 완료되면 /clear 해주세요. 마무리는 매듭을 포함하므로 역시 마찬가지입니다.”). 정리는 에이전트가 끝난 뒤에 시작하는데, 그 커밋이 검사와 push에 들어가야 하고, 시간 테스트는 홀로 돌 때만 믿을 수 있으며, 비운 뒤에 끝난 에이전트의 보고는 받을 대화가 없기 때문입니다. - 정한 것이 어디까지 갔나: status에 결정마다 결정 · 구현 중 · 로컬 앱에 있음 · 사이트에 있음을 적고, 결정하거나 에이전트가 커밋할 때마다 Claude가 바로 고칩니다. 사이트에 올라가 메인테이너가 확인한 줄은 마무리 때 지웁니다(2026-11-21).
- 일은 에이전트가, 대화는 멈추지 않게: 메인테이너가 정한 일(코드 수정, 테스트, 문서 정리)은 Claude가 백그라운드 에이전트에게 맡기고, 그동안 메인테이너와 다음 물음으로 넘어갑니다. 같은 파일을 쓰는 일은 한 에이전트에 차례로 묶습니다. 에이전트는 커밋만 하고, push와 상태 문서(status · outbox · 세션 기록)는 Claude가 합니다(2026-11-03, 메인테이너: “에이전트에게 시키세요. 달님은 계속 나랑 대화하면서 진도 나갑니다.”).
- 정리는 하자고 할 때: 정한 일은 눈에 보이는 변경(코드 · 테스트)만 먼저 해서 빨리 보여 드립니다. 정리(설계 문서 · ADR · DR · UX 결정 · 테스트 목록에 반영하고, 쓰지 않게 된 코드와 형식을 걷어 내기)는 메인테이너가 하자고 할 때 합니다. 매듭은 정리를 포함하고, 마무리는 매듭을 포함하므로 늦어도 매듭 때는 합니다. 그 전의 커밋은 함께 바뀌는 곳의 훅을
Co-change-skip으로 넘기고, 미룬 정리는 상태 문서에 남깁니다(2026-11-21, 호출 블록 변경 하나에 문서 열 곳까지 한 번에 맡겨 오래 걸리자 메인테이너: “다음에는 정리는 내가 하자고 할 때 해주세요. 매듭은 정리를 포함합니다. 마무리는 매듭을 포함합니다.”). - 전체 검사는 push 전에 한 번: 에이전트는 바뀐 패키지의 테스트 · 타입 검사 · lint만 돌립니다. 전체 검사(
pnpm check전체,pnpm e2e)는 매듭 · 마무리 때 push하기 전에 Claude가 한 번 돌립니다. 테스트 목록의 한국어 번역도 그때 한 번에 채웁니다(pnpm test-list:strict). 그 전에는 목록에 영어가 보입니다(2026-11-21, 메인테이너와 지속 가능한 방식을 검토하고 정함). 나란히 돌 에이전트에게는 테스트 ID · 번호 · 포트의 범위를 미리 나눠 줍니다. 시간을 재는 테스트는 다른 일이 돌지 않을 때만 믿습니다. 2026-11-10에 이것을 지키지 않아 하루가 길어졌습니다(메인테이너: “오늘 작업이 너무 오래 걸렸는데 어느 부분에서 오래 걸렸나요?”). - 맥락을 짧게: Claude Code는 매 턴 대화 전체와
CLAUDE.md를 다시 읽으므로, 토큰은 맥락 길이 × 턴 수로 늘어납니다. 그래서 주제가 바뀌면/clear를 추천하고, 기계적인 일은 Sonnet 에이전트에게 맡기고, 검사 출력은 실패만 걸러 읽고, 화면은 스크린숏 대신 글로 읽고, 시안 HTML은 고칠 곳만 Edit하고, 매 턴 따라다니는CLAUDE.md· status · outbox는 짧게 유지합니다(2026-11-21). 그래서CLAUDE.md에는 지시만 두고, 그 까닭과 경위는 이 문서에 둡니다. - 한 항목은 한 곳에만: 아뜰리에의 문서는 질문 하나에 문서 하나이고, 같은 것을 두 곳에 적지 않습니다 → 아뜰리에의 구성
3. 문서
- 문서와 애플리케이션은 서로의 더블입니다. 회계장부의 대변과 차변처럼,
docs/의 내용은 애플리케이션과 하나씩 대응합니다. 애플리케이션에 대응하지 않는 것(일하는 방식, 작업 기준)은docs/에 두지 않고atelier/에 둡니다. 거꾸로 디자인과 설계 문서는 애플리케이션을 빠짐없이 표현해야 합니다(2026-10-17에 나누는 기준을 정하고, 2026-11-18 메인테이너: “내가 생각하는 문서화의 중요한 원칙입니다.”, 2026-11-19 메인테이너: “디자인과 설계는 어플리케이션을 충분히 표현해야합니다.”). docs/는 결과,atelier/는 과정입니다.docs/는 개발된 애플리케이션과 같은 것(지금의 요구사항 · 설계 · 명세)이고, 왜 그렇게 정했는지와 지금 하는 일은atelier/에 있습니다 → [[atelier/README#docs와의-차이|docs/와의 차이]]- 결정은 기록으로 남깁니다. 코드의 구조 · 모델 · 파일 형식 · 기술 선택은 ADR(ADR 목록), 그 밖의 결정(일하는 순서, 조작과 모습, 이름 · 라이선스)은 DR(DR 목록)입니다 → DR-0001. 승인한 기록은 고치지 않고, 바뀌면 새 기록을 씁니다. 작은 조작 · 화면 결정은 따로 기록을 쓰지 않고 UX 결정 모음의 한 항목과 설계 문서의 한 줄로 끝냅니다. ADR은 코드 구조 · 모델 · 파일 형식 · 기술 선택이 바뀔 때만 씁니다(2026-11-21, 변경 하나가 끌고 다니는 문서의 양을 줄이려고).
- 요구사항은 ID를 받습니다.
R-WEB-02처럼 영역과 번호를 붙이고, ID는 바뀌지 않습니다. 철회한 것은 요구사항 변경 기록으로 옮깁니다(2026-10-25) → DR-0016. 우선순위P0~P3은 표의 칸에 그냥 글자로 적습니다. 2026-10-25부터 2026-11-01까지는 Obsidian 태그(#P0)로 달았는데, 메인테이너가 “옵시디언 태그는 문서에 속하는 것이거든요.”라고 해 바꿨습니다. - 정하지 않은 것도 밝힙니다.
docs/에는 아직 설계하지 않은 자리와 정하지 않은 물음을 콜아웃이나 “미결정 사항” 절에 적어, 읽는 사람이 어디까지 정해졌는지 알게 합니다. - 사람이 읽는 형식: 메인테이너는 모든 문서를 Obsidian으로 읽습니다. 그림은 Mermaid나 이미지로 그리고, 상자 그리기 문자의 텍스트 그림은 쓰지 않습니다. 한글 · 이모지의 폭이 Obsidian · GitHub · 사이트마다 달라 줄이 어긋나기 때문입니다(2026-11-01, 메인테이너: “텍스트 그림을 이래서 나는 싫어합니다”). Sequence Diagram에는 activation bar를 넣어 누가 언제 일하는지 보이게 합니다. 그림의 기호와 색의 뜻은 “범례”라고 씁니다(2026-11-18, 메인테이너: “앞으로 문서에 “표기법”은 “범례”로 해주세요.”). 문서의 이름에는 제품 이름이나 상위 폴더의 말머리를 붙이지 않습니다. 사이트가 이 이름을 목록과 탭에 쓰기 때문입니다(2026-10-25). 그리고 같은 문서를 사이트(https://ariadnensd.com/about)에도 펴냅니다 → DR-0013
- 문서의 도구: 제품과 상관없이 이 저장소의 문서를 쓰고 펴내는 데 쓰는 도구입니다.
| 할 일 | 도구 | 자리 |
|---|---|---|
| 문서 읽기 · 편집 | Obsidian(속성, 위키링크, 콜아웃), Mermaid | docs/ atelier/ journal/ til/ |
| 노테이션이 정해진 그림(C&C 뷰) | draw.io. 원본을 내장한 SVG(*.drawio.svg) 하나가 그림이면서 원본이라, draw.io나 Obsidian의 drawio-obsidian 플러그인으로 열어 고칩니다. 처음 그림은 스크립트(journal/assets/2026-11-17-cc-view-build.mjs)로 만들었고 다시 돌리지 않습니다. 노테이션과 배치를 고른 과정은 시안 M58 → sketchbook | docs/03-architecture/assets/ |
| 문서 사이트 | Quartz v4.5.2 (Node 22에서 빌드) | site/, .github/workflows/pages.yml → DR-0013 |
| 문서 검사 훅(2026-11-01부터) · 스파이크 스크립트 | Python 3 | .claude/hooks/doc-check.py, journal/assets/ |
문서에서 쓰는 말
docs/는 아키텍트와 프로그래머의 언어로 씁니다(2026-11-18, 메인테이너: “전체 문서에서 용어의 사용이 어색합니다. 아키텍트나 프로그래머의 언어가 아닙니다.”). 제품 고유의 말(블록, 분기, 접기 영역, 줄, 그림 지문 · 그림 부분 · 그림 요소 · 그림 카탈로그 등)과 화면에 나오는 문구는 예외로, 그대로 둡니다. 아키텍처 · 상세 설계 문서는 03-architecture · 04-design · 05-spec · 07-coding-guide입니다.
| 쓰지 않는 말 | 쓰는 말 | 적용 범위 |
|---|---|---|
| 붙다 | 연동 · 통합 | docs/ 전체 |
| 닿다 | 전달 · 접근 | docs/ 전체 |
| 부르다 | 호출 | docs/ 전체 |
| 들고 있다 | 보유 · 유지 | docs/ 전체 |
| (코드가) 묻다 | 조회 | docs/ 전체 |
| 내놓다 | 제공 · 노출 | docs/ 전체 |
| 떠내다 · 뽑다 | 추출 · 생성 | docs/ 전체 |
| 갈아 끼우다 | 교체 | docs/ 전체 |
| 이야기하다 | 통신 | docs/ 전체 |
| 넘기다 | 전달 | docs/ 전체 |
| 맡다 | 담당 | docs/ 전체 |
| 길 | 경로 | docs/ 전체 |
| 바깥 | 외부 | docs/ 전체 |
| 돌리다 · 돌다 | 실행 | docs/ 전체 |
| 재다 | 측정 | docs/ 전체 |
| 돌려주다 | 반환 | docs/ 전체 |
| 주다 | 전달 | docs/ 전체 |
| 풀다(디코딩 · 압축 해제의 뜻일 때) | 디코딩 | docs/ 전체 |
| 모르다 | 의존하지 않다 | docs/ 전체 |
| 모르는(unknown 값 · 키 · id) | 지원하지 않는 · 정의되지 않은 | docs/ 전체 |
| 알다 | 지원 | docs/ 전체 |
| 보다(검사의 뜻일 때) | 검증 | docs/ 전체 |
| 막다 | 차단(메인 스레드는 블로킹) | docs/ 전체 |
| 잡다 | 검출 | docs/ 전체 |
| 듣다 | 처리 | docs/ 전체 |
| 걸다 | 등록 | docs/ 전체 |
| 싣다 | 포함 | docs/ 전체 |
| 먼저 가져가다 | 선점 | docs/ 전체 |
| 일으키다 | 재현 · 트리거 | docs/ 전체 |
| 가르다 | 구분 | docs/ 전체 |
| 낡다 | 최신 상태가 아님 | docs/ 전체 |
| 겹치다 | 중복 · 충돌 | docs/ 전체 |
| 통째로 바꿔 넣다 | 전체 교체 | docs/ 전체 |
| 덧그리다 | 오버레이 렌더링 | docs/ 전체 |
| 판 | 버전 | docs/ 전체 |
| 덩어리 | 모듈 | docs/ 전체 |
| 조각 | 슬라이스(글꼴) · 청크(번들) | docs/ 전체 |
| 꼴 | 타입 · 형태 | docs/ 전체 |
| 꾸림 | 인코딩 방식 | docs/ 전체 |
| 몫 | 페이로드 · 영역 | docs/ 전체 |
| 낱말 | 토큰 | docs/ 전체 |
| 글 | 레이블 · 텍스트 | docs/ 전체 |
| 짝 | 쌍 | docs/ 전체 |
| 늘 | 항상 | docs/ 전체 |
| 까닭 | 이유 | docs/ 전체 |
| 가짜 · 진짜 | 테스트 더블 · 실제 구현 | docs/ 전체 |
| 시험 | 테스트 | docs/ 전체 |
| 그림 · 그리다 | 렌더링 결과 · 렌더링 | 아키텍처 · 상세 설계 문서 |
| 글자 | 문자 · 텍스트(글자 폭 → 문자 폭) | 아키텍처 · 상세 설계 문서 |
| 자리 | 위치 · 슬롯 | 아키텍처 · 상세 설계 문서 |
| 적다 | 기록 · 기술 · 직렬화(문맥에 따라) | 아키텍처 · 상세 설계 문서 |
4. 그림으로 묻기
말로 견주기 어려운 결정은 글로 묻지 않고 그림으로 묻습니다.
- 시안: 선택지마다 그림과 번호를 붙인 HTML 페이지를 만들어 보여 주고, 메인테이너가 번호로 고릅니다. 기술적으로 될지 모르는 일은 스파이크로, 조작 전체를 써 봐야 아는 일은 프로토타입으로 확인합니다. Claude는 이런 페이지가 필요해 보이면 묻지 않고 먼저 만듭니다. 그림으로 본 시안이 결정에 도움이 됐기 때문입니다(2026-10-09 색상 시안, 2026-10-10 영역 강조 시안).
- 모든 시안 · 스파이크 · 프로토타입은
M01,M02… 의 ID를 받아 sketchbook에 있고, 저장소에 사본을 둡니다. 고른 과정은 시안 페이지에 남기고, 문서에는 결과만 적습니다. - 짧은 선택은 Claude Code의 고르는 창(선택지와 미리보기)으로 묻고, 추천하는 것을 첫째에 둡니다.
5. 코드
- 코드는
src/아래의 pnpm 모노레포입니다 → ADR-0036. 시작하는 법은src/README.md, 규칙은 07-coding-guide입니다. - 설계와 코드가 다르면 둘 중 하나가 틀린 것입니다. 코드를 바꾸면서 설계가 달라지면
docs/도 함께 고칩니다. pnpm check가 타입 검사 · ESLint · Prettier · 의존 방향 · 테스트 · 테스트 목록을 한 번에 봅니다. 통과하지 않으면 커밋하지 않습니다.
6. 테스트
- 테스트를 먼저 설계하고 코드를 썼습니다. 층(단위 · 통합 · E2E)과 무엇을 어디서 확인하는지는 02-test-architecture에 있습니다.
- 테스트마다 ID(
T-0001)를 붙이고, 이름 앞에 확인하는 요구사항 · 품질 속성 시나리오 · 결함의 ID를 적습니다 → DR-0022. 그래서 요구사항이나 시나리오에서 그것을 확인하는 테스트를 찾아갈 수 있습니다. 지금의 테스트 전부는 99-test-list(코드에서 만드는 한국어 목록)에 있습니다. - 버그를 고치면 그 버그를 다시 일으키는 테스트를 먼저 더합니다. 결함은 defects에 ID(
BUG-01)로 남깁니다. - 커버리지(테스트가 실행한 코드 줄의 비율)는 단위 테스트와 E2E를 합쳐 잽니다 → 재는 법은 5. 도구와 CI, 지금의 값은 coverage
7. 올리기 전에 로컬에서 보기
고친 앱과 문서 사이트는 push하기 전에 메인테이너의 PC에서 먼저 봅니다. push하면 사이트에 반영되기까지 몇 분 기다려야 하고, 잘못된 것이 그대로 공개됩니다. 로컬에서 보면 바로 보이고, 고칠 것을 그 자리에서 고칩니다(2026-11-03, 메인테이너).
sequenceDiagram participant M as 메인테이너 participant C as Claude participant L as 로컬 서버 C->>C: 앱이나 문서를 고침 C->>+L: 서버를 띄움 (앱 5173, 사이트 8080) C-->>M: 볼 자리까지의 링크 M->>+L: 브라우저로 열어 봄 L-->>-M: 고친 화면 M->>C: 고칠 것 또는 "좋아요" C->>C: 고치고 다시 보여 줌 M->>C: "마무리" C->>L: 서버를 끔 L-->>-C: C->>C: 커밋하고 push
| 무엇 | 띄우는 법 (src/ 또는 저장소 맨 위에서) | 주소 |
|---|---|---|
| 웹 앱 | cd src && pnpm dev (고치면 바로 반영) | http://localhost:5173/ |
| 문서 사이트 | bash site/build.sh로 앱 · 사용법까지 빌드한 뒤 npx --yes serve@14.2.4 -l 8080 site/.quartz/public | http://localhost:8080/about |
| 문서만 빨리 | bash site/build.sh --serve (웹 앱은 빠짐) | http://localhost:8080/ |
- Claude가 띄웁니다. 메인테이너의 확인이 필요하면 Claude가 서버를 띄우고, 페이지 전체가 아니라 볼 자리까지의 링크(절의 앵커, 예:
http://localhost:8080/docs/03-architecture/02-test-architecture#12-유형과-구성-요소)를 줍니다. - Mermaid 그림은 빌드한 사이트에서 확인합니다. Obsidian과 사이트(Quartz)가 그림을 다르게 그리는 일이 있어서입니다.
- 마무리 때 끕니다. 띄운 서버는 “마무리”할 때 Claude가 끕니다. 테스트와 측정이 쓰는 서버(E2E의 4173, 프로파일의 4174, 커버리지의 4175)는 그 일이 끝나면 저절로 닫히지만, 남아 있으면 그것도 끕니다.
- 고친 것이 앱의 코드라면 테스트(
pnpm check, E2E)를 먼저 통과시킨 뒤 보여 줍니다. 메인테이너는 테스트가 볼 수 없는 것(보기에 어떤지, 쓰기에 편한지)을 봅니다.
8. 커밋과 push
- 커밋은 Claude가 필요할 때마다 묻지 않고 합니다(예: 결정 하나를 반영한 뒤, inbox의 원문을 지키려고). 커밋하지 않은 것은 git으로 되살릴 수 없습니다.
- push는 매듭과 마무리 때만 합니다. push하면 사이트가 다시 빌드되어 공개되기 때문입니다.
- 커밋 메시지는 Conventional Commits 꼴의 머리에 한국어 본문입니다 → DR-0017
9. 정합성 지키기
일이 커지면 같은 사실이 코드와 여러 문서에 흩어집니다. 어긋나지 않게 사람이 기억하는 대신 도구가 알리게 합니다(2026-11-10, 메인테이너: “작업이 커져서 앞으로 문서나 /llms.txt의 정합성이 안 맞을 것이 걱정됩니다.”).
- 원본은 하나: 같은 사실은 한 곳에만 적고, 다른 곳은 빌드가 그것에서 만듭니다.
- 예제는 테스트로: 문서 속 예제는 테스트가 꺼내 실제로 돌립니다. 틀리면
pnpm test가 실패합니다. - 함께 바뀌는 곳은 짝으로: 함께 바뀌어야 하는 코드와 문서의 짝을 표로 두고, 한쪽만 바뀌면 검사가 알립니다.
- 사용자처럼 시험: 출시 전에 새 LLM에게 안내서만 주고 써 보게 합니다.
방법마다의 규칙과 대상은 13. 문서와 코드의 정합성이 원본입니다. 문서의 표와 링크는 문서 검사 훅이 따로 봅니다(3. 문서의 도구). Claude와 에이전트가 커밋할 때는 함께 바뀌는 곳의 훅이 돌아, 짝이 되는 문서를 고치지 않은 커밋을 막습니다(일부러 넘길 때는 커밋 메시지에 까닭을 적음).
10. 함께 일하며 배운 것
- 메인테이너가 Claude Code와 AI와 일하는 법에 대해 배운 것은 learning-claude-code에, 프론트엔드 기술을 묻고 배운 것은
til/(TIL 목록)에 있습니다. - 지나온 전환점은 timeline에 있습니다.