에이전트에 제공하는 컨텍스트를 최소화하기

언제 사용하나

불필요한 파일까지 물려 품질·비용이 나빠질 때 맥락을 정예화할 때.

작성 전 확인

• 이 작업에 정말 필요한 파일/문서만 골라낸다.

최소화 원칙

1. 작업 범위에 직접 관련된 파일만 제공한다.
2. 방대한 자동 생성 파일/빌드 산출물은 제외한다.
3. 규칙은 짧은 지침 파일로, 세부는 링크로 연결한다.
4. 긴 로그·데이터는 핵심 부분만 발췌해 제공한다.
5. 무관한 히스토리를 매번 끌고 오지 않는다.

placeholder 설명

• 작업 성격에 따라 포함 범위를 조정한다.

입력 예시

버그 수정 시: 해당 모듈 + 실패 테스트 + 관련 규칙만 제공

기대 결과

집중된 맥락으로 더 정확하고 빠른 결과를 얻는다.

검증 방법

컨텍스트를 줄였을 때 결과 품질이 유지·향상되는지 비교한다.

주의사항과 흔한 실수

• "많이 넣을수록 좋다"는 오해로 노이즈를 키우지 않는다.
• 꼭 필요한 규칙 파일까지 빼면 규칙을 어길 수 있다.

관련 문서

• Claude Code 문서: https://docs.claude.com/en/docs/claude-code