Aprendizado do Construtor — ciclo de 6 estágios

Esta página descreve o código de hoje: ciclo de 6 estágios + harness do Construtor (biblioteca por tools, ops, to-do ao vivo, lock da Estrutura, política no servidor, duas vias) — issues 01–08 implementadas (agent.js, agent-ops.js, agent-policy.js, agent-tools.js, agent-job.js, agent-intents.js, agent-distill.js, agent-ledger.js). O que ficou fora está marcado como pendente nos blocos «Hoje vs escopo». Specs: perfil em .scratch/ai-aprendizado-ciclo/spec.md; harness em spec-harness.md. Manutenção: app/docs/AI_AGENTE.md + AI_CONSTRUTOR.md + AI_APRENDIZADO.md.

promessa

Fontes do Construtor — e o que ensina o livro de aprendizado

O Construtor não se limita ao chat. No turno ele consulta uma biblioteca (índice no prompt, corpo por ferramenta) — isso é injeção, não o livro:

A saída do turno mutate são ops (o servidor aplica + valida e ainda devolve surveyJson ao Studio) — não um schema completo redigitado. O aceite (botão Salvar) é o que entra no ciclo de aprendizado (via rápida imediata; via lenta em lote). Rascunho não ensina.

Autosave (skipVersion: true) grava rascunho e não vira aceite. Só o botão Salvar (note: studio_json) gera versão e linha kind: accepted.

nao-e

Expectativa vs realidade

Não é (nem no escopo)Hoje (código)Pendente
Classificador lê JSON de cada survey_versions Lê ledger accepted (diff de nomes + áreas) + brutos da via rápida (ops do agente, correção) Diff do aceite com codes do schema (types, visibleIf, settings codes)
Cada mensagem vira regra Só Salvar explícito —
Construtor consulta /docs/ai-construtor via HTTP Sys = proibições + runtime + índice de tools + envelope + orçamento; user = skeleton + digest do livro (≤4 linhas) + pedido; corpo do livro por chapter, schema por element/page —
Saída = schema completo (modelo copista) Ops por name; servidor aplica + política + verify; Studio recebe out.surveyJson. Schema inteiro só com createSurvey / 0 perguntas / rascunho —
Três agentes conversam entre si em tempo real Um chat (loop com tools; mutate vira job agent_turn) + um job agent_distill com dois passos (classificador → Aprendizado); via rápida no Salvar sem LLM; três sinais Memória de chat como estante (turns) e ações com confirmação (clone/restore/status/pasta)
Restore automático Só humano (chip vN) Continua humano

workflow

Ciclo — clique no estágio ou no chip do documento

Fluxo cíclico, não linear. Clique no estágio para Objetivos, Detalhamento, Como processa, ver prompt (agentes IA), Exemplo, Lê/Gera e o bloco insumo to-spec; no chip do documento para a estrutura (popover). Glossário abre os nomes canônicos. Passe o mouse ou foque um estágio para o resumo do ciclo. Agrupado por ator: usuário, sistema, agentes IA.