C.W.K.
Stream
Lesson 03 of 10 · published

GEMINI.md — Context 계층

~14 min · gemini, gemini-md, context-files, hierarchy

Level 0🌱 입문자
0 XP0/70 lessons0/11 achievements
0/120 XP to next level120 XP to go0% complete

같은 아이디어, 이름 셋

GEMINI.md 가 Gemini 한테 CLAUDE.md 가 Claude Code, AGENTS.md 가 Codex 한테인 거. 계층: ~/.gemini/GEMINI.md (user 글로벌) → repo-root GEMINI.md (project) → nested GEMINI.md (서브디렉토리). 파일들 top-down 머지; CWD 에 가까운 게 이김.

Gemini 가 AGENTS.md 도 fallback 으로 read (Codex 호환). 둘 다 있으면 GEMINI.md 이김. 다른 fallback 이름 ~/.gemini/settings.jsoncontextFileName 으로 설정.

Code

GEMINI.md at the repo root·markdown
# 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
Multi-name fallback·json
// ~/.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)

External links

Exercise

진짜 GEMINI.md 작성 (또는 fallback 통해 기존 AGENTS.md 재활용). 5 섹션 포함: what-this-is, setup, standards, important-files, do-not. Gemini 가 로드하는지 verify (활성 context 요약 시켜).

Progress

Progress is local-only — sign in to sync across devices.
이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

댓글 0

🔔 답글 알림 (로그인 필요)
로그인댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.