| 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인/가족 인원
_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 | 알레르기 대체재, 식이 제한 대응 |
