Skip to content

About

Claude Code 다중 세션 분업 방법론 키트 - 역할 카드, 양식, 훅, 스크립트 (레인 교대제)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

Repository files navigation

SessionKit — 세션 분업 방법론 키트

Claude Code 세션 여러 개를 역할별로 나눠서, 토큰을 아끼면서 명세대로 만들고 테스트까지 하는 방법론과, 새 프로젝트에 그대로 복사해 쓰는 파일 묶음.

  • 핵심: 같은 영역(레인)의 일은 한 세션이 이어서 하다가, 대화가 무거워지면 인계서를 남기고 새 세션과 교대한다(레인 교대제). 세션끼리는 대화가 아니라 파일로 주고받는다.
  • 구성: 역할 6개, 서브에이전트 4개, 스크립트 6개(병렬 판단·검사 요약·영향 찾기·회고 정리·훅 2개), 코드·보안·문서 규칙 양식
  • 처음 적용한 프로젝트: SelfAudit
사용자
 └─ 총괄  ─ 의도 확인, 세션 배정, 단계 게이트, main 병합
     ├─ 문서   ─ 명세의 주인: 처음 쓰기 · 변경 요청 · 기록
     ├─ 설계   ─ 폴더·코드 표준·보안·계약 + 기술 검토
     ├─ 관제   ─ Taskmaster: 분해·의존성·병렬 판단
     ├─ 레인 ×N ─ 영역별 구현, 명세 예시 테스트 먼저
     └─ 검증   ─ 합친 결과 검사·보안 리뷰·명세 대조

들어 있는 것

파일 누가 읽나 내용
방법론.md 사람 원칙, 역할, 흐름도, 레인 교대제, 토큰·정확도·보안·편의 장치
적용하기.md 사람 새 프로젝트·기존 프로젝트에 넣는 순서, 시범 운영, 첫날 확인, 문제 해결
template/ 세션 새 프로젝트 맨 위에 복사하는 운영 파일
tests/ 사람 스크립트 테스트

template/ 안

경로 내용
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 폴더 등

빠른 시작

  1. 새 프로젝트 폴더에서 git init, task-master init
  2. template/ 안의 것을 프로젝트 맨 위로 복사 (숨김 파일 포함)
  3. 총괄 세션을 열고: 역할: 총괄. ops/역할/총괄.md를 읽고 시작한다.
  4. 문서 세션과 명세(단계 1) → 설계 검토 → 설계가 기반(단계 2)
  5. 관제가 태스크를 만들면 "다음"이라고 말한다
  6. 중간에 기능을 더하거나 바꾸고 싶으면 총괄에게 "추가하자 / 바꾸자 / 빼자: …" (변경 요청)

자세한 순서는 적용하기.md.

스크립트 테스트

키트 폴더에서:

python -m unittest discover -s tests -v

2026-11-17 기준 31개 통과 (Python 3.13). 표준 라이브러리만 쓰므로 설치할 것이 없다.

About

Claude Code 다중 세션 분업 방법론 키트 - 역할 카드, 양식, 훅, 스크립트 (레인 교대제)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages