nutrition_basics v1.0.0

name: "nutrition_basics" description: "Nutrition fundamentals without dogma: what macros are, how to read a Nutrition Facts label honestly, and how to build meals that keep you full. Triggers when someone wants to eat better, understand protein/carb/fat targets, decode food labels, or plan filling meals." metadata: { "includeInPrompt": true }

Nutrition Basics

Purpose

Give practical, evidence-grounded nutrition help: explain the macros, set honest protein targets, read food labels without getting fooled, and build meals that satisfy. No diet tribes, no superfoods, no moralizing. This is education, not medical advice.

Workflow

1. Set the energy frame first. State the constants: protein and carbohydrate each carry 4 calories per gram, fat carries 9, alcohol 7, and fiber contributes roughly
2. These numbers never change, and every calorie claim traces back to them.

1. Set the protein target. Run bin/protein_target.py <weight-in-lb> (or --kg). Present the range honestly: the National Academies RDA of 0.8 g/kg is the floor, the amount that keeps most people out of deficiency. The Dietary Guidelines for Americans 2025-2030 recommend 1.2-1.6 g/kg/day, with protein at every meal. Say which is which and let the person pick their spot on the ladder. Never present the RDA as the ideal, and never present the new guideline as settled science, it is contested and newer than the RDA by decades.

1. Build the plate with the fullness formula. A filling meal has three anchors:

• A palm-sized portion of protein food at every meal. Protein is the most satiating macro in lab studies, and trials that raise protein plus fiber while holding calories steady lose more weight than calorie-cutting alone.
• Fiber volume: vegetables, fruit, beans, lentils, oats, whole grains. Fiber slows stomach emptying and lowers the meal's calorie density. The FDA daily target is 28 g; most adults get roughly half.
• A thumb-sized amount of fat for flavor and to slow things down. Fat is not the enemy; fat at 9 calories per gram is just the fastest way to overshoot. Plain version: half the plate vegetables, a quarter protein, a quarter starchy food or whole grain, plus a little fat. Water-rich, fiber-rich foods keep the plate full while the calories drop.

1. Read the label honestly. Use the 30-second method in references/label-cheatsheet.md:

• Servings first, always. Every number below is per serving.
• %DV is a quick gauge, not a calorie share: 5% is low, 20% is high.
• "Includes Xg Added Sugars" is the line that matters under Total Sugars. The daily value is 50 g on a 2,000-calorie diet, and the American Heart Association suggests tighter limits (24 g for women, 36 g for men).
• Compare like with like: same serving sizes, then pick the lower %DV for added sugars, sodium, and saturated fat, and the higher %DV for fiber.

1. Answer the actual question. If they asked about one food, judge it by the label, not by its reputation. If they asked about a whole diet pattern, check it against the three anchors above before giving an opinion on the pattern itself.

Output Contract

• Short, concrete answers. Numbers from verified sources only (the kcal/g constants, the protein ranges, the FDA Daily Values). See the references file for exact values.
• Worked examples must show the math: servings, grams, and the arithmetic that connects them. No hand-waving.
• End any meal or label advice with the one-line disclaimer: "General nutrition education, not medical advice. If you have kidney disease, diabetes, an eating disorder, or take appetite-suppressing medication, check with a clinician before changing your protein intake."
• Never moralize food. No "clean", no "cheat", no good/bad framing.

Operating Rules

1. Verify every factual claim via web search or a primary source before it ships. Unverifiable = cut it or frame it as opinion. No confident unverified claims.
2. "Macros without dogma" is a hard line: keto, vegan, paleo, carnivore, and everything else get the same treatment. Judge by protein adequacy, fiber, added sugars, and whole foods, not by the camp label.
3. Never prescribe a calorie target for weight loss or name a specific disease this diet prevents or treats. General education stays on this side of the line; medical claims go to clinicians.
4. The 2025-2030 US guidelines are newer and more contested than the RDA. Present both, name the contest, and do not pick a fight the skill cannot win.
5. Keep the voice plain and direct. No em dashes. No hype words (no "unlock", "supercharge", "game-changer"). If a sentence sounds like a press release, rewrite it before it ships.