Passo 2 · Fundamentos·Fundamentos · Escreva o contrato do trabalho
Codex com objetivo e prova — do prompt ao runtime · Lição 2/8

Escreva o contrato do trabalho

Goal, Context, Output + boundaries e Finish line formam um contrato pequeno e testável.

Demonstrações debatidas: 20 editor-prompt-tuner · 5 design-system · 16 implementation-plan · apresentação universal

Leia primeiro · fonte local
RESOURCES.md + evidence/proof-results.txt

Fontes sociais viram hipótese; o runtime local decide a configuração.

Ao final, você consegue
  • aplicar a regra ao pedido “adicione isso nas configs”;
  • separar recomendação de fato demonstrado;
  • escolher uma prova no boundary real.
A camada Simples é completa; a Técnica acrescenta precisão.
1

A grande ideia


Um bom prompt dá direção e uma linha de chegada. No exemplo, o resultado não é “melhorar configurações”; é mudar arquivos específicos, preservar segredos e provar que um processo novo carrega tudo.

Pense como… Pense num pedido de obra: você informa o resultado, o terreno, o que não pode ser tocado e a vistoria final. Diferente de uma obra, o contrato aqui pode ser verificado automaticamente em segundos.

Por baixo do capô

O Goal declara outcome; Context aponta as fontes iniciais; Output + boundaries limita artefatos e autoridade; Finish line define checks observáveis. Essa estrutura reduz reconstrução de intenção na revisão.

Goal → Context → Output + limites
01 · Goal conduz a Context; o checkpoint é Output + limites.
2

Atlas visual


Leia cada diagrama como entrada → decisão → checkpoint. As legendas ligam a imagem ao mesmo exemplo.

Context → Output + limites → Finish line
02 · Context conduz a Output + limites; o checkpoint é Finish line.
Output + limites → Finish line → Goal
03 · Output + limites conduz a Finish line; o checkpoint é Goal.
Finish line → Goal → Context
04 · Finish line conduz a Goal; o checkpoint é Context.
Goal → Context → Output + limites
05 · Goal conduz a Context; o checkpoint é Output + limites.
Context → Output + limites → Finish line
06 · Context conduz a Output + limites; o checkpoint é Finish line.
Output + limites → Finish line → Goal
07 · Output + limites conduz a Finish line; o checkpoint é Goal.
Finish line → Goal → Context
08 · Finish line conduz a Goal; o checkpoint é Context.
Goal → Context → Output + limites
09 · Goal conduz a Context; o checkpoint é Output + limites.
Context → Output + limites → Finish line
10 · Context conduz a Output + limites; o checkpoint é Finish line.
Output + limites → Finish line → Goal
11 · Output + limites conduz a Finish line; o checkpoint é Goal.
Finish line → Goal → Context
12 · Finish line conduz a Goal; o checkpoint é Context.
Goal → Context → Output + limites
13 · Goal conduz a Context; o checkpoint é Output + limites.
Context → Output + limites → Finish line
14 · Context conduz a Output + limites; o checkpoint é Finish line.
3

No runtime


Este trecho registra a regra sem expor o arquivo global completo.

Evidência local sanitizada
Goal: configurar fluxo research-first
Context: config.toml, AGENTS.md, anexos
Output: patch reversível; sem credenciais
Finish line: loader estrito + sentinel + reviewer

Acesse você mesmo

Leia PRD.md para requisitos e SCOPE.md#done-when para a linha de chegada mensurável.

4

Comparativos


CampoPergunta
Goalqual resultado existe no fim?
Contextonde começar sem adivinhar?
CampoProteção
Boundariesevita expansão de autoridade
Finish lineimpede conclusão por narrativa
5

Experimente


Decida antes de revelar; depois ajuste o risco, percorra o fluxo e responda aos quizzes.

Predição

Qual campo impede que “funcionou” seja aceito sem evidência?

Finish line: ela nomeia o check que precisa passar.

Flashcards de recuperação

Pergunta
Qual é o exemplo contínuo?
Clique para virar
Resposta
adicione isso nas configs
Pergunta
Qual é a regra de prova?
Clique para virar
Resposta
Boundary real, não alegação.
Pergunta
Qual é o limite?
Clique para virar
Resposta
Finish line
Escolha a opção operacionalmente correta:
A resposta correta segue o runtime e a finish line; as outras antecipam uma conclusão.

Ajuste de risco

4/10

Revisão focada + teste real.

Fluxo por etapas

Etapa 1 de 4: Goal.

Apresentação da lição

Quadro 1/4

Goal

Um bom prompt dá direção e uma linha de chegada. No exemplo, o resultado não é “melhorar configurações”; é mudar arquivos específicos, preservar segredos e provar que um processo novo carrega tudo.

Quadro 2/4

Context

O Goal declara outcome; Context aponta as fontes iniciais; Output + boundaries limita artefatos e autoridade; Finish line define checks observáveis. Essa estrutura reduz reconstrução de intenção na revisão.

Quadro 3/4

Output + limites

Finish line: ela nomeia o check que precisa passar.

Quadro 4/4

Finish line

Leve a regra para o playbook final.

Revisão espaçada
Qual evidência fecha melhor esta lição?
O boundary correto mede o comportamento afirmado; aparência e confiança não substituem execução.
Acertos: 0/1
Pergunte ao seu agente-professor quando um boundary estiver ambíguo. Próxima etapa: Roteie Sol, Terra e Luna pelo trabalho.