AI Parlance
v0.1 é apenas especificação. Parser, validador e transpiladores ainda não foram publicados. Esta documentação define a linguagem; geração de código está planejada.
.aip; transpiladores convertem a spec em implementações concretas.
Humano ou IA
↓
AI Parlance (.aip)
↓
AST + validação
↓
Transpiladores
↓
Go, TypeScript, SQL, OpenAPI, …
Por que existe
Modelos de IA que geram código diretamente em linguagens de propósito geral enfrentam:
- alto volume de boilerplate (CRUD, rotas, validação, migrations)
- inconsistência entre stacks
- contexto grande → mais tokens e mais alucinação
- regras de negócio e permissões espalhadas no código gerado
AI Parlance concentra intenção em uma camada semântica compacta antes da implementação.
O que descreve (e o que não)
| Descreve | Não descreve |
|---|
| entidades, tipos, relações | UI custom |
| CRUD, índices, migrations | algoritmos complexos |
| auth, policies | integrações sem bloco na spec |
| workflows e eventos de domínio | SQL imperativo manual |
Exemplo mínimo
app Demo @0.1 {
database postgres
}
entity User {
name: string required
email: email required unique
}
crud User
app (Especificação).
Uma definição pode alimentar vários geradores (ver matriz de transpiladores).
Princípios AI-first
A linguagem prioriza, nesta ordem:
- intenção e semântica de domínio
- estrutura previsível para LLMs
- validação estática antes da geração
- implementação multi-target via transpiladores
Mapa da documentação
| Página | Conteúdo |
|---|
| Especificação | Gramática, builtins, policies, estabilidade |
| Impacto e custos | Tokens, comparativos honestos |
| Sintaxe | Blocos Core + Infra |
| Banco de dados | Migrations, índices, naming |
| Segurança | Auth, policies, rate limit |
| Workflows | Eventos, jobs, filas |
| Agentes | Prompts, ai_context, boas práticas |
