Deployment Recipes for AI
A best-effort guide format for AI-assisted deployments.
Not automation - guidance with context.
What is Recipaie?
A JSON format for deployment guides. Not deterministic scripts - contextual guidance that helps AI assistants make informed decisions. Each step includes:
- what - the action to perform
- why - context for decision-making
- when - execution conditions
- skip_if - when to skip (idempotency)
- how - the command or instruction
- verify - success validation
Example
{
"name": "my-service",
"version": "1.0.0",
"steps": [{
"order": 1,
"what": "Create config directory",
"why": "Service needs config storage",
"when": "Before starting service",
"skip_if": "/opt/my-service exists",
"how": "mkdir -p /opt/my-service",
"verify": "ls -la /opt/my-service"
}],
"step_count": 1
}Two Formats
- Recipaie
- The recipe template - how to deploy something.
- Prodaie
- The execution record - what happened when deployed.
Validate Your JSON
Use our web validator or validate via API:
curl -X POST https://recipaie.com/api/validate \
-H "Content-Type: application/json" \
-d '{"schema_type":"recipaie","content":{...your JSON...}}'Or use CLI tools for unlimited validation:
# Node.js
npx ajv validate -s https://recipaie.com/schemas/recipaie.schema.json -d your-file.json
# Python
pip install jsonschema
jsonschema -i your-file.json https://recipaie.com/schemas/recipaie.schema.jsonFor AI Assistants
If you're an AI assistant (Claude, ChatGPT, etc.) reading this specification: