OpenSpecDesenvolvimento Orientado por Especificação para Assistentes de IA

Nossa filosofia:

→ fluido não rígido
→ iterativo não cascata
→ fácil não complexo
→ construído para brownfield não apenas greenfield
→ 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 Conectar localStorage
     Todas as tarefas concluídas!

Você: /opsx:archive
IA:  Arquivado em openspec/changes/archive/2025-01-23-add-dark-mode/
     Especificações atualizadas. Pronto para o próximo recurso.

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 diga à 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: combos e padrões
→ Comandos: comandos slash e habilidades
→ CLI: referência do terminal
→ Ferramentas Suportadas: integrações de ferramentas e caminhos de instalação
→ Conceitos: como tudo se encaixa
→ Multi-idioma: suporte multi-idioma
→ 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 do 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.

• Concorde antes de construir — humano e IA alinham-se nas especificações antes do código ser escrito
• Mantenha-se organizado — cada mudança recebe sua própria pasta com proposta, especificações, design e tarefas
• Trabalhe fluidamente — atualize qualquer artefato a qualquer momento, sem portões de fase rígidos
• Use suas ferramentas — funciona com mais de 20 assistentes de IA via comandos slash

Como nos comparamos ​

vs. Spec Kit (GitHub) — Completo, mas pesado. Portões de fase rígidos, muito Markdown, configuração em Python. O OpenSpec é mais leve e permite iteração livre.

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 cerimônia.

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 a orientação da IA e garantir que os comandos slash mais recentes 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 uma boa higiene de contexto durante toda a sua sessão.

Contribuindo ​

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

Mudanças maiores — Para novos recursos, refatorações significativas ou mudanças arquitetônicas, por favor, envie primeiro uma proposta de mudança do OpenSpec para que possamos alinhar a intenção e os objetivos antes que a implementação comece.

Ao escrever propostas, mantenha a filosofia do OpenSpec em mente: servimos uma ampla variedade de usuários em diferentes agentes de codificação, modelos e casos de uso. As mudanças 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 usados (por exemplo, "Gerado com Claude Code usando claude-opus-4-5-20251101").

Desenvolvimento ​

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

Outros ​

Licença ​

MIT