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회로 제한한다 (무한 루프 방지)

my-dev-team