O que é o SPELL
A filosofia da linguagem, o problema que ela resolve e por que especificações em Markdown não são suficientes.
Seu primeiro arquivo .spell
Crie um arquivo mínimo válido, declare o bloco Projeto e defina sua primeira tabela de dados.
Compilando o projeto
Como usar o spellcomp para gerar arquivos de instrução para agentes de IA a partir de uma spec .spell.
Bloco Dados
Modele tabelas, campos, tipos, modificadores, relacionamentos e índices compostos.
Bloco Regras
Declare regras de negócio que a IA não pode inventar — validações, autorizações e controles de fluxo.
Bloco Endpoints
Descreva rotas, entradas, parâmetros, códigos de resposta e regras aplicadas.
Bloco Telas
Especifique layouts, wireframes e componentes de interface sem saber design.
Bloco Segurança
Declare intenções de segurança em linguagem de negócio — sem jargão técnico.
Bloco Serviços
Especifique tarefas em background, jobs agendados e processos assíncronos.
O arquivo-índice
Entenda o papel do <projeto>.spell, o bloco Projeto e como o compilador descobre os módulos.
Separando padrões do domínio
A divisão entre Padrões de Engenharia e Domínio do Sistema e por que ela existe.
Projetos multi-módulo
Estratégias de organização de arquivos — por módulo, por tipo de bloco ou híbrido.
Bloco Tecnologia
Declare linguagens, frameworks, bancos de dados, hospedagem e provedores de serviço.
Bloco Arquitetura
Padrão arquitetural, organização de pastas, tratamento de erros e logging.
Convenções
ConvencoesD (banco) e ConvencoesC (código) — idioma, capitalização, nomenclatura e API.
Tema visual
Presets de design system, paleta de cores, tipografia e tokens de comportamento.