-
조직 전체 AI 도구 지침, 계층적으로 통일
여러 프로젝트와 사이트에 걸쳐 개발자 도구 설정 문서(CLAUDE.md)를 계층적으로 관리하는 구조를 추가했다. 전역 지침에서 시작해서 각 사이트별, 프로젝트별로 오버라이드되는 캐스케이드 방식인데, 이제 서버 환경에서도 이 구조가 제대로 로드되는지 검증했다.
읽기 → -
Claude 지침 계층 구조로 설정 관리 일관성 확보
여러 프로젝트와 환경에서 Claude Code를 쓰다 보니, 각 곳의 CLAUDE.md 지침이 서로 다르거나 중복되는 문제를 마주쳤다. 어떤 프로젝트는 최신 규칙을 따르고, 어떤 곳은 낡은 버전을 유지하고 있었고, 이번에 그 혼란을 정리하기 위해 "캐스케이드" 구조를 문서로 명시했다.
읽기 → -
팀 수칙을 계층적으로 관리하는 캐스케이드 구조 개선
여러 프로젝트와 서버 환경에서 팀의 개발 수칙을 일관성 있게 유지하기 위해 CLAUDE.md 캐스케이드 구조를 정리했다. 지금까지는 각 프로젝트나 디렉토리마다 수칙을 따로 관리했을 텐데, 이번 작업은 전사 수칙 → 사이트별 수칙 → 프로젝트별 수칙으로 계층적으로 상속·우선순위를 지정하는 체계를 명문화한 것이다.
읽기 → -
설정 캐스케이드 구조 명시화
여러 팀이 각각 다른 Claude 설정을 쓰게 되면서, 공통 규칙과 팀별 규칙 사이의 우선순위가 애매해지는 문제에 직면했다. 누가 global CLAUDE.md를 수정하면 모든 팀에 영향이 갈 텐데, 각 팀은 자기 사이트/프로젝트만의 규칙도 필요했다. 결국 "어느 설정이 우선인가" 하는 질문이 반복됐고, 새 팀원들은 어느 파일을 봐야 하는지 헷갈렸다.
읽기 → -
사이트별 보트 설정을 캐스케이드로 조직
CLAUDE.md 설정 파일의 캐스케이드 구조를 endpoint2cost 사이트에 추가했다. 여러 보트/프로젝트가 전역 규칙을 상속하면서 각 사이트만의 추가 규칙을 가질 수 있게 정리한 작업이다.
읽기 → -
프로젝트 문서 캐스케이드로 싱크 비용 줄이기
최근 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 에는 없는 상황. 이번 커밋으로 그 간격을 메웠다.
읽기 → -
CLAUDE 문서 슬림화로 봇 초기 로딩 시간 단축
전체 프로젝트 봇들이 초기화될 때마다 로드되는 공통 규칙 문서(hedvion-CLAUDE.md)가 점점 비대해지고 있었다. 광고 정책, 인증 정책, SEO 인프라 규칙 같은 여러 도메인의 상세 내용들이 한 파일에 뭉쳐 있었고, 이는 그 문서를 사용하는 모든 봇과 에이전트의 로딩 시간과 토큰 비용을 늘렸다.
읽기 → -
데이터 적재량을 매주 자동으로 팀에 공유하기
discover 시스템의 적재량(데이터 인제스트 규모) 집계를 주간 cron으로 자동화하고, 매주 디스코드에 리포팅하는 기능을 추가했다. 사실 단순한 모니터링 자동화 같지만, 뒤에는 팀의 운영 효율과 의사결정 가시성을 높이려는 의도가 있었다.
읽기 → -
API 429 throttle을 정책 준수와 백오프로 자동 복구
Wikimedia API와 상호작용하는 그룹 발견/시드 봇이 갑자기 자주 실패하기 시작했다. 원인은 API 요청 제한(throttle)에서 나온 429 응답을 제대로 처리하지 못한 것. Wikimedia 같은 공개 API는 사용 정책이 엄격한데, 당시 봇은 User-Agent를 명시하지 않았고, 429를 받아도 지능형 재시도가 없었다. 이번 작업으로 정책
읽기 → -
내부 가이드 문서의 팀원명 참조 정리
docs/hedvion-CLAUDE.md 파일을 정독하면서 특정 팀원명을 문서에서 완전히 제거했다. 겉으로는 간단한 텍스트 정리지만, 그 뒤에는 팀 문서를 어떻게 관리할 것인가에 대한 생각이 있었다.
읽기 → -
동료 이직, 팀 문서 실시간 업데이트
jerry라는 팀원이 팀을 떠났다. 경력 전환을 결심한 동료를 축하해주면서도, 한편 팀 구성이 확 줄어드는 현실이 와 닿았다. 그리고 그 즉시 해야 할 일이 떠올랐다. 내부 문서에 남겨둔 팀 멤버 정보를 업데이트하는 것. 얼핏 사소해 보일 수 있는 이 작업이, 실은 팀 리더로서 무시할 수 없는 책임이었다.
읽기 →