OpenSpecDesarrollo Impulsado por Especificaciones para Asistentes de IA

Nuestra filosofía:

→ fluido, no rígido
→ iterativo, no en cascada
→ sencillo, no complejo
→ construido para brownfield, no solo greenfield
→ escalable desde proyectos personales hasta empresas

Sigue a @0xTab en X para actualizaciones · Únete al Discord de OpenSpec para ayuda y preguntas.

Míralo en acción ​

Tú: /opsx:propose add-dark-mode
IA:  Creado openspec/changes/add-dark-mode/
     ✓ proposal.md — por qué hacemos esto, qué está cambiando
     ✓ specs/       — requisitos y escenarios
     ✓ design.md    — enfoque técnico
     ✓ tasks.md     — lista de implementación
     ¡Listo para implementar!

Tú: /opsx:apply
IA:  Implementando tareas...
     ✓ 1.1 Añadir proveedor de contexto de tema
     ✓ 1.2 Crear componente de alternancia
     ✓ 2.1 Añadir variables CSS
     ✓ 2.2 Conectar localStorage
     ¡Todas las tareas completadas!

Tú: /opsx:archive
IA:  Archivado en openspec/changes/archive/2025-01-23-add-dark-mode/
     Especificaciones actualizadas. Listo para la siguiente característica.

Inicio Rápido ​

Requiere Node.js 20.19.0 o superior.

Instala OpenSpec globalmente:

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

Luego navega al directorio de tu proyecto e inicializa:

cd your-project
openspec init

Ahora dile a tu IA: /opsx:propose <lo-que-quieras-construir>

Si quieres el flujo de trabajo expandido (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:sync, /opsx:bulk-archive, /opsx:onboard), selecciónalo con openspec config profile y aplícalo con openspec update.

Documentación ​

→ Primeros Pasos: los primeros pasos
→ Flujos de Trabajo: combinaciones y patrones
→ Comandos: comandos slash y habilidades
→ CLI: referencia de terminal
→ Herramientas Compatibles: integraciones de herramientas y rutas de instalación
→ Conceptos: cómo encaja todo
→ Multi-idioma: soporte multi-idioma
→ Personalización: hazlo tuyo

¿Por qué OpenSpec? ​

Los asistentes de codificación con IA son poderosos pero impredecibles cuando los requisitos solo viven en el historial del chat. OpenSpec añade una capa de especificación ligera para que acuerdes qué construir antes de escribir cualquier código.

• Acuerda antes de construir — humano e IA se alinean en las especificaciones antes de escribir código
• Mantente organizado — cada cambio obtiene su propia carpeta con propuesta, especificaciones, diseño y tareas
• Trabaja fluidamente — actualiza cualquier artefacto en cualquier momento, sin puertas de fase rígidas
• Usa tus herramientas — funciona con más de 20 asistentes de IA mediante comandos slash

Cómo nos comparamos ​

vs. Spec Kit (GitHub) — Exhaustivo pero pesado. Puertas de fase rígidas, mucho Markdown, configuración en Python. OpenSpec es más ligero y te permite iterar libremente.

vs. Kiro (AWS) — Poderoso pero estás atado a su IDE y limitado a modelos de Claude. OpenSpec funciona con las herramientas que ya usas.

vs. nada — Codificación con IA sin especificaciones significa indicaciones vagas y resultados impredecibles. OpenSpec aporta previsibilidad sin la ceremonia.

Actualizar OpenSpec ​

Actualiza el paquete

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

Actualiza las instrucciones del agente

Ejecuta esto dentro de cada proyecto para regenerar la guía de la IA y asegurar que los últimos comandos slash estén activos:

openspec update

Notas de Uso ​

Selección de modelo: OpenSpec funciona mejor con modelos de alto razonamiento. Recomendamos Opus 4.5 y GPT 5.2 tanto para planificación como para implementación.

Higiene de contexto: OpenSpec se beneficia de una ventana de contexto limpia. Limpia tu contexto antes de comenzar la implementación y mantén una buena higiene de contexto durante toda tu sesión.

Contribuir ​

Correcciones menores — Corrección de errores, erratas y mejoras menores pueden enviarse directamente como PRs.

Cambios mayores — Para nuevas características, refactorizaciones significativas o cambios arquitectónicos, por favor envía primero una propuesta de cambio de OpenSpec para que podamos alinearnos en la intención y los objetivos antes de que comience la implementación.

Al escribir propuestas, ten en cuenta la filosofía de OpenSpec: servimos a una amplia variedad de usuarios en diferentes agentes de codificación, modelos y casos de uso. Los cambios deben funcionar bien para todos.

El código generado por IA es bienvenido — siempre que haya sido probado y verificado. Los PRs que contengan código generado por IA deben mencionar el agente de codificación y el modelo utilizado (por ejemplo, "Generado con Claude Code usando claude-opus-4-5-20251101").

Desarrollo ​

• Instalar dependencias: pnpm install
• Compilar: pnpm run build
• Probar: pnpm test
• Desarrollar CLI localmente: pnpm run dev o pnpm run dev:cli
• Commits convencionales (una línea): type(scope): subject

Otros ​

Licencia ​

MIT