Meal Planner

---
name: meal-planner
description: "식단 관리의 영양분석부터 조리가이드까지 전 과정을 에이전트 팀이 협업하여 생성하는 풀 파이프라인. '식단 짜줘', '일주일 식단', '다이어트 식단', '벌크업 식단', '당뇨 식단', '아이 이유식 식단', '장보기 목록', '영양 분석해줘', '레시피 알려줘', '밀프렙 계획', '칼로리 계산', '식단 관리' 등 식단·영양·레시피 관련 요청에 이 스킬을 사용한다. 기존 식단이 있으면 영양 분석이나 개선을 지원한다. 단, 의료 영양치료(MNT) 처방, 식품 안전 인증, 식당 메뉴 개발 컨설팅은 이 스킬의 범위가 아니다."
---

# Meal Planner — 식단 관리 풀 파이프라인

영양분석→식단설계→레시피→장보기목록→조리가이드를 에이전트 팀이 협업하여 한 번에 생성한다.

## 실행 모드

**에이전트 팀** — 4명이 SendMessage로 직접 통신하며 교차 검증한다.

## 에이전트 구성

| 에이전트 | 파일 | 역할 | 타입 |
|---------|------|------|------|
| nutritionist | `.claude/agents/nutritionist.md` | 영양 분석, 칼로리·매크로 목표 설정 | general-purpose |
| meal-designer | `.claude/agents/meal-designer.md` | 일간/주간 식단표 설계 | general-purpose |
| recipe-writer | `.claude/agents/recipe-writer.md` | 상세 레시피, 영양정보, 대체재료 | general-purpose |
| shopping-coordinator | `.claude/agents/shopping-coordinator.md` | 장보기 목록, 조리 가이드, 밀프렙 | general-purpose |

## 워크플로우

### Phase 1: 준비 (오케스트레이터 직접 수행)

1. 사용자 입력에서 추출한다:
    - **신체 정보**: 성별, 연령, 신장, 체중, 활동 수준
    - **목표**: 감량/유지/증량/근육증가/건강관리
    - **식이 제한** (선택): 알레르기, 채식, 종교적 제한, 질환
    - **선호** (선택): 좋아하는/싫어하는 음식, 조리 시간 제약
    - **기간**: 며칠/몇 주치 식단
    - **인원수**: 1인/가족 인원
2. `_workspace/` 디렉토리를 프로젝트 루트에 생성한다
3. 입력을 정리하여 `_workspace/00_input.md`에 저장한다
4. 요청 범위에 따라 **실행 모드를 결정**한다

### Phase 2: 팀 구성 및 실행

| 순서 | 작업 | 담당 | 의존 | 산출물 |
|------|------|------|------|--------|
| 1 | 영양 분석·목표 설정 | nutritionist | 없음 | `_workspace/01_nutrition_analysis.md` |
| 2 | 식단표 설계 | meal-designer | 작업 1 | `_workspace/02_meal_plan.md` |
| 3 | 레시피 작성 | recipe-writer | 작업 1, 2 | `_workspace/03_recipes.md` |
| 4a | 장보기 목록 | shopping-coordinator | 작업 3 | `_workspace/04_shopping_list.md` |
| 4b | 조리 가이드 | shopping-coordinator | 작업 2, 3 | `_workspace/05_cooking_guide.md` |

**팀원 간 소통 흐름:**
- nutritionist 완료 → meal-designer에게 칼로리·매크로 목표, 식이 제한 전달
- meal-designer 완료 → recipe-writer에게 메뉴별 레시피 작성 요청, shopping-coordinator에게 밀프렙 전략 전달
- recipe-writer 완료 → shopping-coordinator에게 전체 재료 목록 전달
- shopping-coordinator는 재료 통합 시 정합성 확인. 누락/불일치 발견 시 recipe-writer에게 확인 요청

### Phase 3: 통합 및 최종 산출물

1. `_workspace/` 내 모든 파일을 확인한다
2. 식단표와 레시피의 영양소 합계가 목표와 일치하는지 확인한다
3. 최종 요약을 사용자에게 보고한다:
    - 영양 분석 — `01_nutrition_analysis.md`
    - 식단표 — `02_meal_plan.md`
    - 레시피 모음 — `03_recipes.md`
    - 장보기 목록 — `04_shopping_list.md`
    - 조리 가이드 — `05_cooking_guide.md`

## 작업 규모별 모드

| 사용자 요청 패턴 | 실행 모드 | 투입 에이전트 |
|----------------|----------|-------------|
| "식단 전체 짜줘", "일주일 식단" | **풀 파이프라인** | 4명 전원 |
| "내 칼로리 계산해줘" | **영양분석 모드** | nutritionist 단독 |
| "오늘 저녁 레시피 알려줘" | **레시피 모드** | recipe-writer 단독 |
| "이 식단 영양 분석해줘" (기존 파일) | **분석 모드** | nutritionist 단독 |
| "장보기 목록만 만들어줘" (식단 있음) | **장보기 모드** | shopping-coordinator 단독 |

**기존 파일 활용**: 사용자가 기존 식단표를 제공하면, `_workspace/02_meal_plan.md`로 복사하고 해당 단계를 건너뛴다.

## 데이터 전달 프로토콜

| 전략 | 방식 | 용도 |
|------|------|------|
| 파일 기반 | `_workspace/` 디렉토리 | 주요 산출물 저장 및 공유 |
| 메시지 기반 | SendMessage | 실시간 핵심 정보 전달, 수정 요청 |
| 태스크 기반 | TaskCreate/TaskUpdate | 진행 상황 추적, 의존 관계 관리 |

파일명 컨벤션: `{순번}_{에이전트}_{산출물}.{확장자}`

## 에러 핸들링

| 에러 유형 | 전략 |
|----------|------|
| 사용자 신체 정보 부족 | 한국인 평균 기준 기본값 사용, "추정값" 명시 |
| 극단적 칼로리 목표 | 안전 범위 내로 조정 + 경고 표시 |
| 식이 제한으로 메뉴 구성 곤란 | 대체 메뉴 제시 + 영양 보충 안내 |
| 에이전트 실패 | 1회 재시도 → 실패 시 해당 산출물 없이 진행, 보고서에 누락 명시 |
| 영양소 목표 미달 | 식단설계자에게 메뉴 교체 요청 (최대 2회) |

## 테스트 시나리오

### 정상 흐름
**프롬프트**: "30대 남성, 178cm, 82kg, 사무직이고 일주일에 3번 운동해. 5kg 감량 목표로 1주일 식단 짜줘"
**기대 결과**:
- 영양 분석: BMR→TDEE 계산, 감량 칼로리(약 1800kcal), 매크로 배분
- 식단표: 7일 × 3끼 + 간식, 일일 칼로리 달성률 95% 이상
- 레시피: 최소 15개 레시피 (중복 메뉴 제외), 대체재료 포함
- 장보기: 카테고리별 통합 목록, 주 2회 구매 분할, 예산 추정
- 조리 가이드: 일요일 밀프렙 플랜 + 일별 조리 타임라인

### 기존 파일 활용 흐름
**프롬프트**: "지금 먹고 있는 식단인데 영양 분석해주고 개선점 알려줘" + 식단 파일 첨부
**기대 결과**:
- 기존 식단을 `_workspace/02_meal_plan.md`로 복사
- nutritionist가 현재 식단의 영양 분석 수행
- 개선 권고 사항 포함 보고서 생성

### 에러 흐름
**프롬프트**: "견과류 알레르기 있고 유제품 못 먹어, 비건 식단 짜줘"
**기대 결과**:
- 식이 제한 반영: 견과류·유제품·동물성 식품 전부 제외
- 단백질 부족 리스크 안내 + 식물성 단백질 급원 강화 식단
- 비타민 B12, 칼슘, 오메가3 보충 권고
- 대체재료 목록 충실히 작성

## 에이전트별 확장 스킬

| 에이전트 | 확장 스킬 | 용도 |
|---------|----------|------|
| nutritionist, meal-designer | `nutrition-calculator` | BMR/TDEE 계산, 매크로 배분 공식 |
| recipe-writer, meal-designer | `ingredient-substitution-engine` | 알레르기 대체재, 식이 제한 대응 |