My Dev Team
사용자가 기능 설명을 입력하면, 4명의 에이전트가 순차적으로 실행되어 PRD → 설계 → 코드 → 리뷰까지 자동으로 완성한다.
팀 구성
| 에이전트 | 역할 | 출력물 |
|---|---|---|
| 🧑💼 PM | 요구사항 분석 + PRD 작성 | docs/PRD.md |
| 🏗️ 아키텍트 | 기술 설계 + 파일 구조 설계 | docs/ARCH.md |
| 👨💻 개발자 | 코드 구현 | 코드 파일들 |
| 🔍 리뷰어 | 코드 리뷰 + 개선 | docs/REVIEW.md + 수정 코드 |
실행 전 준비
스킬이 트리거되면:
- 사용자 입력에서 기능 설명을 추출한다.
- 기능 설명이 없으면 AskUserQuestion으로 질문한다:
어떤 기능을 만들까요? 간단히 설명해주세요. 예) "사용자가 URL을 입력하면 스크린샷을 찍어서 저장하는 기능" - 작업 디렉토리와
docs/폴더가 없으면 생성한다.
실행 흐름
[입력] 기능 설명
↓
[1단계] PM 에이전트 → PRD.md 생성
↓
[PRD 검증] 필수 섹션 확인 → 실패 시 PM 재실행 (1회)
↓
[2단계] 아키텍트 에이전트 → ARCH.md 생성
↓
[ARCH 검증] 필수 섹션 확인 → 실패 시 아키텍트 재실행 (1회)
↓
[3단계] 개발자 에이전트 → 코드 파일 생성
↓
[코드 검증] 파일 생성 확인 → 실패 시 개발자 재실행 (1회)
↓
[4단계] 리뷰어 에이전트 → REVIEW.md + 코드 수정
↓
[최종 보고] 생성 파일 목록 + 요약 출력각 에이전트 실행 방법
각 에이전트는 Task 도구로 실행한다. 아래 프롬프트를 그대로 사용한다.
🧑💼 1단계: PM 에이전트
Task(
description="PM: PRD 작성",
prompt="""
너는 시니어 PM이다. 아래 기능 설명을 바탕으로 PRD.md를 작성하라.
기능 설명: {feature_description}
PRD.md 형식:
# PRD: {기능명}
## 배경
왜 이 기능이 필요한지 2-3문장으로 설명
## 기능 요구사항
- 핵심 기능 목록 (5개 이내)
- 각 기능은 구체적이고 측정 가능하게
## 비기능 요구사항
- 성능, 보안, 호환성 등
## 성공 기준
- 이 기능이 성공했다고 판단하는 기준 (측정 가능)
## 범위 외 (Out of Scope)
- 이번에 구현하지 않는 것
완성된 PRD를 docs/PRD.md 파일로 저장하라.
""",
subagent_type="general-purpose"
)🏗️ 2단계: 아키텍트 에이전트
Task(
description="아키텍트: ARCH 설계",
prompt="""
너는 시니어 소프트웨어 아키텍트다. docs/PRD.md를 읽고 기술 설계서(ARCH.md)를 작성하라.
ARCH.md 형식:
# Architecture: {기능명}
## 컴포넌트 구조
- 주요 컴포넌트와 역할 설명
## 파일 구조feature/ ├── main.py # 메인 로직 ├── utils.py # 유틸리티 └── README.md # 사용법
## 구현 계획
1단계: ...
2단계: ...
## 기술 스택
- 언어, 라이브러리, 의존성
## 인터페이스
- 입력/출력 정의
완성된 ARCH.md를 docs/ARCH.md 파일로 저장하라.
""",
subagent_type="general-purpose"
)👨💻 3단계: 개발자 에이전트
Task(
description="개발자: 코드 구현",
prompt="""
너는 시니어 개발자다. docs/PRD.md와 docs/ARCH.md를 읽고 실제 코드를 구현하라.
규칙:
- ARCH.md의 파일 구조를 그대로 따른다
- 각 파일에 간단한 주석을 달아 역할을 설명한다
- 에러 처리를 포함한다
- 실제로 실행 가능한 코드를 작성한다
- README.md에 설치 방법과 사용법을 작성한다
모든 파일을 생성하라.
""",
subagent_type="general-purpose"
)🔍 4단계: 리뷰어 에이전트
Task(
description="리뷰어: 코드 리뷰 + 개선",
prompt="""
너는 시니어 코드 리뷰어다. docs/PRD.md를 기준으로 생성된 코드를 검토하고 개선하라.
리뷰 기준:
1. PRD 요구사항이 모두 구현됐는가?
2. 코드가 실제로 실행 가능한가?
3. 에러 처리가 적절한가?
4. 코드 가독성
결과물:
- docs/REVIEW.md: 리뷰 결과 (PASS/FAIL + 이슈 목록)
- 문제가 있는 코드는 직접 수정한다
REVIEW.md 형식:
# Code Review Report
## 판정: PASS / FAIL
## 체크리스트
- [ ] PRD 요구사항 충족
- [ ] 코드 실행 가능
- [ ] 에러 처리
## 발견된 이슈
| 심각도 | 파일 | 문제 | 수정 방법 |
## 수정 완료 내역
수정한 내용 목록
""",
subagent_type="general-purpose"
)검증 로직
PRD 검증
PRD.md 파일을 읽어서 아래 키워드가 있는지 확인한다:
배경또는Background기능 요구사항또는Requirements성공 기준또는Success Criteria
셋 중 하나라도 없으면 PM 에이전트를 재실행한다.
ARCH 검증
ARCH.md 파일을 읽어서 아래 키워드가 있는지 확인한다:
컴포넌트또는Component파일 구조또는File Structure구현 계획또는Implementation
셋 중 하나라도 없으면 아키텍트 에이전트를 재실행한다.
코드 검증
ARCH.md의 파일 구조 섹션에서 파일명을 추출하고, 실제로 파일이 존재하는지 확인한다. 파일이 없으면 개발자 에이전트를 재실행한다.
최종 보고 형식
✅ 개발 완료!
📁 생성된 파일:
docs/PRD.md — 기획서
docs/ARCH.md — 아키텍처 설계
docs/REVIEW.md — 리뷰 결과
feature/main.py — 메인 코드
feature/utils.py — 유틸리티
feature/README.md — 사용법
📋 리뷰 결과: PASS (이슈 2건 수정 완료)
⏱️ 소요 단계: 4단계 완료사용 예시
입력 예시:
"URL을 입력받아 스크린샷 찍는 기능 만들어줘"→/dev-team트리거"Slack 메시지를 CSV로 내보내는 기능 개발팀으로 만들어줘""로그인 API 에이전트팀으로 만들어줘"
주의사항
- 각 에이전트는 독립적으로 실행된다 (서로 직접 대화 불가)
- 에이전트 간 소통은 파일(PRD.md, ARCH.md)을 통해 이루어진다
- 오케스트레이터(Claude)가 각 단계 결과를 검증하고 다음 에이전트에게 전달한다
- 재실행은 각 단계당 최대 1회로 제한한다 (무한 루프 방지)