식단 관리의 영양분석부터 조리가이드까지 전 과정을 에이전트 팀이 협업하여 생성하는 풀 파이프라인. '식단 짜줘', '일주일 식단', '다이어트 식단', '벌크업 식단', '당뇨 식단', '아이 이유식 식단', '장보기 목록', '영양 분석해줘', '레시피 알려줘', '밀프렙 계획', '칼로리 계산', '식단 관리' 등 식단·영양·레시피 관련 요청에 이 스킬을 사용한다. 기존 식단이 있으면 영양 분석이나 개선을 지원한다. 단, 의료 영양치료(MNT) 처방, 식품 안전 인증, 식당 메뉴 개발 컨설팅은 이 스킬의 범위가 아니다.
영양분석→식단설계→레시피→장보기목록→조리가이드를 에이전트 팀이 협업하여 한 번에 생성한다.
에이전트 팀 — 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 |
_workspace/ 디렉토리를 프로젝트 루트에 생성한다_workspace/00_input.md에 저장한다| 순서 | 작업 | 담당 | 의존 | 산출물 |
|---|---|---|---|---|
| 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 |
팀원 간 소통 흐름:
_workspace/ 내 모든 파일을 확인한다01_nutrition_analysis.md02_meal_plan.md03_recipes.md04_shopping_list.md05_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주일 식단 짜줘" 기대 결과:
프롬프트: "지금 먹고 있는 식단인데 영양 분석해주고 개선점 알려줘" + 식단 파일 첨부 기대 결과:
_workspace/02_meal_plan.md로 복사프롬프트: "견과류 알레르기 있고 유제품 못 먹어, 비건 식단 짜줘" 기대 결과:
| 에이전트 | 확장 스킬 | 용도 |
|---|---|---|
| nutritionist, meal-designer | nutrition-calculator | BMR/TDEE 계산, 매크로 배분 공식 |
| recipe-writer, meal-designer | ingredient-substitution-engine | 알레르기 대체재, 식이 제한 대응 |