1
---
2
name: meal-prep-storage-and-use-by-planner
3
description: Plans where every batch-cooked portion lives after a meal prep session: which stay in the fridge, which go in the freezer on prep day, when to move each to the fridge to thaw, and what goes on the labels, using conservative USDA fridge and freezer times. Flags meals planned past the use-by date, foods that do not freeze, shortfalls, leftovers and a full fridge. Includes a stdlib Python planner with --self-test.
4
---
5
6
# Meal Prep Storage and Use-By Planner
7
8
You help people who batch-cook on one day eat safely all week. Given what they cooked and when they plan to eat it, you decide which portions stay in the fridge and which go straight into the freezer, schedule the thawing, and write the labels, so nothing on Friday's menu is past its fridge window and nothing is wasted.
9
10
## Files in this skill
11
12
- `scripts/prep_storage.py` - reads the batch (item, category, portions, cooked date) and the eating plan, splits portions between fridge and freezer, schedules thawing, writes labels and a day-by-day plan, and flags problems (Python 3 standard library only)
13
- `references/storage-times.md` - fridge and freezer times for 15 food categories with sources, and how to treat foods not on the list
14
- `references/cooling-thawing-reheating.md` - cooling within 2 hours, containers and labels, safe thawing, reheating and cooking temperatures, rice and other special cases
15
- `templates/prep-week-plan.md` - the plan to hand back (storage table, day by day, labels, notes)
16
- `examples/sunday-batch.csv` - a Sunday prep session: 7 items, 31 portions
17
- `examples/week-plan.csv` - Monday to Saturday meals that use them
18
19
## Workflow
20
21
### 1. Collect the batch and the plan
22
Ask what they cooked or prepped, how many portions of each, the cooking date, and which day and meal each portion is for. Map every item to a category (`python3 scripts/prep_storage.py --categories`); when unsure, pick the shorter-lived one. Ask about fridge space (how many containers fit) and whether anything was left out of the fridge for more than 2 hours (that food is not planned, it is discarded).
23
24
### 2. Run the planner
25
```
26
python3 scripts/prep_storage.py examples/sunday-batch.csv examples/week-plan.csv --fridge-capacity 16
27
python3 scripts/prep_storage.py batch.csv plan.csv --json
28
python3 scripts/prep_storage.py --categories
29
python3 scripts/prep_storage.py --self-test
30
```
31
Day 0 is the cooking day. Portions planned within the fridge window stay in the fridge; later ones are frozen on prep day and moved to the fridge the evening before. Use the optional `fridge_days` and `freezer_months` columns for foods not in the table (`freezer_months` 0 = do not freeze). Exit 1 means a HIGH finding (a portion would be eaten past its use-by date or before it is cooked), 2 means bad input.
32
33
### 3. Fix the plan
34
Resolve every finding (see `references/storage-times.md`):
35
- PAST_USE_BY: move that meal earlier, swap it with a freezable item, or make that food fresh mid-week.
36
- SHORTFALL: cook more or swap the meal; SURPLUS_NO_FREEZE: eat it earlier or cook less next time.
37
- FRIDGE_FULL: freeze more portions on prep day, combine portions, or prep twice a week.
38
Re-run until there are no HIGH findings.
39
40
### 4. Deliver
41
Fill `templates/prep-week-plan.md`: storage table, prep-day actions (cool, portion, label, fridge or freezer), the day-by-day list including evening "move to fridge" reminders, labels to write, and the safety notes from `references/cooling-thawing-reheating.md` that apply to this batch.
42
43
## Example result
44
Sunday 2026-11-01 batch: chicken burrito bowls, rice and turkey chili keep 3 fridge portions each (eat by Thursday 11-05); 2 bowls, 2 rice and 3 chili go in the freezer on Sunday, moved to the fridge Thursday and Friday evenings. The raw marinated salmon (2-day window) is frozen raw on Sunday, moved to the fridge Tuesday evening, and cooked Wednesday to 145 F / 63 C. Egg salad on Friday is day 5 and egg salad does not freeze well: HIGH PAST_USE_BY, so move that lunch to Wednesday or Thursday or make it fresh. Two hard-boiled eggs have no plan (eat by Sunday 11-08), one chili portion is a freezer spare, and 22 containers do not fit a 16-container shelf on Sunday.
45
46
## Rules
47
48
- Use the conservative end of every range and say so; when in doubt, throw it out.
49
- Count the cooking day as day 0; a 4-day food cooked Sunday is eaten by Thursday.
50
- Freezer times are for quality, not safety; fridge times are for safety. Never extend fridge times because food "looks fine".
51
- Thaw in the fridge, cold water or microwave, never on the counter; eat thawed cooked food within 3-4 days and do not count fridge days already used before freezing as fresh.
52
- Raw items get a cook-by date and a safe internal temperature, not a reheat note.
53
- This is general food-safety guidance, not medical advice; for pregnancy, infants, older adults or weakened immunity, follow stricter local guidance.
54