ospec-workflow

ospec-workflow

Spec-Driven Development (SDD) llave en mano: OpenSpec como fuente de verdad, Strict TDD, un orquestador que coordina agentes de fase, y cambios revisables de principio a fin. Está basado en Gentle-ai de Gentleman Programming.

El formato canónico es un plugin de agentes para VS Code: VS Code carga este repositorio tal cual, sin compilar nada. Para llevar el mismo workflow a Claude Code o GitHub Copilot CLI, un generador (scripts/configure/cli.js) produce un árbol nativo y validado de cada herramienta en dist/<target>/ sin tocar el origen. Un solo source, tres destinos. Ver Compatibilidad multi-target.

La versión actual es 2.6.0. El usuario trabaja con sdd-orchestrator; el orquestador coordina, los agentes de fase ejecutan y OpenSpec conserva el estado versionable.

Inicio rápido

• Opción A (Uso directo del source - sin ruteo de modelos):
  1. Agrega la raíz de este repositorio clonado a chat.pluginLocations en tu settings.json de VS Code.
• Opción B (Compilado con ruteo de modelos de models.yaml - Recomendado):
  1. Ejecuta el script de configuración automática:

     npm run setup:vscode
     

     (Esto compila el target VS Code a dist/vscode y lo añade automáticamente a chat.pluginLocations de tus editores VS Code/Insiders).
  2. Si deseas realizar cambios futuros e inyectarlos de nuevo:

     npm run reload:vscode
     

En ambos casos:

1. Revisa el manifiesto, los hooks y los servidores MCP antes de habilitarlo.
2. Instala el hook pre-commit de Git para validar tus cambios locales automáticamente:

   npm run setup:git-hooks
   

3. Inicia un cambio con /sdd-new (o /sdd-ff, /sdd-lite, /sdd-baseline según el caso).
4. Continúa el flujo con /sdd-continue o ejecútalo por fases.
5. Verifica con /sdd-verify y archiva con /sdd-archive.

Claude Code

Para usuarios finales (sin clonar el repo ni Node)

El repositorio no se instala directo: la fuente canónica está en formato VS Code y el target claude requiere una transformación obligatoria. El artefacto ya construido se publica en la branch release (vía CI), así que basta con:

claude plugin marketplace add https://github.com/mretamozo-hiberuscom/ospec-workflow.git#release
claude plugin install ospec-workflow@ospec-tools

La branch release es un canal "latest" continuo: CI la republica cada vez que publicas un GitHub Release. Si ya lo tienes instalado, Claude Code cachea el marketplace, así que para recibir la última versión actualiza explícitamente:

claude plugin marketplace update ospec-tools
claude plugin update ospec-workflow@ospec-tools

Para equipos, puedes versionar esto en .claude/settings.json y que a cada miembro se le ofrezca instalarlo al confiar la carpeta del proyecto:

{
  "extraKnownMarketplaces": {
    "ospec-tools": {
      "source": { "source": "github", "repo": "mretamozo-hiberuscom/ospec-workflow", "ref": "release" }
    }
  },
  "enabledPlugins": ["ospec-workflow@ospec-tools"]
}

Para desarrollo del plugin (un solo comando)

Probar solo durante la sesión actual, sin instalar:

node scripts/configure/cli.js --target claude --out dist/claude
claude --plugin-dir dist/claude

Instalación persistente desde el marketplace local. El comando es idempotente: la primera vez registra e instala, y en cada cambio reconstruye y actualiza.

npm run setup:claude

Después abrí Claude Code normalmente (claude) y, dentro de la sesión, /reload-plugins.

Mientras iterás con una sesión abierta, lo más rápido es solo reconstruir y recargar:

npm run reload:claude   # build (con validación strict) — luego /reload-plugins en la sesión

npm run setup:claude reemplaza el flujo manual de cinco pasos. El build ya corre claude plugin validate --strict, y el registro del marketplace + install solo hacen falta una vez (después se hace update). Si preferís el flujo crudo, sigue disponible en docs/plugin-installation.md.

GitHub Copilot CLI

El target github-copilot permite dos modalidades de uso.

Opción A: Local / Proyecto específico

Copia el árbol de agentes y configuración en la raíz del repositorio de destino (.github/, .mcp.json, skills/, scripts/):

npm run install:copilot -- ../mi-proyecto   # build + copia el árbol
npm run build:copilot                        # solo build a dist/github-copilot

Agregá --dry-run para ver qué copiaría sin escribir: node scripts/configure/install-target.js github-copilot ../mi-proyecto --dry-run.

Opción B: Global