Configuração e Otimização FinOps do GeminiIgnore

Visão Geral

Uma habilidade para construir, refinar e manter arquivos .geminiignore de alta performance em diversos tech stacks. Ao filtrar código gerado por máquinas, logs pesados, arquivos de bloqueio de pacotes e ativos binários, esta habilidade otimiza a janela de contexto do agente de IA, acelera a velocidade de processamento e reduz os custos de consumo de tokens (FinOps).

Quando Usar Esta Habilidade

• Use ao inicializar um novo repositório ou workspace para programação em par com agentes de IA.
• Use quando a janela de contexto da IA estiver atingindo seus limites ou quando a otimização de faturamento (FinOps) for uma prioridade.
• Use quando o agente de IA estiver lendo acidentalmente saídas de compilação, arquivos de bloqueio, bancos de dados ou mídias binárias.

Como Funciona

Passo 1: Analisar o Tech Stack do Workspace

Detecta as linguagens, frameworks e gerenciadores de dependência presentes no projeto (ex: Node.js, Python, PHP, Dart/Flutter, Rust).

Passo 2: Inicializar ou Atualizar o Arquivo .geminiignore

Cria um arquivo .geminiignore na raiz do workspace ativo. Se um já existir, revise-o para adicionar categorias ausentes.

Passo 3: Implementar as 7 Regras Principais

Adicione regras divididas nas seguintes categorias para filtrar ruídos desnecessários gerados por máquinas, mantendo o código escrito por humanos visível:

1. Ruído do Sistema e Editor: Bloqueia arquivos temporários do SO (.DS_Store, Thumbs.db) e caches de IDE específicos do usuário (.idea/, .vscode/*, dados do usuário do Xcode).
2. Pastas de Dependência e Arquivos de Bloqueio: Ignora diretórios de pacotes de terceiros (node_modules/, vendor/) e arquivos de bloqueio gigantes gerados por máquinas (package-lock.json, yarn.lock, Cargo.lock, composer.lock).
3. Saída de Compilação e Alvo: Bloqueia pastas compiladas (dist/, build/, .next/, .nuxt/).
4. Caches e Metadados de Ferramentas: Bloqueia caches de compilador (.tsbuildinfo, .vite/, .pytest_cache/, .eslintcache).
5. Ativos Binários e Ricos: Bloqueia tipos de mídia (*.png, *.pdf, *.mp4, *.woff2) para evitar acionar tokens caros de visão/multimodal.
6. Bancos de Dados Locais e Logs: Bloqueia arquivos de log (*.log) e dumps de SQL ou bancos de dados SQLite locais (*.sqlite, *.db).
7. Binários Compilados e Builds de Mobile: Bloqueia arquivos de pacote mobile (*.apk, *.ipa) e binários compilados (*.class, *.pyc, *.dll).

Passo 4: Validar Exclusões

Verifica se a IA ainda consegue ver blueprints de configuração críticos (como .env.example, package.json, composer.json, pyproject.toml), mas ignora os arquivos .env reais e artefatos de compilação.

Exemplos

Exemplo 1: Modelo Universal Padrão de .geminiignore

Aqui está uma configuração base recomendada para um projeto multilíngue:

# ==============================================================================
# .geminiignore - BASELINE DE FINOPS E ARQUITETURA
# ==============================================================================

# 1. SISTEMA OPERACIONAL E IDEs
.DS_Store
Thumbs.db
Desktop.ini
$RECYCLE.BIN/
.vscode/*
!.vscode/settings.json
!.vscode/tasks.json
!.vscode/launch.json
.idea/
*.iml
.gradle/
local.properties
.history/

# 2. DEPENDÊNCIAS (ECONOMIA DE TOKENS EM LOCK FILES)
node_modules/
package-lock.json
yarn.lock
pnpm-lock.yaml
vendor/
composer.lock
venv/
.venv/
env/
.env
.env.*
!.env.example
poetry.lock
Cargo.lock
pubspec.lock

# 3. BUILDS E EXPORTAÇÕES
dist/
build/
out/
target/
.next/
.nuxt/
.output/
bin/
obj/

# 4. CACHES DE FRAMEWORKS
.vite/
.parcel-cache/
.eslintcache
.babel-cache/
.tsbuildinfo
.turbo/
.pytest_cache/
.ruff_cache/
storage/framework/
storage/logs/

# 5. ASSETS BINÁRIOS E MULTIMÍDIA EXTREMOS
*.png
*.jpg
*.jpeg
*.gif
*.webp
*.svg
*.ico
*.psd
*.fig
*.pdf
*.zip
*.tar.gz
*.woff
*.woff2
*.ttf

# 6. BANCOS DE DADOS E LOGS
*.log
*.db
*.sqlite
*.sqlite3
*.sql
*.sql.gz

# 7. ARQUIVOS COMPILADOS
*.apk
*.aab
*.ipa
*.jar
*.class
*.pyc
__pycache__/
*.so
*.dylib
*.dll
*.exe
*.js.map
*.css.map

Melhores Práticas

• ✅ Ignorar arquivos de bloqueio de dependências: Arquivos de bloqueio padrão (ex: package-lock.json, yarn.lock) contêm milhares de linhas de árvores de resolução de pacotes redundantes. Ignorá-los é a maior vitória FinOps.
• ✅ Manter configurações visíveis: Garanta que manifestos como package.json, composer.json, Cargo.toml e pyproject.toml NUNCA sejam ignorados, pois a IA precisa deles para entender as dependências.
• ✅ Listar exemplos de configuração: Use regras como !.env.example juntamente com exclusões de .env para que a IA entenda a estrutura de configuração sem expor credenciais.

…