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

gc-tree는 AI 코딩 에이전트를 위한 글로벌 컨텍스트 관리 도구입니다.

왜 만들었나요

AI를 쓰다 보면 세션이 바뀔 때마다 같은 설명을 반복하게 됩니다.

• 내가 어떤 방식으로 일하는지
• 팀이 어떤 용어를 쓰는지
• 이 repo와 저 repo가 어떻게 연결되는지

세션이 날아가거나 컨텍스트가 압축되면
이런 배경을 매번 다시 넣어줘야 했습니다.

CLAUDE.md나 AGENTS.md 같은 컨텍스트 관리 방식이 있지만,
이런 파일은 repo 하나를 설명하는 데는 잘 맞지만, 여러 repo를 함께 다루는 데에는 불편한 점이 있었습니다.

• 레포 간 관계를 담기 어렵고
• 공통 배경지식은 여기저기 중복되기 쉽고
• 세션이 꺼지면 다시 처음부터 설명해야 합니다

저는 이 반복 작업을 없애고 싶었습니다.

gc-tree는 무엇을 하나요

gc-tree는 내 업무 스타일, 팀의 도메인 용어, 공통 배경지식을 repo 바깥의 글로벌 컨텍스트로 저장해두고,
작업할 때 필요한 정보만 가져와 참고하게 만드는 도구입니다.

한 번 온보딩해두면, 다음부터는 내가 누구이고 어떤 방식으로 일하는지 매번 길게 설명하지 않아도 됩니다.

특히 멀티 레포 환경에서 작업할 때 유용합니다.
특정 repo 안에 갇히지 않고, 여러 프로젝트에서 공통으로 쓰는 맥락을 재사용할 수 있기 때문입니다.

구현하면서 신경 쓴 점

• 매번 전체 컨텍스트를 읽는 대신 필요한 정보만 가져오도록 해서 토큰 사용량을 줄였습니다
• 여러 업무 흐름은 브랜치처럼 나눠 관리할 수 있습니다
• 관련 없는 맥락은 자동으로 무시합니다
• 이미 동료가 정리해둔 온보딩 데이터가 있다면 그대로 가져와 시작할 수도 있습니다
• 기존 개발 환경을 크게 바꾸지 않고 붙일 수 있도록 만들었습니다

마무리

멀티 레포에서 작업하거나, 나만 아는 배경지식을 매번 설명하느라 번거로웠던 분들이라면 한 번 써보실 만할 것 같습니다.
사용해보시고 피드백 주시면 감사하겠습니다.

GitHub Link: https://github.com/handsupmin/gc-tree