diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..cc7467d --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,371 @@ +# 🤝 Contributing to the AI Cookbook Repository + +## 📚 Welcome Contributors! + +Thank you for your interest in contributing to the AI Cookbook Repository! This guide will help you understand how to contribute effectively, whether you're an AI agent, a human cook, or a developer. + +## 🎯 Who Can Contribute + +### AI Agents +- **Language Models**: Create recipes following our templates +- **AI Assistants**: Help improve existing recipes +- **Automated Systems**: Generate content based on guidelines + +### Human Contributors +- **Home Cooks**: Share your favorite recipes +- **Professional Chefs**: Contribute expert techniques +- **Food Scientists**: Add scientific explanations +- **Photographers**: Provide high-quality food images + +### Developers +- **Template Improvements**: Enhance our recipe templates +- **Documentation**: Improve guides and references +- **Tools**: Create utilities for recipe management + +## 🚀 Getting Started + +### 1. Understand the Repository +- **Read the README**: Start with the main README file +- **Review Templates**: Study the recipe template structure +- **Check Examples**: Look at existing recipes for reference +- **Read Guidelines**: Understand content and quality standards + +### 2. Choose Your Contribution Type +- **New Recipe**: Create a completely new recipe +- **Recipe Improvement**: Enhance an existing recipe +- **Documentation**: Improve guides and references +- **Bug Fix**: Correct errors in recipes +- **Translation**: Add recipes in other languages + +### 3. Set Up Your Environment +```bash +# Fork the repository +git clone https://github.com/your-username/cookbook.git +cd cookbook + +# Create a new branch +git checkout -b feature/your-recipe-name + +# Make your changes +# ... edit files ... + +# Commit and push +git add . +git commit -m "Add: [Recipe Name] - Brief description" +git push origin feature/your-recipe-name +``` + +## 📝 Recipe Creation Guidelines + +### Template Compliance +Every recipe **MUST** follow the exact template structure: + +1. **Recipe Information**: All fields must be completed +2. **Ingredients**: Include both metric and imperial measurements +3. **Instructions**: Step-by-step with pro tips and common mistakes +4. **Safety**: Include allergen information and safety warnings +5. **Nutrition**: Provide complete nutritional information +6. **Science**: Explain the cooking science when relevant + +### Content Quality Standards + +#### Required Elements +- ✅ Accurate measurements with units +- ✅ Clear, step-by-step instructions +- ✅ Safety warnings and allergen information +- ✅ Nutritional information +- ✅ Cultural context when relevant +- ✅ High-quality images (if applicable) + +#### Prohibited Elements +- ❌ Vague or imprecise measurements +- ❌ Unclear cooking instructions +- ❌ Missing safety warnings +- ❌ Incomplete nutritional information +- ❌ Cultural appropriation without context + +### Recipe Categories + +#### Main Categories +- **Appetizers**: Small dishes served before main course +- **Main Courses**: Primary dishes of a meal +- **Desserts**: Sweet dishes served after main course +- **Beverages**: Drinks and cocktails +- **Basics**: Fundamental techniques and recipes + +#### Subcategories +- **Cuisine Types**: Italian, French, Asian, Mexican, etc. +- **Dietary Restrictions**: Vegetarian, Vegan, Gluten-Free, etc. +- **Difficulty Levels**: Beginner, Intermediate, Advanced +- **Cooking Methods**: Baking, Grilling, Frying, etc. + +## 🔧 Technical Requirements + +### File Naming Convention +``` +recipes/ +├── appetizers/ +│ └── bruschetta-with-tomato-basil.md +├── main-courses/ +│ └── classic-margherita-pizza.md +├── desserts/ +│ └── tiramisu-classico.md +└── beverages/ + └── classic-mojito.md +``` + +### Markdown Formatting +- Use consistent heading levels (H1, H2, H3) +- Include proper spacing between sections +- Use bullet points and numbered lists appropriately +- Include emojis for visual appeal and categorization +- Follow the exact template structure + +### Image Requirements +- **Resolution**: Minimum 1200x800 pixels +- **Format**: JPG or PNG +- **Quality**: High-quality, well-lit food photography +- **Attribution**: Proper credit for all images +- **Alt Text**: Descriptive alt text for accessibility + +### Metadata Standards +```yaml +--- +title: "Recipe Name" +category: "Main Course" +cuisine: "Italian" +difficulty: "Intermediate" +prep_time: "30 minutes" +cook_time: "45 minutes" +servings: 4 +calories: 350 +tags: ["pizza", "italian", "main-course"] +--- +``` + +## 📋 Submission Process + +### 1. Create Your Recipe +- Copy the template from `cookbook/templates/recipe-template.md` +- Fill in all required sections +- Add high-quality images if applicable +- Test your recipe if possible + +### 2. Quality Check +Use the pre-submission checklist: + +- [ ] All required sections completed +- [ ] Measurements accurate with units +- [ ] Instructions clear and step-by-step +- [ ] Safety warnings included +- [ ] Nutritional information provided +- [ ] Cultural context appropriate +- [ ] Images high-quality and attributed +- [ ] File follows naming conventions +- [ ] Markdown formatting correct +- [ ] Content proofread + +### 3. Submit Pull Request +```bash +# Create pull request +gh pr create --title "Add: [Recipe Name]" --body " +## Description +Brief description of the recipe and why it's valuable. + +## Category +[Appetizer/Main Course/Dessert/Beverage/Basic] + +## Testing +- [ ] Recipe tested in real kitchen +- [ ] Measurements verified +- [ ] Instructions followed successfully + +## Additional Notes +Any other relevant information. +" +``` + +### 4. Pull Request Requirements + +#### Title Format +``` +Add: [Recipe Name] - Brief description +Improve: [Recipe Name] - What was improved +Fix: [Recipe Name] - What was fixed +``` + +#### Description Requirements +- **Clear title**: Descriptive of what's being added +- **Detailed description**: What the recipe is and why it's valuable +- **Category assignment**: Where the recipe should be placed +- **Testing notes**: Any testing that was performed +- **Related issues**: Link to any related discussions + +## 🔍 Review Process + +### Automated Checks +- **Linting**: Markdown formatting validation +- **Template Compliance**: Structure verification +- **Image Validation**: Alt text and attribution checks +- **Link Validation**: Internal and external link verification + +### Human Review +1. **Content Review**: Maintainers review recipe content +2. **Technical Review**: Check formatting and structure +3. **Culinary Review**: Verify accuracy and technique +4. **Final Approval**: Repository maintainers approve + +### Review Timeline +- **Automated checks**: Immediate +- **Content review**: Within 1 week +- **Technical review**: Within 3-5 days +- **Final approval**: Within 1 week + +## 🚨 Common Issues and Solutions + +### Template Compliance Issues +**Problem**: Missing required sections +**Solution**: Use the exact template structure, fill all sections + +**Problem**: Incorrect formatting +**Solution**: Follow markdown guidelines, use proper headings + +### Content Quality Issues +**Problem**: Vague instructions +**Solution**: Be specific, include measurements, timing, and visual cues + +**Problem**: Missing safety information +**Solution**: Always include allergen warnings and safety notes + +### Technical Issues +**Problem**: File naming errors +**Solution**: Use kebab-case, include category prefix + +**Problem**: Image problems +**Solution**: Ensure proper resolution, format, and attribution + +## 🎯 Best Practices + +### For AI Agents +1. **Follow Templates Exactly**: Don't modify the structure +2. **Be Specific**: Include precise measurements and timing +3. **Add Context**: Explain why techniques work +4. **Include Safety**: Always mention allergens and safety +5. **Quality Over Quantity**: One excellent recipe is better than ten mediocre ones + +### For Human Contributors +1. **Test Your Recipes**: Cook them before submitting +2. **Take Photos**: Include high-quality images +3. **Be Accurate**: Double-check measurements and instructions +4. **Share Knowledge**: Include tips and tricks you've learned +5. **Respect Culture**: Provide proper cultural context + +### For Developers +1. **Improve Templates**: Make them more user-friendly +2. **Add Tools**: Create utilities for recipe management +3. **Fix Bugs**: Correct technical issues +4. **Enhance Documentation**: Improve guides and references +5. **Automate Processes**: Streamline submission and review + +## 📚 Resources and References + +### Internal Resources +- [Main README](README.md) +- [Recipe Template](cookbook/templates/recipe-template.md) +- [Cooking Techniques Guide](cookbook/docs/cooking-techniques.md) +- [Substitution Chart](cookbook/docs/substitutions.md) +- [Conversion Tables](cookbook/docs/conversions.md) +- [Food Safety Guidelines](cookbook/docs/food-safety.md) + +### External Resources +- [Culinary Institute of America](https://www.ciachef.edu/) +- [Food Network](https://www.foodnetwork.com/) +- [Serious Eats](https://www.seriouseats.com/) +- [Bon Appétit](https://www.bonappetit.com/) + +### Tools and Utilities +- **Recipe Calculators**: Portion scaling, unit conversion +- **Image Editors**: Photo enhancement and optimization +- **Markdown Editors**: VS Code, Typora, Obsidian +- **Version Control**: Git, GitHub Desktop + +## 🤝 Community Guidelines + +### Code of Conduct +- **Be Respectful**: Treat all contributors with respect +- **Be Inclusive**: Welcome contributors from all backgrounds +- **Be Helpful**: Provide constructive feedback +- **Be Patient**: Understand that learning takes time +- **Be Collaborative**: Work together to improve the repository + +### Communication +- **Issues**: Use GitHub issues for bugs and feature requests +- **Discussions**: Use GitHub discussions for questions and ideas +- **Pull Requests**: Provide clear, constructive feedback +- **Documentation**: Help improve guides and references + +### Recognition +- **Contributors**: All contributors are credited in recipe files +- **Significant Contributions**: Acknowledged in main README +- **Regular Contributors**: May become maintainers +- **Special Recognition**: For exceptional contributions + +## 🆘 Getting Help + +### When You Need Assistance +1. **Check Documentation**: Review guides and references first +2. **Search Issues**: Look for similar problems in closed issues +3. **Ask Questions**: Use GitHub discussions for help +4. **Contact Maintainers**: For urgent or complex issues + +### Common Questions +**Q: Can I submit a recipe I found online?** +A: Only if you have permission or it's in the public domain. Always credit original sources. + +**Q: What if my recipe doesn't fit the template exactly?** +A: The template is designed to be comprehensive. If you need to modify it, discuss with maintainers first. + +**Q: How do I know if my recipe is good enough?** +A: Use the pre-submission checklist. If you're unsure, ask for feedback in discussions. + +## 📈 Future Contributions + +### Planned Features +- **AI Recipe Generation**: Tools for AI agents to create recipes +- **Interactive Cooking Guides**: Step-by-step video integration +- **Recipe Scaling**: Automatic portion adjustment +- **Dietary Filtering**: Advanced search and filtering options +- **Community Features**: User ratings and reviews + +### How to Help +- **Test New Features**: Try out new tools and provide feedback +- **Suggest Improvements**: Share ideas for new features +- **Document Processes**: Help write guides for new features +- **Spread the Word**: Share the repository with others + +--- + +## 🎯 Quick Start Checklist + +**Ready to contribute? Here's your action plan:** + +1. **Fork the repository** to your account +2. **Read the documentation** thoroughly +3. **Choose a recipe** to create or improve +4. **Follow the template** exactly +5. **Test your content** if possible +6. **Submit a pull request** with detailed description +7. **Respond to feedback** and make improvements +8. **Celebrate your contribution!** + +**Remember**: Quality over quantity. One excellent, detailed recipe is worth more than ten incomplete ones. + +**Need help?** Check the documentation, ask questions in discussions, or contact maintainers. + +--- + +*This contributing guide is a living document. New guidelines and best practices will be added as they become available.* + +*Last updated: [Current Date]* +*Version: 1.0.0* +*Maintained by: [Your Name/Organization]* \ No newline at end of file diff --git a/README.md b/README.md index b98b90c..5292d8d 100644 --- a/README.md +++ b/README.md @@ -1,33 +1,413 @@ -![Incredible-API-Docs-logo-lightmode](https://github.com/user-attachments/assets/366ceb9d-06e5-45ac-b234-8c5f28743c9a#gh-light-mode-only) ![Incredible-API-docs-logo](https://github.com/user-attachments/assets/6ffc602e-d3b6-4681-871e-1db4cdf25852#gh-dark-mode-only) +# 🍳 AI Cookbook Repository - Comprehensive Guide for AI Agents +## 📚 Table of Contents +- [Overview](#overview) +- [Repository Structure](#repository-structure) +- [Getting Started](#getting-started) +- [Recipe Template Standards](#recipe-template-standards) +- [Content Guidelines](#content-guidelines) +- [Technical Requirements](#technical-requirements) +- [Quality Assurance](#quality-assurance) +- [Submission Process](#submission-process) +- [Examples & References](#examples--references) +- [Troubleshooting](#troubleshooting) +- [Contributing Guidelines](#contributing-guidelines) -## Development +## 🎯 Overview -Install the [Mintlify CLI](https://www.npmjs.com/package/mint) to preview your documentation changes locally. To install, use the following command: +Welcome to the AI Cookbook Repository! This repository serves as a comprehensive collection of cooking recipes, techniques, and culinary knowledge specifically designed for AI agents to learn from and contribute to. Our mission is to create the most detailed, accurate, and AI-friendly cookbook in existence. + +### 🎯 Purpose +- Provide AI agents with structured, comprehensive cooking knowledge +- Establish standards for recipe creation and documentation +- Create a reference database for culinary AI applications +- Enable AI agents to generate high-quality cooking content + +### 🎯 Target Audience +- AI agents and language models +- Developers building culinary AI applications +- Cooking enthusiasts seeking detailed recipes +- Educational institutions teaching culinary arts + +## 🏗️ Repository Structure ``` -npm i -g mint +cookbook/ +├── recipes/ # Individual recipe files +│ ├── appetizers/ # Appetizer recipes +│ ├── main-courses/ # Main course recipes +│ ├── desserts/ # Dessert recipes +│ ├── beverages/ # Drink recipes +│ └── basics/ # Basic techniques and recipes +├── techniques/ # Cooking techniques and methods +├── ingredients/ # Ingredient information and guides +├── equipment/ # Kitchen equipment guides +├── nutrition/ # Nutritional information +├── cultural/ # Cultural and regional cuisines +├── templates/ # Recipe and content templates +├── assets/ # Images, diagrams, and media +├── docs/ # Documentation and guides +└── tests/ # Recipe testing and validation ``` -Run the following command at the root of your documentation, where your `docs.json` is located: +## 🚀 Getting Started +### Prerequisites for AI Agents +- Understanding of markdown formatting +- Knowledge of cooking terminology and techniques +- Ability to follow structured templates +- Attention to detail and accuracy + +### First Steps +1. **Familiarize yourself** with the repository structure +2. **Review existing recipes** to understand the format +3. **Study the templates** in the `templates/` directory +4. **Choose a recipe category** to contribute to +5. **Follow the submission process** outlined below + +## 📝 Recipe Template Standards + +### Required Recipe Structure +Every recipe must follow this exact structure: + +```markdown +# Recipe Name + +## 📋 Recipe Information +- **Category**: [Appetizer/Main Course/Dessert/Beverage/Basic] +- **Cuisine**: [Regional or cultural origin] +- **Difficulty**: [Beginner/Intermediate/Advanced] +- **Prep Time**: [X minutes] +- **Cook Time**: [X minutes] +- **Total Time**: [X minutes] +- **Servings**: [X servings] +- **Calories per serving**: [X calories] + +## 🎯 Recipe Summary +Brief 2-3 sentence description of the dish, its key characteristics, and what makes it special. + +## 🥘 Ingredients + +### Main Ingredients +- [Quantity] [Unit] [Ingredient Name] - [Special notes if applicable] + +### Optional/Substitution Ingredients +- [Quantity] [Unit] [Ingredient Name] - [What it can replace] + +## 🛠️ Equipment Needed +- [Equipment name] - [Specific requirements or alternatives] +- [Equipment name] - [Specific requirements or alternatives] + +## 📖 Step-by-Step Instructions + +### Preparation Phase +1. **Step Description**: Detailed explanation of what to do + - **Pro Tip**: Additional helpful information + - **Common Mistake**: What to avoid + +2. **Step Description**: Detailed explanation of what to do + - **Pro Tip**: Additional helpful information + - **Common Mistake**: What to avoid + +### Cooking Phase +1. **Step Description**: Detailed explanation of what to do + - **Pro Tip**: Additional helpful information + - **Common Mistake**: What to avoid + +2. **Step Description**: Detailed explanation of what to do + - **Pro Tip**: Additional helpful information + - **Common Mistake**: What to avoid + +## 🔍 Visual Cues & Doneness Indicators +- **Visual**: Describe what the dish should look like +- **Texture**: Describe the expected texture +- **Temperature**: Specific temperature readings if applicable +- **Time**: Time-based indicators + +## 🎨 Presentation & Plating +- **Garnish suggestions**: Specific garnishes and placement +- **Serving temperature**: Hot, warm, or cold +- **Plate selection**: Type and size of serving dish +- **Arrangement**: How to arrange components on the plate + +## 🍽️ Serving Suggestions +- **Accompaniments**: What to serve with the dish +- **Beverage pairings**: Recommended drinks +- **Meal context**: When to serve this dish + +## 📊 Nutritional Information +- **Calories**: Per serving +- **Protein**: Grams per serving +- **Carbohydrates**: Grams per serving +- **Fat**: Grams per serving +- **Fiber**: Grams per serving +- **Sugar**: Grams per serving +- **Sodium**: Milligrams per serving + +## 🔄 Variations & Substitutions +- **Variation 1**: Description and modifications needed +- **Variation 2**: Description and modifications needed +- **Substitution 1**: What to replace and with what +- **Substitution 2**: What to replace and with what + +## 🚨 Allergen Information +- **Contains**: List of allergens present +- **May contain**: Potential cross-contamination risks +- **Allergen-free alternatives**: How to make allergen-free versions + +## 💡 Tips & Tricks +- **Pro Tip 1**: Advanced technique or insight +- **Pro Tip 2**: Advanced technique or insight +- **Time-saving tip**: How to prepare ahead or save time +- **Storage tip**: How to store leftovers + +## ❓ Frequently Asked Questions +**Q: Common question about the recipe?** +A: Detailed answer with explanation. + +**Q: Another common question?** +A: Detailed answer with explanation. + +## 🔬 Science Behind the Recipe +- **Chemical reactions**: What happens during cooking +- **Temperature effects**: Why specific temperatures matter +- **Ingredient interactions**: How ingredients work together + +## 📚 Related Recipes +- [Related Recipe 1](link-to-recipe) +- [Related Recipe 2](link-to-recipe) +- [Related Recipe 3](link-to-recipe) + +## 📝 Notes & References +- **Source**: Where the recipe originated +- **Cultural significance**: Historical or cultural context +- **Additional resources**: Books, videos, or websites for more information + +## 🏷️ Tags +[tag1], [tag2], [tag3], [tag4], [tag5] ``` -mint dev -``` -View your local preview at `http://localhost:3000`. +## 📋 Content Guidelines + +### Content Quality Standards +- **Accuracy**: All information must be factually correct +- **Completeness**: Every section must be fully filled out +- **Clarity**: Instructions must be clear and unambiguous +- **Consistency**: Follow established formatting and terminology +- **Accessibility**: Use inclusive language and clear explanations + +### Required Content Elements +1. **Detailed measurements** with both metric and imperial units +2. **Step-by-step instructions** with specific timing +3. **Visual descriptions** for each step +4. **Troubleshooting tips** for common issues +5. **Nutritional information** when applicable +6. **Allergen warnings** for safety +7. **Cultural context** when relevant + +### Prohibited Content +- Vague or imprecise measurements +- Unclear cooking instructions +- Missing safety warnings +- Incomplete nutritional information +- Cultural appropriation without proper context + +## ⚙️ Technical Requirements + +### File Naming Convention +- Use kebab-case for filenames +- Include category prefix: `appetizer-`, `main-`, `dessert-`, etc. +- Use descriptive names: `classic-margherita-pizza.md` + +### Markdown Formatting +- Use consistent heading levels (H1, H2, H3) +- Include proper spacing between sections +- Use bullet points and numbered lists appropriately +- Include emojis for visual appeal and categorization + +### Image Requirements +- High-quality, well-lit food photography +- Multiple angles showing different stages +- Proper attribution for all images +- Alt text descriptions for accessibility + +### Metadata Standards +- Include YAML front matter for categorization +- Use consistent tag systems +- Include difficulty ratings and time estimates +- Specify cuisine type and cultural origin + +## ✅ Quality Assurance + +### Pre-Submission Checklist +- [ ] All required sections are completed +- [ ] Measurements are accurate and include units +- [ ] Instructions are clear and step-by-step +- [ ] Safety warnings are included +- [ ] Nutritional information is provided +- [ ] Cultural context is appropriate +- [ ] Images are high-quality and properly attributed +- [ ] File follows naming conventions +- [ ] Markdown formatting is correct +- [ ] Content has been proofread + +### Validation Process +1. **Automated checks**: Linting and format validation +2. **Peer review**: Other contributors review content +3. **Expert review**: Culinary experts verify accuracy +4. **Testing**: Recipes are tested in real kitchens +5. **Final approval**: Content is approved for inclusion + +## 📤 Submission Process + +### How to Submit +1. **Fork the repository** to your own account +2. **Create a new branch** for your recipe +3. **Add your recipe file** following the template +4. **Include all required assets** (images, etc.) +5. **Submit a pull request** with detailed description +6. **Respond to review comments** and make improvements +7. **Wait for approval** and merge + +### Pull Request Requirements +- **Clear title**: Descriptive of what's being added +- **Detailed description**: What the recipe is and why it's valuable +- **Category assignment**: Where the recipe should be placed +- **Testing notes**: Any testing that was performed +- **Related issues**: Link to any related discussions + +### Review Process +- **Automated checks** must pass +- **Content review** by maintainers +- **Technical review** for formatting and structure +- **Culinary review** for accuracy and technique +- **Final approval** by repository maintainers + +## 📖 Examples & References + +### Excellent Recipe Examples +- [Classic Margherita Pizza](examples/classic-margherita-pizza.md) +- [Beef Bourguignon](examples/beef-bourguignon.md) +- [Tiramisu](examples/tiramisu.md) + +### Reference Materials +- [Cooking Techniques Guide](docs/cooking-techniques.md) +- [Ingredient Substitution Chart](docs/substitutions.md) +- [Measurement Conversion Tables](docs/conversions.md) +- [Food Safety Guidelines](docs/food-safety.md) + +### External Resources +- [Culinary Institute of America](https://www.ciachef.edu/) +- [Food Network](https://www.foodnetwork.com/) +- [Serious Eats](https://www.seriouseats.com/) +- [Bon Appétit](https://www.bonappetit.com/) + +## 🚨 Troubleshooting + +### Common Issues +**Problem**: Recipe instructions are unclear +**Solution**: Break down steps into smaller, more specific actions + +**Problem**: Missing measurements or units +**Solution**: Always include precise measurements with standard units + +**Problem**: Incomplete nutritional information +**Solution**: Use reliable sources or calculate from ingredients + +**Problem**: Poor image quality +**Solution**: Use high-resolution photos with proper lighting + +### Getting Help +- Check existing documentation first +- Search through closed issues for similar problems +- Ask questions in the discussion section +- Contact maintainers for urgent issues + +## 🤝 Contributing Guidelines + +### Code of Conduct +- Be respectful and inclusive +- Provide constructive feedback +- Help other contributors +- Follow established guidelines +- Maintain high quality standards + +### Contribution Types +- **New recipes**: Complete recipes following templates +- **Recipe improvements**: Enhancements to existing recipes +- **Documentation**: Improve guides and templates +- **Bug fixes**: Correct errors in recipes +- **Translations**: Add recipes in other languages + +### Recognition +- Contributors are credited in recipe files +- Significant contributions are acknowledged in the main README +- Regular contributors may become maintainers +- Special recognition for exceptional contributions + +## 📞 Contact & Support + +### Repository Maintainers +- **Lead Maintainer**: [Name] - [Email] +- **Technical Maintainer**: [Name] - [Email] +- **Culinary Expert**: [Name] - [Email] + +### Communication Channels +- **Issues**: Use GitHub issues for bugs and feature requests +- **Discussions**: Use GitHub discussions for questions and ideas +- **Email**: [repository-email@domain.com] +- **Discord**: [Discord server link] + +### Response Times +- **Critical issues**: Within 24 hours +- **General questions**: Within 3-5 days +- **Feature requests**: Within 1-2 weeks +- **Recipe reviews**: Within 1 week + +## 📈 Future Roadmap + +### Planned Features +- **AI recipe generation**: Tools for AI agents to create recipes +- **Interactive cooking guides**: Step-by-step video integration +- **Recipe scaling**: Automatic portion adjustment +- **Dietary filtering**: Advanced search and filtering options +- **Community features**: User ratings and reviews + +### Development Timeline +- **Q1 2024**: Basic recipe structure and templates +- **Q2 2024**: Advanced features and AI integration +- **Q3 2024**: Community features and mobile app +- **Q4 2024**: Advanced AI tools and machine learning + +## 📄 License + +This repository is licensed under the [MIT License](LICENSE). By contributing, you agree that your contributions will be licensed under the same license. + +## 🙏 Acknowledgments + +- **Contributors**: All the amazing people who contribute recipes +- **Culinary Experts**: Professional chefs and food scientists +- **Open Source Community**: Tools and platforms that make this possible +- **AI Community**: Inspiration and collaboration opportunities + +--- + +## 🎯 Quick Start for AI Agents -## Publishing changes +**Ready to contribute? Here's your 5-minute action plan:** -Install our GitHub app from your [dashboard](https://dashboard.mintlify.com/settings/organization/github-app) to propagate changes from your repo to your deployment. Changes are deployed to production automatically after pushing to the default branch. +1. **Choose a recipe** you want to create or improve +2. **Copy the template** from `templates/recipe-template.md` +3. **Fill in all sections** following the guidelines above +4. **Add high-quality images** and proper attribution +5. **Submit your contribution** via pull request -## Need help? +**Remember**: Quality over quantity. One excellent, detailed recipe is worth more than ten incomplete ones. -### Troubleshooting +**Need help?** Check the examples, read the documentation, or ask questions in discussions. -- If your dev environment isn't running: Run `mint update` to ensure you have the most recent version of the CLI. -- If a page loads as a 404: Make sure you are running in a folder with a valid `docs.json`. +--- -### Resources -- [Mintlify documentation](https://mintlify.com/docs) -- [Mintlify community](https://mintlify.com/community) \ No newline at end of file +*Last updated: [Current Date]* +*Version: 1.0.0* +*Maintained by: [Your Name/Organization]* \ No newline at end of file diff --git a/cookbook/docs/conversions.md b/cookbook/docs/conversions.md new file mode 100644 index 0000000..1298572 --- /dev/null +++ b/cookbook/docs/conversions.md @@ -0,0 +1,339 @@ +# 📏 Measurement Conversion Tables + +## 📚 Overview +This comprehensive conversion guide provides AI agents and cooks with accurate measurement conversions between different units and systems. All conversions are precise and include common cooking measurements used in recipes worldwide. + +## 🌍 Measurement Systems + +### Primary Systems +- **Metric System**: Used in most countries worldwide +- **Imperial System**: Used primarily in the United States +- **US Customary**: Similar to Imperial but with some differences +- **Volume vs. Weight**: Understanding when to use each + +## 📊 Weight Conversions + +### Metric to Imperial Weight + +#### Grams to Ounces +| Grams | Ounces | Common Use | +|-------|--------|------------| +| 1 g | 0.035 oz | Spices, herbs | +| 5 g | 0.18 oz | Small amounts | +| 10 g | 0.35 oz | Seasonings | +| 15 g | 0.53 oz | Small ingredients | +| 25 g | 0.88 oz | Medium ingredients | +| 50 g | 1.76 oz | Small portions | +| 100 g | 3.53 oz | Standard portions | +| 150 g | 5.29 oz | Medium portions | +| 200 g | 7.05 oz | Large portions | +| 250 g | 8.82 oz | Quarter pound | +| 500 g | 17.64 oz | Half kilogram | +| 1 kg | 35.27 oz | Full kilogram | + +#### Kilograms to Pounds +| Kilograms | Pounds | Ounces | Common Use | +|-----------|--------|--------|------------| +| 0.1 kg | 0.22 lb | 3.5 oz | Small amounts | +| 0.25 kg | 0.55 lb | 8.8 oz | Quarter kilo | +| 0.5 kg | 1.10 lb | 17.6 oz | Half kilo | +| 0.75 kg | 1.65 lb | 26.5 oz | Three-quarter kilo | +| 1 kg | 2.20 lb | 35.3 oz | Full kilo | +| 1.5 kg | 3.31 lb | 52.9 oz | Large amounts | +| 2 kg | 4.41 lb | 70.6 oz | Very large amounts | + +### Imperial to Metric Weight + +#### Ounces to Grams +| Ounces | Grams | Common Use | +|--------|-------|------------| +| 0.25 oz | 7.09 g | Very small amounts | +| 0.5 oz | 14.17 g | Small amounts | +| 1 oz | 28.35 g | Standard ounce | +| 2 oz | 56.70 g | Two ounces | +| 3 oz | 85.05 g | Three ounces | +| 4 oz | 113.40 g | Quarter pound | +| 6 oz | 170.10 g | Six ounces | +| 8 oz | 226.80 g | Half pound | +| 12 oz | 340.20 g | Three-quarters pound | +| 16 oz | 453.59 g | Full pound | + +#### Pounds to Kilograms +| Pounds | Kilograms | Grams | Common Use | +|--------|-----------|-------|------------| +| 0.25 lb | 0.11 kg | 113.4 g | Quarter pound | +| 0.5 lb | 0.23 kg | 226.8 g | Half pound | +| 0.75 lb | 0.34 kg | 340.2 g | Three-quarters pound | +| 1 lb | 0.45 kg | 453.6 g | Full pound | +| 1.5 lb | 0.68 kg | 680.4 g | Pound and a half | +| 2 lb | 0.91 kg | 907.2 g | Two pounds | +| 3 lb | 1.36 kg | 1360.8 g | Three pounds | +| 5 lb | 2.27 kg | 2268.0 g | Five pounds | + +## 🥄 Volume Conversions + +### Metric to Imperial Volume + +#### Milliliters to Fluid Ounces +| Milliliters | Fluid Ounces | Common Use | +|-------------|--------------|------------| +| 5 ml | 0.17 fl oz | Very small amounts | +| 10 ml | 0.34 fl oz | Small amounts | +| 15 ml | 0.51 fl oz | Tablespoon (metric) | +| 30 ml | 1.01 fl oz | Two tablespoons | +| 50 ml | 1.69 fl oz | Small amounts | +| 100 ml | 3.38 fl oz | Small cups | +| 150 ml | 5.07 fl oz | Small cups | +| 200 ml | 6.76 fl oz | Medium cups | +| 250 ml | 8.45 fl oz | Standard cups | +| 500 ml | 16.91 fl oz | Half liter | +| 1 L | 33.81 fl oz | Full liter | + +#### Liters to Cups/Quarts +| Liters | Cups | Quarts | Common Use | +|--------|------|--------|------------| +| 0.1 L | 0.42 cups | 0.11 qt | Very small amounts | +| 0.25 L | 1.06 cups | 0.26 qt | Quarter liter | +| 0.5 L | 2.11 cups | 0.53 qt | Half liter | +| 0.75 L | 3.17 cups | 0.79 qt | Three-quarter liter | +| 1 L | 4.23 cups | 1.06 qt | Full liter | +| 1.5 L | 6.34 cups | 1.59 qt | Large amounts | +| 2 L | 8.45 cups | 2.11 qt | Very large amounts | + +### Imperial to Metric Volume + +#### Fluid Ounces to Milliliters +| Fluid Ounces | Milliliters | Common Use | +|--------------|-------------|------------| +| 0.25 fl oz | 7.39 ml | Very small amounts | +| 0.5 fl oz | 14.79 ml | Small amounts | +| 1 fl oz | 29.57 ml | Standard ounce | +| 2 fl oz | 59.15 ml | Two ounces | +| 3 fl oz | 88.72 ml | Three ounces | +| 4 fl oz | 118.29 ml | Quarter cup | +| 6 fl oz | 177.44 ml | Three-quarters cup | +| 8 fl oz | 236.59 ml | Full cup | +| 12 fl oz | 354.88 ml | Cup and a half | +| 16 fl oz | 473.18 ml | Pint | +| 32 fl oz | 946.35 ml | Quart | + +#### Cups to Milliliters +| Cups | Milliliters | Liters | Common Use | +|------|-------------|--------|------------| +| 0.25 cup | 59.15 ml | 0.06 L | Quarter cup | +| 0.33 cup | 78.07 ml | 0.08 L | Third cup | +| 0.5 cup | 118.29 ml | 0.12 L | Half cup | +| 0.67 cup | 158.51 ml | 0.16 L | Two-thirds cup | +| 0.75 cup | 177.44 ml | 0.18 L | Three-quarters cup | +| 1 cup | 236.59 ml | 0.24 L | Full cup | +| 1.5 cups | 354.88 ml | 0.35 L | Cup and a half | +| 2 cups | 473.18 ml | 0.47 L | Two cups | +| 3 cups | 709.76 ml | 0.71 L | Three cups | +| 4 cups | 946.35 ml | 0.95 L | Quart | + +## 🥄 Common Cooking Measurements + +### Spoon Measurements + +#### Metric Spoons +| Metric | Imperial | Milliliters | Common Use | +|--------|----------|-------------|------------| +| 1 ml | 0.034 fl oz | 1 ml | Very small amounts | +| 5 ml | 0.17 fl oz | 5 ml | Teaspoon (metric) | +| 15 ml | 0.51 fl oz | 15 ml | Tablespoon (metric) | +| 30 ml | 1.01 fl oz | 30 ml | Two tablespoons | + +#### Imperial Spoons +| Imperial | Metric | Milliliters | Common Use | +|----------|--------|-------------|------------| +| 1/4 tsp | 1.25 ml | 1.25 ml | Very small amounts | +| 1/2 tsp | 2.5 ml | 2.5 ml | Half teaspoon | +| 1 tsp | 5 ml | 5 ml | Standard teaspoon | +| 1/2 tbsp | 7.5 ml | 7.5 ml | Half tablespoon | +| 1 tbsp | 15 ml | 15 ml | Standard tablespoon | +| 2 tbsp | 30 ml | 30 ml | Two tablespoons | + +### Cup Measurements + +#### Metric Cups +| Metric | Imperial | Milliliters | Common Use | +|--------|----------|-------------|------------| +| 50 ml | 0.21 cups | 50 ml | Small amounts | +| 100 ml | 0.42 cups | 100 ml | Small cups | +| 150 ml | 0.63 cups | 150 ml | Medium cups | +| 200 ml | 0.85 cups | 200 ml | Large cups | +| 250 ml | 1.06 cups | 250 ml | Standard cups | + +#### Imperial Cups +| Imperial | Metric | Milliliters | Common Use | +|----------|--------|-------------|------------| +| 1/8 cup | 29.57 ml | 29.57 ml | Very small amounts | +| 1/4 cup | 59.15 ml | 59.15 ml | Quarter cup | +| 1/3 cup | 78.87 ml | 78.87 ml | Third cup | +| 1/2 cup | 118.29 ml | 118.29 ml | Half cup | +| 2/3 cup | 157.73 ml | 157.73 ml | Two-thirds cup | +| 3/4 cup | 177.44 ml | 177.44 ml | Three-quarters cup | +| 1 cup | 236.59 ml | 236.59 ml | Full cup | + +## 🌡️ Temperature Conversions + +### Celsius to Fahrenheit +| Celsius | Fahrenheit | Common Use | +|---------|------------|------------| +| -10°C | 14°F | Freezing | +| 0°C | 32°F | Water freezing | +| 10°C | 50°F | Cool | +| 20°C | 68°F | Room temperature | +| 30°C | 86°F | Warm | +| 40°C | 104°F | Hot | +| 50°C | 122°F | Very hot | +| 60°C | 140°F | Simmering | +| 70°C | 158°F | Poaching | +| 80°C | 176°F | Low simmer | +| 90°C | 194°F | Simmering | +| 100°C | 212°F | Boiling | +| 110°C | 230°F | Low oven | +| 120°C | 248°F | Low oven | +| 130°C | 266°F | Low oven | +| 140°C | 284°F | Low oven | +| 150°C | 302°F | Low oven | +| 160°C | 320°F | Low oven | +| 170°C | 338°F | Medium oven | +| 180°C | 356°F | Medium oven | +| 190°C | 374°F | Medium oven | +| 200°C | 392°F | Medium oven | +| 210°C | 410°F | High oven | +| 220°C | 428°F | High oven | +| 230°C | 446°F | High oven | +| 240°C | 464°F | High oven | +| 250°C | 482°F | Very high oven | + +### Fahrenheit to Celsius +| Fahrenheit | Celsius | Common Use | +|------------|---------|------------| +| 32°F | 0°C | Water freezing | +| 50°F | 10°C | Cool | +| 68°F | 20°C | Room temperature | +| 86°F | 30°C | Warm | +| 104°F | 40°C | Hot | +| 122°F | 50°C | Very hot | +| 140°F | 60°C | Simmering | +| 158°F | 70°C | Poaching | +| 176°F | 80°C | Low simmer | +| 194°F | 90°C | Simmering | +| 212°F | 100°C | Boiling | +| 230°F | 110°C | Low oven | +| 248°F | 120°C | Low oven | +| 266°F | 130°C | Low oven | +| 284°F | 140°C | Low oven | +| 302°F | 150°C | Low oven | +| 320°F | 160°C | Low oven | +| 338°F | 170°C | Medium oven | +| 356°F | 180°C | Medium oven | +| 374°F | 190°C | Medium oven | +| 392°F | 200°C | Medium oven | +| 410°F | 210°C | High oven | +| 428°F | 220°C | High oven | +| 446°F | 230°C | High oven | +| 464°F | 240°C | High oven | +| 482°F | 250°C | Very high oven | +| 500°F | 260°C | Broiling | +| 518°F | 270°C | Broiling | +| 536°F | 280°C | Broiling | + +## 📏 Length Conversions + +### Metric to Imperial Length +| Centimeters | Inches | Common Use | +|-------------|--------|------------| +| 1 cm | 0.39 in | Very small | +| 2.5 cm | 1 in | Standard inch | +| 5 cm | 1.97 in | Small | +| 10 cm | 3.94 in | Medium | +| 15 cm | 5.91 in | Medium | +| 20 cm | 7.87 in | Large | +| 25 cm | 9.84 in | Large | +| 30 cm | 11.81 in | Very large | + +### Imperial to Metric Length +| Inches | Centimeters | Common Use | +|--------|-------------|------------| +| 0.25 in | 0.64 cm | Very small | +| 0.5 in | 1.27 cm | Small | +| 1 in | 2.54 cm | Standard inch | +| 2 in | 5.08 cm | Two inches | +| 3 in | 7.62 cm | Three inches | +| 4 in | 10.16 cm | Four inches | +| 6 in | 15.24 cm | Six inches | +| 8 in | 20.32 cm | Eight inches | +| 12 in | 30.48 cm | Foot | + +## 🧮 Conversion Formulas + +### Weight Conversions +- **Grams to Ounces**: `grams × 0.035 = ounces` +- **Ounces to Grams**: `ounces × 28.35 = grams` +- **Kilograms to Pounds**: `kilograms × 2.205 = pounds` +- **Pounds to Kilograms**: `pounds × 0.454 = kilograms` + +### Volume Conversions +- **Milliliters to Fluid Ounces**: `milliliters × 0.034 = fluid ounces` +- **Fluid Ounces to Milliliters**: `fluid ounces × 29.57 = milliliters` +- **Liters to Cups**: `liters × 4.23 = cups` +- **Cups to Liters**: `cups × 0.237 = liters` + +### Temperature Conversions +- **Celsius to Fahrenheit**: `(celsius × 9/5) + 32 = fahrenheit` +- **Fahrenheit to Celsius**: `(fahrenheit - 32) × 5/9 = celsius` + +### Length Conversions +- **Centimeters to Inches**: `centimeters × 0.394 = inches` +- **Inches to Centimeters**: `inches × 2.54 = centimeters` + +## 🎯 Common Recipe Conversions + +### Baking Conversions +| Ingredient | Metric | Imperial | Notes | +|------------|--------|----------|-------| +| Flour | 120 g | 1 cup | Spoon and level method | +| Sugar | 200 g | 1 cup | Granulated white | +| Brown Sugar | 220 g | 1 cup | Packed | +| Butter | 227 g | 1 cup | 2 sticks | +| Milk | 240 ml | 1 cup | Liquid measure | +| Eggs | 50 g | 1 large | Average size | + +### Liquid Conversions +| Ingredient | Metric | Imperial | Notes | +|------------|--------|----------|-------| +| Water | 240 ml | 1 cup | Standard | +| Oil | 216 ml | 1 cup | Slightly less than water | +| Honey | 340 g | 1 cup | By weight | +| Maple Syrup | 312 g | 1 cup | By weight | + +## ⚠️ Important Notes + +### Accuracy Considerations +1. **Weight vs. Volume**: Weight is more accurate for dry ingredients +2. **Packing Methods**: Brown sugar and flour can vary based on packing +3. **Temperature Effects**: Volume can change with temperature +4. **Humidity**: Dry ingredients can absorb moisture + +### Best Practices +1. **Use weight for baking**: More consistent results +2. **Use volume for liquids**: Standard practice +3. **Check conversions**: Verify with multiple sources +4. **Test small batches**: When converting recipes +5. **Document changes**: Keep notes on successful conversions + +### Common Mistakes +1. **Confusing weight and volume**: Grams vs. milliliters +2. **Incorrect temperature conversions**: Using wrong formula +3. **Not accounting for density**: Different ingredients have different weights per volume +4. **Rounding errors**: Accumulating small errors + +--- + +*This conversion guide is a living document. New conversions and refinements will be added as they become available.* + +*Last updated: [Current Date]* +*Version: 1.0.0* \ No newline at end of file diff --git a/cookbook/docs/cooking-techniques.md b/cookbook/docs/cooking-techniques.md new file mode 100644 index 0000000..8b0bddf --- /dev/null +++ b/cookbook/docs/cooking-techniques.md @@ -0,0 +1,247 @@ +# 🍳 Cooking Techniques Guide + +## 📚 Overview +This guide provides comprehensive information about fundamental cooking techniques that AI agents should understand when creating recipes. Each technique includes detailed explanations, best practices, and common applications. + +## 🔥 Heat-Based Cooking Methods + +### Dry Heat Methods + +#### Baking +- **Definition**: Cooking food in an enclosed space using dry heat +- **Temperature Range**: 300°F - 450°F (150°C - 230°C) +- **Best For**: Breads, pastries, casseroles, meats +- **Key Principles**: + - Preheat oven for consistent results + - Use appropriate pan sizes + - Monitor internal temperatures +- **Common Mistakes**: Opening oven door frequently, overcrowding pans + +#### Roasting +- **Definition**: Cooking food uncovered in dry heat, usually at high temperatures +- **Temperature Range**: 350°F - 500°F (175°C - 260°C) +- **Best For**: Meats, vegetables, whole fish +- **Key Principles**: + - High heat for browning + - Rest meat after cooking + - Use roasting rack for air circulation +- **Common Mistakes**: Not resting meat, overcrowding pan + +#### Grilling +- **Definition**: Cooking food directly over high heat source +- **Temperature Range**: 400°F - 600°F (200°C - 315°C) +- **Best For**: Meats, vegetables, seafood +- **Key Principles**: + - Clean and oil grates + - Control heat zones + - Don't move food too much +- **Common Mistakes**: Flipping too frequently, not preheating + +#### Broiling +- **Definition**: Cooking food under direct, intense heat from above +- **Temperature Range**: 500°F - 550°F (260°C - 290°C) +- **Best For**: Melting cheese, browning tops, quick cooking +- **Key Principles**: + - Watch closely to prevent burning + - Position rack appropriately + - Use broiler-safe pans +- **Common Mistakes**: Leaving unattended, wrong rack position + +### Moist Heat Methods + +#### Boiling +- **Definition**: Cooking food in liquid at 212°F (100°C) +- **Best For**: Pasta, vegetables, eggs, grains +- **Key Principles**: + - Salt water for flavor + - Don't overcrowd pot + - Maintain rolling boil +- **Common Mistakes**: Overcooking, insufficient water + +#### Simmering +- **Definition**: Cooking food in liquid at 185°F - 200°F (85°C - 93°C) +- **Best For**: Soups, stews, braises, poaching +- **Key Principles**: + - Gentle bubbles, not rolling boil + - Maintain consistent temperature + - Cover when appropriate +- **Common Mistakes**: Too high heat, not monitoring temperature + +#### Poaching +- **Definition**: Cooking food in liquid at 160°F - 180°F (71°C - 82°C) +- **Best For**: Eggs, fish, chicken, fruits +- **Key Principles**: + - Maintain gentle temperature + - Use flavorful liquid + - Don't overcrowd +- **Common Mistakes**: Too high heat, wrong liquid temperature + +#### Steaming +- **Definition**: Cooking food using water vapor +- **Temperature**: 212°F (100°C) +- **Best For**: Vegetables, fish, dumplings, rice +- **Key Principles**: + - Don't let water touch food + - Maintain steady steam + - Don't overcook +- **Common Mistakes**: Overcooking, insufficient water + +## 🍳 Combination Methods + +### Braising +- **Definition**: Combination of dry and moist heat cooking +- **Process**: Brown food first, then cook slowly in liquid +- **Best For**: Tough cuts of meat, root vegetables +- **Key Principles**: + - Brown meat well for flavor + - Use flavorful liquid + - Cook low and slow +- **Common Mistakes**: Insufficient browning, too much liquid + +### Stewing +- **Definition**: Cooking food completely submerged in liquid +- **Best For**: Tough meats, vegetables, legumes +- **Key Principles**: + - Cut ingredients uniformly + - Use flavorful broth + - Cook until tender +- **Common Mistakes**: Uneven cutting, bland liquid + +## 🥘 Preparation Techniques + +### Cutting Techniques + +#### Julienne +- **Description**: Cutting food into long, thin strips +- **Dimensions**: 1/8" × 1/8" × 2-3" (3mm × 3mm × 5-8cm) +- **Best For**: Carrots, zucchini, potatoes +- **Method**: Stack slices, cut into strips + +#### Brunoise +- **Description**: Cutting food into small cubes +- **Dimensions**: 1/8" × 1/8" × 1/8" (3mm × 3mm × 3mm) +- **Best For**: Onions, carrots, celery +- **Method**: Julienne first, then cross-cut + +#### Chiffonade +- **Description**: Cutting leafy vegetables into thin ribbons +- **Best For**: Basil, spinach, lettuce +- **Method**: Stack leaves, roll tightly, slice thinly + +#### Mince +- **Description**: Cutting food into very small pieces +- **Best For**: Garlic, herbs, onions +- **Method**: Chop finely until pieces are uniform + +### Mixing Techniques + +#### Folding +- **Description**: Gently combining ingredients without deflating +- **Best For**: Whipped cream, egg whites, delicate batters +- **Method**: Use spatula to cut through and turn over + +#### Creaming +- **Description**: Beating butter and sugar until light and fluffy +- **Best For**: Cakes, cookies, frostings +- **Method**: Beat until mixture is pale and increased in volume + +#### Whisking +- **Description**: Beating ingredients to incorporate air +- **Best For**: Eggs, cream, batters +- **Method**: Use whisk in circular motion + +## 🌡️ Temperature Control + +### Critical Temperatures + +#### Meat Doneness +- **Rare**: 125°F (52°C) - Red center, soft +- **Medium Rare**: 135°F (57°C) - Pink center, slightly firm +- **Medium**: 145°F (63°C) - Light pink center, firm +- **Medium Well**: 155°F (68°C) - Slight pink, very firm +- **Well Done**: 165°F (74°C) - No pink, very firm + +#### Fish Doneness +- **Rare**: 110°F (43°C) - Translucent center +- **Medium**: 125°F (52°C) - Slightly translucent +- **Well Done**: 140°F (60°C) - Opaque throughout + +#### Egg Doneness +- **Soft Boiled**: 6-7 minutes - Runny yolk +- **Medium Boiled**: 9-10 minutes - Semi-firm yolk +- **Hard Boiled**: 12-15 minutes - Firm yolk + +## 🧪 Chemical Reactions + +### Maillard Reaction +- **Definition**: Chemical reaction between amino acids and reducing sugars +- **Temperature**: 280°F - 330°F (138°C - 165°C) +- **Result**: Browning, flavor development +- **Applications**: Searing meat, toasting bread, roasting coffee + +### Caramelization +- **Definition**: Breakdown of sugar molecules under heat +- **Temperature**: 320°F - 350°F (160°C - 175°C) +- **Result**: Sweet, nutty flavors, brown color +- **Applications**: Caramel sauce, roasted vegetables + +### Gelatinization +- **Definition**: Absorption of water by starch granules +- **Temperature**: 140°F - 180°F (60°C - 82°C) +- **Result**: Thickening, texture change +- **Applications**: Sauces, gravies, puddings + +## 🛡️ Safety Considerations + +### Food Safety +- **Danger Zone**: 40°F - 140°F (4°C - 60°C) +- **Cross Contamination**: Use separate cutting boards for raw meat +- **Hand Washing**: Wash hands frequently +- **Temperature Monitoring**: Use food thermometers + +### Kitchen Safety +- **Knife Safety**: Keep knives sharp, use proper grip +- **Fire Safety**: Never leave cooking unattended +- **Burns**: Use oven mitts, be careful with hot liquids +- **Cleanliness**: Keep work surfaces clean + +## 📚 Advanced Techniques + +### Sous Vide +- **Definition**: Cooking food in vacuum-sealed bags in water bath +- **Temperature Range**: 120°F - 185°F (49°C - 85°C) +- **Best For**: Precise temperature control, tender meats +- **Equipment**: Immersion circulator, vacuum sealer + +### Smoking +- **Definition**: Cooking food with smoke from burning wood +- **Temperature Range**: 200°F - 250°F (93°C - 121°C) +- **Best For**: Meats, fish, cheese +- **Wood Types**: Hickory, apple, mesquite, oak + +### Fermentation +- **Definition**: Using beneficial bacteria to preserve and flavor food +- **Best For**: Sauerkraut, kimchi, yogurt, bread +- **Key Factors**: Temperature, salt, time, cleanliness + +## 🎯 Technique Selection Guide + +### Choose Based On: +1. **Food Type**: Tender vs. tough cuts +2. **Desired Result**: Crispy, tender, moist, etc. +3. **Time Available**: Quick vs. slow cooking +4. **Equipment Available**: What's in the kitchen +5. **Skill Level**: Beginner vs. advanced techniques + +### Technique Combinations: +- **Sear then Braise**: For tough cuts of meat +- **Blanch then Sauté**: For vegetables +- **Poach then Sear**: For fish fillets +- **Steam then Grill**: For vegetables + +--- + +*This guide is a living document. New techniques and refinements will be added as they become available.* + +*Last updated: [Current Date]* +*Version: 1.0.0* \ No newline at end of file diff --git a/cookbook/docs/food-safety.md b/cookbook/docs/food-safety.md new file mode 100644 index 0000000..cb2fbe1 --- /dev/null +++ b/cookbook/docs/food-safety.md @@ -0,0 +1,354 @@ +# 🛡️ Food Safety Guidelines + +## 📚 Overview +This comprehensive food safety guide provides AI agents and cooks with essential information about safe food handling, storage, and preparation practices. Following these guidelines helps prevent foodborne illness and ensures the safety of all consumers. + +## 🌡️ Temperature Control + +### Danger Zone +- **Temperature Range**: 40°F - 140°F (4°C - 60°C) +- **Time Limit**: Food should not remain in this range for more than 2 hours +- **Risk**: Bacteria multiply rapidly in this temperature range +- **Action**: Keep hot foods hot and cold foods cold + +### Safe Cooking Temperatures + +#### Meat and Poultry +| Food Item | Minimum Internal Temperature | Rest Time | Visual Cues | +|-----------|------------------------------|------------|-------------| +| Ground Beef | 160°F (71°C) | 3 minutes | No pink, juices run clear | +| Ground Pork | 160°F (71°C) | 3 minutes | No pink, juices run clear | +| Ground Lamb | 160°F (71°C) | 3 minutes | No pink, juices run clear | +| Ground Turkey | 165°F (74°C) | 3 minutes | No pink, juices run clear | +| Chicken Breast | 165°F (74°C) | 3 minutes | No pink, juices run clear | +| Turkey Breast | 165°F (74°C) | 3 minutes | No pink, juices run clear | +| Duck | 165°F (74°C) | 3 minutes | No pink, juices run clear | +| Pork Chops | 145°F (63°C) | 3 minutes | Slight pink, juices run clear | +| Pork Roast | 145°F (63°C) | 3 minutes | Slight pink, juices run clear | +| Beef Steaks | 145°F (63°C) | 3 minutes | Slight pink, juices run clear | +| Beef Roasts | 145°F (63°C) | 3 minutes | Slight pink, juices run clear | +| Lamb Chops | 145°F (63°C) | 3 minutes | Slight pink, juices run clear | +| Lamb Roasts | 145°F (63°C) | 3 minutes | Slight pink, juices run clear | + +#### Seafood +| Food Item | Minimum Internal Temperature | Visual Cues | +|-----------|------------------------------|-------------| +| Fish | 145°F (63°C) | Flakes easily with fork | +| Shrimp | 145°F (63°C) | Pink and opaque | +| Lobster | 145°F (63°C) | Red shell, opaque meat | +| Crab | 145°F (63°C) | Red shell, opaque meat | +| Scallops | 145°F (63°C) | Opaque and firm | +| Clams | 145°F (63°C) | Shells open | +| Mussels | 145°F (63°C) | Shells open | +| Oysters | 145°F (63°C) | Shells open | + +#### Eggs and Dairy +| Food Item | Minimum Internal Temperature | Visual Cues | +|-----------|------------------------------|-------------| +| Egg Dishes | 160°F (71°C) | Firm, no runny parts | +| Custards | 160°F (71°C) | Set, no jiggle | +| Cheesecake | 160°F (71°C) | Set, no jiggle | +| Milk | 161°F (72°C) | Pasteurized | +| Cheese | 145°F (63°C) | Melted if applicable | + +### Holding Temperatures +- **Hot Foods**: Above 140°F (60°C) +- **Cold Foods**: Below 40°F (4°C) +- **Monitoring**: Check temperatures every 2 hours +- **Equipment**: Use food thermometers and holding equipment + +## 🧤 Personal Hygiene + +### Hand Washing +- **When to Wash**: + - Before starting food preparation + - After handling raw meat, poultry, or seafood + - After using the bathroom + - After touching face, hair, or body + - After handling garbage + - After touching pets + - After coughing or sneezing + +- **Proper Technique**: + 1. Wet hands with warm water + 2. Apply soap and lather thoroughly + 3. Scrub for at least 20 seconds + 4. Rinse under running water + 5. Dry with clean towel or air dry + +### Personal Protective Equipment +- **Hair Restraints**: Hats, hairnets, or hair ties +- **Clean Clothing**: Fresh, clean work clothes +- **Gloves**: Use when handling ready-to-eat foods +- **Aprons**: Clean aprons for food preparation + +### Illness Policy +- **Stay Home If You Have**: + - Diarrhea + - Vomiting + - Fever + - Sore throat with fever + - Jaundice + - Open wounds or sores +- **Return to Work**: Only after symptoms resolve and medical clearance + +## 🥘 Food Preparation Safety + +### Cross-Contamination Prevention + +#### Separate Equipment +- **Cutting Boards**: Use separate boards for raw meat and ready-to-eat foods +- **Utensils**: Use separate knives, tongs, and spatulas +- **Containers**: Use separate bowls and containers +- **Storage**: Store raw foods below ready-to-eat foods + +#### Color-Coding System +- **Red**: Raw meat and poultry +- **Yellow**: Raw seafood +- **Green**: Ready-to-eat foods +- **Blue**: Raw fish +- **White**: Dairy products +- **Brown**: Cooked foods + +### Thawing Methods + +#### Safe Thawing Techniques +1. **Refrigerator Thawing** (Recommended) + - Temperature: Below 40°F (4°C) + - Time: 24-48 hours depending on size + - Safety: Most controlled method + +2. **Cold Water Thawing** + - Temperature: Below 70°F (21°C) + - Method: Submerge in cold water, change every 30 minutes + - Time: 1-3 hours depending on size + - Safety: Must cook immediately after thawing + +3. **Microwave Thawing** + - Method: Use defrost setting + - Time: Varies by microwave and food size + - Safety: Must cook immediately after thawing + +#### Never Thaw +- **Room Temperature**: Bacteria can multiply rapidly +- **Hot Water**: Can partially cook food, creating safety risks +- **Sunlight**: Inconsistent temperatures + +### Preparation Guidelines + +#### Raw Foods +- **Wash Produce**: Rinse under running water +- **Peel When Possible**: Remove outer layers of vegetables +- **Inspect**: Check for damage, mold, or spoilage +- **Separate**: Keep away from ready-to-eat foods + +#### Ready-to-Eat Foods +- **No Reheating**: Serve immediately or keep at safe temperatures +- **Clean Surfaces**: Use sanitized preparation areas +- **Clean Hands**: Wash hands before handling +- **Clean Equipment**: Use sanitized utensils and containers + +## 🗄️ Food Storage + +### Refrigerator Storage + +#### Temperature Requirements +- **Refrigerator**: 32°F - 40°F (0°C - 4°C) +- **Freezer**: 0°F (-18°C) or below +- **Monitoring**: Check temperatures daily +- **Thermometers**: Use appliance thermometers + +#### Storage Organization +- **Top Shelf**: Ready-to-eat foods, leftovers +- **Middle Shelves**: Dairy products, eggs +- **Bottom Shelf**: Raw meat, poultry, seafood +- **Crisper Drawers**: Fruits and vegetables +- **Door**: Condiments, juices, butter + +#### Storage Times +| Food Item | Refrigerator | Freezer | +|-----------|--------------|---------| +| Ground Meat | 1-2 days | 3-4 months | +| Steaks/Roasts | 3-5 days | 6-12 months | +| Poultry | 1-2 days | 9-12 months | +| Fish | 1-2 days | 3-6 months | +| Eggs | 3-5 weeks | Not recommended | +| Milk | 5-7 days | Not recommended | +| Leftovers | 3-4 days | 2-6 months | + +### Pantry Storage + +#### Dry Goods +- **Temperature**: Below 70°F (21°C) +- **Humidity**: Low humidity environment +- **Light**: Keep away from direct sunlight +- **Containers**: Use airtight containers + +#### Storage Times +| Food Item | Storage Time | Signs of Spoilage | +|-----------|--------------|-------------------| +| Flour | 6-8 months | Off odor, bugs | +| Sugar | Indefinite | Hardening, bugs | +| Rice | 1-2 years | Off odor, bugs | +| Pasta | 1-2 years | Off odor, bugs | +| Canned Goods | 1-2 years | Bulging, rust, dents | +| Dried Herbs | 1-3 years | Loss of aroma, color | + +## 🧹 Cleaning and Sanitizing + +### Cleaning Procedures + +#### Equipment Cleaning +1. **Pre-rinse**: Remove visible food debris +2. **Wash**: Use hot, soapy water +3. **Rinse**: Remove soap residue +4. **Sanitize**: Use approved sanitizer +5. **Air Dry**: Allow to air dry completely + +#### Surface Cleaning +- **Frequency**: Before and after each use +- **Method**: Hot, soapy water followed by sanitizer +- **Materials**: Use clean cloths and towels +- **Storage**: Store cleaning supplies away from food + +### Sanitizing Solutions + +#### Chemical Sanitizers +- **Chlorine**: 50-100 ppm for food contact surfaces +- **Quaternary Ammonium**: 200-400 ppm for food contact surfaces +- **Iodine**: 12.5-25 ppm for food contact surfaces +- **Testing**: Use test strips to verify concentration + +#### Heat Sanitizing +- **Temperature**: 171°F (77°C) for 30 seconds +- **Method**: Immerse in hot water +- **Equipment**: Commercial dishwashers +- **Monitoring**: Check temperatures regularly + +## 🚨 Food Safety Hazards + +### Biological Hazards + +#### Bacteria +- **Salmonella**: Found in raw poultry, eggs, meat +- **E. coli**: Found in raw ground beef, produce +- **Listeria**: Found in deli meats, soft cheeses +- **Campylobacter**: Found in raw poultry, unpasteurized milk + +#### Viruses +- **Norovirus**: Highly contagious, causes vomiting and diarrhea +- **Hepatitis A**: Spread through contaminated food and water +- **Prevention**: Proper hand washing and food handling + +#### Parasites +- **Toxoplasma**: Found in raw meat, cat feces +- **Trichinella**: Found in undercooked pork and wild game +- **Prevention**: Proper cooking and freezing + +### Chemical Hazards +- **Cleaning Chemicals**: Store away from food +- **Pesticides**: Wash produce thoroughly +- **Heavy Metals**: Avoid using certain cookware +- **Allergens**: Clearly label and separate + +### Physical Hazards +- **Glass**: Check for broken glass in food +- **Metal**: Inspect equipment for loose parts +- **Plastic**: Avoid using damaged containers +- **Bones**: Remove bones from fish and meat + +## 📋 HACCP Principles + +### Hazard Analysis and Critical Control Points + +#### Seven Principles +1. **Conduct Hazard Analysis**: Identify potential hazards +2. **Determine Critical Control Points**: Points where hazards can be controlled +3. **Establish Critical Limits**: Maximum/minimum values for control +4. **Establish Monitoring Procedures**: Regular checks of critical control points +5. **Establish Corrective Actions**: What to do when limits are exceeded +6. **Establish Verification Procedures**: Confirm system is working +7. **Establish Record-Keeping**: Document all procedures and results + +#### Critical Control Points +- **Receiving**: Check temperature and quality +- **Storage**: Maintain proper temperatures +- **Preparation**: Prevent cross-contamination +- **Cooking**: Achieve proper temperatures +- **Cooling**: Rapid cooling to safe temperatures +- **Holding**: Maintain safe temperatures +- **Service**: Prevent contamination during service + +## 🆘 Emergency Procedures + +### Foodborne Illness Outbreak +1. **Identify**: Determine if illness is food-related +2. **Isolate**: Remove suspected food from service +3. **Document**: Record all details of incident +4. **Notify**: Contact health department if required +5. **Investigate**: Determine cause of outbreak +6. **Correct**: Implement corrective actions +7. **Prevent**: Establish procedures to prevent recurrence + +### Power Outage +1. **Assess**: Determine length of outage +2. **Protect**: Keep refrigerator and freezer doors closed +3. **Monitor**: Check temperatures when power returns +4. **Evaluate**: Determine if food is safe to use +5. **Discard**: Throw away unsafe food + +### Equipment Failure +1. **Stop**: Cease using malfunctioning equipment +2. **Assess**: Determine if food safety is compromised +3. **Transfer**: Move food to working equipment if safe +4. **Repair**: Fix equipment or replace if necessary +5. **Verify**: Test equipment before returning to service + +## 📚 Training and Education + +### Required Training +- **Food Safety Basics**: All food handlers +- **HACCP Principles**: Managers and supervisors +- **Allergen Awareness**: All staff +- **Emergency Procedures**: All staff + +### Training Topics +- **Personal Hygiene**: Hand washing, illness policy +- **Temperature Control**: Cooking, holding, cooling +- **Cross-Contamination**: Prevention methods +- **Cleaning and Sanitizing**: Proper procedures +- **Food Storage**: Safe storage practices +- **Allergen Management**: Identification and prevention + +### Training Frequency +- **Initial Training**: Before starting work +- **Refresher Training**: Annually +- **Updated Training**: When procedures change +- **Documentation**: Keep training records + +## 🔍 Monitoring and Verification + +### Daily Checks +- **Temperatures**: Refrigerator, freezer, hot holding +- **Personal Hygiene**: Hand washing, clean clothing +- **Food Quality**: Check for spoilage, damage +- **Equipment**: Functioning properly + +### Weekly Checks +- **Deep Cleaning**: Thorough cleaning of equipment +- **Inventory**: Check expiration dates +- **Training**: Review procedures with staff +- **Documentation**: Update logs and records + +### Monthly Checks +- **Equipment Maintenance**: Professional inspection +- **Pest Control**: Check for signs of pests +- **Staff Meetings**: Review food safety procedures +- **Audit**: Self-inspection of facility + +--- + +*This food safety guide is a living document. New guidelines and best practices will be added as they become available.* + +*Last updated: [Current Date]* +*Version: 1.0.0* \ No newline at end of file diff --git a/cookbook/docs/substitutions.md b/cookbook/docs/substitutions.md new file mode 100644 index 0000000..a01c5d6 --- /dev/null +++ b/cookbook/docs/substitutions.md @@ -0,0 +1,310 @@ +# 🔄 Ingredient Substitution Chart + +## 📚 Overview +This comprehensive substitution guide helps AI agents and cooks find alternatives when specific ingredients are unavailable, expensive, or need to be avoided due to dietary restrictions. Each substitution includes ratios, best uses, and important notes. + +## 🥛 Dairy Substitutions + +### Milk Substitutions + +#### Plant-Based Milk Alternatives +- **Almond Milk** (1:1 ratio) + - **Best For**: Baking, smoothies, cereal + - **Notes**: Lower protein, may affect texture in some recipes + - **Flavor**: Slightly nutty, mild + +- **Soy Milk** (1:1 ratio) + - **Best For**: Baking, cooking, drinking + - **Notes**: Higher protein content, good for savory dishes + - **Flavor**: Neutral, slightly beany + +- **Oat Milk** (1:1 ratio) + - **Best For**: Coffee, smoothies, baking + - **Notes**: Creamy texture, good for lattes + - **Flavor**: Mild, slightly sweet + +- **Coconut Milk** (1:1 ratio) + - **Best For**: Curries, desserts, tropical dishes + - **Notes**: Higher fat content, may add coconut flavor + - **Flavor**: Distinct coconut taste + +#### Other Milk Substitutions +- **Evaporated Milk** (1:1 ratio) + - **Best For**: Baking, sauces, soups + - **Notes**: Concentrated, richer than regular milk + +- **Powdered Milk** (1/4 cup powder + 1 cup water = 1 cup milk) + - **Best For**: Baking, emergency situations + - **Notes**: Longer shelf life, may affect flavor + +### Butter Substitutions + +#### Plant-Based Alternatives +- **Coconut Oil** (1:1 ratio) + - **Best For**: Baking, sautéing + - **Notes**: Solid at room temperature, may add coconut flavor + - **Melting Point**: 76°F (24°C) + +- **Olive Oil** (3/4 cup oil = 1 cup butter) + - **Best For**: Sautéing, dressings, some baking + - **Notes**: Liquid at room temperature, may affect texture + - **Flavor**: Distinct olive taste + +- **Vegan Butter** (1:1 ratio) + - **Best For**: Baking, spreading, cooking + - **Notes**: Formulated to behave like dairy butter + - **Availability**: Widely available in most stores + +#### Other Butter Substitutions +- **Applesauce** (1/2 cup = 1 cup butter) + - **Best For**: Baking, reducing fat content + - **Notes**: Adds moisture, may affect texture + - **Best In**: Muffins, quick breads, cakes + +- **Mashed Banana** (1/2 cup = 1 cup butter) + - **Best For**: Baking, adding natural sweetness + - **Notes**: Adds banana flavor, good for quick breads + - **Best In**: Muffins, pancakes, cookies + +### Cheese Substitutions + +#### Plant-Based Cheese Alternatives +- **Nutritional Yeast** (2-3 tbsp = 1/4 cup cheese) + - **Best For**: Pasta, popcorn, sauces + - **Notes**: Adds cheesy flavor, no melting properties + - **Nutrition**: High in B vitamins + +- **Cashew Cheese** (1:1 ratio) + - **Best For**: Spreads, dips, pasta dishes + - **Notes**: Creamy texture, can be made at home + - **Preparation**: Soak cashews, blend with seasonings + +- **Store-Bought Vegan Cheese** (1:1 ratio) + - **Best For**: Melting, grating, slicing + - **Notes**: Varies by brand, some melt better than others + - **Types**: Cheddar, mozzarella, parmesan alternatives + +## 🥚 Egg Substitutions + +### Baking Substitutions +- **Flaxseed Egg** (1 tbsp ground flaxseed + 3 tbsp water = 1 egg) + - **Best For**: Baking, binding ingredients + - **Notes**: Let mixture sit for 5 minutes to gel + - **Best In**: Muffins, cookies, quick breads + +- **Chia Seed Egg** (1 tbsp chia seeds + 3 tbsp water = 1 egg) + - **Best For**: Baking, binding ingredients + - **Notes**: Similar to flaxseed egg, let sit to gel + - **Nutrition**: High in omega-3 fatty acids + +- **Applesauce** (1/4 cup = 1 egg) + - **Best For**: Baking, adding moisture + - **Notes**: May make baked goods denser + - **Best In**: Cakes, muffins, quick breads + +- **Banana** (1/4 cup mashed = 1 egg) + - **Best For**: Baking, adding sweetness + - **Notes**: Adds banana flavor, good for quick breads + - **Best In**: Muffins, pancakes, cookies + +- **Silken Tofu** (1/4 cup = 1 egg) + - **Best For**: Baking, creamy dishes + - **Notes**: Blends smoothly, neutral flavor + - **Best In**: Cakes, puddings, smoothies + +### Cooking Substitutions +- **Aquafaba** (3 tbsp = 1 egg white) + - **Best For**: Meringues, mousses, binding + - **Notes**: Liquid from canned chickpeas + - **Best In**: Macarons, marshmallows, cocktails + +- **Arrowroot Powder** (1 tbsp + 2 tbsp water = 1 egg) + - **Best For**: Thickening, binding + - **Notes**: Neutral flavor, good for sauces + - **Best In**: Gravies, puddings, stir-fries + +## 🌾 Flour Substitutions + +### Gluten-Free Alternatives +- **Almond Flour** (1:1 ratio for some recipes) + - **Best For**: Baking, breading, thickening + - **Notes**: Higher fat content, may need additional binding + - **Best In**: Cookies, cakes, breading + +- **Coconut Flour** (1/4 cup = 1 cup wheat flour) + - **Best For**: Baking, thickening + - **Notes**: Very absorbent, may need more liquid + - **Best In**: Pancakes, muffins, cookies + +- **Rice Flour** (1:1 ratio) + - **Best For**: Baking, thickening, breading + - **Notes**: Neutral flavor, good for Asian dishes + - **Best In**: Tempura, rice cakes, thickening sauces + +- **Chickpea Flour** (1:1 ratio) + - **Best For**: Baking, savory dishes, binding + - **Notes**: High protein, slightly beany flavor + - **Best In**: Socca, fritters, flatbreads + +### Other Flour Substitutions +- **Whole Wheat Flour** (1:1 ratio) + - **Best For**: Baking, adding fiber + - **Notes**: May make baked goods denser + - **Best In**: Bread, muffins, cookies + +- **Spelt Flour** (1:1 ratio) + - **Best For**: Baking, some gluten sensitivity + - **Notes**: Contains gluten but may be easier to digest + - **Best In**: Bread, pasta, baked goods + +## 🧂 Sweetener Substitutions + +### Natural Sweeteners +- **Honey** (3/4 cup = 1 cup sugar) + - **Best For**: Baking, beverages, dressings + - **Notes**: Reduce liquid by 1/4 cup, may brown faster + - **Flavor**: Distinct honey taste + +- **Maple Syrup** (3/4 cup = 1 cup sugar) + - **Best For**: Baking, beverages, glazes + - **Notes**: Reduce liquid by 1/4 cup, adds maple flavor + - **Flavor**: Rich maple taste + +- **Agave Nectar** (2/3 cup = 1 cup sugar) + - **Best For**: Beverages, dressings, some baking + - **Notes**: Very sweet, may affect texture in baking + - **Flavor**: Mild, neutral + +### Artificial Sweeteners +- **Stevia** (1/2 tsp = 1 cup sugar) + - **Best For**: Beverages, some baking + - **Notes**: Very concentrated, may have bitter aftertaste + - **Best In**: Coffee, tea, smoothies + +- **Erythritol** (1:1 ratio) + - **Best For**: Baking, beverages + - **Notes**: No calories, may have cooling effect + - **Best In**: Cookies, cakes, beverages + +## 🧅 Onion Substitutions +- **Shallots** (1 small shallot = 1/4 cup chopped onion) + - **Best For**: Finely chopped applications + - **Notes**: Milder flavor, more expensive + - **Best In**: Vinaigrettes, sauces, fine cooking + +- **Leeks** (1 cup chopped leeks = 1 cup chopped onion) + - **Best For**: Soups, stews, braises + - **Notes**: Milder flavor, wash thoroughly + - **Best In**: Potato leek soup, braised dishes + +- **Green Onions** (1/2 cup chopped = 1/2 cup chopped onion) + - **Best For**: Garnishes, Asian dishes + - **Notes**: Milder flavor, use white and green parts + - **Best In**: Stir-fries, salads, garnishes + +## 🧄 Garlic Substitutions +- **Garlic Powder** (1/8 tsp = 1 clove fresh garlic) + - **Best For**: Dry mixes, rubs, when fresh isn't available + - **Notes**: More concentrated, may have different flavor + - **Best In**: Spice rubs, dry seasonings + +- **Granulated Garlic** (1/4 tsp = 1 clove fresh garlic) + - **Best For**: Similar to powder but coarser texture + - **Notes**: Better for some applications than powder + - **Best In**: Rubs, marinades + +- **Garlic Salt** (1/2 tsp = 1 clove fresh garlic) + - **Best For**: When you need both garlic and salt + - **Notes**: Reduce other salt in recipe + - **Best In**: Quick seasoning, rubs + +## 🍋 Acid Substitutions + +### Lemon Juice Alternatives +- **Lime Juice** (1:1 ratio) + - **Best For**: Most applications + - **Notes**: Slightly different flavor profile + - **Best In**: Mexican, Thai, Vietnamese dishes + +- **White Vinegar** (1:1 ratio) + - **Best For**: When citrus flavor isn't needed + - **Notes**: More acidic, may need to reduce amount + - **Best In**: Pickling, cleaning, some cooking + +- **Apple Cider Vinegar** (1:1 ratio) + - **Best For**: When you want milder acidity + - **Notes**: Slightly sweet, may add flavor + - **Best In**: Dressings, marinades, pickling + +## 🧂 Salt Substitutions +- **Kosher Salt** (1:1 ratio by volume) + - **Best For**: Most cooking applications + - **Notes**: Larger crystals, may need to adjust + - **Best In**: General cooking, seasoning + +- **Sea Salt** (1:1 ratio by volume) + - **Best For**: Finishing, some cooking + - **Notes**: May have trace minerals, different texture + - **Best In**: Finishing dishes, some baking + +- **Low-Sodium Alternatives** (1:1 ratio) + - **Best For**: Reducing sodium intake + - **Notes**: May need to increase amount for same saltiness + - **Best In**: Health-conscious cooking + +## 🥜 Nut Substitutions + +### Tree Nut Alternatives +- **Sunflower Seeds** (1:1 ratio) + - **Best For**: When tree nuts are not allowed + - **Notes**: Different flavor, may need to toast + - **Best In**: Granola, salads, baked goods + +- **Pumpkin Seeds** (1:1 ratio) + - **Best For**: Similar to sunflower seeds + - **Notes**: Green color, nutty flavor + - **Best In**: Trail mix, salads, granola + +- **Sesame Seeds** (1:1 ratio) + - **Best For**: Asian dishes, when nuts aren't available + - **Notes**: Smaller size, different flavor + - **Best In**: Asian cuisine, breads, salads + +## 🍄 Mushroom Substitutions +- **Portobello Mushrooms** (1:1 ratio) + - **Best For**: Meat alternatives, grilling + - **Notes**: Meaty texture, good for burgers + - **Best In**: Vegetarian dishes, grilling + +- **Shiitake Mushrooms** (1:1 ratio) + - **Best For**: Asian dishes, umami flavor + - **Notes**: Strong flavor, may need to reduce amount + - **Best In**: Stir-fries, soups, Asian cuisine + +## 🎯 Substitution Guidelines + +### General Rules +1. **Start with 1:1 ratios** unless specified otherwise +2. **Test small batches** before making large quantities +3. **Consider flavor impact** of substitutions +4. **Adjust cooking times** if needed +5. **Monitor texture changes** in baked goods + +### When Substitutions May Not Work +- **Yeast breads**: Gluten-free flours may not rise properly +- **Delicate pastries**: Fat substitutions may affect texture +- **Meringues**: Egg white substitutes may not whip properly +- **Cheese-heavy dishes**: Plant-based alternatives may not melt the same + +### Testing Substitutions +1. **Make a small batch** first +2. **Note any changes** in texture, flavor, or appearance +3. **Adjust ratios** if needed +4. **Document successful substitutions** for future use + +--- + +*This substitution chart is a living document. New alternatives and refinements will be added as they become available.* + +*Last updated: [Current Date]* +*Version: 1.0.0* \ No newline at end of file diff --git a/cookbook/recipes/main-courses/classic-margherita-pizza.md b/cookbook/recipes/main-courses/classic-margherita-pizza.md new file mode 100644 index 0000000..6b008b6 --- /dev/null +++ b/cookbook/recipes/main-courses/classic-margherita-pizza.md @@ -0,0 +1,148 @@ +# Classic Margherita Pizza + +## 📋 Recipe Information +- **Category**: Main Course +- **Cuisine**: Italian +- **Difficulty**: Intermediate +- **Prep Time**: 30 minutes +- **Cook Time**: 12-15 minutes +- **Total Time**: 45 minutes +- **Servings**: 4 servings (1 large pizza) +- **Calories per serving**: 350 calories + +## 🎯 Recipe Summary +A traditional Neapolitan-style Margherita pizza featuring a thin, crispy crust topped with fresh mozzarella, San Marzano tomatoes, and fragrant basil. This classic combination represents the colors of the Italian flag and showcases the perfect balance of simplicity and flavor that makes Italian cuisine world-renowned. + +## 🥘 Ingredients + +### Main Ingredients +- 2 1/4 cups (280g) bread flour - High-protein flour for better gluten development +- 1 cup (240ml) warm water (110°F/43°C) - Lukewarm to activate yeast +- 2 1/4 tsp (7g) active dry yeast - Fresh yeast for optimal rising +- 1 tsp (6g) kosher salt - Enhances flavor and controls yeast +- 1 tbsp (15ml) extra virgin olive oil - Adds richness and prevents sticking +- 8 oz (227g) fresh mozzarella cheese - Fresh, not pre-shredded +- 1/2 cup (120ml) San Marzano tomato sauce - Authentic Italian tomatoes +- 1/4 cup fresh basil leaves - Torn, not chopped, for authentic presentation +- 2 tbsp (30ml) extra virgin olive oil - For drizzling + +### Optional/Substitution Ingredients +- 1/4 cup (25g) grated Parmigiano-Reggiano - For extra umami flavor +- 1/4 tsp red pepper flakes - For subtle heat +- 1 clove garlic, minced - For garlic lovers + +## 🛠️ Equipment Needed +- Stand mixer with dough hook - For consistent dough development +- Pizza stone or steel - For authentic crispy crust +- Pizza peel - For transferring pizza to oven +- Digital kitchen scale - For precise measurements +- Instant-read thermometer - For water temperature +- Large mixing bowl - For dough rising +- Plastic wrap - For covering dough during rise + +## 📖 Step-by-Step Instructions + +### Preparation Phase +1. **Activate Yeast**: In a small bowl, combine warm water and yeast. Let stand for 5-10 minutes until foamy + - **Pro Tip**: Water should feel warm to the touch, not hot + - **Common Mistake**: Using water that's too hot kills yeast + +2. **Mix Dough**: In stand mixer bowl, combine flour and salt. Add yeast mixture and olive oil + - **Pro Tip**: Mix on low speed to prevent flour from flying + - **Common Mistake**: Adding all ingredients at once can cause clumping + +3. **Knead Dough**: Mix on medium speed for 8-10 minutes until dough is smooth and elastic + - **Pro Tip**: Dough should pull away from bowl sides and feel slightly tacky + - **Common Mistake**: Under-kneading results in dense, tough crust + +4. **First Rise**: Place dough in oiled bowl, cover with plastic wrap, let rise 1-2 hours until doubled + - **Pro Tip**: Warm, draft-free location speeds rising + - **Common Mistake**: Over-proofing makes dough collapse + +### Cooking Phase +1. **Preheat Oven**: Place pizza stone in oven and preheat to 500°F (260°C) for 1 hour + - **Pro Tip**: Longer preheating ensures stone reaches full temperature + - **Common Mistake**: Insufficient preheating results in soggy crust + +2. **Shape Dough**: On floured surface, stretch dough into 12-inch circle, leaving thicker edges + - **Pro Tip**: Use knuckles to stretch, not fingertips + - **Common Mistake**: Rolling pin compresses dough layers + +3. **Add Toppings**: Spread sauce thinly, add torn mozzarella, drizzle with olive oil + - **Pro Tip**: Less is more - don't overload the pizza + - **Common Mistake**: Too many toppings make crust soggy + +4. **Bake Pizza**: Transfer to hot stone, bake 12-15 minutes until crust is golden and cheese bubbles + - **Pro Tip**: Rotate pizza halfway through for even cooking + - **Common Mistake**: Opening oven door too frequently + +## 🔍 Visual Cues & Doneness Indicators +- **Visual**: Crust should be golden brown with charred spots, cheese should be melted and slightly browned +- **Texture**: Crust should be crispy on bottom, chewy inside, with airy bubbles +- **Temperature**: Internal temperature should reach 200°F (93°C) +- **Time**: 12-15 minutes total, with rotation at 6-7 minutes + +## 🎨 Presentation & Plating +- **Garnish suggestions**: Fresh basil leaves scattered over top, drizzle of olive oil +- **Serving temperature**: Hot, straight from oven +- **Plate selection**: Large wooden cutting board or pizza pan +- **Arrangement**: Cut into 8 slices, arrange with basil garnish visible + +## 🍽️ Serving Suggestions +- **Accompaniments**: Simple green salad with balsamic vinaigrette, red wine +- **Beverage pairings**: Chianti, Sangiovese, or light Italian red wine +- **Meal context**: Perfect for casual dinner, pizza night, or entertaining + +## 📊 Nutritional Information +- **Calories**: 350 per serving +- **Protein**: 18g per serving +- **Carbohydrates**: 45g per serving +- **Fat**: 12g per serving +- **Fiber**: 3g per serving +- **Sugar**: 2g per serving +- **Sodium**: 680mg per serving + +## 🔄 Variations & Substitutions +- **Margherita Bianca**: Omit tomato sauce, use only mozzarella and basil +- **Spicy Margherita**: Add red pepper flakes and spicy salami +- **Substitution 1**: Use all-purpose flour instead of bread flour (slightly less chewy) +- **Substitution 2**: Substitute fresh mozzarella with low-moisture mozzarella (more traditional) + +## 🚨 Allergen Information +- **Contains**: Gluten (wheat), dairy (milk) +- **May contain**: Soy (if using certain flours) +- **Allergen-free alternatives**: Use gluten-free flour blend and vegan mozzarella + +## 💡 Tips & Tricks +- **Pro Tip 1**: Let dough rest 10 minutes after mixing before kneading for easier handling +- **Pro Tip 2**: Use a pizza steel instead of stone for even better heat distribution +- **Time-saving tip**: Make dough ahead and refrigerate overnight for deeper flavor +- **Storage tip**: Leftover pizza reheats best in a hot skillet, not microwave + +## ❓ Frequently Asked Questions +**Q: Can I make this without a pizza stone?** +A: Yes, use a heavy baking sheet turned upside down, but results won't be as crispy. + +**Q: Why is my dough not rising?** +A: Check water temperature (should be 110°F/43°C), yeast freshness, and ensure no salt contact with yeast. + +**Q: How do I prevent toppings from sliding off?** +A: Don't overload pizza, and ensure sauce is spread thinly and evenly. + +## 🔬 Science Behind the Recipe +- **Chemical reactions**: Yeast fermentation produces CO2, creating air pockets in dough +- **Temperature effects**: High oven temperature (500°F) creates Maillard reaction for browning +- **Ingredient interactions**: Gluten proteins in bread flour create elastic network for chewy texture + +## 📚 Related Recipes +- [Neapolitan Pizza Dough](link-to-recipe) +- [Quick Pizza Sauce](link-to-recipe) +- [Focaccia Bread](link-to-recipe) + +## 📝 Notes & References +- **Source**: Traditional Neapolitan pizza technique +- **Cultural significance**: Named after Queen Margherita of Italy, represents Italian flag colors +- **Additional resources**: "The Pizza Bible" by Tony Gemignani, "Flour Water Salt Yeast" by Ken Forkish + +## 🏷️ Tags +pizza, italian, margherita, mozzarella, basil, tomato, dough, bread, main-course, traditional, neapolitan \ No newline at end of file diff --git a/cookbook/templates/recipe-template.md b/cookbook/templates/recipe-template.md new file mode 100644 index 0000000..85773ee --- /dev/null +++ b/cookbook/templates/recipe-template.md @@ -0,0 +1,120 @@ +# Recipe Name + +## 📋 Recipe Information +- **Category**: [Appetizer/Main Course/Dessert/Beverage/Basic] +- **Cuisine**: [Regional or cultural origin] +- **Difficulty**: [Beginner/Intermediate/Advanced] +- **Prep Time**: [X minutes] +- **Cook Time**: [X minutes] +- **Total Time**: [X minutes] +- **Servings**: [X servings] +- **Calories per serving**: [X calories] + +## 🎯 Recipe Summary +Brief 2-3 sentence description of the dish, its key characteristics, and what makes it special. + +## 🥘 Ingredients + +### Main Ingredients +- [Quantity] [Unit] [Ingredient Name] - [Special notes if applicable] + +### Optional/Substitution Ingredients +- [Quantity] [Unit] [Ingredient Name] - [What it can replace] + +## 🛠️ Equipment Needed +- [Equipment name] - [Specific requirements or alternatives] +- [Equipment name] - [Specific requirements or alternatives] + +## 📖 Step-by-Step Instructions + +### Preparation Phase +1. **Step Description**: Detailed explanation of what to do + - **Pro Tip**: Additional helpful information + - **Common Mistake**: What to avoid + +2. **Step Description**: Detailed explanation of what to do + - **Pro Tip**: Additional helpful information + - **Common Mistake**: What to avoid + +### Cooking Phase +1. **Step Description**: Detailed explanation of what to do + - **Pro Tip**: Additional helpful information + - **Common Mistake**: What to avoid + +2. **Step Description**: Detailed explanation of what to do + - **Pro Tip**: Additional helpful information + - **Common Mistake**: What to avoid + +## 🔍 Visual Cues & Doneness Indicators +- **Visual**: Describe what the dish should look like +- **Texture**: Describe the expected texture +- **Temperature**: Specific temperature readings if applicable +- **Time**: Time-based indicators + +## 🎨 Presentation & Plating +- **Garnish suggestions**: Specific garnishes and placement +- **Serving temperature**: Hot, warm, or cold +- **Plate selection**: Type and size of serving dish +- **Arrangement**: How to arrange components on the plate + +## 🍽️ Serving Suggestions +- **Accompaniments**: What to serve with the dish +- **Beverage pairings**: Recommended drinks +- **Meal context**: When to serve this dish + +## 📊 Nutritional Information +- **Calories**: Per serving +- **Protein**: Grams per serving +- **Carbohydrates**: Grams per serving +- **Fat**: Grams per serving +- **Fiber**: Grams per serving +- **Sugar**: Grams per serving +- **Sodium**: Milligrams per serving + +## 🔄 Variations & Substitutions +- **Variation 1**: Description and modifications needed +- **Variation 2**: Description and modifications needed +- **Substitution 1**: What to replace and with what +- **Substitution 2**: What to replace and with what + +## 🚨 Allergen Information +- **Contains**: List of allergens present +- **May contain**: Potential cross-contamination risks +- **Allergen-free alternatives**: How to make allergen-free versions + +## 💡 Tips & Tricks +- **Pro Tip 1**: Advanced technique or insight +- **Pro Tip 2**: Advanced technique or insight +- **Time-saving tip**: How to prepare ahead or save time +- **Storage tip**: How to store leftovers + +## ❓ Frequently Asked Questions +**Q: Common question about the recipe?** +A: Detailed answer with explanation. + +**Q: Another common question?** +A: Detailed answer with explanation. + +## 🔬 Science Behind the Recipe +- **Chemical reactions**: What happens during cooking +- **Temperature effects**: Why specific temperatures matter +- **Ingredient interactions**: How ingredients work together + +## 📚 Related Recipes +- [Related Recipe 1](link-to-recipe) +- [Related Recipe 2](link-to-recipe) +- [Related Recipe 3](link-to-recipe) + +## 📝 Notes & References +- **Source**: Where the recipe originated +- **Cultural significance**: Historical or cultural context +- **Additional resources**: Books, videos, or websites for more information + +## 🏷️ Tags +[tag1], [tag2], [tag3], [tag4], [tag5] + +--- + +*Template version: 1.0.0* +*Last updated: [Current Date]* +*Maintained by: [Your Name/Organization]* \ No newline at end of file