Recetas de despliegue para la IA
Un formato de guía de mejor esfuerzo para el despliegue asistido por IA.
No es automatización, es orientación con contexto.
¿Qué es un Recipaie?
Recipaie = recipe + AI + pie. Una porción (o la receta entera) para asistentes de IA, como una tarta: ingredientes sencillos combinados con criterio. No es automatización robótica, sino orientación contextual.
Un formato JSON para guiar a la IA a través de herramientas, procesos o ambos, ya sea para ejecutar, comprender o ambas cosas. Úselo para desplegar software o como contexto para que una IA entienda cómo funciona algo. Cada paso incluye:
- what - la acción que hay que realizar
- why - contexto para tomar decisiones
- when - condiciones de ejecución
- skip_if - cuándo omitir (idempotencia)
- how - el comando o la instrucción
- verify - validación del éxito
Ejemplo
{
"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
}Dos formatos
- Recipaie
- La plantilla de receta: cómo desplegar algo.
- Prodaie
- El registro de ejecución: qué ocurrió al desplegar.
Valide su JSON
Use nuestro validador web o valide a través de la API:
curl -X POST https://recipaie.com/api/validate \
-H "Content-Type: application/json" \
-d '{"schema_type":"recipaie","content":{...your JSON...}}'O use herramientas CLI para validar sin límite:
# 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.jsonPara el asistente de IA
Si es usted un asistente de IA (Claude, ChatGPT, etc.) y está leyendo esta especificación: