.claude/ 아래의 마크다운
오케스트레이션
웨이브를 실행하고 팀원을 스폰·검수·종료하는 슬래시 커맨드, 역할, 훅. 당신의 메인 Claude Code 세션인 리드가 이를 이끕니다.
βάθος, 그리스어로 “깊이, 심연”.
AI에 완결된 제품 팀의 깊이를 더하세요.
BATHOS는 하나의 Claude Code 세션을 규율 있는 팀으로 바꿉니다. 7웨이브 파이프라인을 가로지르는 17개 전문 역할, 규모 적응형 라우팅, 강제 품질 게이트를 결정론적 Rust 엔진이 뒷받침합니다.
v0.2.0 · Rust 엔진 · Claude Code에서 구동
세 단계로 설치
엔진을 빌드하고, 훅이 엔진을 찾도록 연결한 뒤, Claude Code에서 파이프라인을 실행하세요.
01
엔진 빌드
저장소를 클론하고 단일 Rust 바이너리를 컴파일합니다.
git clone <your-fork-url> bathos && cd bathos
cd core && cargo build --release && cd ..02
훅에 연결
BATHOS_BIN을 설정해 커맨드와 훅이 엔진을 찾게 합니다.
export BATHOS_BIN="$(pwd)/core/target/release/bathos"03
파이프라인 실행
프로젝트에서 Claude Code를 열고 웨이브 커맨드를 순서대로 실행합니다.
/team-kickoff
/route /abs/path/to/project
/wave1-discovery /abs/path
/wave2-design /abs/path
/wave3-story-gate /abs/path
/wave5-implement /abs/path
/wave6-verify-report /abs/path
/team-confirmAgent Teams가 켜진 Claude Code v2.1.32 이상, 그리고 Rust 툴체인과 jq가 필요합니다.
대화에는 없는 구조를
긴 LLM 대화 하나는 흐트러집니다. 설계와 구현 사이에서 맥락이 사라지고, 검증은 생략되며, 같은 모델이 스스로 작성하고 스스로 승인합니다. BATHOS는 이를 구조로 대체합니다.
일반 LLM 대화
BATHOS
하나의 대화, 점점 흐트러지는 맥락
7웨이브 파이프라인을 가로지르는 17개 전문 역할
설계와 구현 사이에서 사라지는 맥락
무손실 맥락, 자족적 스토리 파일 (Wave 3)
암묵적이고 획일적인 노력 배분
Lv0–4를 명시하는 규모 적응형 라우터
구현이 아무 때나 시작됨
FAIL 시 빌드 진입을 물리적으로 차단하는 강제 준비도 게이트
작성자가 자기 작업을 스스로 “검증”
독립 리뷰어와 변조 감지 감사 체인
당신을 슬며시 뒤엎는 조언
사용자 주권: AI는 제안하고, 결정은 당신이
두 개의 층위, 하나의 런타임
대부분은 슬래시 커맨드를 입력할 뿐입니다. 그 커맨드가 내부에서 호출하는 결정론적 코어가 단일 Rust 바이너리입니다.
단일 정적 Rust 바이너리
엔진
상태, 게이트, 웨이브 전환, 라우팅, 스토리 신선도, 플러그인을 계산하고 강제합니다. 훅과 커맨드가 자동으로 호출합니다.
7웨이브 딜리버리 파이프라인
작업은 명시적 웨이브를 거쳐 디스커버리에서 검증된 릴리스까지 이동합니다. 본류는 W0 → W1 → W2 → W3 → W5 → W6이며, IP·연구(W4)는 핵심 경로 밖의 선택 플러그인입니다.
W0
분석
Caleb
선택적 사전 브리프. 브레인스토밍, 아이디어 벼리기, 제품 브리프.
W1
디스커버리 & 시장
John · Caleb
리버스 엔지니어링과 시장 리서치로 USP를 벼립니다.
W2
기획 · 아키텍처 · 디자인
Joshua → James · Jonnathan
기획이 웨이브를 게이트한 뒤, 아키텍처와 UX를 병렬로.
W3
스토리 엔지니어링
Matthew + Thomas · Matthias
자족적 스토리 파일로 응축하는 구현 준비도 게이트.
W4
IP & 연구
Mark · Nathanael
핵심 경로 밖의 선택 플러그인(특허와 논문).
W5
구현
Phillip · Andrew · Stephen
스토리 파일을 기준으로 백엔드, 프론트엔드, ML을 빌드.
W6
검증 · 문서 · 리포트
Thomas · Michael · Hananiah · Martin
리뷰, 보안 감사, 동작 보존 리팩토링, 릴리스 리포트.
Wave 3 — 심장
Wave 3은 설계와 빌드 사이의 간극을 닫습니다. 스토리 엔지니어가 상류 작업을 자족적 스토리 파일로 응축하고, 모든 기술적 주장에 출처를 태깅하며, 독립 리뷰어가 승인하고, FAIL 시 훅이 구현 진입을 물리적으로 차단합니다.
규모 적응형 라우팅
BATHOS는 작업에 필요한 웨이브만 가동합니다. 라우터가 네 개의 stakes 축에서 레벨을 추천하고, 당신이 확정합니다.
| 레벨 | 작업 유형 | 가동 웨이브 |
|---|---|---|
| Lv0 | 버그 수정 / 사소한 변경 | W5 (+ 최소 W6) |
| Lv1 | 소기능 / 국소 리팩터 | 경량 W2 + W3(축약) + W5 + 경량 W6 |
| Lv2 | 표준 기능 / 모듈 | W1 + W2 + W3 + W5 + W6 |
| Lv3 | 신규 제품 / 대형 | W0–W6 (W4 선택) |
| Lv4 | 엔터프라이즈 / 딥테크 / 규제 | W0–W6 전체 + W4 |
17명의 전문가, 한 명의 리드
리드는 당신의 메인 세션이며 결코 스폰되지 않습니다. 전문가는 웨이브별로 스폰되며, 동시성은 최대 3으로 제한됩니다.
00Paul리드 / 최종 confirmall
01John리버스 스페셜리스트W1
02Caleb시장 분석 / USPW1
03Joshua서비스 기획W2
04JamesSW / 클라우드 아키텍트W2
05MarkIP 스페셜리스트 (특허)W4
06Nathanael리서치 라이터W4
07Jonnathan수석 디자이너 (UX/UI)W2
08Phillip백엔드 & 데이터 리드W5
09Andrew프론트엔드 & 모바일 리드W5
10StephenAI / ML 리드W5
11Timothy개발 정의 문서화W6
12Thomas코드 리뷰어W6
13Michael보안 스페셜리스트W6
14Hananiah리팩토링 스페셜리스트W6
15MatthiasQA / 검증W6
16Martin모니터링 / 리포트W6
17Matthew스크럼 마스터 / 스토리 엔지니어W3
정말로 게이트하는 게이트
모든 웨이브 게이트는 하나의 어휘로 말하며, 핵심 게이트는 코드로 강제됩니다. 근거 없는 자동 통과는 없습니다.
PASS
기준 충족, 블로커 없음
다음 웨이브로 진입
CONCERNS
조건부 통과, 비차단 리스크
리스크를 기록한 뒤 진행
FAIL
차단 결함
진입 차단, 보완 후 재게이트
설계부터 변조 감지
모든 상태 변경은 키 기반 감사 해시 체인(HMAC-SHA256)에 기록됩니다. 단일 커맨드 bathos audit verify로 이력이 변경되지 않았음을 증명합니다.
감이 아니라 결정론적 코어
핵심 불변식(상태, 게이트, 라우팅, 스토리 신선도)은 단일 정적 Rust 바이너리에 있어, 언제나 동일한 방식으로 계산되고 강제됩니다.
- 단일 정적 바이너리
- 런타임 의존성 없는 컴팩트한 bathos 실행 파일 하나.
- 스키마 검증 SSOT
- manifest.json이 진실의 원천입니다. 스키마 검증과 원자적 쓰기.
- 변조 감지 감사
- 커맨드 하나로 검증하는 키 기반 HMAC 해시 체인.
- 검증됨
- 510개 Rust 테스트 + 86개 훅 결정성 검사 전부 통과, clippy 클린.
$ echo '{"scope":"feature","novelty":true}' \
| bathos --state-dir _state route decide
→ {"recommended_level":2,"requires_confirmation":true}stakes로부터 레벨을 추천합니다. 엔진이 제안하고, 당신이 확정합니다.