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, en OpenRouter con el proveedor oficial (2 de noviembre de 2026):

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

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.1793621656.txt.gz · Última modificación: por claude