Instrucciones invisibles
Cada nuevo proyecto empieza sin contexto. Hay que recordarle a la IA cómo quieres que piense y escriba.
procesos con ia · harness
Un archivo que enseña a la IA a trabajar mejor.
Basado en el enfoque de Andrej Karpathy, he creado un archivo de instrucciones global que opencode carga en cualquier proyecto. Así la IA parte con unas guías claras sobre cómo escribir, pensar y estructurar código.
CLAUDE.md
Guías de comportamiento para reducir errores comunes al programar con IA.
Trade-off: Estas guías priorizan la precaución sobre la velocidad. Para tareas triviales,
usa el criterio.
01
Pensar antes de programar
No asumas. Expón los trade-offs antes de implementar.
02
Simplicidad primero
Mínimo código que resuelve el problema. Nada especulativo.
03
Cambios quirúrgicos
Toca solo lo que debas. No refactorices lo que no está roto.
04
Ejecución guiada por objetivos
Define criterios de éxito. Itera hasta verificarlos.
origen
La idea
Andrej Karpathy lleva tiempo insistiendo en que el prompt lo es todo. No importa lo bueno que sea el modelo si las instrucciones son vagas o contradictorias. Un buen harness — las guías que acompañan al código— puede marcar la diferencia entre una IA que alucina y una que produce resultados sólidos.
opencode permite definir un archivo global (karpathy.md) que se inyecta como
contexto en todos los proyectos. Así no tengo que repetir las mismas
instrucciones cada vez que empiezo algo nuevo: la IA ya sabe cómo quiero que trabaje.
Archivo global
Un solo fichero en ~/.config/opencode/ que opencode carga siempre. Las reglas están ahí
desde el primer mensaje.
Consistencia
El agente no empieza de cero: conoce mis principios de código, mi estilo y cómo manejar los trade-offs.
configuración
Dónde vive el archivo
opencode busca instrucciones globales en una ruta específica del sistema. Basta con colocar el archivo ahí y todos los proyectos lo heredan.
1. Crear el archivo
Escribes karpathy.md con las guías de comportamiento que quieras: cómo abordar problemas,
qué priorizar, cómo documentar.
2. Colocarlo en la ruta global
Lo guardas en ~/.config/opencode/ y opencode lo carga automáticamente al iniciar
cualquier proyecto.
3. Listo
Cada vez que hablas con el agente, las instrucciones están presentes. Sin setup adicional, sin copiar archivos entre proyectos.
contenido
Qué contiene karpathy.md
Cuatro principios que reducen errores y mejoran la calidad del código generado por IA.
-
Think Before Coding
qué dice — No asumas. No escondas la confusión. Explica los trade-offs antes de implementar.
para qué sirve — Evita que la IA se lance a escribir código sin entender el contexto o sin preguntar cuando algo es ambiguo.
-
Simplicity First
qué dice — El mínimo código que resuelve el problema. Nada especulativo, nada abstracto para un solo uso.
para qué sirve — La IA tiende a sobreingenierizar. Este principio la frena y la obliga a preguntarse si está añadiendo complejidad innecesaria.
-
Surgical Changes
qué dice — Toca solo lo que debas. No "mejores" código adyacente ni refactorices lo que no está roto.
para qué sirve— Las IAs suelen reescribir más de lo necesario. Con esto limito los cambios a lo estrictamente pedido.
-
Goal-Driven Execution
qué dice — Define criterios de éxito. Itera hasta verificarlos.
para qué sirve — Transforma instrucciones vagas en un bucle de trabajo comprobable. La IA sabe cuándo ha terminado.
resultado
Menos vueltas, más acierto
La IA pregunta antes de escribir
Cuando algo no está claro, el agente lo dice en lugar de asumir. Eso evita iteraciones desperdiciadas y código que no pedí.
Menos sobreingeniería
El archivo frena las abstracciones innecesarias. El resultado es código más legible y fácil de mantener.
Consistencia entre proyectos
Da igual si empiezo un script pequeño o una app completa: el agente parte con la misma base de criterios.
Iteraciones más cortas
Al tener objetivos claros desde el principio, cada ciclo de feedback produce cambios concretos y medibles.
el archivo
Un harness que no tocas, pero siempre está.
El archivo global de opencode es una de esas configuraciones que hacen que todo funcione mejor sin que tengas que acordarte. Lo pones una vez y la IA lo usa siempre.