# Arquivos de instrução não são um mapa do seu código.

Canonical source: https://maguyva.ai/pt-br/beyond-rules-files

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

CLAUDE.md e AGENTS.md dizem a um agente como se comportar. Não dizem o que tem no código. O Maguyva é a camada que diz, via MCP.

Um arquivo de regras é escrito à mão: não consegue listar cada chamador, import e definição, e fica desatualizado assim que o código muda. O Maguyva indexa o próprio repositório e mantém esse mapa atualizado.

- [Indexe seu primeiro repositório](https://app.maguyva.ai/auth/sign-up?plan=free)
- [Leia a documentação](https://maguyva.ai/pt-br/docs)

plano gratuito: 3 repositórios, Até 50 mil linhas de repositório indexadas, sem cartão.

## Mantenha seus arquivos de regras

*// comportamento*

CLAUDE.md e AGENTS.md continuam fazendo o trabalho deles: convenções, comandos e guardrails.

## Adicione um índice consultável

*// fatos*

Busca semântica, estrutural, de grafo e de texto sobre o código real, via MCP.

## Não é uma foto congelada

*// atualizado*

As reconstruções mantêm o mapa sincronizado com o código, não com a documentação do mês passado.

## Regras para o comportamento. Maguyva para os fatos.

Indexe um repositório que você já conhece e faça uma pergunta que consiga verificar.

01. **Mantenha seus arquivos de regras**: CLAUDE.md e AGENTS.md continuam exatamente como estão. Nada para migrar.
02. **Adicione o Maguyva via MCP**: Indexe um repositório que você conhece, depois conecte Claude, Codex, Cursor, ou qualquer cliente MCP.
03. **Pergunte o que a documentação não responde**: O que chama esta função? O que quebra se eu mudar isso? Perguntas que um arquivo markdown não aguenta.

## Use arquivos de regras para o comportamento. Use o Maguyva para os fatos.

Comece grátis. Adicione a camada de contexto de código que seus arquivos de instrução não conseguem ser. Sem cartão de crédito, sem ligação de vendas.

- [Indexe seu primeiro repositório](https://app.maguyva.ai/auth/sign-up?plan=free)
- [Leia a documentação](https://maguyva.ai/pt-br/docs)