일기
회고 / 메모
-
프로젝트별 AI 봇 설정을 계층 구조로 정리하기
여러 사이트에 걸쳐 흩어져 있던 CLAUDE.md 파일들을 캐스케이드 구조로 재정렬하고, 서버 환경에서 실제 작동을 검증했다.
읽기 → -
CLAUDE.md 헤더 계층 정리로 문서 가독성 향상
psyquiz 의 CLAUDE.md 파일에서 마크다운 헤더의 계층 구조를 정리했다. 단순한 문서 정리처럼 보이지만, 팀 전체가 의존하는 지침 문서의 구조를 바로잡는 작업이었다.
읽기 → -
팀별 지침을 계층 구조로 정리
여러 프로젝트와 팀이 각각 다른 Claude 지침을 가져야 할 때, 전역 규칙과 프로젝트별 규칙을 어떻게 관리할지가 문제였다. 이번 작업은 CLAUDE.md 파일들을 사이트별 캐스케이드 구조로 재정의해서 싱글 소스 오브 트루스를 확보하고, 동시에 토큰 비용도 최적화했다.
읽기 → -
봇 지침 문서 헤더 체계 통일
pdf2api 프로젝트의 CLAUDE.md 문서 구조를 정리했다. "캐스케이드 헤더"라고 부르는 제목 계층 구조를 보강하고 서버 환경에서 검증했다.
읽기 → -
설정 파일 중복을 계층 구조로 정리하기
여러 사이트를 운영하면서 AI 봇 설정 파일이 자꾸 중복되는 문제가 있었다. 이번에 CLAUDE.md를 사이트별로 계층적으로 관리할 수 있게 개선했다.
읽기 → -
Claude 지침을 사이트별로 계층화
insurance 사이트별 CLAUDE.md를 캐스케이드 구조로 추가했다. 여러 사이트를 운영하면서 전역 지침과 사이트별 지침을 동시에 관리해야 했는데, 단순히 파일을 나누는 것만으로는 충분하지 않았다.
읽기 → -
지침 문서 헤더 체계화로 팀 가이드 접근성 개선
팀의 공유 지침 문서(CLAUDE.md)를 마크다운 헤더 계층 구조(캐스케이드)로 체계화했다. 겨우 문서 포맷 개선이라고 생각하기 쉽지만, 팀이 커질수록 이런 작은 구조 변경이 얼마나 큰 차이를 만드는지 경험했다.
읽기 → -
팀 공유 지침 문서 헤더 체계화로 가독성 개선
저희 팀은 모든 개발자가 접근할 수 있는 CLAUDE.md 파일들을 관리하고 있다. 이 파일들엔 프로젝트별 개발 규칙, AI 에이전트를 위한 컨텍스트, 코드 리뷰 가이드라인 같은 것들이 담겨 있다. 이번 작업은 이 문서들의 헤더 구조를 체계화해서 찾기 쉽고 이해하기 좋게 만든 것이다.
읽기 → -
AI 지침 문서 계층화로 일관성 강화
최근 games-hub 프로젝트에서 사이트별 설정 문서(CLAUDE.md)의 캐스케이드 구조를 정리하고 서버 환경에서 이를 검증하는 작업을 했다. 한두 개 파일 수정으로 보이지만, 뒤에는 팀 간 협업과 AI 어시스턴트 활용 방식을 표준화하는 꽤 중요한 인프라 개선이 숨어 있었다.
읽기 → -
사이트별 Claude 지침을 계층 구조로 관리하게
여러 사이트/팀에서 같은 money 프로젝트를 쓸 때 Claude Code 지침(CLAUDE.md)을 어떻게 관리할지가 고민이었다. 이번엔 사이트별로 지침을 계층적으로 구조화했다.
읽기 → -
팀 지침 문서 계층 구조 명확화
한 사이드 프로젝트의 CLAUDE.md 파일에서 마크다운 헤더 구조를 개선하고 서버에서 검증한 작업을 했다. 간단한 문서 수정처럼 보이지만, 팀 규모가 커질수록 이런 세부사항이 모여 지침 일관성을 결정한다는 생각이 들었다.
읽기 → -
AI 프롬프트 규칙을 계층화 구조로 관리하기
ssulbox 환경에서 여러 사이트를 동시에 관리하면서 마주한 문제가 있었다. 각 사이트마다 특수한 AI 봇 지침(CLAUDE.md)이 필요한데, 모든 사이트가 지켜야 할 '공통 기본 규칙'도 있었다는 것. 이 둘을 어떻게 효율적으로 관리할지 고민하다가 CLAUDE.md 를 계층화 구조(캐스케이드)로 정리했다.
읽기 → -
공통 설정 한 번에 관리하는 계층 구조 도입
namecert 사이트에 CLAUDE.md의 캐스케이드 설정을 추가했다. 간단한 문서화 작업처럼 보이지만, 실은 여러 사이트를 운영하는 팀이라면 반복하게 될 설정 관리 문제를 정면으로 푼 것이다.
읽기 → -
봇 설정을 효율적으로 관리하다
팀의 프로젝트와 사이트가 늘어나면서 봇 설정 문서(CLAUDE.md)도 함께 증가했다. 처음엔 각 사이트가 독립적이라 괜찮았지만, 시간이 지나니 문제가 보였다. 공통으로 적용할 규칙들이 여러 파일에 중복되고, 한곳을 수정하면 다른 곳도 일일이 찾아 고쳐야 했다. 특히 팀이 커지면서 "이 설정이 어디까지 반영됐지?", "누가 서버에서 git pull 했나?"
읽기 → -
사이트별 개발자 지침을 계층화해 중복 제거
모든 claude 호출마다 CLAUDE.md가 로드되는 구조에서, 여러 사이트가 공통 지침을 반복으로 담고 있었다. 이번에 계층화된 cascade 방식을 도입해 토큰 낭비를 줄이고 유지보수를 개선했다.
읽기 → -
조직 전체 AI 도구 지침, 계층적으로 통일
여러 프로젝트와 사이트에 걸쳐 개발자 도구 설정 문서(CLAUDE.md)를 계층적으로 관리하는 구조를 추가했다. 전역 지침에서 시작해서 각 사이트별, 프로젝트별로 오버라이드되는 캐스케이드 방식인데, 이제 서버 환경에서도 이 구조가 제대로 로드되는지 검증했다.
읽기 → -
Claude 지침 계층 구조로 설정 관리 일관성 확보
여러 프로젝트와 환경에서 Claude Code를 쓰다 보니, 각 곳의 CLAUDE.md 지침이 서로 다르거나 중복되는 문제를 마주쳤다. 어떤 프로젝트는 최신 규칙을 따르고, 어떤 곳은 낡은 버전을 유지하고 있었고, 이번에 그 혼란을 정리하기 위해 "캐스케이드" 구조를 문서로 명시했다.
읽기 → -
팀 수칙을 계층적으로 관리하는 캐스케이드 구조 개선
여러 프로젝트와 서버 환경에서 팀의 개발 수칙을 일관성 있게 유지하기 위해 CLAUDE.md 캐스케이드 구조를 정리했다. 지금까지는 각 프로젝트나 디렉토리마다 수칙을 따로 관리했을 텐데, 이번 작업은 전사 수칙 → 사이트별 수칙 → 프로젝트별 수칙으로 계층적으로 상속·우선순위를 지정하는 체계를 명문화한 것이다.
읽기 → -
설정 캐스케이드 구조 명시화
여러 팀이 각각 다른 Claude 설정을 쓰게 되면서, 공통 규칙과 팀별 규칙 사이의 우선순위가 애매해지는 문제에 직면했다. 누가 global CLAUDE.md를 수정하면 모든 팀에 영향이 갈 텐데, 각 팀은 자기 사이트/프로젝트만의 규칙도 필요했다. 결국 "어느 설정이 우선인가" 하는 질문이 반복됐고, 새 팀원들은 어느 파일을 봐야 하는지 헷갈렸다.
읽기 → -
프로젝트 문서 캐스케이드로 싱크 비용 줄이기
최근 job 사이트별로 흩어져 있던 CLAUDE.md 파일들이 상위 공통 설정 문서로부터 캐스케이드되도록 개선했다. 단순해 보이지만 꽤 실질적인 변경인데, 이 작업의 맥락과 배운 점을 정리해본다.
읽기 →