​

Agentes e prompts

​

Como a IA deve escrever .aip

1. Estrutura previsível: app → entity → crud → policy → workflow
2. Nomes claros; um idioma consistente por arquivo
3. Semântica explícita (required, belongs_to, predicados)
4. Evitar lógica imperativa longa em workflow
5. Não repetir auth no bloco api se já estiver definido em app

​

Prompt mínimo → saída

app CRM @0.1 {
  database postgres
  auth jwt
}

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

entity Lead {
  name: string required
  phone: phone required
}

entity Task {
  title: string required
  lead: belongs_to Lead optional
}

crud User
crud Lead
crud Task

​

Estratégia de prompting

Domínio: [descrição]
Entidades: [campos]
Regras: [validação, duplicidade, atribuição]
Acesso: [papéis / dono do recurso]
Eventos: [o que dispara automação]

​

ai_context

ai_context Lead {
  description "
    Leads do site institucional.
    Não permitir duplicidade por telefone normalizado.
    Atribuir ao primeiro seller disponível.
  "
}

​

Gramática controlada

​

Fluxo agente → software

Prompt → LLM → .aip → Validador → AST → Transpiladores → artefatos

​

Checklist antes de entregar

• um bloco app com database (e auth se usar authenticated / role)
• toda entity referenciada existe
• policies owner_* apontam para FK real
• workflow tem when
• emit usa event declarado
• ordem canônica de modificadores
• @0.1 em app ao usar blocos beta

​

Referência completa