Tabla de Contenidos
¡Esta es una revisión vieja del documento!
Cómo se programa con IA: 10 ideas
1. Tú haces la arquitectura, la IA escribe el código
La IA es una máquina de implementar: funciona cuando ya has tomado las decisiones difíciles. Multiplica lo que sabes, no lo sustituye.
The Architecture-First Approach: visión, arquitectura, tareas pequeñas y una implementación cada vez.
2. El diseño detallado, antes que el código
Si le dejas, decide él el alcance, los componentes y las interfaces. Se acuerda de lo abstracto a lo concreto: capacidades, componentes, interacciones y contratos. Hasta entonces, ni una línea de código.
Design-First Collaboration: los cinco niveles de diseño.
3. El prompt se puede ignorar, la arquitectura no
Tú escribes el esqueleto (clases base, contratos, seguridad, gestión de errores) y la IA rellena los huecos. No puede saltarse lo que no controla.
Skeleton Architecture: el esqueleto lo pones tú, el tejido la IA.
4. Una tarea pequeña cada vez
Se pide un trozo, se prueba y se sigue. Si sale mal, no le pidas que lo deshaga: vuelve al último punto bueno y empieza una sesión nueva con más límites.
Pair programming con la IA: el ciclo de planificar, implementar, probar y volver atrás.
5. Guardarraíles deterministas
La IA no da dos veces el mismo resultado, sus comprobaciones sí tienen que darlo. El agente las lanza en su bucle y corrige hasta que pasan:
- JUnit: que hace lo que tiene que hacer.
- ArchUnit: que respeta la arquitectura.
- Métricas: cobertura, complejidad ciclomática, CRAP.
Herramientas deterministas: SonarQube, Snyk y cómo meterlas en el bucle.
6. SDD, ¿realmente funciona?
No como dogma. La prueba de Scott Logic: Spec Kit frente a su forma habitual, con incrementos pequeños y prompts sencillos:
| Agente | Revisión humana | Markdown | Código | |
|---|---|---|---|---|
| Con Spec Kit | 33 min | 3,5 h | 2.577 líneas | 689 líneas |
| Sin especificación | 8 min | 24 min | 0 | 1.000 líneas |
Especifica lo que no cabe en una frase, y que la especificación sea corta: lo que vale es el diseño, no el volumen de markdown.
Putting Spec Kit through its paces: ¿idea radical o cascada reinventada?
7. ¿Es necesario conocer un framework?
Sus conceptos sí, porque sin ellos no puedes revisar lo que sale. Su API de memoria no: eso lo pone el agente, con la documentación de la versión que usas.
Context7: la documentación actual de cada librería, dentro del agente.
8. Skills y agentes
- Skill: cómo se hace una tarea en tu equipo. Aquí va el conocimiento.
- Agente: quién la hace, con qué herramientas y cuándo para.
Casi todo son skills: en un proyecto real, 28.211 líneas de skills y 134 de agentes.
Skills: cómo se escriben.
9. OpenCode y los precios
OpenCode es de código abierto, habla con cualquier proveedor y recién instalado ya funciona con modelos gratuitos. Para trabajar en serio, un plan de pago fijo: sale mucho más barato que pagar por token.
OpenCode: instalarlo y conectar proveedores.
10. Orca o herdr: varios agentes a la vez
Los dos ejecutan tus agentes, cada uno en su worktree, y avisan de cuál te necesita. Usa Orca, que además deja revisar y comentar el diff. herdr si quieres quedarte en la terminal.
herdr y Orca comparados: qué tiene cada uno.

