SPEC-DRIVEN DEVELOPMENT • O SUPERPODER HUMANO NA ERA DA IA

Pare de programar por tentativa e erro.
Comece a construir com especificações.

O Spec Architect é uma bancada visual de desenvolvimento orientado a especificações para agentes de IA: você planeja a mudança, revisa os documentos e entrega tarefas de escopo fechado a Claude Code, Codex e outros agentes, com tudo versionado no Git.

  1. Ideia
  2. Proposta
  3. Requisitos
  4. Tarefas
  5. Agente
  6. Verificação

A IA não vai substituir os programadores. Vai substituir quem só sabe pedir pra IA. Tony Stark não diz ao JARVIS “faz uma armadura aí”. Ele entrega o projeto: medidas, materiais, limites. O JARVIS constrói; ele testa cada peça antes de vestir. O Spec Architect é a sua oficina: você define proposta, requisitos e tarefas, o agente executa, e a verificação confere se o resultado bate com o projeto.

🧩 Compatível com OpenSpec • ⚡ Zero Dependências Globais • 🦀 Tauri v2 + Rust Core • 🛡️ Motor Isolado em Sandbox
Spec Architect: quadro de mudanças com o progresso das tarefas de cada change

Você já usa OpenSpec?

O Spec Architect é compatível com o OpenSpec e usa de propósito os mesmos nomes de pastas e arquivos. Um projeto começado no OpenSpec abre aqui e continua de onde parou; um projeto começado aqui continua no OpenSpec. Sem conversão nos dois sentidos.

Baixar e abrir meu projeto

O Spec Architect é um projeto independente, sem vínculo com a Fission AI, criadora do OpenSpec. Não é um produto oficial do OpenSpec.

O Que o Desenvolvimento Orientado a Especificações RESOLVE de Verdade?

Se alguém te perguntar por que essa metodologia importa, o argumento definitivo é o que ela resolve na prática:

🔄 Resolvido

O "Loop do Prompt Infinito"

O Problema do Vibe Coding Sabe quando você pede algo para a IA, ela conserta uma coisa, quebra outra e você passa horas colando código no chat sem entender nada?
A Solução do Spec Architect Quebra esse ciclo pela raiz. Você cria um arquivo de especificação estruturado (spec) antes de qualquer linha de código. A IA lê o plano completo e implementa seguindo o que foi especificado.
🧠 Resolvido

A "Amnésia" e Alucinação da IA

O Problema do Vibe Coding Modelos de linguagem perdem o contexto facilmente em chats longos. Começam a inventar dependências inexistentes e esquecem contratos decididos minutos antes.
A Solução do Spec Architect A especificação funciona como uma "âncora de realidade" e fonte única da verdade no Git. Se a IA tentar inventar uma lógica maluca, ela é barrada pelo contrato técnico definido na spec.
🏗️ Resolvido

O Abismo entre Ideia e Engenharia

O Problema do Vibe Coding Escrever o código virou a parte barata da tecnologia. O erro é sair gerando código às cegas sem pensar nos casos de borda e regras críticas do sistema.
A Solução do Spec Architect Força a sua cognição a pensar nos casos de borda, regras de negócio e integrações antes de gastar token. O humano arquiteta com visão estratégica; a máquina faz o trabalho braçal.
🦾 ⚡ 🤖

"Tony Stark não faz 'vibe coding' com o JARVIS. Ele chega com especificações técnicas milimétricas, modelos matemáticos e pura cognição antes de mandar a máquina construir. No desenvolvimento moderno, o verdadeiro superpoder não é digitar código nem debugar prompts no escuro: é ser o arquiteto que dita as regras do jogo."

— O Princípio Stark do Spec-Driven Development

A Diferença Entre Prompting Cego e SDD

Vibe coding funciona em brinquedos descartáveis. Software sério de produção exige limites formais e rastreabilidade.

O Caos do Prompting Cego

Prompt-and-Pray (Vibecoding)

  • ✕ Deriva de Contexto: O agente perde a linha lógica na 4ª iteração e regride código que já funcionava.
  • ✕ Arquitetura Invisível: Decisões estruturais ficam soterradas no histórico do chat e nunca viram documentação.
  • ✕ Refatorações Destrutivas: Mudanças isoladas quebram contratos implícitos do sistema sem aviso prévio.
  • ✕ Ilusão de Conclusão: O código compila no console, mas viola regras de negócio fundamentais da empresa.
A Abordagem de Engenharia

Spec-Driven Development (SDD)

  • ✓ Contratos Vivos no Git: Especificações claras em Markdown/YAML evoluem lado a lado com a base de código.
  • ✓ Handoff com Escopo Fechado: Agentes de IA recebem apenas tarefas atômicas com escopo restrito e critérios de aceite.
  • ✓ Auditoria Antes do Código: Mudanças arquiteturais são propostas, debatidas e aprovadas antes de qualquer diff.
  • ✓ Mais Previsibilidade e Rastreabilidade: A IA trabalha a partir da especificação, o que reduz retrabalho e inconsistências, e cada decisão fica registrada.

O Pipeline SDD em 4 Etapas

Um fluxo sistemático de engenharia que substitui a tentativa e erro por etapas revisáveis.

ETAPA 01

Propor & Explorar

Crie uma proposta de mudança (`proposal.md`), mapeie o impacto nas especificações existentes e defina o design arquitetural antes de escrever uma linha de código.

ETAPA 02

Especificação Viva

Formalize os requisitos funcionais, cenários de teste e deltas de spec. Seus documentos são versionados no Git e nunca ficam defasados da realidade.

ETAPA 03

Handoff de Agentes

Despache tarefas estruturadas diretamente para Claude Code, Codex, Cursor Agent, Kiro ou Antigravity com contexto isolado, sem poluir a memória do modelo.

ETAPA 04

Auditoria & Conclusão

Verifique a conformidade da implementação contra a especificação original, execute testes de invariantes e finalize a mudança com histórico completo.

Engenharia Sob o Capô

Construído com padrões industriais para desenvolvedores que exigem performance, segurança e soberania técnica.

27 / 52 MBInstalador Windows / pacote .deb
~90 MBMemória do núcleo em Rust
0Runtimes para instalar
Zero-Config

Motor Embutido em Sandbox

O interpretador e o motor de execução vêm 100% integrados no instalador. Você não precisa instalar Node, npm ou pacotes globais para usar o app.

Performance

Tauri v2 + Rust Core

Núcleo em Rust com cerca de 90 MB de memória. A interface usa o navegador do próprio sistema em vez de embutir um Chromium inteiro como os apps Electron: 27 MB no instalador do Windows, 52 MB no pacote .deb.

Imunidade

Resistente a Quebras Externas

Mesmo que ferramentas de terceiros atualizem comandos ou quebrem APIs globais na sua máquina, seu ambiente de especificações continua 100% estável.

Orquestração

Compatibilidade Multi-Agent

Suporte de primeira classe para Claude Code, Codex, Cursor Agent, Kiro e Antigravity com detecção automática de ambiente e histórico isolado.

Privacidade

100% Local-First & Git-Native

Nenhum código ou especificação é enviado para servidores proprietários. Seus arquivos residem estritamente no seu disco e no seu controle de versão.

Economia

Menos tokens, menos retrabalho

O agente recebe a especificação e uma tarefa de escopo fechado, não o histórico inteiro de um chat longo. Menos contexto repetido a cada mensagem e menos idas e vindas para consertar o que a IA inventou.

Do download à primeira mudança em 4 passos

  1. 1

    Instale um agente e o app

    Tenha uma CLI de agente logada (Claude Code, Codex, Cursor Agent, Kiro ou Antigravity) e instale o Spec Architect para Windows ou Linux.

  2. 2

    Abra a pasta do projeto

    Escolha a raiz do seu repositório. Se ele ainda não usa o Spec Architect, o app prepara a estrutura com um clique; se já usa, tudo aparece na hora.

  3. 3

    Planeje com o agente

    Descreva a mudança e o agente escreve proposta, requisitos, design e tarefas no console do app. Você revisa antes de qualquer linha de código.

  4. 4

    Implemente, verifique e finalize

    O quadro acompanha as tarefas ao vivo. No fim, o agente verifica a implementação contra a spec e a mudança vai para o histórico.

Instale o Spec Architect

Binários autocontidos com verificação criptográfica SHA-256 incluída.

Pré-requisito Tenha pelo menos uma CLI de agente de IA instalada e logada

O Spec Architect organiza as especificações e entrega as tarefas a um agente de IA — quem escreve o código é o agente, rodando no console do app. Instale um destes antes de usar:

  • Claude Codeclaude
  • Codexcodex
  • Cursor Agentcursor-agent
  • Kirokiro-cli
  • Antigravityagy

Node.js e a CLI do OpenSpec não são necessários: já vêm dentro do app. Git é opcional (habilita o painel de alterações).

🐧 Linux Disponível

Binários oficiais para distribuições baseadas em Debian, Ubuntu, Fedora e Arch Linux.

🪟 Windows Disponível

Windows 10 e 11 (64 bits). Instale sem precisar de administrador, ou use a versão portátil: extraia e execute.

O executável ainda não é assinado: na primeira execução o Windows SmartScreen avisa. Clique em Mais informações → Executar assim mesmo.

chmod +x spec-architect_amd64.AppImage && ./spec-architect_amd64.AppImage

SHA256SUMS.txt · Todas as versões

Autor & Criador

Marcelo Guimarães

Programador Sênior Full Stack

Raízes sólidas na engenharia de software, explorando arquitetura de sistemas, inteligência artificial e computação de alta performance em Rust. Experiência acima de ferramentas.

  • ADS
  • Gestão Comercial
  • Pós IA / ML
  • Rust & WGPU
Apoie o projeto

Gostou? Deixe uma estrela no GitHub

É grátis, leva um clique e é o que mais ajuda o Spec Architect a chegar a mais gente.

⭐ Dar estrela no GitHub

☕ Outras formas de apoiar 100% voluntário

O Spec Architect é um projeto livre e independente, feito nas horas vagas. Se ele te ajuda e você quiser apoiar a continuidade, escolha o caminho que preferir. Apoiar não libera nem muda nada: o app é o mesmo para todo mundo.