Meal PlannerSAFE

An agent skill published by revfactory.

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

```markdown
---
name: meal-planner
description: "A full pipeline where an agent team collaborates to handle everything from nutritional analysis to cooking guides for meal management. Use this skill for any meal, nutrition, or recipe-related requests such as 'create a meal plan', 'weekly meal plan', 'diet meal plan', 'bulking meal plan', 'diabetic meal plan', 'baby food plan', 'grocery list', 'analyze my nutrition', 'give me a recipe', 'meal prep plan', 'calorie count', 'manage my diet'. If an existing meal plan is provided, supports nutritional analysis and improvement. Does NOT cover medical nutrition therapy (MNT) prescriptions, food safety certification, or restaurant menu development consulting."
---

# Meal Planner — Full Meal Management Pipeline

An agent team collaborates to generate nutrition analysis → meal design → recipes → grocery list → cooking guide all at once.

## Execution Modes

**Agent Team** — 4 agents communicate directly via SendMessage and cross-validate each other.

## Agent Composition

| Agent | File | Role | Type |
|---------|------|------|------|
| nutritionist | `.claude/agents/nutritionist.md` | Nutritional analysis, calorie & macro goal setting | general-purpose |
| meal-designer | `.claude/agents/meal-designer.md` | Daily/weekly meal plan design | general-purpose |
| recipe-writer | `.claude/agents/recipe-writer.md` | Detailed recipes, nutritional info, ingredient substitutions | general-purpose |
| shopping-coordinator | `.claude/agents/shopping-coordinator.md` | Grocery list, cooking guide, meal prep | general-purpose |

## Workflow

### Phase 1: Preparation (Orchestrator performs directly)

1. Extract from user input:
    - **Physical info**: gender, age, height, weight, activity level
    - **Goal**: weight loss / maintenance / weight gain / muscle gain / health management
    - **Dietary restrictions** (optional): allergies, vegetarian, religious restrictions, medical conditions
    - **Preferences** (optional): liked/disliked foods, cooking time constraints
    - **Duration**: how many days/weeks of meal plan
    - **Number of people**: single / family size
2. Create a `_workspace/` directory in the project root
3. Organize the input and save to `_workspace/00_input.md`
4. **Determine execution mode** based on the scope of the request

### Phase 2: Team Assembly and Execution

| Order | Task | Assigned To | Depends On | Output |
|------|------|------|------|--------|
| 1 | Nutritional analysis & goal setting | nutritionist | None | `_workspace/01_nutrition_analysis.md` |
| 2 | Meal plan design | meal-designer | Task 1 | `_workspace/02_meal_plan.md` |
| 3 | Recipe writing | recipe-writer | Tasks 1, 2 | `_workspace/03_recipes.md` |
| 4a | Grocery list | shopping-coordinator | Task 3 | `_workspace/04_shopping_list.md` |
| 4b | Cooking guide | shopping-coordinator | Tasks 2, 3 | `_workspace/05_cooking_guide.md` |

**Team communication flow:**
- nutritionist completes → sends calorie & macro targets and dietary restrictions to meal-designer
- meal-designer completes → requests recipe writing per menu item from recipe-writer, sends meal prep strategy to shopping-coordinator
- recipe-writer completes → sends full ingredient list to shopping-coordinator
- shopping-coordinator verifies consistency when consolidating ingredients. If gaps or mismatches found, requests confirmation from recipe-writer

### Phase 3: Integration and Final Deliverables

1. Review all files in `_workspace/`
2. Verify that nutrient totals in the meal plan and recipes match the targets
3. Report final summary to the user:
    - Nutritional analysis — `01_nutrition_analysis.md`
    - Meal plan — `02_meal_plan.md`
    - Recipe collection — `03_recipes.md`
    - Grocery list — `04_shopping_list.md`
    - Cooking guide — `05_cooking_guide.md`

## Mode by Task Scope

| User Request Pattern | Execution Mode | Agents Deployed |
|----------------|----------|-------------|
| "Create a full meal plan", "weekly meal plan" | **Full Pipeline** | All 4 agents |
| "Calculate my calories" | **Nutrition Analysis Mode** | nutritionist only |
| "Give me a recipe for tonight's dinner" | **Recipe Mode** | recipe-writer only |
| "Analyze the nutrition of this meal plan" (existing file) | **Analysis Mode** | nutritionist only |
| "Just make me a grocery list" (meal plan provided) | **Shopping Mode** | shopping-coordinator only |

**Using existing files**: If the user provides an existing meal plan, copy it to `_workspace/02_meal_plan.md` and skip that step.

## Data Transfer Protocol

| Strategy | Method | Purpose |
|------|------|------|
| File-based | `_workspace/` directory | Store and share primary deliverables |
| Message-based | SendMessage | Real-time key info delivery, revision requests |
| Task-based | TaskCreate/TaskUpdate | Progress tracking, dependency management |

File naming convention: `{order}_{agent}_{deliverable}.{extension}`

## Error Handling

| Error Type | Strategy |
|----------|------|
| Insufficient physical info from user | Use default values based on population averages, mark as "estimated" |
| Extreme calorie targets | Adjust to safe range + display warning |
| Dietary restrictions make menu composition difficult | Suggest alternative menus + nutrition supplementation guidance |
| Agent failure | 1 retry → if still failing, proceed without that deliverable and note the gap in the report |
| Nutrient targets not met | Request menu replacement from meal-designer (max 2 times) |

## Test Scenarios

### Normal Flow
**Prompt**: "Male in his 30s, 178cm, 82kg, office worker who exercises 3 times a week. Create a 1-week meal plan to lose 5kg."
**Expected Results**:
- Nutritional analysis: BMR → TDEE calculation, deficit calories (~1800kcal), macro distribution
- Meal plan: 7 days × 3 meals + snacks, daily calorie target achievement rate 95% or above
- Recipes: minimum 15 recipes (excluding duplicates), with ingredient substitutions
- Grocery list: consolidated list by category, split int

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (1)

Gates applied: no_behavioural_pass.