Comandos do Codex e o AGENTS.md do projeto

Perguntas frequentes

O que é o AGENTS.md de um projeto?

É o manual operacional do projeto: um arquivo de texto comum, criado na pasta do projeto, que o Codex lê sozinho quando inicia. O que estiver escrito ali vale como instrução permanente, sem precisar repetir nada a cada conversa. Seis seções dão conta: arquitetura (as partes e como elas conversam), comandos de teste (o que digitar para verificar), padrões da casa (como nomear, em que idioma comentar), limites (o que não pode ser tocado), estrutura de pastas (onde nasce cada arquivo novo) e critérios de conclusão (o que faz "pronto" virar fato verificável). Markdown é opcional: português corrente funciona, e dez linhas já mudam o resultado.

Quais comandos do Codex realmente importam?

Seis, e nenhum deles se decora — a grafia exata aparece na própria tela. Comando começa com barra, e a barra avisa que aquilo é ordem para o programa, não conversa com a inteligência artificial: mesma lógica da barra no WhatsApp ou no Slack. Há o de ajuda (a lista de comandos), o de status (modelo, permissão, pasta e conta da sessão), o de modelo (que escolhe quem responde e quanto esforço de raciocínio ele gasta), o de permissões, o de revisão (ele relê as próprias alterações e procura problemas) e o que mostra os servidores conectados à sessão.

É seguro rodar o Codex num projeto baixado da internet?

Só depois de ler o que veio dentro dele. Configuração local de projeto vale apenas em repositório confiável, e o motivo é direto: quando você baixa o projeto de outra pessoa, os arquivos de instrução vêm junto — inclusive o AGENTS.md, que pode trazer instrução escrita por um desconhecido e que o Codex vai ler como se fosse sua. É assinar contrato sem ler porque o envelope era bonito. São arquivos de texto: abrir e ler leva um minuto, e esse minuto é a diferença entre usar o projeto de alguém e obedecer a ele. Vale a mesma cautela do nível de permissão, que começa restritivo e só afrouxa depois.