Regras do projeto
AGENTS.md, regras globais, instructions e o /init.
Atualizado em 16 de set. de 2026
Antes de atender qualquer pedido, o agente lê as regras do projeto: um arquivo Markdown na raiz do repositório que explica como o código é organizado, o que ele deve fazer e o que não deve. De tudo o que existe para melhorar as respostas, este é o passo mais barato e o que mais rende.
Crie um AGENTS.md na raiz do repositório. Se já existe um CLAUDE.md, ele também é lido. Um exemplo do que costuma valer a pena escrever:
# Loja
Monorepo: apps/web (Next), apps/api (FastAPI), packages/ui.
## Como trabalhar aqui
- Testes: `pnpm test` na raiz; nunca pule os testes de apps/api.
- Migrações só com `alembic revision --autogenerate`; não edite as geradas.
- Commits em português, no imperativo.
## O que não fazer
- Não instale dependências novas sem perguntar.
- Não toque em apps/legacy: está congelado./init na interface escreve um primeiro AGENTS.md analisando o projeto; revise e commite, porque o arquivo vale para todo mundo que abrir o repositório com o HiNow Code.
~/.config/hinow/AGENTS.md vale em qualquer pasta: seu idioma, seu estilo de commit, suas preferências. As regras do projeto e as globais são somadas.
instructions em hinow.json inclui outros arquivos ou padrões: ["docs/arquitetura.md", "docs/adr/*.md"]. Arquivos grandes custam contexto a cada mensagem; prefira poucos e diretos.
Regras que funcionam
Escreva o que o agente não descobre sozinho lendo o código: comandos de build e teste, convenções, o que está proibido, onde ficam as coisas. Não descreva o óbvio nem cole a documentação inteira.