Para agents

Como ler

/llms.txt: índice no formato llmstxt.org, com título e descrição de cada página.
/llms-full.txt: toda a documentação em texto puro, na ordem de tutorial.
Qualquer página em Markdown cru: acrescente .md à URL (por exemplo /comecar/token.md). Cada página HTML aponta para sua versão com <link rel="alternate" type="text/markdown">.
Sem cookies e sem JavaScript obrigatório: um GET simples lê tudo.

Contrato de App Nebular: o documento para mandar a um agent que vai adequar um app à Nebular; regras normativas (porta, disco somente leitura, config, banco) e tabela de erros de deploy com culpa e correção.
Deploy de aplicações com vários serviços: front, API, worker e bancos no mesmo projeto, com referências, deploy em grupo, rollback, erros e o que ainda não existe (manifesto, réplicas).
Como corrigir cada erro de deploy: cookbook com uma seção por error_code (âncora estável), o que cada erro significa, como corrigir e de quem é a culpa; inclui migrar SQLite local para libSQL gerenciado.
Preparar o app para rodar e escalar: use antes do primeiro deploy; cobre 0.0.0.0:$PORT, app sem estado, health check, SIGTERM, volumes e migrations.
Variáveis e referências: use ao configurar ambiente; explica as variáveis automáticas e as referências ${{serviço.VAR}}.
Conexão e referências de banco: use ao ligar app e banco; o banco não é injetado sozinho, a ligação é um passo explícito resolvido no deploy.
Sugestões de persistência: quando um app precisa de volume ou banco, a plataforma detecta e sugere criar; leia e descarte sugestões pela API, sempre com autorização.

Autentique com Authorization: Bearer $NEBULAR_TOKEN, lendo o token do ambiente.
Use Idempotency-Key em todo envio automatizado.
Decida pelo campo error e siga a tabela de erros.
Trate páginas “em construção — disponível na v13” como recursos inexistentes: não invente rotas.