Quando carregar / Quando pular
- Carregar: tarefas de escopo aberto, sem critérios predefinidos; resultados precisam ser verificados por alguém que não o produtor; necessidade de uma equipe de subagentes com ferramentas.
- Pular: especificação restrita com aceitação fixa (basta executar conforme o plano); tarefas triviais; situações de crunch/pressão de prazo — nesses casos, adicionar metas ambiciosas só aumenta o risco, e a afirmação "compromissos desmoronam sob pressão de prazo" é uma hipótese (a ser testada pelo agente), não um fato empírico.
- Este arquivo aciona apenas padrões, Fast path e contexto permanente da máquina de estados; todo o resto é carregado por nó da máquina de estados (ADR-1/ADR-12).
Fast path (versão de três minutos)
- Primeira ação = compilador de metas: traduz a solicitação em um trio de artefatos (detalhes em chapters/01-goal-compiler.md):
- Invariante: resultado (outcome), não tarefa (ex.: "corrigir crashes" → "manter apps livres de crashes");
- Verificador: estilo CMD falseável (comando + saída esperada), não pode ser texto descritivo nem inventado; itens faltantes devem ser explicitamente nomeados com indicação de onde buscar;
- Manifesto de ambiente: acesso a telemetria/tabela de versões/ambiente de reprodução.
- Qualquer subproduto rebaixado (incluindo metas de aprendizado) deve ser reprocessado por este compilador (ADR-2/ADR-7).
- Camada mínima do juiz = subagente cego em novo contexto: analisa apenas o artefato, não a argumentação do executor. Texto fundamental:
"I implore you to insist on outside validation. Ideally that's a tool the model can run to get feedback immediately." (Tradução: Peço encarecidamente que você insista na validação externa — idealmente uma ferramenta que o modelo possa executar para obter feedback imediato. — Felix Rieseberg, How to be more ambitious; entrada verificada em research/ledger-a.md)
- Dois checkpoints humanos são obrigatórios: confirmação da meta e aceitação final (references/decision-checkpoints.md). Cláusula de agente: quando o executor é um subagente (sem humano no loop), o checkpoint pode ser assinado pelo nível superior da cadeia de delegação (o delegador), com registro no claim record; se não houver ninguém para assinar, registrar como UNVERIFIED + três linhas (QUERY/WHERE/RESULT), sem silenciosamente considerar como verificado.
- Apenas três flags (O-1):
--quick(atalho, sem o fluxo completo, mas o campo verificador permanece obrigatório);--no-crew(pula o nó de tripulação);--judge=ctx-agent|tests|domain|human(especifica o nível do juiz). Regras de combinação: qualquer combinação das três flags é válida.--quick×--judge=:--quickapenas reduz nós do fluxo, não rebaixa o nível especificado por--judge— nos nós remanescentes, o nível especificado é executado normalmente; quando não puder ser executado, as afirmações relacionadas são registradas como UNVERIFIED + três linhas. Em qualquer combinação, o campo verificador (estilo CMD) é obrigatório.--no-crewem tarefas não-range é no-op (sem efeito), não um erro.
A máquina de estados
Fluxo: Compilação → Auditoria de hipóteses → Execução → Julgamento → Falha? Acordo → Verificação de conclusão → Tripulação (apenas para range). Se qualquer nó falhar, consulte primeiro chapters/06-failure-modes.md.
| Nó | Regra (âncora) | Carregar por nó |
|---|---|---|
| Compilação | Trio de artefatos; primeiro fixe a meta difícil, só mude para meta de aprendizado se a pergunta "novo domínio e nenhuma estratégia validada" for verdadeira (ADR-7) | chapters/01-goal-compiler.md; references/goal-setting-rules.md, references/prompt-compiler.md |
| Auditoria de hipóteses | ≤3 hipóteses, cada uma com a refutação mais barata; evidências em nível narrativo completo | chapters/01-goal-compiler.md; references/assumption-audit.md |
| Tom de execução | ADR-10 em camadas: use andaimes na camada de processo/aceitação, espaço em branco na camada narrativa de execução; limite de passos configurável (padrão 5, empírico) | chapters/03-execution-voice.md; references/inner-game-voice.md |
| Suporte de casos | Recupere 1–2 exemplos por gênero; efeito de precedência é combustível, não método; sem campo verificador, não pode entrar no repositório | chapters/05-evidence-cases.md; references/exemplars.md, references/story-calibration.md |
| Julgamento (Judge) | Escada de quatro níveis; tabela tipo de tarefa → nível mínimo; critérios de aprovação do juiz separados da condição de conclusão do executor em parágrafos distintos (O-2); fixtures primeiro (ADR-11) | chapters/02-judge-ladder.md; references/claim-format.md, references/judge-tools.md, references/worked-example.md |
| Falha? Acordo | Atribuição e retreinamento + subetapa de microsucesso, ambos obrigatórios; escala da subetapa configurável (padrão equivalente a 15 minutos, empírico; ADR-8) | chapters/03-execution-voice.md; references/self-efficacy-sources.md |
| Verificação de conclusão (done) | Regime de consumo: cada afirmação encerrada (PASS/FAIL) ou explicitamente UNVERIFIED + três linhas sem registro; sem limite de quantidade (ADR-5) | scripts/check_claims.py; references/claim-format.md |
| Checkpoint humano | Dois obrigatórios: ① confirmação da meta (após compilação, antes da execução) ② aceitação final (após done); subagentes seguem a cláusula de agente (Fast path 4) | references/decision-checkpoints.md |
| Tripulação (crew) | Apenas para range: arquivo de definição do subagente com três campos obrigatórios (ferramentas/dados/aceitação) + orçamento, retry, camada de compartilhamento de artefatos; quatro passos anti-roleplay — "don't write like a short seller, do what a short seller does" (Tradução: Não escreva como se fosse um vendedor a descoberto, faça o que um vendedor a descoberto faz. — Rieseberg; entrada verificada em research/ledger-a.md) | chapters/04-range-crew.md; references/subagent-templates.md |
| Disciplina de citações | Toda SOURCE-URL deve ser rastreável ao cânone; citações devem incluir original + tradução + fonte completa | references/sources.md |
Autoverificação
- Q Cada meta foi compilada no trio <invariante + verificador estilo CMD + manifesto de ambiente>, com o verificador como um comando falseável em vez de texto descritivo?
- Q Cada critério de aprovação do juiz está em parágrafo separado, sem referenciar as afirmações de conclusão do executor, e a tabela já atribuiu o nível mínimo?
- Q Cada afirmação tem registro de cinco campos, um dos três valores de VEREDICTO, e não há entradas não encerradas no momento de done?
- Q Após uma falha, foram realizados tanto a atribuição e retreinamento quanto uma subetapa de microsucesso que sirva à meta original e seja verificável (ambos obrigatórios)?
- Q Cada arquivo de definição de subagente possui os três campos obrigatórios (ferramentas, fonte de dados, aceitação), além de coluna de orçamento e camada de estado de compartilhamento de artefatos?
- Q Cada exemplo citado possui o trio de artefatos, validade, coluna de veredito de três valores, e exemplos lendários vêm com nota de calibração?