프로젝트 기억 파일: CLAUDE.md, AGENTS.md, GEMINI.md

이름은 달라도 프로젝트 기억을 담는 방식은 같다

주요 AI CLI는 모두 작업을 시작하기 전에 저장소의 Markdown 파일을 읽어. Claude Code는 CLAUDE.md, Codex는 AGENTS.md, Gemini CLI는 GEMINI.md를 써. 이름만 다를 뿐, 프로젝트와 함께 움직이는 장기 기억이라는 목적은 같아.

대화에 적은 규칙은 세션이 끝나면 사라지지만 파일은 남아. 팀이 TypeScript strict를 쓰고 any를 금지한다는 사실을 매번 다시 말해야 한다면 사실상 규칙이 없는 셈이야. 저장소에 추적되는 문서로 남기면 새 세션, 새 clone, CI 작업도 같은 출발점에서 시작해.

이 파일들은 보통 전역 설정에서 저장소 루트, 더 깊은 하위 디렉터리 순으로 겹쳐 적용돼. 개인 습관은 전역에, 팀의 아키텍처는 루트에, 결제나 인증처럼 특별히 엄격한 규칙은 해당 디렉터리에 둬. 가까운 규칙이 더 구체적인 사정을 덧붙이는 상속 구조라고 보면 돼.

직접 확인할 항목: git clone, ~/.claude/, ~/.codex/, ~/.gemini/.

Code

한 저장소에 놓인 세 가지 문맥 파일·text

myproject/
├── CLAUDE.md          ← Claude Code reads this
├── AGENTS.md          ← Codex CLI reads this
├── GEMINI.md          ← Gemini CLI reads this
├── src/
│   ├── payments/
│   │   ├── CLAUDE.md  ← extra rules just for payments code
│   │   └── ...
│   └── ...
└── ...

# Same content can live in all three (or share most of it)
# — different agents, same project memory.

문맥 파일에는 무엇을 적을까·markdown

# AGENTS.md (or CLAUDE.md / GEMINI.md)

## What this is
TypeScript REST API on Node 22 + Postgres 16. Deployed via Fly.io.

## Standard commands
npm run dev      # localhost:3000, hot reload
npm test         # vitest
npm run db:migrate

## Conventions
- TS strict, no `any` (use `unknown` and narrow)
- All routes have an integration test in tests/
- Error envelope: { data, error, meta }

## Do not
- Commit .env (use direnv)
- Modify schema.prisma without a migration
- Add deps without checking bundle size first

이름은 달라도 프로젝트 기억을 담는 방식은 같다

Code

External links

Exercise

Progress

댓글 0