Qué es churrerIA

Esta página combina un texto introductorio escrito a mano con un extracto vivo del propio arnés. El bloque “Extracto del arnés vigente” lo genera el script de regeneración tomando la versión actual de CLAUDE.md; el resto es plantilla estática.

La metáfora

churrerIA es un arnés agéntico cuyo nombre nace de una metáfora deliberada: un sistema en el que la inteligencia artificial fríe churros. Es decir, produce piezas concretas, repetibles y de calidad medible. La metáfora no es decorativa: marca la frontera entre la promesa abstracta de la IA (“podría hacer cualquier cosa”) y el compromiso operativo del arnés (“hace exactamente esto, así, con estos controles”).

Igual que una churrería tiene maestros churreros, recetas, hornos y horarios, churrerIA tiene agentes, directrices, un ciclo de desarrollo y gates humanos que firman lo construido antes de servirlo.

Las dos fases del arnés

El arnés se construye en dos fases con ambición creciente:

• Fase 1 — Asistente agéntico con humano en el bucle. Cada agente se invoca dentro de un entorno con humano supervisor. El humano (titular del arnés) gobierna decisiones estructurales, firma los gates internos y modera las conversaciones con quien encarga el producto. Los agentes ejecutan, proponen, redactan, validan; el humano corrige y aprueba.
• Fase 2 — Director autónomo. El humano cede al Director del arnés la orquestación del ciclo extremo a extremo. El Director despierta agentes, gestiona cruces entre ellos, decide retrocesos, mantiene la trazabilidad y solo escala al humano cuando un gate de Stakeholder lo exige. La fase 1 es el camino aprendido; la fase 2 es el destino operativo.

Vertebración por carriles y agentes

El arnés se organiza en cuatro carriles que cubren todas las dimensiones de calidad del software que produce:

• Arquitectura — modularidad, contratos, resiliencia, decisiones técnicas que viven en ADRs.
• Calidad funcional — niveles de prueba, criterios de aceptación, gates de promoción, gestión de bugs.
• Observabilidad — instrumentación, métricas, alertas, ventana de observación post-despliegue.
• Usabilidad — accesibilidad, microcopy, consistencia visual, prueba con usuarios.

Cada carril tiene un agente propietario y reglas firmes documentadas. Sobre estos carriles trabajan ocho agentes con responsabilidades cerradas — Product Owner, Director, Arquitecto, UX, Backend, Frontend, SRE y QA — coordinados por un ciclo de desarrollo de seis etapas con gates humanos al inicio y al cierre.

Objetivo del arnés

Un sistema reproducible para construir software de calidad con agentes IA y supervisión humana mínima necesaria. Reproducible significa que dos proyectos distintos siguen el mismo ciclo, firman los mismos gates y producen evidencia comparable. Calidad significa que cada pieza está cubierta por tests, validada por humanos en los puntos críticos y observada después del despliegue. Supervisión humana mínima necesaria significa que el humano interviene donde su criterio es insustituible — apertura de necesidades, firma de dirección visual, aprobación de promoción a producción — y se retira del resto.

Extracto del arnés vigente

El bloque siguiente lo extrae el script de regeneración desde CLAUDE.md del repo del arnés. Es la voz literal del titular del arnés sobre el sistema.

CLAUDE.md — churrerIA

Rol activo en sesiones interactivas — LEER PRIMERO

Cuando el titular del arnés abre Claude Code en esta carpeta, actúas como el Director del arnés churrerIA.

Lee .claude/agents/director.md como tu system prompt activo. Ese documento define tu cometido, tus responsabilidades, los gates que firmas, cómo te comunicas con el titular del arnés y cómo interactúas con los demás agentes.

Al arrancar cada sesión:

1. Lee memory.md + autonomia.md para ponerte al día del estado del arnés.
2. Emite tu presencia a la oficina-agéntica:

   source .secrets/oficina-agentica.env && curl -s -X POST "$OFICINA_AGENTICA_URL" \
     -H "Authorization: Bearer $OFICINA_AGENTICA_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"id_agente":"claude-code-churrerIA","nombre":"Claude Code (churrerIA)","estado":"activo","arnes":"churrerIA","proyecto":"Trabajo genérico","tarea_titulo":"sesión interactiva con el titular del arnés"}'

3. Informa brevemente a el titular del arnés del estado del arnés (proyecto activo, próximo gate pendiente, si hay algo en el inbox).

Al cerrar sesión (cuando el titular del arnés se despide): emite estado: inactivo.

Esta configuración sustituye al comportamiento de asistente genérico para esta carpeta. Fuera de churrerIA, Claude Code actúa con normalidad.

---

Proyecto personal de el titular del arnés: construir un software propio capaz de producir desarrollos de software de forma agéntica, con la calidad y los fundamentos de un equipo profesional pero con intervención humana mínima en la fase 1.

Hereda contexto de <directorio-del-titular>/emprendimiento/CLAUDE.md (línea de emprendimiento), de <directorio-del-titular>/CLAUDE.md (espacio del titular) y del global (~/<workspace>/CLAUDE.md). Para el estado vivo (decisiones, agentes diseñados, directrices, gaps detectados, próximos pasos), ver memory.md en esta misma carpeta.

Qué es churrerIA

Un arnés agéntico: sistema de carriles (directrices con reglas firmes) y agentes IA (con cometidos diferenciados) que trabajan juntos para llevar una necesidad de un stakeholder a software desplegado en producción, sin que la velocidad comprometa los fundamentos (arquitectura, calidad, observabilidad, usabilidad).

El nombre es deliberado y juego de palabras: churrería + IA. Filosofía implícita: hacer software con la regularidad y fiabilidad con la que se hacen churros, automatizando lo estandarizable y manteniendo el oficio donde de verdad aporta.

Las dos fases del proyecto

• Fase 1: pipeline 100% automatizado para productos sencillos. El resultado debe ser un producto en sí mismo — un servicio comercializable que vende desarrollos simples ejecutados por agentes IA con calidad real.
• Fase 2: humanos estratégicos definiendo carriles más estrictos y validando, capaces de abordar productos más complejos.
• Restricción transversal: ninguna decisión de fase 1 puede bloquear fase 2.