~14 min · gemini, gemini-md, context-files, hierarchy
사용자 전역 ~/.gemini/GEMINI.md, 저장소 루트, 더 깊은 하위 디렉터리의 문서를 차례로 합쳐 읽어. 작업 위치에 가까운 문서가 충돌할 때 우선하므로 개인 습관과 팀 규칙, 특정 영역의 제약을 한 계층으로 나눌 수 있어.
Gemini는 AGENTS.md도 대체 이름으로 읽을 수 있고, contextFileName에서 다른 기존 문서 이름을 지정할 수도 있어. Codex와 Gemini를 함께 쓰는 팀이라면 AGENTS.md 하나를 기준으로 삼아 두 사본이 갈라지는 일을 피하는 편이 실용적이야.
직접 확인할 항목: GEMINI.md, ~/.gemini/settings.json.
# myproject — GEMINI.md
## What this is
Python data pipeline (Pandas + DuckDB) with a FastAPI surface.
## Setup
poetry install
docker-compose up -d duckdb
poetry run uvicorn app.main:app --reload --port 8000
## Standards
- Python 3.12, type hints everywhere
- Tests use pytest, pytest-asyncio
- Use src/lib/logger.py, never print()
- Schema migrations via Alembic; no raw ALTER
## Do not
- Modify alembic/versions/* (only generate via revision)
- Commit .env (use direnv)
- Use synchronous I/O in API handlers// ~/.gemini/settings.json
{
"contextFileName": ["GEMINI.md", "AGENTS.md", "AI_GUIDE.md"],
"contextFileMaxBytes": 65536
}
// Gemini will check each name in order:
// 1. GEMINI.md (preferred)
// 2. AGENTS.md (Codex compat)
// 3. AI_GUIDE.md (your team's existing name)아직 댓글이 없어요. 첫 댓글을 남겨보세요.