Herramientas de usuario

Herramientas del sitio


cursos:sdd:presentacion

¡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 misma funcionalidad, medida por Scott Logic con Spec Kit:

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.

precios-planes.jpeg

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.

cursos/sdd/presentacion.1793617906.txt.gz · Última modificación: por claude