Claude Code 세션 여러 개를 역할별로 나눠서, 토큰을 아끼면서 명세대로 만들고 테스트까지 하는 방법론과, 새 프로젝트에 그대로 복사해 쓰는 파일 묶음.
- 핵심: 같은 영역(레인)의 일은 한 세션이 이어서 하다가, 대화가 무거워지면 인계서를 남기고 새 세션과 교대한다(레인 교대제). 세션끼리는 대화가 아니라 파일로 주고받는다.
- 구성: 역할 6개, 서브에이전트 4개, 스크립트 6개(병렬 판단·검사 요약·영향 찾기·회고 정리·훅 2개), 코드·보안·문서 규칙 양식
- 처음 적용한 프로젝트: SelfAudit
사용자
└─ 총괄 ─ 의도 확인, 세션 배정, 단계 게이트, main 병합
├─ 문서 ─ 명세의 주인: 처음 쓰기 · 변경 요청 · 기록
├─ 설계 ─ 폴더·코드 표준·보안·계약 + 기술 검토
├─ 관제 ─ Taskmaster: 분해·의존성·병렬 판단
├─ 레인 ×N ─ 영역별 구현, 명세 예시 테스트 먼저
└─ 검증 ─ 합친 결과 검사·보안 리뷰·명세 대조
| 파일 | 누가 읽나 | 내용 |
|---|---|---|
| 방법론.md | 사람 | 원칙, 역할, 흐름도, 레인 교대제, 토큰·정확도·보안·편의 장치 |
| 적용하기.md | 사람 | 새 프로젝트·기존 프로젝트에 넣는 순서, 시범 운영, 첫날 확인, 문제 해결 |
template/ |
세션 | 새 프로젝트 맨 위에 복사하는 운영 파일 |
tests/ |
사람 | 스크립트 테스트 |
| 경로 | 내용 |
|---|---|
CLAUDE.md |
모든 세션 공통 규칙 (짧게) |
.claude/settings.json |
.env·백업 읽기 금지 + 훅 2개 (레인 울타리, 자동 요약 뒤 교대 알림) |
.claude/rules/ |
경로 규칙 6개(코드-공통, 코드-서버, 코드-화면, 보안코딩, 테스트, 명세작성): 해당 파일을 열 때만 읽힌다 |
.claude/agents/ |
서브에이전트 task-planner, security-reviewer, spec-checker, doc-recorder |
.taskmaster/CLAUDE.md |
Taskmaster 명령 (쓰기는 관제만) |
docs/00_지도.md |
세션이 시작할 때 읽는 프로젝트 지도 (폴더·레인·파일 주인·명령) |
docs/코드규칙.md |
코드 표준 양식: 폴더·모듈 표, 계층, 공통 규칙, 테스트, git, 도구 설정 기본값, 세 겹 대응표 (설계가 채움) |
docs/보안규칙.md |
보안 기준 양식: 데이터 등급, 비밀값, 입력·출력, 공급망, AI 에이전트(LLM Top 10 2025), OWASP Top 10:2025 대응표, 점검표 (설계가 채움) |
docs/문서규칙.md |
명세 쓰는 형식: ID 체계, 기능 절 형식, 예시 쓰는 법, 변경 이력 (문서가 채움) |
docs/결정기록.md |
결정의 이유와 이력 |
ops/역할/ |
역할 카드: 총괄, 문서, 설계, 관제, 레인, 검증 |
ops/양식/ |
배정문, 보고서, 인계서, 변경요청(CR) |
ops/보드.md |
총괄의 현황판 |
ops/모델표.md |
역할별 모델·노력 기준표 (총괄이 세션을 열 때 자동 적용) |
ops/회고/ |
역할별 '문제와 개선' 기록 (<역할>.md, 프로젝트에서 생김) |
ops/checks.json |
검사 명령 목록 (설계가 프로젝트에 맞춤) |
ops/측정.csv |
태스크별 측정 |
ops/scripts/ |
tm_parallel.py(병렬 판단), check.py(검사 요약), impact.py(기능 ID 영향 찾기·새 번호), retro.py(문제와 개선 자동 정리 → docs/회고.md), hook_fence.py, hook_compact.py, oplib.py |
.gitignore |
.lane.json, .ops-logs/, worktree 폴더 등 |
- 새 프로젝트 폴더에서
git init,task-master init template/안의 것을 프로젝트 맨 위로 복사 (숨김 파일 포함)- 총괄 세션을 열고:
역할: 총괄. ops/역할/총괄.md를 읽고 시작한다. - 문서 세션과 명세(단계 1) → 설계 검토 → 설계가 기반(단계 2)
- 관제가 태스크를 만들면 "다음"이라고 말한다
- 중간에 기능을 더하거나 바꾸고 싶으면 총괄에게 "추가하자 / 바꾸자 / 빼자: …" (변경 요청)
자세한 순서는 적용하기.md.
키트 폴더에서:
python -m unittest discover -s tests -v2026-11-17 기준 31개 통과 (Python 3.13). 표준 라이브러리만 쓰므로 설치할 것이 없다.