Jorge Castro · IA aplicada al desarrollo
Trabaja con agentes de IA sin perder el control de tu código.
Escribo lo que de verdad uso cuando trabajo con agentes de código: qué reglas les pongo antes de dejarlos tocar nada, cómo administro el contexto cuando el proyecto crece, y dónde me equivoqué, que suele ser la parte más útil. Este sitio lo decido y lo opero junto a ARK, mi sistema de decisión, y el criterio final sigue siendo mío.
En español y por email. Sin costo. Puedes darte de baja en un clic.
Últimos artículos
Empieza por aquí
Las instrucciones con las que arranco, cómo administro el contexto, y un caso que sigue corriendo en mi equipo.
Qué hay realmente dentro de mi CLAUDE.md
Las reglas que le pongo a un agente de código antes de dejarlo tocar nada, y el fallo concreto que previene cada una. Incluida la que más trabajo me ha ahorrado.
Más contexto no es mejor contexto
Le di a un agente acceso a todo el repositorio para arreglar tres líneas. Falló, y no por falta de información. Las cuatro reglas que escribí después para administrar el contexto como el recurso escaso que es.
De horas a minutos: Cómo automaticé el cierre de Sprints con IA y n8n
Reescribiendo el rol de quien lidera el equipo: cómo automatizar los reportes nos devolvió tiempo y le dio autonomía al equipo.
Sobre mí
Quince años construyendo software, y todavía aprendiendo a decidir.
Soy Jorge Castro. Empecé dando soporte a sistemas que ya estaban en producción, después fundé una empresa que sostuve nueve años, y hoy lidero un equipo técnico. Uso IA para construir y operar software real, y escribo qué funcionó, qué no y por qué, con los errores incluidos.
Caso real
Un cierre de sprint con IA y revisión humana
Cada cierre de sprint me tomaba el viernes completo copiando números de una pestaña a otra, así que conecté las herramientas del equipo con n8n y un modelo de lenguaje para que armara el reporte, que igual reviso antes de que llegue a nadie. Sigue corriendo, y hoy hace bastante más que en la versión del artículo.
Ver el proceso y sus límites- Datos del sprint: tickets de Jira, logs de CI/CD, incidentes en producción y pull requests.
- n8n los reúne y un modelo de lenguaje resume el avance y las desviaciones.
- Reviso el reporte antes de que llegue a los stakeholders.
- El equipo consulta el dashboard por su cuenta y corrige tickets antes de la revisión.
Cómo opero este sitio
Un sitio co-gestionado con IA
ARK es el sistema de decisión en Markdown que consulto antes de decidir qué publicar, qué medir y qué descartar, y su trabajo principal es llevarme la contra cuando lo que propongo choca con algo que yo mismo ya había decidido. Participa, y no publica ni decide solo.
Cómo funciona ARK- Cada artículo declara si ARK fue consultado o asistió. Sin esa etiqueta, la autoría es solo humana.
- Las decisiones difíciles de revertir, como la identidad pública del sitio o el alcance de su rediseño, se registran con contexto y alternativas antes de ejecutarse.
- ARK contrasta lo que propongo con lo que ya decidí. Nunca inicia una acción: la última palabra es mía.
Recursos
Un archivo gratuito con el que puedes empezar hoy, y un sistema de pago para cuando el contexto y las decisiones empiecen a perderse entre sesiones.
Sistema personal de contexto
ARK
Un sistema para conservar contexto, contrastar decisiones y mantener el trabajo con agentes bajo criterio humano.
Conocer ARK
Plantilla de trabajo
CLAUDE.md base
Las reglas con las que comienzo un proyecto, comentadas desde la experiencia y listas para adaptar.
Conocer CLAUDE.md
Conversemos sobre una idea concreta.
Si algo de acá conecta con un problema que estás resolviendo ahora, escríbeme y cuéntame el contexto, que es lo que hace la diferencia entre una respuesta genérica y una útil.
Alcance
Haz exactamente lo pedido. No amplíes el alcance sin una razón declarada.
Implementa el cambio correcto más pequeño.
Por qué está: es la regla que más trabajo me ha ahorrado.
Límites
Nunca modifiques un test para que pase. Si un test falla, el sospechoso es el código.
El CLAUDE.md base
Las instrucciones con las que comienzo proyectos junto a agentes, comentadas regla por regla y listas para adaptar.