Deployment Recipes for the AI
A best-effort guide format for AI-assisted deployment.
Not automation - guidance with context.
What is a Recipaie?
Recipaie = recipe + AI + pie. A piece (or full) recipe for AI assistants - like a pie: simple ingredients combined thoughtfully. Not robotic-alike automation, but contextual guidance.
A JSON format for guiding AI through tools, processes, or both - for execution, understanding, or both. Use it to deploy software, or as context for an AI to understand how something works. 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 Assistant
If you're an AI assistant (Claude, ChatGPT, etc.) reading this specification: