# My Dev Team

> 4명의 에이전트 팀(PM → 아키텍트 → 개발자 → 리뷰어)이 순차적으로 기능을 자동 개발한다. 기획서(PRD) → 설계(ARCH) → 코드 → 리뷰까지 완전 자동 파이프라인. "/dev-team", "개발팀으로 만들어줘", "에이전트팀으로 만들어줘", "자동 개발해줘" 요청에 사용.

- Skill: `eoash/my-dev-team` (Agent Skill)
- Install (CLI): `npx skillmds@latest add eoash/my-dev-team`
- Raw SKILL.md: https://api.skillmd.com/api/skills/eoash/my-dev-team/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: eoash (https://skillmd.com/u/eoash)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/eoash/my-dev-team

---


# My Dev Team

사용자가 기능 설명을 입력하면, 4명의 에이전트가 순차적으로 실행되어 PRD → 설계 → 코드 → 리뷰까지 자동으로 완성한다.

---

## 팀 구성

| 에이전트 | 역할 | 출력물 |
|---------|------|--------|
| 🧑‍💼 PM | 요구사항 분석 + PRD 작성 | `docs/PRD.md` |
| 🏗️ 아키텍트 | 기술 설계 + 파일 구조 설계 | `docs/ARCH.md` |
| 👨‍💻 개발자 | 코드 구현 | 코드 파일들 |
| 🔍 리뷰어 | 코드 리뷰 + 개선 | `docs/REVIEW.md` + 수정 코드 |

---

## 실행 전 준비

스킬이 트리거되면:

1. 사용자 입력에서 **기능 설명**을 추출한다.
2. 기능 설명이 없으면 AskUserQuestion으로 질문한다:
   ```
   어떤 기능을 만들까요? 간단히 설명해주세요.
   예) "사용자가 URL을 입력하면 스크린샷을 찍어서 저장하는 기능"
   ```
3. 작업 디렉토리와 `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회**로 제한한다 (무한 루프 방지)