Show GN: AI에게 매번 같은 설명을 하지 않기 위해 만든 gc-tree

gc-tree — AI 코딩 도구를 위한 컨텍스트 관리 도구

Show GN: AI에게 매번 같은 설명을 하지 않기 위해 만든 gc-tree

AI 코딩 도구를 매일 사용하면서 늘 불편했던 점이 하나 있다. 바로 "같은 맥락을 반복 설명해야 한다"는 것이다. 코드 컨벤션, 아키텍처 결정, API 설계 철학 — 이런 것들을 매번 새로운 세션마다 AI에게 다시 알려줘야 했다. 이 문제를 해결하기 위해 등장한 도구가 바로 gc-tree다.

gc-tree란 무엇인가

gc-tree는 "Branch-aware Global Context for AI Coding Tools"를표어로 하는 오픈소스 도구다. 쉽게 말해, AI에게 전달할 맥락 문서를 branches처럼 관리할 수 있게 해주는 CLI 도구이다.

Git의 branch 개념과 유사하게, gc-tree도 gc-branch를 만든다. 각 gc-branch는 특정 프로젝트나 작업 흐름에 맞는 컨텍스트 문서들의수합이다. 예를 들어:

• main branch: 전체 팀이 공유하는 기본 컨벤션

• project-a branch: A 프로젝트만의 아키텍처 문서

• billing branch: 결제 관련 정책과 규칙

이렇게 branch를 나눠두면, 각 프로젝트에 맞는 맥락만 AI에게 자동으로 전달할 수 있다.

핵심 기능 들여다보기

1. 점진적 컨텍스트 공개 (Progressive Disclosure)

gc-tree의 가장 큰특점시 "빠르게 요약만 보고, 필요할 때 전체 문서를 본다"는 흐름이다.

gctree resolve --query "auth token rotation policy"

이 명령을 실행하면 해당 쿼리와 관련된 문서 요약만 먼저 보여준다. 실제 전체 문서가 필요하면:

gctree show-doc --id "auth"

이렇게 해야 비로소 전체 내용을 확인한다. AI가 매번 긴 문서 전체를 읽어야 하는 부담을 줄이는 설계다.

2. Repository Scope Mapping

모든 프로젝트에 동일한 컨텍스트를 적용할 필요는 없다. gc-tree는 어떤 gc-branch가 어떤 저장소에 적용되는지를 지정할 수 있다.

gctree set-repo-scope --branch project-a --includegctree set-repo-scope --branch project-a --exclude

branch-repo-map.json에 이 매핑 정보가 저장되고, 새로운 저장소에서 gc-tree를 실행하면 자동으로 relevant한 branch를 제안한다.

3. 다양한 AI 도구 지원

gc-tree는 현재 다음 도구들과 연동된다:

• Claude Code CLI

• OpenAI Codex CLI

gctree scaffold 명령으로 특정 저장소에 로컬 override를 설치할 수도 있어서, 전역 컨벤션과 지역 특수 규칙을 모두 관리할 수 있다.

설치부터 기본 사용법까지

설치

npm install -g @handsupmin/gc-tree

초기 설정

gctree init# 1. provider 선택 (claude-code / codex / both)# 2. 작업 언어 선택 (English, 한국어 등)# 3. main gc-branch에 대한 guided onboarding 진행

맥락 추가하기

# main branch에 문서 추가 (대화형)gctree onboard# 전역 컨텍스트 durable 업데이트gctree update-global-context# 단축어: gctree ugc

문서 검색하기

# 쿼리와 관련된 문서 요약 확인gctree resolve --query "billing retry policy"# 관련 문서의 supporting docs 확인gctree related --id # 전체 문서 확인gctree show-doc --id 

branch 관리

# branch 목록 확인gctree branches# branch 전환gctree checkout # 새 branch 생성gctree checkout -b new-feature-branch

왜 gc-tree가 필요한가

AI 코딩 도구를 활발히 사용하는 개발자라면 공감할 것이다. 컨텍스트 전송 비용 문제다.

Claude Code나 Codex에게 큰 규모의 코드베이스를 설명하려면 상당한 토큰을소비한다. 특히:

• 멀티 레포지트리 환경에서 각 프로젝트의 특수 규칙

• 팀 내 컨벤션과 철학

• "우리의 방식"으로 동작하는 구체적 규칙

이런 정보를 매번 입력하면 비용도 크고, 일관성도 떨어진다. gc-tree는 이런 반복적인 컨텍스트를 구조화된 문서로 축적하고, AI가 필요할 때만 필요한 만큼만 꺼내 쓸 수 있게 해준다.

발전 방향과 과제

현재 gc-tree는 NPM 패키지로 제공되며, CLI 기반이다. 향후 과제로는:

• 더 많은 IDE 연동 (VS Code, JetBrains)

• GUI 관리 도구 제공

• 클라우드 동기화 (팀 간 gc-branch 공유)

등이 논의되고 있다. 특히 팀 환경에서 컨벤션 문서를 어떻게 효과적으로 공유할지 설계가 중요하다.

요약

gc-tree는 AI 코딩 도구를 더 효과적으로 사용하는 컨텍스트 관리 도구다. 핵심 가치를 정리하면:

기능	효과
gc-branch 기반 문서 관리	프로젝트별 맥락 분리
점진적 컨텍스트 공개	토큰 비용 절감
Repo scope mapping	불필요한 컨텍스트 노출 방지
다중 AI 도구 지원	Claude Code, Codex 모두 지원

AI에게 "매번 같은 설명"을 반복하고 있다면, gc-tree가 답이 될 수 있다. 특히 여러 프로젝트를 동시에 진행하는 팀이라면, 컨벤션 문서 관리 도구로 유용할 것이다.

---

📚 출처

• https://news.hada.io/topic?id=29161

• https://github.com/handsupmin/gc-tree

tags: AI,LLM,Claude Code,Codex,gc-tree,context management,AI coding tools,developer tools,productivity

---

📚 출처

• https://news.hada.io/topic?id=29161