Herramientas de usuario

Herramientas del sitio


cursos:sdd:presentacion

¡Esta es una revisión vieja del documento!


Cómo se programa con IA

1. Se programa en OpenCode, no en un IDE

El agente vive en la terminal y trabaja sobre la carpeta del proyecto. Tú le pides, él edita y lanza órdenes. Es de código abierto y habla con cualquier proveedor.

OpenCode: instalarlo y conectar proveedores.

2. OpenCode se mete dentro de Orca o herdr

Son el «IDE» de hoy: 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.

3. Precios: API o suscripción

  • API: se paga por token. Para probar o para un uso puntual.
  • Suscripción: pago fijo con límite de uso. Para trabajar a diario: sale mucho más barata.

Por API, en dólares por millón de tokens de entrada, en OpenRouter con el proveedor oficial (2 de noviembre de 2026):

Modelo Entrada
Claude Haiku 5.5 (hasta 100.000 tokens de entrada) 0,10
DeepSeek V4.1 Flash 0,15
Claude Haiku 5.5 (a partir de 100.000) 0,50
GLM 5.3 1,40
Kimi K3.1 Pro 2
Claude Sonnet 5.5 2
Claude Opus 5.5 4
Claude Fable 5.1 10

Por suscripción, en dólares al mes:

Plan Precio Modelos
OpenCode Go 10 y 40 Modelos abiertos: Kimi, DeepSeek, GLM…
GLM Coding Plan 18, 72 y 160 GLM
Kimi 19, 39, 99 y 199 Kimi
Claude 20, 100 y 200 Haiku, Sonnet, Opus

precios-planes.jpeg

OpenRouter: los precios actualizados de cada modelo y proveedor.

4. Skills y MCP

  • Skill: cómo se hace una tarea en tu equipo. Solo ocupa contexto cuando la tarea encaja.
  • MCP: herramientas nuevas: el navegador, la base de datos, la documentación actual. Ocupa contexto siempre, así que conecta solo los que uses.

Empieza por las skills: son ficheros de texto.

Qué usar para cada problema: el problema que tienes y la pieza que lo resuelve.

5. El contexto

Es todo lo que ve el modelo, y se le manda entero en cada turno. Cuanto más lleno, peor trabaja y más cuesta.

  • No pases del 40 % de la ventana.
  • Una tarea, una sesión: al cambiar de tarea, /clear.
  • Lo fijo, corto: AGENTS.md se carga siempre.

El contexto: qué entra y cómo se llena.

6. Agentes

Un subagente hace un trozo del trabajo en su propia ventana de contexto y devuelve un resumen. Sirve para lo que leería demasiado o para revisar sin fiarse de quien implementó.

La skill dice cómo se hace; el agente, quién lo hace y cuándo para. Casi todo son skills: en un proyecto real, 28.211 líneas de skills y 134 de agentes.

Agentes: cómo se escribe uno.

7. 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.

8. 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.

9. 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.

10. 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.

11. 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.

12. 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?

13. ¿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.

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