매주 AGENTS.md / CLAUDE.md 유지보수에 시간을 얼마나 쓰시나요?

30분도 훨씬 안 걸림. 사실 할 일이 그렇게 많지 않아. 더 중요한 건 아주 잘 짜인 린트 규칙, 타입 체크 시스템, 코드 자동 포맷터를 설정하는 거야. 그리고 에이전트가 실수할 때마다 AGENTS.md를 업데이트하게 하면 됨. 너무 많은 내용을 넣으면 에이전트가 과부하 걸리니까 주의해야 해. 난 보통 200줄 이하로 유지하려고 함.

세션 파일이나 AI 메모리 시스템(graphify 같은 거 말하는 건가?)이 정확히 뭘 의미하는지는 잘 모르겠네. 네가 분명히 과대평가하고 있는 것 같아…

파일 700개에 코드 9만 줄, 그리고 또 파일 400개에 12만 줄 정도 됨.

주제에서 좀 벗어나긴 하는데, 코드베이스 탐색이랑 토큰 줄이는 데 도움 되려고 graphify 써봤는데 별로였음. 근데 최근에 https://gortex.dev/ 써보고 있는데, 지금까지는 꽤 괜찮음. AI가 왜 이런 작업이나 변경이 이루어졌는지 정보를 저장하고 불러올 수 있게 해줘서, 코드베이스 변경 이력을 자동으로 관리해 줌. 아직 완벽하다고 말할 만큼 충분히 써보진 않았지만...

너무 걱정 안 해도 됨.

원한다면 매주 에이전트를 설정해서 에이전트 문서랑 코드베이스를 확인하고, 추천 변경 사항으로 PR을 만들게 할 수도 있음.

수정하는 것 자체가 시간을 잡아먹는 게 아니라, 어떤 규칙이 실제로 지켜지고 있고 어떤 게 조용히 무시되는지 파악하는 게 문제임. 우리 쪽은 가차 없이 200줄 미만으로 줄여버렸고, 비율 기반 규칙('3번에 한 번씩 X를 언급해라')을 절대적인 규칙으로 바꿨음. 모델들은 세션 간에 횟수를 세지 못해서 'N번에 1번' 같은 지시는 결국 '내키는 대로'로 변질되거든.

AGENTS.md / CLAUDE.md는 작고 지루하게 유지하는 게 좋음. 실수하는 건 이걸 에이전트가 해석해야 할 제2의 코드베이스로 만드는 거임.

거기에 넣을 만한 것:

• 테스트/타입 체크/린트 실행 방법
• 어기기 쉬운 아키텍처 경계
• 코드에서 바로 알기 어려운 네이밍/임포트 컨벤션
• 에이전트가 이미 겪었던 흔한 실패 유형
• 물어보지 않고 건드리면 안 되는 것

거기에 넣지 말아야 할 것: 긴 제품 문서, 방대한 스타일 가이드, 혹은 모든 하위 시스템에 대한 낡은 설명들...