2026-11-21 매듭 뒤의 /clear와 토큰 절약

일하는 방식만 다룬 짧은 세션이다. 매듭 · 마무리 뒤에 대화를 비우기로 하고, 토큰이 어디로 가는지 본 뒤 늘 실리는 문서를 줄였다. 코드는 바뀌지 않았다.

논의 흐름

  1. 매듭 뒤 /clear: 메인테이너: “앞으로 매듭짓기가 완료되면 /clear 해주세요. 마무리는 매듭을 포함하므로 역시 마찬가지입니다.” Claude가 clear_session(“self”)으로 비울 수 있음을 확인하고, CLAUDE.md “세션 끝날 때 할 일” 10번과 how-we-work에 적었다.
  2. 에이전트가 끝나야 매듭: 메인테이너: “매듭은 모든 agent가 종료되어야 지을 수 있는 것이지요?” 그렇다: 전체 검사와 push에 그 커밋이 들어가야 하고, 시간 테스트는 혼자 돌 때만 믿고, 비운 뒤에는 보고를 받을 대화가 없다. 규칙에 더했다.
  3. 매듭과 마무리의 차이: 하는 일은 같고 정리한 뒤만 다르다(이어 감 / 닫음, 로컬 서버를 끔). 비운 뒤의 대화는 새 세션으로 치고 세션 기록도 다음 번호로 새로 쓴다. 메인테이너: “네, 새 번호로 해주세요.”
  4. 토큰 절약: 메인테이너: “매듭지으면서 /clear를 생각한 이유는 토큰을 절약하기 위해서입니다.” usage를 보니 그날 토큰의 98%가 캐시 읽기다. 토큰은 맥락의 길이 × 턴 수로 는다. 제안 다섯(늘 실리는 문서 줄이기, 주제가 바뀌면 /clear, 에이전트 · Sonnet, 긴 출력 거르기, 시안은 고칠 곳만)에 메인테이너: “제안이 모두 마음에 듭니다. 즉시 시행해주세요.”
  5. 문서 줄이기: 에이전트가 CLAUDE.md 26.9 → 18.0KB, outbox 23.5 → 9.1KB, status 11.7 → 5.3KB로 줄였다(5bd7010 2eabe73 c7bfcd6). 규칙은 그대로, 까닭 · 날짜 · 인용은 how-we-work로, outbox의 답을 기다리는 항목은 모두 남겼다. 더 줄이는 것(긴 절차를 how-we-work로)은 Claude가 멈추기를 추천했다.

결정

  • 일하는 방식(CLAUDE.md, how-we-work): 매듭 · 마무리는 에이전트가 모두 끝난 뒤에 하고, 마치면 /clear. 비운 뒤는 새 세션 번호. 맥락을 짧게 하는 규칙 한 줄.

발견한 위험

  • outbox를 줄이며 세부를 링크로 돌렸다. 메인테이너가 답할 때 링크를 한 번 더 열어야 할 수 있다.

다음 할 일