recipes

name	Recipes
description	Build a personal recipe collection with ingredients, scaling, and meal planning.
metadata	{"clawdbot":{"emoji":"🍳","os":["linux","darwin","win32"]}}

Core Behavior

• User shares a recipe → capture in standard format, save to collection
• User asks "what can I make with X" → search by ingredient
• User plans meals → help organize week and generate shopping list
• Create ~/recipes/ as workspace

When User Shares a Recipe

• URL → fetch and extract into standard format
• Photo of recipe → extract text, structure it
• Voice/text description → format into recipe structure
• Handwritten family recipe → preserve original, add structured version

Recipe File Structure

• One Markdown file per recipe: chicken-tikka-masala.md
• Frontmatter: prep_time, cook_time, servings, tags, source
• Sections: ingredients, instructions, notes
• Keep readable — someone should cook from this file

Key Fields

• Title and brief description
• Prep time, cook time, total time
• Servings (base for scaling)
• Ingredients with quantities and units
• Step-by-step instructions
• Tags: cuisine, meal-type, dietary, difficulty
• Source: URL, book, or "family recipe"
• Notes: substitutions, tips, variations tried

Ingredient Format

• Quantity, unit, ingredient, prep: "2 cups chicken, diced"
• Consistent units — pick metric or imperial, stick with it
• Group by section if complex: "For the sauce:", "For the marinade:"
• Note optional ingredients clearly

Scaling

• Store base servings in frontmatter
• Calculate scaled quantities on request
• Flag ingredients that don't scale linearly (salt, yeast, baking powder)
• Round to practical measurements — no "0.37 cups"

Progressive Enhancement

• Week 1: dump recipes as they come, minimal formatting
• Week 2: standardize format, add tags
• Week 3: build index by cuisine/meal type
• Month 2: meal planning and shopping lists
• Month 3: ingredient inventory integration

Folder Structure

~/recipes/
├── mains/
├── sides/
├── desserts/
├── basics/          # sauces, stocks, staples
├── index.md         # master list with tags
└── meal-plans/      # weekly plans

Searching and Filtering

• By ingredient: "recipes with chickpeas"
• By tag: "quick weeknight", "vegetarian", "mexican"
• By time: "under 30 minutes"
• Favorites: tag or star system for go-to recipes

Meal Planning

• Weekly plan: 7 dinners, optional lunches/breakfasts
• Balance variety — not three pasta dishes in a row
• Consider ingredient overlap — buy once, use twice
• Generate combined shopping list from plan

Shopping List Generation

• Aggregate ingredients across selected recipes
• Combine same ingredients: 2 cups + 1 cup = 3 cups
• Group by store section: produce, dairy, pantry
• Exclude pantry staples user always has (configurable)

What To Capture From URLs

• Recipe title and description
• Ingredients list (structured)
• Instructions (numbered steps)
• Times and servings
• Skip the life story — just the recipe

Notes and Variations

• "Made this 2024-03-15, added more garlic, family loved it"
• Track modifications that worked
• Rate recipes after making them
• Flag recipes never actually made vs tested

What NOT To Suggest

• Complex recipe management app — files work fine
• Nutrition calculation — too complex, use dedicated tool if needed
• Automated meal planning — user knows their preferences
• Social features — this is personal collection

Family Recipe Preservation

• Scan or photograph original handwritten recipes
• Link image in the markdown file
• Keep original measurements even if odd ("coffee cup of flour")
• Note the source: "Grandma's recipe, circa 1960"