GEMINI.md (Gemini CLI): onde fica e como as ferramentas o leem

GEMINI.md é o arquivo de contexto que o Gemini CLI envia com cada prompt. Ele também pode ler AGENTS.md ou qualquer outro nome definido em context.fileName.

Onde fica

• Global: ~/.gemini/GEMINI.md.
• GEMINI.md nos diretórios do workspace e nos diretórios ancestrais.
• GEMINI.md encontrado sob demanda nos diretórios acessados pelas ferramentas e em seus ancestrais até uma raiz confiável.

Formato

Markdown sem frontmatter. Inclua outros arquivos com @file.md, por caminho relativo ou absoluto, usando o Memory Import Processor. O nome do arquivo pode ser configurado em context.fileName como uma string ou uma lista.

# Project context

@./docs/architecture.md

## Commands

- Install: `uv sync`
- Test: `uv run pytest`
- Lint: `uv run ruff check .`

## Rules

- Target Python 3.13 with type hints on public functions.
- Keep database code in app/db/.
- Never run migrations against production.

Precedência e combinação

Os arquivos são carregados nesta ordem: global, depois os diretórios do workspace e seus ancestrais e, por fim, os arquivos encontrados sob demanda. Todos são concatenados e enviados com cada prompt, portanto nada é sobrescrito.

Ferramentas que o leem

Dicas

• Defina context.fileName como ["AGENTS.md", "GEMINI.md"] em .gemini/settings.json para compartilhar um arquivo com outros agentes.
• Cada arquivo carregado acompanha todos os prompts, então remova o que o modelo não precisa em todas as interações.
• Use /memory show para ver exatamente o que o Gemini CLI carregou e /memory reload após editar.

Outros arquivos de instruções