🗂️ Fundamentos

Cada conversa nova num chat comum começa do zero: você precisa contar de novo quem é e no que trabalha.

Perceber esse custo é o primeiro passo para trocar o chat solto por um lugar fixo de trabalho.

Conversa nova, contexto, reexplicar, memória curta.

No Codex, projeto é a pasta do seu computador que você abre nele. Tudo o que está lá dentro vira contexto.

Se o projeto é uma pasta comum, você já sabe organizá-lo: é como arrumar arquivos no seu computador.

Projeto, pasta, arquivos, contexto.

Escolher a pasta no app (ou rodar codex dentro dela no terminal) e fazer o primeiro pedido ali.

É o gesto que muda tudo: a partir dele o Codex trabalha com os seus arquivos, não só com o que você digita.

Abrir projeto, app desktop, terminal, primeiro pedido.

Separar clientes, propostas, modelos e rascunhos em subpastas com nomes que dizem o que têm dentro.

Pasta bagunçada faz o agente procurar às cegas, gastar mais cota e errar de arquivo.

Subpasta, nome descritivo, estrutura, busca.

Pedir ao Codex que leia a pasta e conte o que já existe e o que ficou pela metade.

Mostra na prática que o contexto mora na pasta e não na sua cabeça.

Resumo, retomada, histórico do projeto.

Abrir a pasta de usuário inteira, misturar trabalhos diferentes na mesma pasta, guardar senha em arquivo solto.

Esses erros deixam o agente lento, confuso ou com acesso a mais do que deveria.

Escopo da pasta, um assunto por projeto, dados sensíveis.

Markdown é texto comum com marcas simples: # para título, - para lista, **negrito**. O .md é a extensão desse tipo de arquivo.

Você vai escrever e ler arquivos .md o curso inteiro: AGENTS.md, SKILL.md e anotações.

Markdown, extensão .md, título, lista.

Em toda conversa nova daquele projeto, o Codex lê o AGENTS.md da raiz antes de olhar o seu pedido.

O que estiver ali ele sabe sempre: é o jeito de parar de repetir as mesmas instruções.

Raiz do projeto, conversa nova, instrução permanente.

As primeiras linhas: quem é você, qual o papel do agente, o tom, o idioma e o que ele nunca deve fazer.

Um papel claro muda a qualidade das respostas mais do que qualquer truque de pedido.

Papel, tom, idioma, limites, pedir antes de apagar.

Uma lista que liga cada necessidade a uma pasta: dados de cliente em clientes/, jeito de escrever em linkedin/estilo.md.

Com o mapa, o agente vai direto ao arquivo certo em vez de vasculhar a pasta inteira.

Mapa de rotas, caminho de pasta, busca dirigida.

O projeto da Paula tem um AGENTS.md; o da loja do Rui tem outro, com regras e rotas próprias.

Regras de um trabalho não devem vazar para outro: cada pasta fala do seu assunto.

Um arquivo por projeto, regras específicas, separação.

Quando você corrige o agente duas vezes pela mesma coisa, a correção vira uma linha nova no AGENTS.md.

O arquivo cresce com o uso e o agente erra menos a cada semana.

Revisão, correção recorrente, rascunho feito pelo Codex.

Harness é o programa que dá ao modelo de IA ferramentas (ler arquivo, rodar comando, navegar) e um ciclo de trabalho. O Codex é um harness.

Separar modelo de harness explica por que o mesmo modelo faz muito mais no Codex do que num chat.

Harness, modelo, ferramenta, agente.

O agente pensa, escolhe uma ferramenta, olha o resultado, pensa de novo e só responde quando terminou.

Entender o ciclo ajuda a escrever pedidos que ele consegue cumprir sem travar.

Ciclo do agente, ferramenta, resultado, iteração.

Depois da resposta aparece quanto tempo ele trabalhou; abrindo, você vê o raciocínio resumido e cada comando rodado.

O registro é a sua janela para conferir o que o agente fez de verdade.

Registro, raciocínio resumido, comandos, transparência.

Observar a ordem em que ele abre arquivos e onde ele procura demais.

O que ele procura e não acha mostra o que falta na sua pasta ou no AGENTS.md.

Observação, ordem de leitura, lacunas do projeto.

Regras (AGENTS.md) dizem como trabalhar; memórias guardam fatos lembrados, como "a Paula prefere propostas em 1 página".

Saber onde cada coisa mora evita colocar fato solto nas regras ou regra perdida na memória.

Regra, memória, fato, preferência.

Um pedido que exige buscar dados, como listar os itens com menos de 10 unidades no estoque.csv, acompanhado passo a passo.

Ver o ciclo acontecer num caso real fixa a ideia melhor do que qualquer explicação.

Pedido com dados, CSV, acompanhamento, conferência.

Com /goal o agente persegue o objetivo: tenta, encontra obstáculo, muda de caminho e só para quando atinge ou você interrompe.

É a diferença entre um pedido de uma resposta e um trabalho entregue do começo ao fim.

/goal, objetivo, persistência, interrupção.

Um objetivo com critério concreto, como "relatório de 2 páginas com 30 fontes" ou "18 cartões conferidos em captura de tela".

Quando dá para conferir, o agente sabe quando terminou e você sabe se ficou bom.

Critério de pronto, verificação, captura de tela.

Objetivo do tipo "até ficar satisfeito" funciona, mas o próprio agente decide quando acabou.

Escrever critérios, mesmo simples, evita surpresa no resultado.

Subjetivo, critério, expectativa.

Escolher um objetivo pequeno e verificável no seu projeto e rodar o /goal do começo ao fim.

O primeiro objetivo pequeno mostra o comportamento do agente antes de você confiar em um grande.

Primeiro objetivo, escopo pequeno, acompanhamento.

Dizer o que ele pode e o que não pode fazer, e deixar o agente trabalhar sem microgerenciar.

Os modelos atuais rendem mais com objetivo claro e espaço; controle vem dos limites, não da interferência.

Limites, autonomia, microgerenciamento.

Tarefas arriscadas (dinheiro, apagar arquivos, e-mail a cliente), objetivo vago ou sem jeito de conferir.

Um agente persistente num objetivo errado faz estrago com a mesma persistência.

Risco, ação irreversível, objetivo vago.