openspec

OpenSpec é um framework de desenvolvimento orientado por especificações (SDD) para assistentes de codificação por IA. Ele adiciona uma camada leve de especificação para garantir que desenvolvedores humanos e assistentes de IA estejam alinhados sobre o que construir antes de qualquer código ser escrito. O projeto é publicado como o pacote npm @fission-ai/openspec, licenciado sob MIT e requer Node.js 20.19.0 ou superior. O fluxo de trabalho é construído em torno de comandos com barra invertida que funcionam dentro de ferramentas de codificação por IA suportadas. Após executar `openspec init` em um projeto, os usuários podem invocar comandos como `/opsx:explore` para discutir uma ideia com a IA, `/opsx:propose <name>` para criar uma proposta de mudança, `/opsx:apply` para implementar as tarefas planejadas e `/opsx:archive` para finalizar e arquivar a mudança. Cada proposta de mudança recebe sua própria pasta em `openspec/changes/`, contendo um `proposal.md`, uma pasta `specs/` com requisitos e cenários, um `design.md` e um `tasks.md`. As especificações são escritas em Markdown simples, usando um formato simples de requisito e cenário, sem sintaxe especial necessária. OpenSpec suporta mais de 30 assistentes e ferramentas de codificação por IA, com variações de escrita do comando canônico dependendo da ferramenta, como `/opsx-propose`, `@opsx-propose` ou `$openspec-propose`. Um perfil de fluxo expandido está disponível com comandos adicionais, incluindo `/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/opsx:verify` e `/opsx:onboard`. O projeto também introduz um recurso em beta chamado Stores, que permite planejar em um repositório separado compartilhado entre uma equipe via git push. Stores usam a mesma estrutura `openspec/` para especificações e mudanças e visam suportar funcionalidades entre repositórios, requisitos compartilhados gerenciados por uma única equipe e fluxos de trabalho "planeje antes de codificar", onde repositórios de código se atualizam posteriormente. OpenSpec coleta estatísticas anônimas de uso, limitadas a nomes de comandos e versão, sem argumentos, caminhos, conteúdo ou informações pessoalmente identificáveis. A telemetria é desativada automaticamente em CI e pode ser desativada por configuração ou variáveis de ambiente. A documentação cobre início rápido, funcionamento dos comandos, adoção em projetos existentes, edição de mudanças, referência CLI, suporte multi-linguagem, personalização e esquemas da comunidade. O projeto foi construído com OpenSpec itself, e seu repositório contém exemplos ao vivo de especificações e mudanças em andamento.