-
설정 문서의 평문 비밀 정보 제거
도입부: CLAUDE.md 파일에서 평문으로 노출되어 있던 DB 비밀번호를 발견하고 secrets.env 참조로 정리했다. 사소해 보이는 변경이지만, 팀 공동 문서의 보안 위험을 줄이는 중요한 작업이었다.
읽기 → -
지침 파일 분산 관리를 캐스케이드로 통합
Claude 봇들이 작동할 때 로드되는 지침 파일 CLAUDE.md 를 여러 환경에 걸쳐 관리하면서 문제가 생겼다. Mac 로컬 환경과 서버 환경에서 지침이 따로 존재하다 보니, 공통 규칙을 변경할 때마다 양쪽을 동시에 업데이트해야 했고, 손으로 직접 편집하면서 불일치가 발생할 수 있었다. 이번에 이 문제를 단일진실(single source of truth
읽기 → -
봇 지침 중복 제거로 운영 복잡도 낮추기
여러 봇과 도구가 함께 작동하는 환경에서 각각의 설정 지침을 관리하는 것은 생각보다 복잡하다. 내 경우, 공용 서버에서 동작하는 여러 봇들이 각자의 CLAUDE.md 를 가지고 있었는데, 공통 정책은 항상 중복되고, 어느 것을 수정해야 하는지 불명확했다.
읽기 → -
반복되는 지침을 계층별로 관리하기
telebot 이라는 새 봇을 배포하면서, 해당 봇만의 CLAUDE.md 를 추가하는 작업을 진행했다. 이것만 보면 단순한 문서 파일 생성처럼 보이지만, 사실 이 작업의 핵심은 **지침(프롬프트 정책)을 계층적으로 관리하는 구조를 구현**하는 것이었다.
읽기 → -
봇별 지침 문서화로 운영 일관성 확보
gov-bot이라는 새 서버 봇을 위해 CLAUDE.md 파일을 생성했다. 한 줄짜리 commit처럼 보이지만, 이건 우리 멀티 봇 환경에서 지침 관리를 체계화하는 중요한 스텝이다.
읽기 → -
계층화된 지침 구조로 문서 관리 효율성 높인 일
admin 도구와 관련된 지침을 CLAUDE.md에 추가하면서, 동시에 문서의 계층화 구조를 정리했다. 서버에서 실제 동작을 검증하며 느낀 문서 설계의 중요성을 정리해본다.
읽기 → -
팀 규칙 문서를 계층별로 정리
CLAUDE.md는 우리 팀이 각 프로젝트와 환경에서 따르는 공통 지침이다. 이번 커밋은 작지만, 그 배경에는 "여러 계층의 문서들이 어떻게 연결되어 있는가"를 명시하고 검증하는 의도가 담겨 있었다.
읽기 → -
봇 지침 계층화로 전사 중복 제거
최근 여러 팀과 사이트가 사용하는 AI 봇들의 지침 파일(CLAUDE.md) 관리 구조를 개선했다. 개별 봇이나 사이트마다 전사 공통 규칙을 반복해서 작성하는 비효율을 없애기 위해 캐스케이드 방식의 계층화를 도입한 작업이다.
읽기 → -
프로젝트별 AI 봇 설정을 계층 구조로 정리하기
여러 사이트에 걸쳐 흩어져 있던 CLAUDE.md 파일들을 캐스케이드 구조로 재정렬하고, 서버 환경에서 실제 작동을 검증했다.
읽기 → -
CLAUDE.md 헤더 계층 정리로 문서 가독성 향상
psyquiz 의 CLAUDE.md 파일에서 마크다운 헤더의 계층 구조를 정리했다. 단순한 문서 정리처럼 보이지만, 팀 전체가 의존하는 지침 문서의 구조를 바로잡는 작업이었다.
읽기 → -
팀별 지침을 계층 구조로 정리
여러 프로젝트와 팀이 각각 다른 Claude 지침을 가져야 할 때, 전역 규칙과 프로젝트별 규칙을 어떻게 관리할지가 문제였다. 이번 작업은 CLAUDE.md 파일들을 사이트별 캐스케이드 구조로 재정의해서 싱글 소스 오브 트루스를 확보하고, 동시에 토큰 비용도 최적화했다.
읽기 → -
봇 지침 문서 헤더 체계 통일
pdf2api 프로젝트의 CLAUDE.md 문서 구조를 정리했다. "캐스케이드 헤더"라고 부르는 제목 계층 구조를 보강하고 서버 환경에서 검증했다.
읽기 → -
설정 파일 중복을 계층 구조로 정리하기
여러 사이트를 운영하면서 AI 봇 설정 파일이 자꾸 중복되는 문제가 있었다. 이번에 CLAUDE.md를 사이트별로 계층적으로 관리할 수 있게 개선했다.
읽기 → -
Claude 지침을 사이트별로 계층화
insurance 사이트별 CLAUDE.md를 캐스케이드 구조로 추가했다. 여러 사이트를 운영하면서 전역 지침과 사이트별 지침을 동시에 관리해야 했는데, 단순히 파일을 나누는 것만으로는 충분하지 않았다.
읽기 → -
봇 프롬프트를 계층화해 관리 복잡도 낮추다
mingsblog 사이트에 사이트별 CLAUDE.md 파일을 추가하고 프롬프트 캐스케이드 구조를 정립했다. 작은 변경처럼 보이지만, 멀티 봇·멀티 사이트 환경에서 프롬프트 설정을 체계적으로 관리하기 위한 중요한 구조화 작업이었다.
읽기 → -
서버 봇 지침 분리로 자동화 시스템 단정화
money-bot 전용 CLAUDE.md를 생성하고 서버 환경에서 검증했다. 이 작업은 단순해 보이지만 팀의 자동화 시스템이 성장할 때 꼭 필요한 구조 정리였다.
읽기 → -
지침 문서 헤더 체계화로 팀 가이드 접근성 개선
팀의 공유 지침 문서(CLAUDE.md)를 마크다운 헤더 계층 구조(캐스케이드)로 체계화했다. 겨우 문서 포맷 개선이라고 생각하기 쉽지만, 팀이 커질수록 이런 작은 구조 변경이 얼마나 큰 차이를 만드는지 경험했다.
읽기 → -
팀 공유 지침 문서 헤더 체계화로 가독성 개선
저희 팀은 모든 개발자가 접근할 수 있는 CLAUDE.md 파일들을 관리하고 있다. 이 파일들엔 프로젝트별 개발 규칙, AI 에이전트를 위한 컨텍스트, 코드 리뷰 가이드라인 같은 것들이 담겨 있다. 이번 작업은 이 문서들의 헤더 구조를 체계화해서 찾기 쉽고 이해하기 좋게 만든 것이다.
읽기 → -
AI 지침 문서 계층화로 일관성 강화
최근 games-hub 프로젝트에서 사이트별 설정 문서(CLAUDE.md)의 캐스케이드 구조를 정리하고 서버 환경에서 이를 검증하는 작업을 했다. 한두 개 파일 수정으로 보이지만, 뒤에는 팀 간 협업과 AI 어시스턴트 활용 방식을 표준화하는 꽤 중요한 인프라 개선이 숨어 있었다.
읽기 → -
사이트별 Claude 지침을 계층 구조로 관리하게
여러 사이트/팀에서 같은 money 프로젝트를 쓸 때 Claude Code 지침(CLAUDE.md)을 어떻게 관리할지가 고민이었다. 이번엔 사이트별로 지침을 계층적으로 구조화했다.
읽기 →