CLAUDE.md를 짧게 유지하고 코드 구조는 Octocode에 맡기는 방식
큰 코드베이스에서 CLAUDE.md가 너무 길어지고 금방 낡는 문제를 줄이는 작업 방식이다. 핵심은 코드 구조 정보를 CLAUDE.md 안에 계속 적어두지 않고, Octocode라는 오픈소스 MCP 서버에 맡기는 것이다. Octocode는 tree-sitter AST 파싱과 지식 그래프를 이용해 파일 구조, 가져오기 관계, 어떤 코드가 어떤 코드를 부르는지 같은 정보를 찾을 수 있게 해준다. 그래서 CLAUDE.md는 약 50줄 정도의 짧은 규칙 문서로 유지하고, Claude 같은 AI 에이전트는 필요할 때 Octocode에 질문해 최신 코드베이스 문맥을 가져온다. 이 방식은 큰 프로젝트에서 AI 도구가 오래된 설명이나 지나치게 긴 지침에 휘둘리는 일을 줄이는 데 목적이 있다.
핵심 포인트
용어 한 줄 설명
- CLAUDE.md
- Claude Code에게 프로젝트 규칙과 작업 방식을 알려주는 안내 파일입니다.
- Octocode
- 코드 구조를 분석해 AI 도구가 필요한 정보를 찾아볼 수 있게 해주는 오픈소스 도구입니다.
- MCP 서버
- AI 도구가 파일, 앱, 데이터 같은 외부 기능과 연결되게 해주는 서버입니다.
- tree-sitter AST 파싱
- 코드를 문장처럼 쪼개 구조를 이해하는 분석 방식이다.
- 지식 그래프
- 정보와 정보 사이의 관계를 점과 선처럼 연결해 정리한 구조입니다.
- AI 에이전트
- 사람 대신 정보를 찾거나 작업을 처리하도록 만든 AI 프로그램입니다.
- 1인 개발자
- 회사에 소속되지 않고 혼자서 기획부터 제작까지 모든 과정을 책임지는 제작자.
- MD 파일
- 마크다운 형식으로 쓴 문서 파일입니다.