일기
회고 / 메모
-
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 파일들이 상위 공통 설정 문서로부터 캐스케이드되도록 개선했다. 단순해 보이지만 꽤 실질적인 변경인데, 이 작업의 맥락과 배운 점을 정리해본다.
읽기 → -
멀티사이트 운영 문서 구조 정리하기
사이트별 개발 지침 파일(CLAUDE.md)을 계층적으로 정리했다. 전역 지침과 각 사이트별 지침을 분리해서, 봇이 호출될 때마다 필요한 규칙만 로드하도록 설계한 작업이다.
읽기 → -
문서 계층화로 팀 지침 일관성 확보
lotto 사이트에 CLAUDE.md 캐스케이드 구조를 추가했다. 한 문장이지만 뒤에는 제법 있는 이야기가 있다.
읽기 → -
봇 지침 계층화로 프로젝트별 정책 충돌 없애기
이번 작업은 사실 "side task"로 분류했지만, 팀이 여러 프로젝트를 동시에 돌리면서 마주친 꽤 실질적인 기반 시설 문제였다. CLAUDE.md를 사이트별로 캐스케이드하는 구조를 다시 정리한 거다.
읽기 → -
여러 사이트의 공통 지침을 한곳에서 관리하다
Claude Code 로컬 설정인 CLAUDE.md는 꽤 특이한 파일이다. 모든 봇 호출마다 로드되기 때문에, 파일 크기와 내용이 토큰 비용에 직결된다. 한두 줄이라도 불필요한 중복이 있으면 매 호출마다 낭비가 누적된다.
읽기 → -
프로젝트별 Claude 지침을 계층화하다
CLAUDE.md 파일의 사이트별 캐스케이드 구조를 추가했다. 단순해 보이지만 문서 관리의 복잡성을 한 차원 낮춘 작업이다.
읽기 → -
클론 존재 상태를 '없음'으로 잘못 기록한 문서 정정
오늘 docs/sites-detail.md 를 수정했다. love mac 클론이 실제로는 존재하는데, 문서에 "클론 없음"이라고 잘못 기록되어 있던 부분을 정정한 것. 원인은 **zsh glob 패턴 오판**이었다.
읽기 → -
문서 보안과 신뢰도를 동시에 챙기기
팀의 기술 문서들을 보안 관점에서 정리했다. 평문 비밀번호를 제거하고, 여러 문서 간의 진입점을 명확히 하는 "필독 헤더"를 추가한 작업이다. 사소해 보이지만, 팀 규모가 커지고 AI와 협업할수록 의외로 중요한 변경이 되어간다.
읽기 → -
비밀번호 노출 제거, 정적 페이지를 SSR로 전환
문서 저장소에 노출된 민감정보를 정리하고, 검색엔진 최적화가 필요한 페이지들을 정적에서 동적 렌더링으로 전환했다.
읽기 → -
라이브 사이트 인벤토리 불일치 고치기
서버 검증 과정에서 실제 운영 중인 라이브 사이트 2개가 우리 문서에 빠져 있다는 걸 발견했다. 서버에는 있는데 docs/sites-detail.md 에는 없는 상황. 이번 커밋으로 그 간격을 메웠다.
읽기 → -
내부 가이드 문서의 팀원명 참조 정리
docs/hedvion-CLAUDE.md 파일을 정독하면서 특정 팀원명을 문서에서 완전히 제거했다. 겉으로는 간단한 텍스트 정리지만, 그 뒤에는 팀 문서를 어떻게 관리할 것인가에 대한 생각이 있었다.
읽기 → -
동료 이직, 팀 문서 실시간 업데이트
jerry라는 팀원이 팀을 떠났다. 경력 전환을 결심한 동료를 축하해주면서도, 한편 팀 구성이 확 줄어드는 현실이 와 닿았다. 그리고 그 즉시 해야 할 일이 떠올랐다. 내부 문서에 남겨둔 팀 멤버 정보를 업데이트하는 것. 얼핏 사소해 보일 수 있는 이 작업이, 실은 팀 리더로서 무시할 수 없는 책임이었다.
읽기 →