OpenSpecDesenvolvimento Orientado a Especificações para Assistentes de IA

→ fluido, não rígido
→ iterativo, não em cascata
→ fácil, não complexo
→ construído para terrenos já desenvolvidos, não apenas para novos projetos
→ escalável de projetos pessoais a empresas

Siga @0xTab no X para atualizações · Junte-se ao Discord do OpenSpec para ajuda e perguntas.

Veja em ação ​

Você: /opsx:propose add-dark-mode
IA:   Criado openspec/changes/add-dark-mode/
      ✓ proposal.md — por que estamos fazendo isso, o que está mudando
      ✓ specs/       — requisitos e cenários
      ✓ design.md    — abordagem técnica
      ✓ tasks.md     — checklist de implementação
      Pronto para implementação!

Você: /opsx:apply
IA:   Implementando tarefas...
      ✓ 1.1 Adicionar provedor de contexto de tema
      ✓ 1.2 Criar componente de alternância
      ✓ 2.1 Adicionar variáveis CSS
      ✓ 2.2 Integrar com localStorage
      Todas as tarefas concluídas!

Você: /opsx:archive
IA:   Arquivado em openspec/changes/archive/2025-01-23-add-dark-mode/
      Especificações atualizadas. Próxima funcionalidade.

Início Rápido ​

Requer Node.js 20.19.0 ou superior.

Instale o OpenSpec globalmente:

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

Em seguida, navegue até o diretório do seu projeto e inicialize:

cd seu-projeto
openspec init

Agora digite para sua IA: /opsx:propose <o-que-você-quer-construir>

Se você deseja o fluxo de trabalho expandido (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:sync, /opsx:bulk-archive, /opsx:onboard), selecione-o com openspec config profile e aplique com openspec update.

Documentação ​

→ Primeiros Passos: primeiros passos
→ Fluxos de Trabalho: combinações e padrões
→ Comandos: comandos de barra e habilidades
→ CLI: referência do terminal
→ Ferramentas Suportadas: integrações e caminhos de instalação
→ Conceitos: como tudo se encaixa
→ Multi-Idioma: suporte a múltiplos idiomas
→ Personalização: faça do seu jeito

Por que OpenSpec? ​

Assistentes de codificação com IA são poderosos, mas imprevisíveis quando os requisitos vivem apenas no histórico de chat. O OpenSpec adiciona uma camada leve de especificação para que você concorde sobre o que construir antes que qualquer código seja escrito.

• Concorda antes de construir — humano e IA alinham-se nas especificações antes que o código seja escrito
• Mantenha-se organizado — cada alteração recebe sua própria pasta com proposta, especificações, design e tarefas
• Trabalhe de forma fluida — atualize qualquer artefato a qualquer momento, sem bloqueios de fase rígidos
• Use suas ferramentas — funciona com mais de 20 assistentes de IA via comandos de barra

Como nos comparamos ​

vs. Spec Kit (GitHub) — Completo, mas pesado. Bloqueios de fase rígidos, muita Markdown, configuração em Python. O OpenSpec é mais leve e permite que você itere livremente.

vs. Kiro (AWS) — Poderoso, mas você fica preso ao IDE deles e limitado aos modelos Claude. O OpenSpec funciona com as ferramentas que você já usa.

vs. nada — Codificação com IA sem especificações significa prompts vagos e resultados imprevisíveis. O OpenSpec traz previsibilidade sem a formalidade.

Atualizando o OpenSpec ​

Atualize o pacote

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

Atualize as instruções do agente

Execute isso dentro de cada projeto para regenerar as orientações da IA e garantir que os últimos comandos de barra estejam ativos:

openspec update

Notas de Uso ​

Seleção de modelo: O OpenSpec funciona melhor com modelos de alto raciocínio. Recomendamos Opus 4.5 e GPT 5.2 tanto para planejamento quanto para implementação.

Higiene de contexto: O OpenSpec se beneficia de uma janela de contexto limpa. Limpe seu contexto antes de iniciar a implementação e mantenha boa higiene de contexto durante toda a sessão.

Contribuindo ​

Pequenas correções — Correções de bugs, correções de erros de digitação e melhorias menores podem ser enviadas diretamente como PRs.

Alterações maiores — Para novas funcionalidades, refatorações significativas ou alterações arquiteturais, por favor, envie primeiro uma proposta de alteração do OpenSpec para que possamos alinhar intenção e objetivos antes que a implementação comece.

Ao escrever propostas, lembre-se da filosofia do OpenSpec: servimos uma ampla variedade de usuários em diferentes agentes de codificação, modelos e casos de uso. As alterações devem funcionar bem para todos.

Código gerado por IA é bem-vindo — desde que tenha sido testado e verificado. PRs contendo código gerado por IA devem mencionar o agente de codificação e o modelo utilizado (ex., "Gerado com Claude Code usando claude-opus-4-5-20251101").

Desenvolvimento ​

• Instale dependências: pnpm install
• Compile: pnpm run build
• Teste: pnpm test
• Desenvolva a CLI localmente: pnpm run dev ou pnpm run dev:cli
• Commits convencionais (uma linha): type(scope): subject

Outros ​

Licença ​

MIT