Propósito
Al desarrollar con IA, los requisitos pueden quedar repartidos entre distintas conversaciones. Un comportamiento que acordaste conservar hoy podría pasarse por alto en el siguiente cambio. OpenSpec guarda requisitos, decisiones de diseño y tareas en archivos del proyecto para que puedas revisar el plan antes de pedir a la IA que lo implemente.
Es una herramienta de desarrollo guiado por especificaciones que combina una CLI con varios agent skills. Puedes usarla en tu herramienta de desarrollo con IA habitual, sin cambiar de editor. El proyecto oficial publica el código fuente con licencia MIT.
Cuándo usarlo
Creemos que vale la pena probar OpenSpec cuando una función requiere varias conversaciones, se extiende a más de un chat o tiene criterios de aceptación claros. Al guardar los requisitos en el proyecto, tendrás un documento que consultar cuando retomes el trabajo.
Si solo vas a corregir una frase, preparar todos los documentos de un cambio puede llevar más tiempo que editarla directamente. Puedes decidir según el alcance del cambio. Esta es una valoración editorial basada en la documentación oficial; no procede de pruebas propias ni de una comparación de rendimiento.
Ejemplo de uso
Para añadir un directorio de Agent Skills, podrías decirle primero a la IA:
Ayúdame a explorar cómo crear un directorio de Agent Skills. Quiero incluir Skills propios y otros externos seleccionados, con filtros por categoría y ordenación por fecha. Aclaremos primero los requisitos; todavía no escribas código.
La guía de inicio oficial divide un cambio en cinco etapas:
- Explorar: Hablar de los requisitos, revisar el código existente y comparar opciones sin programar.
- Proponer: Registrar el motivo del cambio, los requisitos y las tareas; añadir un documento de diseño si hay decisiones técnicas que tomar.
- Revisión humana: Confirmar el alcance y los criterios de aceptación antes de implementar.
- Implementar: Pedir a la IA que complete las tareas siguiendo los archivos.
- Archivar: Incorporar los requisitos terminados a las especificaciones principales y conservar el historial del cambio.
Para invocar la exploración directamente, usa $openspec-explore en Codex o /opsx:explore en Claude Code. La forma de invocación depende de la herramienta; consulta las indicaciones de la inicialización y la documentación de herramientas compatibles.
Limitaciones
Las especificaciones aún necesitan revisión humana. Si un requisito es incorrecto, seguirá siéndolo después de escribirlo en un archivo. OpenSpec no garantiza que la IA acierte ni sustituye las pruebas de software o la revisión humana.
Las plataformas compatibles, los métodos de instalación y los comandos pueden cambiar con cada versión. Codex, Claude Code, Cursor y GitHub Copilot son ejemplos; la lista completa está en la documentación oficial.
Instalación
Si vas a instalarlo con npm, comprueba primero que tienes Node.js 22.12.0 o posterior. Después ejecuta:
npm install -g @fission-ai/openspec@latest
openspec --versionCuando aparezca la versión, entra en el directorio de tu proyecto e inicializa OpenSpec:
cd your-project
openspec initSustituye your-project por la ruta de tu proyecto y elige las herramientas de IA que usas cuando se te indique. Después podrás pedir a la IA que explore requisitos o proponga un cambio. La guía oficial también ofrece un instalador independiente y Homebrew; el instalador independiente no requiere Node.js. Consulta la guía de instalación para otros métodos y actualizaciones.