| name | subagent-dev |
| description | Execute implementation plans using fresh subagents per task with two-stage review (spec compliance + code quality). Use when executing multi-task plans with independent work units. Enhances ralph-loop methodology. |
| metadata | {"author":"misskim","version":"1.0","origin":"Concept from obra/superpowers subagent-driven-development, adapted for Clawdbot sessions_spawn"} |
Subagent-Driven Development
구현 계획을 서브에이전트 단위로 실행, 2단계 리뷰.
ralph-loop와의 관계
이 스킬은 ralph-loop의 "서브에이전트로 1태스크씩" 원칙을 강화한다:
- ralph-loop = 전체 프로세스 (specs → plan → implement → test)
- subagent-dev = implement 단계의 실행 패턴
프로세스
계획 읽기 → 태스크 전체 추출
↓
[태스크마다 반복]
1. 구현 서브에이전트 디스패치 (태스크 전문 + 맥락)
├─ 질문 있으면? → 답변 후 재디스패치
└─ 구현 + 테스트 + 커밋 + 셀프리뷰
2. 스펙 검증 서브에이전트 디스패치
├─ 스펙 불일치? → 구현자가 수정 → 재검증
└─ 통과
3. 코드 품질 리뷰 서브에이전트 디스패치
├─ 품질 이슈? → 구현자가 수정 → 재리뷰
└─ 승인
4. 태스크 완료 표시
↓
전체 완료 → 최종 코드 리뷰 → 브랜치 마무리
2단계 리뷰의 핵심
Stage 1: 스펙 검증
- 코드가 요구사항과 일치하는가?
- 빠진 기능은? 추가된 불필요 기능은?
- 스펙에 명시된 모든 항목이 구현됐는가?
Stage 2: 코드 품질
- 중복 코드? 네이밍? 타입 커버리지?
- 에러 처리? 엣지 케이스?
- 성능 이슈? 보안 이슈?
왜 2단계?
- 스펙 검증 = "맞는 것을 만들었는가?" (What)
- 코드 품질 = "잘 만들었는가?" (How)
- 하나의 리뷰에 합치면 둘 다 놓치기 쉬움
서브에이전트 프롬프트 구조
구현자 프롬프트
## 태스크
[계획에서 추출한 태스크 전문]
## 맥락
[관련 파일, 아키텍처, 제약 조건]
## 제약
- 이 태스크 범위만 수정
- TDD: 테스트 먼저, 구현 후
- 커밋 메시지 작성
- 셀프리뷰 결과 포함
## 출력
- 구현 요약
- 테스트 결과
- 셀프리뷰 발견사항
스펙 리뷰어 프롬프트
## 원본 스펙
[태스크 요구사항 전문]
## 검증 대상
[구현된 코드의 git diff 또는 파일 목록]
## 체크리스트
- 모든 요구사항 구현됐는가?
- 불필요한 추가 기능은?
- 엣지 케이스 처리?
장점
- 신선한 컨텍스트: 태스크별 새 서브에이전트 = 오염 없음
- 품질 게이트: 2단계 리뷰로 이중 검증
- 속도: 컨트롤러가 태스크 맥락을 사전 준비
- 질문 가능: 서브에이전트가 모호한 점을 질문
비용
- 태스크당 3회 서브에이전트 (구현 + 스펙리뷰 + 품질리뷰)
- 컨트롤러의 준비 작업 필요
- 리뷰 루프 시 추가 호출
결론: 비용 대비 품질 이득이 크다. 특히 중요한 기능 구현 시 필수.
