When the user enters a feature description, the 4 agents run sequentially and automatically complete everything from PRD → design → code → review.
Team composition
| Agent | Role | Output |
|---|---|---|
| 🧑💼 PM | Requirements analysis + PRD writing | docs/PRD.md |
| 🏗️ Architect | Technical design + file structure design | docs/ARCH.md |
| 👨💻 Developer | Code implementation | Code files |
| 🔍 Reviewer | Code review + improvement | docs/REVIEW.md + revised code |
Preparation before execution
When the skill is triggered:
- From the user input, extract the feature description.
- If there is no feature description, ask via AskUserQuestion:
어떤 기능을 만들까요? 간단히 설명해주세요. 예) "사용자가 URL을 입력하면 스크린샷을 찍어서 저장하는 기능" - If the working directory and the
docs/folder do not exist, create them.
Execution flow
[입력] 기능 설명
↓
[1단계] PM 에이전트 → PRD.md 생성
↓
[PRD 검증] 필수 섹션 확인 → 실패 시 PM 재실행 (1회)
↓
[2단계] 아키텍트 에이전트 → ARCH.md 생성
↓
[ARCH 검증] 필수 섹션 확인 → 실패 시 아키텍트 재실행 (1회)
↓
[3단계] 개발자 에이전트 → 코드 파일 생성
↓
[코드 검증] 파일 생성 확인 → 실패 시 개발자 재실행 (1회)
↓
[4단계] 리뷰어 에이전트 → REVIEW.md + 코드 수정
↓
[최종 보고] 생성 파일 목록 + 요약 출력
How to run each agent
Each agent is run with the Task tool. Use the prompts below as-is.
🧑💼 Step 1: PM agent
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"
)
🏗️ Step 2: Architect agent
Task(
description="아키텍트: ARCH 설계",
prompt="""
너는 시니어 소프트웨어 아키텍트다. docs/PRD.md를 읽고 기술 설계서(ARCH.md)를 작성하라.
ARCH.md 형식:
# Architecture: {기능명}
## 컴포넌트 구조
- 주요 컴포넌트와 역할 설명
## 파일 구조
feature/ ├── main.py # Main logic ├── utils.py # Utilities └── README.md # Usage
## 구현 계획
1단계: ...
2단계: ...
## 기술 스택
- 언어, 라이브러리, 의존성
## 인터페이스
- 입력/출력 정의
완성된 ARCH.md를 docs/ARCH.md 파일로 저장하라.
""",
subagent_type="general-purpose"
)
👨💻 Step 3: Developer agent
Task(
description="개발자: 코드 구현",
prompt="""
너는 시니어 개발자다. docs/PRD.md와 docs/ARCH.md를 읽고 실제 코드를 구현하라.
규칙:
- ARCH.md의 파일 구조를 그대로 따른다
- 각 파일에 간단한 주석을 달아 역할을 설명한다
- 에러 처리를 포함한다
- 실제로 실행 가능한 코드를 작성한다
- README.md에 설치 방법과 사용법을 작성한다
모든 파일을 생성하라.
""",
subagent_type="general-purpose"
)
🔍 Step 4: Reviewer agent
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"
)
Validation logic
PRD validation
Read the PRD.md file and check whether the following keywords are present:
배경orBackground기능 요구사항orRequirements성공 기준orSuccess Criteria
If any one of the three is missing, rerun the PM agent.
ARCH validation
Read the ARCH.md file and check whether the following keywords are present:
컴포넌트orComponent파일 구조orFile Structure구현 계획orImplementation
If any one of the three is missing, rerun the Architect agent.
Code validation
Extract filenames from the file structure section of ARCH.md and check whether the files actually exist. If a file is missing, rerun the Developer agent.
Final report format
✅ 개발 완료!
📁 생성된 파일:
docs/PRD.md — 기획서
docs/ARCH.md — 아키텍처 설계
docs/REVIEW.md — 리뷰 결과
feature/main.py — 메인 코드
feature/utils.py — 유틸리티
feature/README.md — 사용법
📋 리뷰 결과: PASS (이슈 2건 수정 완료)
⏱️ 소요 단계: 4단계 완료
Usage examples
Example input:
"URL을 입력받아 스크린샷 찍는 기능 만들어줘"→/dev-teamtrigger"Slack 메시지를 CSV로 내보내는 기능 개발팀으로 만들어줘""로그인 API 에이전트팀으로 만들어줘"
Cautions
- Each agent runs independently(they cannot talk to each other directly)
- Communication between agents happens through **files (PRD.md, ARCH.md)**
- The orchestrator (Claude) validates the result of each step and passes it to the next agent
- Reruns are limited to a maximum of 1회per step (to prevent infinite loops)