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인/가족 인원
_workspace/ 디렉토리를 프로젝트 루트에 생성한다
- 입력을 정리하여
_workspace/00_input.md에 저장한다
- 요청 범위에 따라 실행 모드를 결정한다
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: 통합 및 최종 산출물
_workspace/ 내 모든 파일을 확인한다
- 식단표와 레시피의 영양소 합계가 목표와 일치하는지 확인한다
- 최종 요약을 사용자에게 보고한다:
- 영양 분석 —
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 |
알레르기 대체재, 식이 제한 대응 |
1---2name: meal-planner-23description: 식단 관리의 영양분석부터 조리가이드까지 전 과정을 에이전트 팀이 협업하여 생성하는 풀 파이프라인. '식단 짜줘', '일주일 식단', '다이어트 식단', '벌크업 식단', '당뇨 식단', '아이 이유식 식단', '장보기 목록', '영양 분석해줘', '레시피 알려줘', '밀프렙 계획', '칼로리 계산', '식단 관리' 등 식단·영양·레시피 관련 요청에 이 스킬을 사용한다. 기존 식단이 있으면 영양 분석이나 개선을 지원한다. 단, 의료 영양치료(MNT) 처방, 식품 안전 인증, 식당 메뉴 개발 컨설팅은 이 스킬의 범위가 아니다.4---56# Meal Planner — 식단 관리 풀 파이프라인78영양분석→식단설계→레시피→장보기목록→조리가이드를 에이전트 팀이 협업하여 한 번에 생성한다.910## 실행 모드1112**에이전트 팀** — 4명이 SendMessage로 직접 통신하며 교차 검증한다.1314## 에이전트 구성1516| 에이전트 | 파일 | 역할 | 타입 |17|---------|------|------|------|18| nutritionist | `.claude/agents/nutritionist.md` | 영양 분석, 칼로리·매크로 목표 설정 | general-purpose |19| meal-designer | `.claude/agents/meal-designer.md` | 일간/주간 식단표 설계 | general-purpose |20| recipe-writer | `.claude/agents/recipe-writer.md` | 상세 레시피, 영양정보, 대체재료 | general-purpose |21| shopping-coordinator | `.claude/agents/shopping-coordinator.md` | 장보기 목록, 조리 가이드, 밀프렙 | general-purpose |2223## 워크플로우2425### Phase 1: 준비 (오케스트레이터 직접 수행)26271. 사용자 입력에서 추출한다:28 - **신체 정보**: 성별, 연령, 신장, 체중, 활동 수준29 - **목표**: 감량/유지/증량/근육증가/건강관리30 - **식이 제한** (선택): 알레르기, 채식, 종교적 제한, 질환31 - **선호** (선택): 좋아하는/싫어하는 음식, 조리 시간 제약32 - **기간**: 며칠/몇 주치 식단33 - **인원수**: 1인/가족 인원342. `_workspace/` 디렉토리를 프로젝트 루트에 생성한다353. 입력을 정리하여 `_workspace/00_input.md`에 저장한다364. 요청 범위에 따라 **실행 모드를 결정**한다3738### Phase 2: 팀 구성 및 실행3940| 순서 | 작업 | 담당 | 의존 | 산출물 |41|------|------|------|------|--------|42| 1 | 영양 분석·목표 설정 | nutritionist | 없음 | `_workspace/01_nutrition_analysis.md` |43| 2 | 식단표 설계 | meal-designer | 작업 1 | `_workspace/02_meal_plan.md` |44| 3 | 레시피 작성 | recipe-writer | 작업 1, 2 | `_workspace/03_recipes.md` |45| 4a | 장보기 목록 | shopping-coordinator | 작업 3 | `_workspace/04_shopping_list.md` |46| 4b | 조리 가이드 | shopping-coordinator | 작업 2, 3 | `_workspace/05_cooking_guide.md` |4748**팀원 간 소통 흐름:**49- nutritionist 완료 → meal-designer에게 칼로리·매크로 목표, 식이 제한 전달50- meal-designer 완료 → recipe-writer에게 메뉴별 레시피 작성 요청, shopping-coordinator에게 밀프렙 전략 전달51- recipe-writer 완료 → shopping-coordinator에게 전체 재료 목록 전달52- shopping-coordinator는 재료 통합 시 정합성 확인. 누락/불일치 발견 시 recipe-writer에게 확인 요청5354### Phase 3: 통합 및 최종 산출물55561. `_workspace/` 내 모든 파일을 확인한다572. 식단표와 레시피의 영양소 합계가 목표와 일치하는지 확인한다583. 최종 요약을 사용자에게 보고한다:59 - 영양 분석 — `01_nutrition_analysis.md`60 - 식단표 — `02_meal_plan.md`61 - 레시피 모음 — `03_recipes.md`62 - 장보기 목록 — `04_shopping_list.md`63 - 조리 가이드 — `05_cooking_guide.md`6465## 작업 규모별 모드6667| 사용자 요청 패턴 | 실행 모드 | 투입 에이전트 |68|----------------|----------|-------------|69| "식단 전체 짜줘", "일주일 식단" | **풀 파이프라인** | 4명 전원 |70| "내 칼로리 계산해줘" | **영양분석 모드** | nutritionist 단독 |71| "오늘 저녁 레시피 알려줘" | **레시피 모드** | recipe-writer 단독 |72| "이 식단 영양 분석해줘" (기존 파일) | **분석 모드** | nutritionist 단독 |73| "장보기 목록만 만들어줘" (식단 있음) | **장보기 모드** | shopping-coordinator 단독 |7475**기존 파일 활용**: 사용자가 기존 식단표를 제공하면, `_workspace/02_meal_plan.md`로 복사하고 해당 단계를 건너뛴다.7677## 데이터 전달 프로토콜7879| 전략 | 방식 | 용도 |80|------|------|------|81| 파일 기반 | `_workspace/` 디렉토리 | 주요 산출물 저장 및 공유 |82| 메시지 기반 | SendMessage | 실시간 핵심 정보 전달, 수정 요청 |83| 태스크 기반 | TaskCreate/TaskUpdate | 진행 상황 추적, 의존 관계 관리 |8485파일명 컨벤션: `{순번}_{에이전트}_{산출물}.{확장자}`8687## 에러 핸들링8889| 에러 유형 | 전략 |90|----------|------|91| 사용자 신체 정보 부족 | 한국인 평균 기준 기본값 사용, "추정값" 명시 |92| 극단적 칼로리 목표 | 안전 범위 내로 조정 + 경고 표시 |93| 식이 제한으로 메뉴 구성 곤란 | 대체 메뉴 제시 + 영양 보충 안내 |94| 에이전트 실패 | 1회 재시도 → 실패 시 해당 산출물 없이 진행, 보고서에 누락 명시 |95| 영양소 목표 미달 | 식단설계자에게 메뉴 교체 요청 (최대 2회) |9697## 테스트 시나리오9899### 정상 흐름100**프롬프트**: "30대 남성, 178cm, 82kg, 사무직이고 일주일에 3번 운동해. 5kg 감량 목표로 1주일 식단 짜줘"101**기대 결과**:102- 영양 분석: BMR→TDEE 계산, 감량 칼로리(약 1800kcal), 매크로 배분103- 식단표: 7일 × 3끼 + 간식, 일일 칼로리 달성률 95% 이상104- 레시피: 최소 15개 레시피 (중복 메뉴 제외), 대체재료 포함105- 장보기: 카테고리별 통합 목록, 주 2회 구매 분할, 예산 추정106- 조리 가이드: 일요일 밀프렙 플랜 + 일별 조리 타임라인107108### 기존 파일 활용 흐름109**프롬프트**: "지금 먹고 있는 식단인데 영양 분석해주고 개선점 알려줘" + 식단 파일 첨부110**기대 결과**:111- 기존 식단을 `_workspace/02_meal_plan.md`로 복사112- nutritionist가 현재 식단의 영양 분석 수행113- 개선 권고 사항 포함 보고서 생성114115### 에러 흐름116**프롬프트**: "견과류 알레르기 있고 유제품 못 먹어, 비건 식단 짜줘"117**기대 결과**:118- 식이 제한 반영: 견과류·유제품·동물성 식품 전부 제외119- 단백질 부족 리스크 안내 + 식물성 단백질 급원 강화 식단120- 비타민 B12, 칼슘, 오메가3 보충 권고121- 대체재료 목록 충실히 작성122123## 에이전트별 확장 스킬124125| 에이전트 | 확장 스킬 | 용도 |126|---------|----------|------|127| nutritionist, meal-designer | `nutrition-calculator` | BMR/TDEE 계산, 매크로 배분 공식 |128| recipe-writer, meal-designer | `ingredient-substitution-engine` | 알레르기 대체재, 식이 제한 대응 |