skill to-readme — orientação rápida¶
| Roda em | model/effort |
Dispara quando |
|---|---|---|
| agente-build | inherit / medium |
"atualiza o README", "cria o README de \<app>" |
README de orientação rápida — na raiz do monorepo ou de um app/módulo (apps/*, agents/*): o que é,
stack, como rodar/testar/buildar, estrutura de pastas em alto nível.
A divisão que evita três verdades diferentes¶
| Arquivo | Para quem | Conteúdo |
|---|---|---|
README.md |
humano chegando agora | como rodar, o que é |
CLAUDE.md |
agente | convenção, regra de edição |
docs/wiki/ |
quem quer entender o produto | conhecimento de domínio |
Duplicar entre os três é pior que faltar: quando divergem, ninguém sabe qual está velho. Ela levanta
os fatos do próprio repo (scripts do package.json, estrutura real) em vez de repetir texto antigo.