Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.aiparlance.org/llms.txt

Use this file to discover all available pages before exploring further.

​
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.
AI Parlance é uma linguagem AI-first para representação intermediária (IR) na geração de software assistida por IA — focada em aplicações orientadas a dados, API, autorização e automações declarativas. Humanos, agentes e LLMs descrevem sistemas em .aip; transpiladores convertem a spec em implementações concretas. 
Humano ou IA
↓
AI Parlance (.aip)
↓
AST + validação
↓
Transpiladores
↓
Go, TypeScript, SQL, OpenAPI, …
Detalhes normativos: Especificação.

​
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)

DescreveNão descreve
entidades, tipos, relaçõesUI custom
CRUD, índices, migrationsalgoritmos complexos
auth, policiesintegrações sem bloco na spec
workflows e eventos de domínioSQL imperativo manual

​
Exemplo mínimo

app Demo @0.1 {
  database postgres
}

entity User {
  name: string required
  email: email required unique
}

crud User
Ver examples/minimal.aip. Toda spec v0.1 exige um bloco app (Especificação). Uma definição pode alimentar vários geradores (ver matriz de transpiladores).

​
Princípios AI-first

A linguagem prioriza, nesta ordem:
  1. intenção e semântica de domínio
  2. estrutura previsível para LLMs
  3. validação estática antes da geração
  4. implementação multi-target via transpiladores

​
Mapa da documentação

PáginaConteúdo
EspecificaçãoGramática, builtins, policies, estabilidade
Impacto e custosTokens, comparativos honestos
SintaxeBlocos Core + Infra
Banco de dadosMigrations, índices, naming
SegurançaAuth, policies, rate limit
WorkflowsEventos, jobs, filas
AgentesPrompts, ai_context, boas práticas
Spec de referência: examples/crm-reference.aip.