Guía · A fondo OpenSpec

A fondo con OpenSpec y SDD

Deja de mirar y toma el volante: el flujo completo, código legacy y tu propio esquema para que el agente de IA te haga caso de verdad.

  • Tomas el volante

    Control fino del flujo, no el modo asistido del onboard.

  • Hecho para legacy

    Documenta y cambia código que ya existe sin romperlo.

  • Tu propio flujo

    Forkeas el esquema y le metes tus reglas a medida.

¿Te quedaste con ganas después del curso gratis?

Marca lo que te pasa de verdad. El curso gratis te da el mapa; cada cruz aquí es una perilla que solo se toca a fondo.

El flujo, de un vistazo

El onboard del curso gratis encadenaba nueve pasos. A fondo lo conduces tú en cinco: exploras, propones, aplicas con freno, verificas y archivas. El verify no viene por defecto — lo añadimos porque lo quieres.

  1. Paso 1

    Explore

    Investiga, no implementa

  2. Paso 2

    Propose

    Proposal + design + tareas

  3. Paso 3

    Apply

    Implementa y se PARA si duda

  4. Paso 4

    Verify

    Comprueba que cumple la spec

  5. Paso 5

    Archive

    Fusiona tu spec con la principal

Modo asistido vs a fondo

No es que el curso gratis esté mal: es la liga de iniciación. La diferencia es quién conduce y hasta dónde llega el método cuando el proyecto es tuyo.

Modo asistido (el free)

Copiloto
  • OpenSpec conduce, tú mirasGenial para entender el ciclo. No para tu proyecto del lunes.
  • Proyecto de jugueteLa API de Chiquito cabe en un explore. Tu monorepo, no.
  • Flujo por defectoEl SpecDriven de fábrica, sin tocar ni una regla.
  • NO objetivos, solo mencionadosSabes que existen. No cómo afinarlos para frenar al agente.
  • Un modelo para todoSin estrategia de coste por fase.
Onboard → miras → entiendes el ciclo → ¿y ahora en lo mío?

A fondo (tú al volante)

Al mando
  • Tú conduces el flujoParas, corriges y decides en cada fase. Verify incluido.
  • Grande y legacyEsquema research: documentas lo que ya existe antes de tocarlo.
  • Tu propio esquemaForkeas SpecDriven y le metes tus reglas (STOP, log de notas).
  • NO objetivos afinadosLa perilla exacta que frena al agente que se viene arriba.
  • Modelo por faseBarato para explorar, capaz para proponer, intermedio para aplicar.
Exploras → propones → aplicas con freno → verificas → archivas → repites

El curso gratis te enseña a leer el mapa. A fondo te da el volante.

Qué hay dentro de la guía

Enseñamos el índice, no destripamos las soluciones. Lo valioso está dentro: comandos copy-paste, capturas reales y un ejemplo trabajado de principio a fin.

  • 1

    El flujo completo, tú al mando

    explore → propose → apply → verify → archive sobre React Meteo, una app del tiempo de verdad (monorepo: front, back, BD y email).

    Solo para suscriptores

  • 2

    Verify: el paso que añadimos

    Comprobar que lo implementado coincide con la spec y las tareas antes de cerrar el cambio. No viene por defecto; lo quieres.

    Solo para suscriptores

  • 3

    Personaliza el flujo (I)

    Frena el salto automático a apply y haz que el agente guarde un log de decisiones, forkeando el esquema SpecDriven.

    Solo para suscriptores

  • 4

    Personaliza el flujo (II): legacy

    Crea un esquema research en solo lectura para documentar código que ya existe sin tocarlo. Ejemplo trabajado sobre un proyecto Drupal.

    Solo para suscriptores

  • 5

    Buenas prácticas y ahorro de tokens

    Grilling al planificar, AGENTS.md / CLAUDE.md afinados, el estado vive en ficheros y un modelo por fase para gastar menos.

    Solo para suscriptores

  • +

    Comparativa de sistemas SDD

    OpenSpec frente a SpecKit, GSD, Poll y MyOpenAgent, con un cuestionario para elegir según tu caso.

    Solo para suscriptores

Extras

La guía también te pilla si…

  • Hiciste el curso gratis y quieres llevarlo a un proyecto de verdad
  • Tu código es legacy y no sabes cómo meterle specs sin romper nada
  • Quieres que el agente deje de implementar de más
  • Gastas demasiados tokens por ciclo y sospechas que hay forma de bajarlo

Cada uno de esos caminos tiene su capítulo con el ejemplo trabajado sobre React Meteo.

Dudas antes de entrar

¿Necesito haber hecho el curso gratis de OpenSpec?
Ayuda, pero no es obligatorio. El gratis te enseña el ciclo en modo asistido; este te pone a ti al volante. Si vienes de cero, en el primer paso tienes la guía de instalación completa.
¿Sirve para mi proyecto grande o legacy?
Es justo donde más brilla. Hay un esquema research en solo lectura para documentar lo que ya existe antes de tocar nada, con un ejemplo trabajado sobre un proyecto Drupal.
¿Funciona con mi agente de IA?
OpenSpec es open source y compatible con decenas de agentes: Claude Code, OpenCode, Cursor, Codex, Gemini CLI y muchos más. Tú eliges; el flujo es el mismo.
¿De verdad ahorra tokens?
Sí: el estado vive en los ficheros, no en el chat, y puedes asignar un modelo distinto por fase. Dentro tienes la estrategia concreta.
¿Puedo dejar la suscripción al terminar?
Sí. Pero la membresía incluye podcast premium, otras guías y la comunidad — la mayoría se queda.