/ 2분 / AGENTS · CONTEXT

파일을 쪼갠다고 컨텍스트가 줄지는 않는다

에이전트 규칙을 계층으로 나눴는데 프롬프트는 그대로였다. 줄어든 건 폴더를 옮기고 나서였다.

상시 로드 14파일 69KB → 0

코딩 에이전트에게 주는 규칙 파일이 불어나면 누구나 같은 걸 한다. 하나의 큰 파일을 주제별로 쪼개고, 목차 파일에서 나머지를 참조한다. 정리된 기분이 든다.

문제는 정리된 기분과 줄어든 프롬프트가 별개라는 것이다.

쪼개도 그대로인 이유

Claude Code는 규칙 파일의 @경로 임포트를 세션 시작 시점에 펼친다. 재귀로 몇 단계까지 따라간다. 즉 다섯 개로 쪼개서 목차에서 다섯 개를 임포트하면, 프롬프트에는 다섯 개가 전부 들어간다. 한 파일이었을 때와 같은 양이다.

유지보수는 나아진다. 파일을 찾기 쉽고, 고칠 때 충돌이 적다. 그건 진짜 이득이다. 다만 그건 사람 쪽 이득이고, 모델이 매 요청마다 지불하는 비용은 1바이트도 안 줄었다.

같은 착각이 폴더에도 적용된다. 규칙 폴더 안에 _deprecated/ 같은 하위 폴더를 만들어 안 쓰는 걸 옮겨두면 목록이 깔끔해진다. 그런데 그 폴더가 여전히 규칙 로드 경로 안이면, 안 쓰는 규칙도 매 세션 그대로 올라간다.

실제로 재봤다

내 워크스페이스가 정확히 그 상태였다.

파일크기
활성 규칙7—
폐기 규칙 (rules/_deprecated/)1469KB

폐기한 지 몇 달 된 것들이었다. 이름 앞에 밑줄까지 붙여놨으니 나는 “치웠다”고 생각하고 있었다. 로더는 밑줄을 안 읽는다. 경로만 읽는다.

고친 건 한 줄짜리 작업이다.

# rules/ 안이 아니라 밖으로
mv .claude/rules/_deprecated/* .claude/_archived-rules/

폴더 이름을 바꾼 게 아니라 로드 경로 밖으로 뺐다. 그때 69KB가 사라졌다.

그래서 계층은 무엇으로 나누나

파일 개수가 기준이 아니다. 언제 읽히느냐가 기준이다.

  • 항상 읽히는 층 — 모든 작업에 걸리는 기준. 다른 파일을 안 열고도 그대로 실행 가능해야 한다. 여기 있는 문장은 전부 비용을 매 요청 지불하므로, 요약이 아니라 실행 가능한 지시여야 한다.
  • 조건부로 읽히는 층 — 읽을 트리거가 명확한 상세. 트리거가 없으면 존재만 하고 안 올라간다.
  • 안 읽히는 층 — 폐기물. 로드 경로 밖. 여기 있으면 0바이트다.

세 번째 층이 있다는 걸 계속 잊는다. 폐기 규칙에 폐기 절차만 있고 폐기물을 어디에 두는지가 없으면, 폐기물은 계속 활성 폴더에 쌓인다.

남은 것

지금 규칙에 “1개월 보관 후 삭제”를 적어뒀지만 이것도 사람이 기억해야 도는 규칙이다. 문서로 적은 규칙은 안 지켜진다는 걸 이미 여러 번 겪었으니, 다음은 이걸 기계로 옮기는 쪽이다 — 이동 후 30일 지난 파일을 세션 시작 훅이 세서 알려주게 하는 정도면 충분할 것 같다. 아직 안 만들었다.