Instala OpenSpec y conoce a Chiquito

OpenSpec es open source, vive en openspec.dev y es compatible con casi cualquier agente: Claude Code, Cursor, Codex, Copilot, Gemini, Kiro… Nosotros vamos a trabajar con OpenCode, también open source, que tiene una virtud para aprender: no esconde nada, lo ves todo a la vista. Puedes enchufarle tu cuenta de Copilot, la de ChatGPT o un modelo local con Ollama.

El proyecto de prácticas es una API de chistes de Chiquito de la Calzada: sencilla, generada con IA y, lo importante, ya existe. La tienes en github.com/webreactiva-devs/chiquito-api-openspec. Puedes usar esa o cualquier proyecto tuyo.

Necesitas Node 20.19 o superior. Instala OpenSpec global, con npm:

npm install -g @fission-ai/openspec@latest

Dentro de la carpeta del proyecto, inicializas y eliges tu agente (aquí, opencode):

openspec init

Pulsa Enter para elegir herramientas:

                        Welcome to OpenSpec
                        A lightweight spec-driven framework

        ████            This setup will configure:
      ██    ██            • Agent Skills for AI tools
    ██  ████  ██          • /opsx:* slash commands
    ██  ████  ██
    ██  ████  ██        Quick start after setup:
      ██    ██            /opsx:new      Create a change
        ████              /opsx:continue Next artifact
                          /opsx:apply    Implement tasks

                        Press Enter to select tools...

Selecciona tu agente (Espacio para marcar, Enter para confirmar):

? Select tools to set up (30 available)
  Selected: (none selected)
  Search: [type to filter]
  ↑↓ navigate • Space toggle • Backspace remove • Enter confirm
  › ○ Amazon Q Developer
    ○ Antigravity
    ○ Auggie (Augment CLI)
    ○ Bob Shell
    ○ Claude Code
    ○ Cline
    ○ Codex
    ○ ForgeCode
    ○ CodeBuddy Code (CLI)
    ○ Continue
    ○ CoStrict
    ○ Crush
    ○ Cursor
    ○ Factory Droid
    ○ Gemini CLI
  (1/2)

Al terminar verás el resumen: ha creado la carpeta openspec/ con sus comandos y skills:

OpenSpec Setup Complete

Created: opencode
11 skills and 11 commands in .opencode/
Config: openspec/config.yaml (schema: spec-driven)

Getting started:
  Start your first change: /opsx:propose "your idea"

Learn more: https://github.com/Fission-AI/OpenSpec
Feedback:   https://github.com/Fission-AI/OpenSpec/issues

Restart your IDE for slash commands to take effect.

Un aviso para que no te líes: los comandos del agente empiezan por opsx. En Claude Code o Codex los verás con dos puntos (/opsx:onboard); en OpenCode, con guion (/opsx-onboard), porque cuando se grabó esto OpenCode aún no aceptaba los dos puntos. A lo largo del curso te dejo siempre las dos formas.

Por defecto se instala el perfil core (propose, explore, apply, sync, archive), y para este flujo te vale. Pero hasta que no controles todos los comandos que existen, es mejor tenerlos todos a mano: lanza el configurador, elige Delivery and workflows, marca ambos (skills + commands) y todos los workflows —incluidos new, continue, ff, verify y onboard—:

openspec config profile

Elige Delivery and workflows:

> openspec config profile

Current profile settings
  Delivery: both
  Workflows: 9 selected (custom)
  Delivery = where workflows are installed (skills, commands, or both)
  Workflows = which actions are available (propose, explore, apply, etc.)

? What do you want to configure?
❯ Delivery and workflows
  Delivery only
  Workflows only
  Keep current settings (exit)

Selecciona ambos (skills + commands):

✔ What do you want to configure? Delivery and workflows
? Delivery mode (how workflows are installed):
❯ Both (skills + commands) [current]
  Skills only
  Commands only

Marca todos los workflows:

✔ Delivery mode (how workflows are installed): Both (skills + commands) [current]
? Select workflows to make available:
 [x] Propose change
 [x] Explore ideas
 [x] New change
 [x] Continue change
 [x] Apply tasks
 [x] Fast-forward
 [x] Sync specs
 [x] Archive change
 [x] Bulk archive
 [x] Verify change
❯[x] Onboard

Y aplicas los cambios:

openspec update

Todo esto son ficheros Markdown. Por eso es tan fácil destilar el esquema y hacerte el tuyo… pero eso ya es harina del curso avanzado.