---
description: 설계 → 논의 → 승인 → 코드 구현 워크플로우
---

# 🚀 점진적 개발 워크플로우 (Development Workflow)

> **설계와 논의를 충분히 거친 후, 사용자의 승인을 받아야만 코드를 작성한다.**

---

## 🔑 핵심 원칙
1. **PM (제이 부장)의 역할**: 에이전트 간 의견 조율(Moderation) 및 사용자 보고(Reporting).
2. **사용자 승인 필수**: 에이전트 간 합의가 끝났더라도, **사용자 승인 없이는 코드 구현 금지**.
3. **점진적 진행**: 한 번에 너무 큰 덩어리를 맡기지 말고, 검증 가능한 단위로 쪼개서 진행.

---

## 🔄 작업 플로우 (Process)

```
[1. 설계/기획] (Docs Update)
    ↓
[2. 에이전트 검토 & 조율] (Multi-Agent Discussion)
    ↓   (PM: 내부적으로 치열하게 검증하고 최적안 도출)
    ↓
[3. 사용자 보고 & 승인 요청] (User Sign-off) 👈 Critical Step!
    ↓   (User: "OK, 진행해." 또는 "수정해.")
    ↓
[4. 코드 구현] (Coding)
    ↓
[5. 검증 & 테스트] (Verification)
```

---

## 📝 단계별 상세 가이드

### 1단계: 설계/기획
- **위치**: `docs/decisions/`, `docs/specs/`, `docs/meetings/`
- **파일명**: `{YYMMDD}-{HH.MM}-{주제}.md`
- **내용**: 무엇을 만들 것인가? (요구사항, 스펙, UX)

### 2단계: 에이전트 검토 & 조율
- **주체**: PM (Facilitator), Expert Agents (UX, FE, BE, Data)
- **활동**:
    - 기술적 실현 가능성 검토
    - 잠재적 문제점(Edge case) 발굴
    - 대안 제시 및 최적안 선정
- **산출물**: 회의록(`docs/meetings/`) 또는 업데이트된 계획서

### 3단계: 사용자 보고 & 승인 요청 (User Approval)
- **PM의 멘트 예시**: "에이전트들과 논의한 결과, A안이 가장 적합하다고 판단됩니다. 구체적인 계획은 [링크]와 같습니다. 진행해도 될까요?"
- **승인 전에는**: 절대 코드를 작성하거나 수정하지 않음.

### 4단계: 코드 구현
- 승인된 계획에 따라 실제 코드 작성 (`src/`, `functions/` 등)

### 5단계: 검증 & 테스트
- 구현 결과물이 기획 의도와 맞는지 확인
- 사용자에게 테스트 요청

---

## 🚫 금지 사항
- ❌ **사용자 패싱**: "논의 끝났으니 바로 구현합니다" (절대 금지)
- ❌ **독단적 결정**: 다른 에이전트(또는 사용자) 의견 무시하고 PM 마음대로 결정
- ❌ **코드 선행**: 설계나 승인 없이 일단 코드부터 짜기