OpenSpecDesarrollo Impulsado por Especificaciones para Asistentes de IA

→ fluido, no rígido
→ iterativo, no en cascada
→ fácil, no complejo
→ construido para proyectos existentes, no solo para nuevos
→ escalable desde proyectos personales hasta empresas

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

Veálo en acción ​

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

Tú: /opsx:apply
IA:  Implementando tareas...
     ✓ 1.1 Añadir proveedor de contexto de temas
     ✓ 1.2 Crear componente de alternancia
     ✓ 2.1 Añadir variables CSS
     ✓ 2.2 Conectar con 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 próxima funcionalidad.

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 tu-proyecto
openspec init

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

Si deseas el flujo de trabajo ampliado (/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: primeros pasos
→ Flujos de Trabajo: combinaciones y patrones
→ Comandos: comandos de barra inclinada y habilidades
→ CLI: referencia de la terminal
→ Herramientas Soportadas: 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 ligera de especificaciones para que se acuerde qué construir antes de escribir cualquier código.

• Acuerda antes de construir — humano y IA se alinean en las especificaciones antes de que se escriba el código
• Mantente organizado — cada cambio obtiene su propia carpeta con propuesta, especificaciones, diseño y tareas
• Trabaja con fluidez — actualiza cualquier artefacto en cualquier momento, sin puertas de fase rígidas
• Usa tus herramientas — funciona con más de 20 asistentes de IA a través de comandos de barra inclinada

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 encerrado en su IDE y limitado a modelos Claude. OpenSpec funciona con las herramientas que ya usas.

vs. nada — Codificar con IA sin especificaciones significa prompts vagos y resultados impredecibles. OpenSpec aporta previsibilidad sin la ceremonia.

Actualizar OpenSpec ​

Actualiza el paquete

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

Refresca las instrucciones del agente

Ejecuta esto dentro de cada proyecto para regenerar la guía de IA y asegurar que los últimos comandos de barra inclinada 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 la planificación como para la implementación.

Higiene del 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 del contexto durante toda tu sesión.

Contribuir ​

Correcciones pequeñas — Las correcciones de errores, correcciones de errores tipográficos y mejoras menores se pueden enviar directamente como PRs.

Cambios más grandes — Para nuevas funcionalidades, 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 a través de diferentes agentes de codificación, modelos y casos de uso. Los cambios deben funcionar bien para todos.

Se acepta código generado por IA — 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