저장소 컨텍스트를 에이전트에 제공하는 구조 만들기

언제 사용하나

에이전트가 매번 헤매지 않도록 필요한 맥락을 구조적으로 제공할 때.

작성 전 확인

• 에이전트가 자주 묻는 것(구조, 실행법, 규칙)을 파악한다.

구성 방법

프로젝트 루트/
├─ AGENTS.md 또는 CLAUDE.md   # 규칙·명령 (짧게)
├─ docs/architecture.md       # 모듈 경계·데이터 흐름
├─ docs/conventions.md        # 네이밍·에러 처리 규칙
└─ README.md                  # 설치·실행

핵심 원칙:
1. 한 파일에 다 넣지 말고 주제별로 분리한다.
2. 지침 파일은 "무엇을/어디서/무엇을 하지 말지"를 짧게.
3. 자주 바뀌는 세부는 링크로 연결한다.

placeholder 설명

• 프로젝트 상황에 맞게 파일 구성을 조정한다.

입력 예시

백엔드/프런트 모노레포라면 각 패키지에 지침 파일 배치

기대 결과

에이전트가 필요한 맥락을 빠르게 찾아 헤매지 않는다.

검증 방법

새 작업을 시켰을 때 구조/규칙 관련 질문이 줄어드는지 본다.

주의사항과 흔한 실수

• 너무 방대한 컨텍스트는 오히려 품질을 떨어뜨린다(핵심만).
• 오래된 지침은 최신 코드와 어긋나니 주기적으로 갱신한다.

관련 문서

• Claude Code 메모리: https://docs.claude.com/en/docs/claude-code