| name | spawn-commit |
| description | 빌드 성공 후 commit-agent를 활용하여 커밋 생성 |
| allowed-tools | Task, Read |
Commit Agent 활용 가이드
빌드 성공 후 commit-agent를 사용하여 변경사항을 커밋하는 방법입니다.
핵심 원칙
빌드 성공 후에만 커밋합니다.
builder-agent가 성공적으로 완료된 후 commit-agent를 spawn합니다.
언제 사용하나?
- builder-agent 빌드 성공 후
- Step 완료 시점
- 테스트 통과 후
사전 조건
- coder-agent: COMPLETED
- builder-agent: COMPLETED (빌드 성공)
Spawn 방법
1. 빌드 성공 확인
builder-agent 결과 확인:
## builder-agent 결과
- 상태: COMPLETED
- 빌드: 성공
- 테스트: 통과
2. Spawn 실행
반드시 Task tool을 사용합니다. Bash 명령어로 실행하지 마세요.
Task tool 호출:
subagent_type: "commit-agent"
run_in_background: true
prompt: |
다음 작업을 수행해줘:
TASK-ID: TASK-001
Step: Step 2
변경 파일:
- src/auth/login.ts
- src/middleware/auth.ts
Step 설명: 사용자 인증 미들웨어 구현
.claude/agents/commit-agent.md 의 지시를 따르고,
작업 완료 후 결과만 요약해서 보고해줘."
3. 결과 대기
commit-agent 결과 확인:
- COMPLETED: 커밋 성공
- FAILED: 커밋 실패
정보 전달 항목
commit-agent에 전달해야 할 정보:
| 항목 | 설명 | 예시 |
|---|---|---|
| TASK-ID | Task 식별자 | TASK-001 |
| Step | 완료된 Step 번호 | Step 2 |
| 변경 파일 | 수정된 파일 목록 | src/auth/*.ts |
| Step 설명 | 작업 내용 요약 | 인증 미들웨어 구현 |
결과 처리
성공 시
## commit-agent 결과
- 상태: COMPLETED
- 커밋 해시: abc1234
- 커밋 메시지: [TASK-001] Add user authentication middleware
- 커밋된 파일:
- src/auth/login.ts
- src/middleware/auth.ts
→ test-case-agent로 테스트 케이스 생성 진행
실패 시
## commit-agent 결과
- 상태: FAILED
- 에러: pre-commit hook 실패
- 상세: ESLint 에러 발견
→ 에러 원인 분석 후 coder-agent에 수정 요청
워크플로우 통합
coder-agent (코드 작성)
↓
builder-agent (빌드/테스트)
↓ [성공 시]
commit-agent (커밋 생성) ← 이 시점
↓
test-case-agent (테스트 케이스 생성)
주의사항
- 순서 준수: 반드시 builder-agent 성공 후 실행
- 민감 정보 확인: commit-agent가 민감 파일 제외하는지 확인
- 커밋 메시지 검증: TASK-ID 포함 여부 확인
- 실패 시 롤백: 커밋 실패 시 다음 Step으로 진행하지 않음