🧳 A pasta .agents e a vinda do Claude Code

No módulo anterior, a skill da Paula foi salva em .agents/skills/descricao-post/SKILL.md. Esse caminho tem lógica: a pasta .agents guarda as skills, e dentro dela cada skill tem a sua própria pasta.

É o mesmo desenho da pasta .codex que você viu na Trilha 2: .codex guarda configurações, .agents guarda receitas. As duas começam com ponto, e é por isso que às vezes "somem" da vista.

Como ler o desenho: o bloco roxo é a pasta .agents. Repare no padrão: uma pasta por skill, e dentro de cada uma o mesmo arquivo SKILL.md. O olho riscado lembra por que você talvez não a veja de primeira.

Existem dois endereços para skills. Dentro do projeto (.agents/skills/), a skill só vale ali. Na sua pasta de usuário (~/.agents/skills/), ela vale em todos os projetos: é uma skill global.

A pergunta que decide é simples: "eu usaria esta receita em outro projeto?". A skill de promoção da loja é do loja-rui. Já uma skill que revisa ortografia e deixa o texto mais claro serve para qualquer coisa que o Rui escreva: vai para o usuário.

Como ler o desenho: o bloco azul de cima é o usuário, e as linhas tracejadas mostram que as skills dele chegam a todos os projetos. Os blocos roxos de baixo são as skills de cada projeto, que não "vazam" para o vizinho.

Uma skill não precisa carregar tudo dentro do SKILL.md. Ela pode apontar para outros arquivos: um guia de voz, um modelo de proposta, uma planilha, até outra skill. O Codex abre esses arquivos só quando a receita manda.

Isso deixa a receita curta e fácil de manter. Quando a Paula muda o modelo de proposta, ela edita um arquivo só, e a skill passa a usar a versão nova sem ninguém tocar nela.

Como ler o desenho: o centro roxo é a receita, curta. Os quatro cantos são materiais que ela consulta. Mudar um canto não exige reescrever o centro, e o mesmo guia de voz pode servir a várias skills.

---
name: proposta-cliente
description: Use quando eu pedir uma proposta comercial para um cliente de consultoria de RH. Monta a proposta no meu modelo e no meu tom.
---

# Antes de escrever, leia
- O tom de voz em linkedin/guia-de-voz.md
- A estrutura em modelos/modelo-proposta.md
- Os valores em propostas/precos.csv (nunca invente preço)

# Passos
1. Leia a ficha do cliente em clientes/.
2. Preencha o modelo com o problema e a solução do cliente.
3. Use só valores da tabela de preços.
4. Salve em propostas/ com a data no começo do nome.

Muita gente começa em outro agente, como o Claude Code, e depois quer usar o Codex também. A boa notícia: as ideias são as mesmas, só mudam os nomes dos arquivos. Lá existe o CLAUDE.md e a pasta .claude; aqui, o AGENTS.md e as pastas .agents e .codex.

A mudança é como uma mala: você leva as regras, as receitas e as configurações. E o jeito mais simples de fazer a mala é pedir ao próprio Codex: "analise este projeto, que eu montei no Claude Code, e deixe-o pronto para o Codex".

Como ler o desenho: cada caixa amarela da esquerda tem um par roxo à direita, na mesma altura. Regras viram regras, receitas viram receitas, configurações viram configurações. A mala do meio é o pedido que você faz ao Codex.

Este projeto foi montado no Claude Code. Analise o CLAUDE.md, a pasta .claude e o resto da estrutura e deixe tudo pronto para o Codex: crie o AGENTS.md com as mesmas regras (mantenha o CLAUDE.md, os dois podem conviver), copie as skills para .agents/skills/ e me diga quais configurações precisam ser adaptadas para .codex. Primeiro me mostre o plano em forma de lista. Não apague nada.

Repare no que a mudança mostrou: o valor do projeto não estava na ferramenta, estava nos arquivos. Regras, receitas, modelos, histórico. Tudo em texto simples, numa pasta sua.

Isso é liberdade. Se amanhã surgir um agente melhor, a Paula abre a mesma pasta nele e continua de onde parou. Ferramentas vêm e vão; a pasta bem organizada fica.

Como ler o desenho: a pasta roxa é o centro fixo. Os agentes giram em volta e se ligam a ela. O círculo pontilhado de baixo é o agente que ainda nem existe: quando chegar, ele também vai ler a mesma pasta.

Depois de alguns meses, o Rui tinha 23 skills. Algumas ótimas, outras esquecidas, duas fazendo quase a mesma coisa. O Codex começou a escolher a receita errada de vez em quando.

Biblioteca de skills é como a prateleira de temperos: rende quando está etiquetada, sem repetição e sem vidro vazio. Uma faxina a cada mês resolve.

Como ler o desenho: em cima, nomes que não dizem nada, receitas repetidas e uma vazia confundem o Codex. Embaixo, menos potes, todos com nome claro; os roxos são do projeto e os azuis são globais.

O que olhar na tabela: o terceiro hábito é o que mais melhora as escolhas do Codex. Duas skills parecidas fazem ele hesitar.

Liste todas as skills deste projeto e as globais do meu usuário. Para cada uma, diga: o que faz, se o nome é claro, se há outra parecida e se deveria estar no projeto ou no usuário. Termine com uma proposta de faxina (juntar, renomear, mover, apagar). Não altere nada até eu aprovar.