프로젝트 팀
세 가지 역할. 아래의 공유 규칙을 읽은 후, 자신의 역할 파일만 읽으십시오:
- 브레인스토밍: "너는 브레인스토밍 에이전트야" → brainstorm.md
- 코디네이터: "너는 코디네이터야" → coordinator.md. 별도 세션, 번호를 붙이지 않음.
- 파트 N: "너는 파트 N이야" (역시 "task N", "agent N") → worker.md
<repo> = 폴더 ~/<repo>; <proj> = 세션 이름에 사용되는 짧은 이름(보통 동일). <NN> = 두 자리 파트 번호.
스킬 파일: ~/.claude/skills/project-team/ (templates/, scripts/tokens.sh 세션별 토큰, scripts/patrol.sh 코디네이터 순찰).
사용자의 멀티 에이전트 프로젝트 실행 경험을 바탕으로 구축됨 (2026-10).
프로젝트 레이아웃 (브레인스토밍이 생성)
CLAUDE.md 3줄 포인터만 (templates/CLAUDE_pointer.md)
.claude/settings.json {"crossSessionInbound": "accept"} ← 세션은 메시지를 수신할 수 있음
docs/INTERFACES.md 파트 간의 계약; git에 포함됨; 코드와 동일한 커밋에서 변경됨
team/ 조정 상태; `/team/`은 gitignore 처리됨; 오직 ~/<repo>/team에만 존재
TEAM.md 프로젝트 사실, 읽기 순서, 코디네이터 권한, 프로젝트별 규칙
SCOPE.md 목표 · 사용자 결정 (날짜 포함) · 제안된 기본값 · 범위 외
PARTS.md 파트 테이블 · 디스패치 테이블 · 흐름도 · 웨이브
parts/P<NN>_<name>.md 파트별 브리프 각 1개
STATUS.md 파트당 한 행 · 사용자 필요 · 최근 10개 마일스톤
REQUESTS.md 사용자의 요청/버그 리포트, 사용자 언어, 소유자, 상태
ISSUES.md 파트 간 버그 · DECISIONS.md 편차 · log/P<NN>.md 파트별 노트
research/NN_<topic>.md · launch.sh (tmux의 이름이 있는 세션, 선택 사항)
워크트리에는 team/이 없음: 항상 절대 경로 ~/<repo>/team/... 사용.
공유 규칙 (모든 역할)
이름은 주소입니다. <proj> coordinator, <proj> part N; 해당 정확한 이름으로 SendMessage 하십시오. 에이전트는 스스로 이름을 바꿀 수 없습니다: ListAgents의 첫 줄("이 세션은 ...입니다")이 자신의 이름이 아니라면, 사용자에게 한 번 물어보십시오: "/rename <proj> part N 해주세요", 그동안 계속 읽으십시오.
누군가 행동해야 할 때만 메시지를 보냅니다. 태그 하나, 첫 번째 단어:
| 태그 | 발신자 → 수신자 | 사용 시점 |
|---|---|---|
DONE P3.2 <sha> | 파트 → 코디네이터 | 디스패치에 명시된 어떤 단계가 필요하거나, 전체 파트가 완료되어 병합됨. 마일스톤은 오직 여기에만 기록 |
START P4.2 | 코디네이터 → 파트 | 해당 단계의 모든 필요 사항이 병합됨 |
STOP / RESUME | 코디네이터 → 파트 | 실행 제어 |
REQ R7 <사용자 말> / DONE R7 <sha> | 코디네이터 ↔ 소유 파트 | 사용자 요청 라우팅 / 완료 |
DECISION <사용자 말> | 코디네이터 → 영향받는 파트; 사용자가 파트에게 말한 경우 파트 → 코디네이터 | 사용자가 무언가 결정함 |
ISSUES N | 파트 → 소유 파트 | ISSUES.md에 N개의 새 줄을 당신을 위해 일괄 추가 |
IFACE | 파트 → 영향받는 파트 | INTERFACES.md의 계약이 해당 파트 아래에서 변경됨 |
BLOCKED | 파트 → 코디네이터 | 진행할 수 없고 임시 방편도 없음 (그 외에는 Need user 행, 메시지 없음) |
ASK | 누구 → 누구 | 답변 필요; 답변을 받는 유일한 태그 |
- 원시적, ≤2줄, ≤300자, 사실을 먼저. 파일/커밋을 가리키고, 설명하지 마십시오.
ASK가 아니면 답변하지 마십시오. 절대 승인, 감사, "알겠습니다", "지금 시작", 진행 상황, "모두 괜찮음" 같은 말을 하지 마십시오.- 기록할 가치가 있으면 → 디스크에 기록(STATUS 행, 로그, ISSUES, DECISIONS), 메시지로 보내지 마십시오.
- 대기: 당신의 차례를 끝내십시오. 폴링이나 수면 루프 금지; 메시지가 당신을 깨웁니다.
- 에이전트 표류(수다, 승인, 범위 이탈): 한 줄 알림, 한 번.
공유 파일. 여러 에이전트가 team/을 작성합니다: STATUS/REQUESTS는 Edit 도구로만 변경하십시오(오래된 쓰기는 거부됨; 다시 읽고 재시도), ISSUES/DECISIONS에는 >>로 추가하십시오. sed -i나 Write로 덮어쓰지 마십시오.
사용자에게는 코디네이터를 통해서만 질문하며, 일괄 처리되고 번호가 매겨집니다. 파트는 사용자를 절대 차단하지 않으며 AskUserQuestion을 사용하지 않습니다: STATUS에 Need user 행(- [ ] P3: 질문; 사용된 임시 방편; 영향), 브리프의 제안을 사용하고, DECISIONS.md에 기록하고, 계속 진행하십시오.
모든 역할은 리드입니다. 광범위한 읽기, 코딩, 긴 테스트 → 원시적인 브리프(범위, 편집 가능한 절대 경로, 완료 기준), ≤100단어 보고서, 긴 출력은 파일로 하는 서브 에이전트를 사용하십시오. 동시 서브 에이전트는 같은 파일을 절대 편집하지 않습니다; 공유 레지스트리/인덱스 파일은 리드만 편집합니다.
공유 머신. 당신이 시작한 PID만 종료하십시오(한 파트의 pkill -f vite가 모든 사람의 서버를 죽였습니다). 당신의 포트 범위만 사용하십시오. GPU 사용 전 nvidia-smi. ListAgents만으로 다른 에이전트가 죽었다고 선언하지 마십시오(ps, tmux, 트랜스크립트 mtime 확인); 사용자 없이 다른 에이전트의 작업이나 프로세스를 죽이거나 인수하지 마십시오. 누군가 사용 중일 수 있는 서비스(사용자 재생, 데모)를 재시작하지 마십시오(유휴 상태인지 확인). 자동 모드가 명령을 차단하면 → 재시도하거나 우회하지 마십시오; Need user 행; 다음으로 넘어가십시오. 사용자의 글로벌 규칙은 여전히 적용됩니다.
STOP: 현재의 작은 액션을 완료하고, 서브 에이전트와 개발 서버를 중단하고(프로덕션/라이브 서비스는 유지), 당신의 브랜치에 WIP을 커밋하고(절대 main에 하지 않음), 로그에 "X에서 중단됨, 다음 Y", 행에 stopped, 차례를 종료하십시오. RESUME / 압축 후: TEAM.md(규칙이 변경되었을 수 있음), 당신의 로그, 당신의 행, git status를 다시 읽으십시오; 계속하십시오.