Spec Programming & Execution Logic Language — v2.0

O arquiteto
descreve.
A IA implementa.

SPELL é uma linguagem estruturada de especificação de software. O elo formal entre a visão do arquiteto e o trabalho de uma inteligência artificial geradora de código — substituindo o prompt livre por um contrato validado.

Baixar Pacote SPELL spell-package-v2.0.0.zip · v2.0
entidade ◆ regra de negócio ◆ endpoint ◆ tela ◆ segurança ◆ spellcomp compile ◆ instrucoes ◆ recomendar ◆ servico ◆ entidade ◆ regra de negócio ◆ endpoint ◆ tela ◆ segurança ◆ spellcomp compile ◆ instrucoes ◆ recomendar ◆ servico ◆
O Problema

Vibe coding funciona.
Mas só depois que
alguém faz o Vibe Engineering.

— Marcos Fiore

A prática de enviar prompts livres para uma IA e aceitar o código gerado como resultado criou uma geração de projetos frágeis — sem arquitetura, sem consistência, e com débito técnico acumulado desde o primeiro commit.

Quando o arquiteto não define o que o sistema deve fazer com precisão, a IA inventa. Ela infere regras de negócio que não existem, ignora restrições críticas e toma decisões técnicas sem contexto. O resultado parece funcionar — até que não funciona.

O problema não é a IA. O problema é a ausência de uma especificação formal que a discipline.

73%
dos projetos gerados por IA sem especificação formal requerem refatoração significativa em até 60 dias
4×
mais retrabalho em projetos onde as regras de negócio nunca foram documentadas antes da geração de código
0
regras de negócio que a IA consegue inventar com precisão — elas precisam vir do arquiteto, sempre
Sintomas do vibe coding
✕ Regras de negócio implícitas — a IA assume comportamentos que nunca foram discutidos, gerando lógica incorreta que só aparece em produção
✕ Inconsistência entre sessões — cada nova conversa com a IA resulta em código com convenções diferentes, tornando o projeto incoerente ao longo do tempo
✕ Débito técnico estrutural — decisões de arquitetura são tomadas pela IA com base no que é mais comum, não no que é certo para o problema específico
✕ Ausência de contrato formal — sem uma especificação, não há como validar se o código gerado realmente implementa o que o negócio precisa
A Solução

Estrutura antes
de qualquer linha
de código.

SPELL é uma linguagem de especificação — não de programação. O arquiteto descreve o que o sistema deve fazer, usando blocos estruturados que cobrem entidades, regras de negócio, endpoints, telas e serviços.

A IA recebe o arquivo .spell compilado, audita o que foi declarado, lista o que vai inferir, faz perguntas sobre ambiguidades — e só então gera código. A sequência nunca se inverte.

Funciona com qualquer agente de IA: Claude Code, Cursor, Aider, Copilot ou qualquer ferramenta que aceite um arquivo de contexto Markdown. O campo agente: na Stack gera automaticamente o arquivo de entrada no nome correto para cada agente.

"O arquiteto nunca é obrigado a saber mais do que o negócio exige. A IA nunca pode saber mais do que o arquiteto declarou."

meu-projeto.spell
1. Projeto nome: "AgendaFácil" versao: "1.0" descricao: "Sistema para clínicas" 1.1. Stack frontend: React backend: Node.js banco: PostgreSQL agente: claude-code 2.1. Tabela Consulta medico_id: inteiro, obrigatorio paciente_id: inteiro, obrigatorio data_hora: data-hora, obrigatorio status: texto, padrao: "Agendada" 3.1. Regra HorarioDisponivel contexto: Agendamento de consulta condicao: Médico já tem consulta no mesmo horário acao: Recusar com mensagem de horário indisponível // a IA nunca inventa regras de negócio // elas precisam vir de você
Fluxo de Trabalho

Do spec ao código em cinco passos estruturados.

1
Criar o .spell
O arquiteto descreve o sistema em blocos estruturados: entidades, regras de negócio, endpoints, telas e serviços. Sem código, sem detalhes técnicos desnecessários.
meu-projeto.spell
2
Compilar
O compilador spellcomp valida a especificação, detecta inconsistências e gera o arquivo .md otimizado para agentes de IA.
spellcomp compile
3
Resolver Inconsistências
O compilador exibe erros, avisos e inferências. O arquiteto corrige o .spell antes de prosseguir — garantindo que nenhuma ambiguidade chegue à IA.
spellcomp check
4
IA Audita e Pergunta
O agente de IA lê o .md, lista tudo que inferiu e faz perguntas sobre pontos em aberto. O código não começa antes da confirmação do arquiteto.
auditoria + confirmação
5
Gerar Código
Somente após a validação completa, a IA gera o código. Estruturado, consistente e fiel à especificação que o arquiteto aprovou.
código gerado
Por que o SPELL é diferente?

Nenhuma outra ferramenta
faz o que o SPELL faz.

Metodologias de prompt, templates de markdown, frameworks de agentes — nenhum deles é uma linguagem formal compilável. O SPELL é a única abordagem que valida a especificação antes de qualquer IA entrar em cena.

Linguagem formal
Compilador real, não um template
O SPELL tem parser, AST e compilador. Erros de sintaxe, referências mortas e contradições são detectados deterministicamente — offline, sem IA, sem API. Nenhum framework de agentes ou metodologia de prompt faz isso.
Auditoria semântica
A IA vê apenas specs íntegras
Antes de gerar qualquer linha, o compilador detecta endpoints referenciando regras inexistentes, telas navegando para telas que não existem, entidades sem nenhum endpoint que as escreva. A IA nunca recebe uma spec ambígua.
Output fragmentado
Contexto cirúrgico por módulo
O spellcomp gera arquivos separados por bloco: dados, regras, endpoints, telas. O agente carrega só o que é relevante para cada tarefa. Nenhuma ferramenta concorrente fragmenta o contexto dessa forma.
Sem lock-in
Funciona com qualquer agente de IA
Claude Code, Cursor, Aider, Copilot ou qualquer ferramenta que aceite Markdown como contexto. O campo agente: na Stack gera automaticamente o arquivo de entrada no nome correto para cada agente.
Linguagem de negócio
O arquiteto escreve, não o programador
O arquiteto descreve intenção de negócio, não detalhes técnicos. Ele não sabe o que é JWT nem rate limiting — e não precisa. A IA decide o mecanismo. O SPELL define a fronteira entre humano e máquina com precisão cirúrgica.
Skills detection
Compilador detecta o que a IA vai precisar
O spellcomp analisa o AST e identifica automaticamente quais capacidades o agente vai precisar — geração de PDF, planilhas, design de interface, OAuth. Skills declaradas e sugeridas chegam no CLAUDE.md automaticamente.
SPELL vs. outras abordagens
Recurso SPELL Prompt livre Templates .md Frameworks de agente
Validação sintática offline ✓ ✗ ✗ ✗
Auditoria semântica antes da geração ✓ ✗ ✗ parcial
Output fragmentado por módulo ✓ ✗ ✗ ✗
Agnóstico de agente de IA ✓ ✓ ✓ parcial
Não exige conhecimento técnico ✓ parcial parcial ✗
Detecção automática de skills necessárias ✓ ✗ ✗ ✗
Vantagens

Mais precisão.
Menos retrabalho.
Muito menos tokens.

Projetos construídos com SPELL chegam ao agente de IA com contexto cirúrgico, sem ambiguidade e sem espaço para inferência incorreta. O resultado é código que acerta na primeira tentativa — e uma economia dramática no consumo de tokens.

A combinação de especificação formal + output fragmentado + auditoria semântica elimina as principais causas de retrabalho em projetos com IA: regras de negócio inferidas, inconsistências entre sessões e contexto irrelevante consumindo janela.

↓60% tokens economizados
Por que o SPELL economiza tokens?
  • Output fragmentado: a IA carrega só o módulo relevante para cada tarefa, não o projeto inteiro
  • Spec pré-validada elimina rodadas de clarificação — a IA entende de primeira
  • Regras de negócio explícitas: zero inferência, zero correção de comportamento errado
  • Formato estruturado e determinístico: sem ambiguidade, sem retrabalho de interpretação
  • Menos erros → menos rodadas de correção → menos tokens consumidos por feature
  • Auditoria obrigatória filtra perguntas desnecessárias antes da geração
✓ Código consistente entre sessões — a spec é o contrato. Cada nova conversa com a IA parte do mesmo estado, sem drift de convenções ou arquitetura.
✓ Regras de negócio nunca inventadas — o bloco regra captura o conhecimento que só o arquiteto tem. A IA não pode inferir o que não foi declarado.
✓ Erros detectados antes, não depois — o compilador encontra inconsistências antes de qualquer IA ser consultada. O custo de corrigir uma spec é zero comparado ao custo de refatorar código.
✓ Documentação formal como subproduto — o arquivo .spell é a especificação viva do projeto. Novos membros do time entendem o sistema sem ler código.
✓ Manutenção estruturada — precisa mudar uma regra de negócio? Altere o .spell, recompile, gere as instruções atualizadas. Nenhuma sessão de "contexto perdido" com a IA.
✓ Sem lock-in de plataforma — o output é Markdown puro. Mude de Claude Code para Cursor, de Cursor para Aider. A spec é sua, portável, e funciona em qualquer lugar.
✓ Escala com a complexidade — três níveis de detalhe: totalmente especificado, parcialmente especificado ou totalmente delegado à IA. A mesma linguagem serve para um MVP e para um sistema enterprise.
✓ Onboarding acelerado de desenvolvedores — a spec formal substitui reuniões de alinhamento. Novos devs leem o .spell, entendem o negócio, e começam a trabalhar com a IA com o contexto correto.
Instalação e Uso

Pronto para usar
em minutos.

O pacote SPELL inclui o compilador, a especificação completa da linguagem, o manual do arquiteto e exemplos prontos.

1
Baixe e extraia o pacote
Descompacte o arquivo spell-package-v2.0.0.zip em uma pasta de sua escolha.
2
Copie o spell.md para a raiz do projeto
Este arquivo define o contexto da linguagem para o agente de IA. Coloque-o na raiz do repositório junto com seu projeto.spell.
3
Escreva seu arquivo .spell
Use qualquer editor de texto. Consulte o manual incluído no pacote para referência completa de todos os blocos e sintaxe.
4
Compile e valide
Baixar Pacote SPELL
terminal
# Verificar instalação $ spellcomp --version SPELL Compiler v2.0.0 # Validar sem gerar output $ spellcomp check agenda.spell ✅ 0 erros, 0 avisos encontrados. # Compilar e gerar o .md $ spellcomp compile agenda.spell ✅ agenda.spell compilado → agenda/ 📋 8 arquivos │ 4 tabelas │ 2 regras # Ver resumo do arquivo $ spellcomp info agenda.spell
Estrutura do projeto
meu-projeto/
├── meu-projeto.spell ← você edita este
├── meu-projeto.md ← gerado pelo spellcomp
├── spell.md ← incluído no pacote
└── wireframes/
├── login.png
└── dashboard.png

Pare de vibar.
Comece a especificar.

O pacote inclui compilador, manual completo, referência da linguagem e exemplos. Grátis, sem cadastro.

Baixar SPELL v1.0
spell-package-v2.0.0.zip · Manual incluído · Licença de uso livre
Sobre o Autor
Marcos Fiore
Marcos Fiore
Empreendedor serial com mais de 30 anos de experiência em tecnologia, fundou e liderou uma das primeiras plataformas de e-mail marketing e automação de canais digitais do Brasil, construída do zero em 2005 e vendida a um dos maiores players nacionais de Customer Experience em 2022. Hoje comanda um grupo tecnológico através do qual desenvolve múltiplos projetos nas áreas de transformação digital, cloud computing e automação de processos, além de atuar como investidor em negócios de tecnologia. Ao longo da carreira, ajudou mais de 5 mil empresas brasileiras a se comunicarem melhor com seus clientes por meio da tecnologia.

[email protected] →