매일 갱신되는 codegraph 인덱스가 조회 0회, 규칙 대신 훅으로 살린 기록

매일 갱신되는데 아무도 안 여는 자산, 혹시 갖고 계신가요? 저는 코드 인덱스가 그랬어요.

codegraph는 코드베이스의 심볼과 호출 관계를 미리 색인해 두는 도구예요. 파일을 하나씩 grep으로 뒤지는 대신 한 번의 조회로 관련 함수와 호출 경로를 받아 보라고 규칙 파일에 적어 뒀죠. "grep 루프 금지"라고요.

로그 두 개를 나란히 놓고 보니

직접 동기화 로그와 조회 로그를 나란히 놓고 세어 보니 결과가 이랬어요.

• 동기화 로그: 10,470줄
• 조회 로그: 1줄
• 마지막 조회 이후 지난 날: 18일

인덱스는 매일 새로 만들어졌는데, 18일 동안 조회는 0회였어요. 규칙 문장 1줄은 강제력이 0이었던 거죠. 문서에 적혀 있다는 사실과 실제로 쓰인다는 사실은 다른 얘기예요.

동기화 로그 10,470줄 vs 조회 로그 1줄

규칙을 지우고 훅을 넣었어요

바꾼 건 파일 1개예요. 프롬프트가 들어올 때마다 도는 훅 스크립트 하나가, 코드 관련 질문이면 관련 심볼을 찾아 프롬프트 뒤에 자동으로 붙여요. 제가 기억해서 도구를 여는 게 아니라, 도구가 먼저 와 있는 구조예요.

다만 자동으로 밀어넣는 건 브레이크 없이는 위험해요. 그래서 4개를 같이 걸었어요.

• ✓레포별 opt-in
• ✓주입 상한 14줄/2,400바이트
• ✓실패나 빈 결과면 무주입
• ✓전 건 로그

레포마다 켜고 끄고, 주입량엔 상한을 두고, 검색 결과가 비거나 실패하면 아무것도 안 붙이고, 어떤 경우든 로그를 남겨요. 훅으로 바꿔 돌려 보니 조회 로그가 그날부터 채워지기 시작했어요.

하나 걸린 게 있어요. codegraph는 단어가 겹치는 정도로 순위를 매겨서, "회비 청구 함수 어디서 호출되나"처럼 한국어로 물으면 영어 심볼을 못 찾아요. 테스트해 보면 "dues charge"로 물어야 바로 맞아요. 훅이 영문 식별자를 뽑아 얹긴 하지만, 순수 한국어 질문은 여전히 비어요.

1인 브랜드 운영에서 똑같이 일어나는 일

이 기록을 굳이 브랜드 이야기로 쓰는 이유가 있어요. 콘텐츠 운영에서 정확히 같은 구조를 봤거든요.

톤 가이드, 금지어 목록, 제품 사실 정리 문서. 매번 갱신은 하는데 글 쓰는 순간엔 안 열어 봐요. "발행 전에 가이드 확인"이라는 규칙 문장도 강제력이 0이에요. 그래서 라이프케어로그 블로그의 초안 파이프라인에는 가이드를 프롬프트에 자동으로 첨부하게 붙여 뒀어요. 플랜씨(plan-c)가 로그인 없이 쓰는 계산기라는 사실도 제가 기억하는 게 아니라 초안이 만들어질 때 같이 들어가요. 적용해 봤더니 가이드를 안 본 채 나가는 글이 줄었어요.

한국어 질문이 영어 심볼을 못 찾는 문제도 콘텐츠와 닮았어요. 독자가 검색창에 치는 단어와 제목의 단어가 다르면, 아무리 잘 쓴 글도 조회 로그가 비어요.

남긴 건 세 줄이에요. 만든 수와 쓰인 수를 따로 센다. 문장 규칙은 파이프라인에 훅으로 옮긴다. 자동화엔 상한과 로그를 같이 단다. 매일 갱신만 되는 자산이 있다면, 조회 로그부터 열어 보세요.