서버 봇 지침 분리로 자동화 시스템 단정화

money-bot 전용 CLAUDE.md를 생성하고 서버 환경에서 검증했다. 이 작업은 단순해 보이지만 팀의 자동화 시스템이 성장할 때 꼭 필요한 구조 정리였다.

봇이 많아질수록 지침도 분산되어야 한다

처음엔 global CLAUDE.md 하나로 모든 봇의 공통 규칙(날짜 기준, 출력 형식, 토큰 비용 주의 등)을 관리했다. 이는 작을 때는 괜찮지만 봇이 10개, 20개로 늘어나면 문제가 생긴다.

global 지침이 비대해지면:
- 매 봇 호출마다 불필요한 토큰을 소비한다 (지침을 매번 읽어야 하니까)
- 전체 규칙 속에 봇별 특수 사항이 묻힌다
- 수정할 때 영향 범위를 파악하기 어렵다

money-bot처럼 특정 도메인(금융/자동화)의 봇이 나올 때는 그 봇 디렉토리 안에만 적용되는 지침을 따로 둬야 한다. 예를 들어 money-bot은 금액 포맷, 거래 기록 출력 방식, 감사 로그 규칙 같은 봇별 요구사항이 있을 텐데, 이것들이 global 지침에 섞여 있으면 다른 봇(예: 문서 생성 봇)이 로드할 때 관련 없는 규칙까지 읽게 된다.

서버 검증이 신뢰도를 만든다

지침 파일을 생성하는 것만으로는 충분하지 않다. "이 파일이 실제 서버에서 로드되나?"를 확인해야 한다.

money-bot이 실제로 서버에서 돌아갈 때 지침이 제대로 적용되는지 테스트한 것이 "서버검증" 단계다. 이를 통해:
- 파일 경로가 올바른지 (서버 파일시스템 상에서 접근 가능한가)
- 형식이 올바른지 (파이썬의 로더, 자바스크립트, 또는 각 언어별 파서가 제대로 읽는가)
- 지침이 실제 봇 동작에 반영되는지

를 확인할 수 있다. 이전에 작성한 global CLAUDE.md 주석에 "loose 직접편집 금지"라고 명시했듯이, 우리는 지침 관리에 신중하다. 서버검증은 그 신중함을 실제로 실행하는 단계다.

일관성을 유지하면서 확장한다

money-bot CLAUDE.md를 생성할 때 중요한 건 기존 패턴을 따르는 것이었다. global 지침에 이미 정의된 원칙들—단일진실 개념, git-ops 기반 관리, 토큰 비용 관심—을 봇별 지침에도 적용했을 것이다.

이렇게 하면 팀이 커져도 새로운 엔지니어가 금방 따라갈 수 있다. "아, 저 봇도 CLAUDE.md가 있겠네"라고 예상하고 찾을 수 있기 때문이다. 또한 향후 money-bot과 비슷한 다른 금융 자동화 봇이 나올 때도 money-bot의 구조를 참고해서 빠르게 세팅할 수 있다.

회고: 구조화의 작은 승리

이건 한두 줄의 커밋처럼 보이지만 실제론 자동화 팀의 체계가 한 단계 성숙해진 것 같다. 봇이 많아질수록 지침도 분산되어야 하고, 그 분산이 일관된 구조 속에서 일어나야 한다는 걸 명시한 거니까. 서버 검증을 통해 "정말 동작하는구나"를 확인했을 때 그 신뢰감이 있었다.

앞으로 money-bot이 운영되면서 지침이 보완되거나 변경될 때도, 이 기초 구조가 있으면 수정이 깔끔할 것 같다.

🛒 이 글과 어울리는 추천 상품

• 모니터 쿠팡에서 보기 →
• 외장SSD 쿠팡에서 보기 →
• 기계식키보드 쿠팡에서 보기 →

*위 링크는 쿠팡파트너스 활동의 일환이며, 일정액의 수수료를 제공받을 수 있습니다.