# Recipe Alchemy - AI Policy
# https://recipealchemy.ai
# Version: 1.5.0
# Last Updated: 2026-03-06

## About This File
This file declares Recipe Alchemy's AI capabilities, usage policies, and data provenance for AI systems and crawlers.

## Product Identity
Name: Recipe Alchemy
Category: AI Recipe Generation with Nutrition Analysis
URL: https://recipealchemy.ai

## AI Capabilities

### What AI Does
- Generates complete recipes from natural language prompts
- Creates cooking instructions and techniques
- Suggests ingredient substitutions
- Provides meal pairings and serving suggestions
- Explains cooking science and techniques

### What AI Does NOT Do
- Generate nutrition numbers (these come from USDA FoodData Central)
- Invent calorie counts or macronutrient values
- Estimate micronutrient amounts
- Create health claims without data backing

## AI Models (via OpenRouter + Perplexity)

### Research Models (Perplexity)
| Model | Use Case |
|-------|----------|
| perplexity/sonar-deep-research | Deep ingredient identity research (CFPO v2) |
| perplexity/sonar-pro-search | Ingredient research, deep knowledge/nutrition research, web search |

### Image Generation Models
| Model | Use Case |
|-------|----------|
| google/gemini-3-pro-image-preview | Recipe hero images, meal presentation visuals, plating suggestions |

### Text Models (Anthropic)
| Model | Use Case |
|-------|----------|
| anthropic/claude-opus-4.5 | Recipe generation (primary) |
| anthropic/claude-sonnet-4.5 | Leftover suggestions, content generation fallback |

### Text Models (OpenAI)
| Model | Use Case |
|-------|----------|
| openai/gpt-5-mini | Nutrition analysis, content generation, insights, knowledge, shopping lists, fast tasks |

### Text Models (Google)
| Model | Use Case |
|-------|----------|
| google/gemini-2.5-flash | Recipe previews, enrichment preview teasers |

### Primary Service Assignments
| Service | Primary Model |
|---------|---------------|
| Recipe Generation | anthropic/claude-opus-4.5 |
| Nutrition Analysis | openai/gpt-5-mini |
| Deep Research | perplexity/sonar-deep-research |
| Image Generation | google/gemini-3-pro-image-preview |
| Fast Tasks | openai/gpt-5-mini |

## Data Provenance

### Nutrition Data Source
Oracle: USDA FoodData Central
Datasets: Foundation, SR_Legacy, FNDDS, Branded
Provenance: Every nutrition value includes fdc_id reference
Policy on Missing Data: Return "unknown" rather than estimate

### Trust Architecture
Pattern: Claim Authorization Architecture (CAA)
Principle: "Simulators propose, reality vetoes"
Enforcement: Architectural separation - AI cannot emit nutrition values

## Usage Policy

### Allowed Uses
- Indexing and crawling public recipe pages
- Referencing nutrition data with attribution
- Linking to recipes and collections
- Using structured data (JSON-LD) for rich results

### Attribution Required
When citing nutrition data, please note:
"Nutrition data sourced from USDA FoodData Central via Recipe Alchemy"

## Machine-Readable Files
- /robots.txt - Crawler directives
- /sitemap.xml - URL discovery
- /llms.txt - LLM-readable product description
- /.well-known/llms.json - Machine-verifiable authority claims

## Contact
Website: https://recipealchemy.ai
Support: support@recipealchemy.ai