Graft

코드베이스 그래프로 코딩 에이전트의 탐색 비용을 줄이는 도구

npm install -g @nanonets/graft

저장소를 그래프로 만들어 두고 매 요청마다 관련된 부분만 끌어다 붙입니다. 코딩 에이전트가 파일을 찾아 헤매는 구간이 줄어드는 구조입니다. 저장소가 공개한 자체 측정에서는 도구 호출이 46퍼센트, 토큰이 42퍼센트, 시간이 60퍼센트 줄고 정답률은 54에서 66퍼센트로 올랐습니다. 초기화 한 번이면 그래프를 만들고 쓰는 에이전트에 배선까지 해 줍니다. 상주 프로세스가 없고 그래프는 그냥 파일이라 각자 다시 만들어 쓰면 됩니다. 검색과 구조 파악, 시각화 명령을 따로 제공합니다.

판단

이럴 때 씁니다

  • 에이전트가 매번 같은 저장소를 다시 훑느라 토큰을 태울 때
  • 큰 저장소에서 어디를 고쳐야 할지 파악이 오래 걸릴 때
  • 팀이 같은 구조 설명을 공유하고 싶을 때

이럴 땐 쓰지 마세요

  • 파일 몇 개짜리 저장소에는 효과가 없습니다
  • 그래프를 만들 때 한 번은 비용이 듭니다
  • 지원 언어 밖이면 값이 떨어집니다

차별점

  • 임베딩이나 유사도 검색 없이 연결된 문서 파일로 그래프를 만듭니다.
  • 기호 목록이 아니라 무엇을 하고 어디에 이어지는지 설명을 씁니다.
  • 상주 프로세스가 없고 색인을 유지할 필요가 없습니다.
  • 저장소가 자체 측정으로 도구 호출과 토큰, 시간 절감치를 공개합니다.

워크플로

  1. 01CLI 를 전역으로 설치합니다.
  2. 02무엇을 건드릴지 먼저 확인합니다.
  3. 03초기화로 그래프를 만들고 쓰는 에이전트를 배선합니다.
  4. 04배선 파일만 커밋해 팀과 공유합니다.
  5. 05각자 그래프를 다시 만들어 씁니다.

주요 명령

명령설명
npm install -g @nanonets/graft설치합니다.
graft init --dry-run건드릴 파일을 먼저 봅니다. 이 단계까지는 아무것도 쓰지 않습니다.
graft build그래프만 다시 만듭니다.
graft grep / graft map / graft viz검색, 구조 파악, 시각화입니다.

함정

설치 전에 확인하세요

  • 그래프는 다시 만들 수 있는 지역 캐시입니다. 커밋 대상이 아니고 초기화가 무시 목록에 자동으로 넣습니다.
  • 공유하는 것은 그래프가 아니라 배선 파일입니다. 팀원은 각자 다시 만들어야 합니다.
  • 저장소가 릴리스 노트를 남기지 않습니다. 변경 내역은 판 태그와 커밋으로만 확인됩니다.
  • 심어 두는 설정과 훅이 기존 배선과 겹칠 수 있습니다. 미리보기로 확인하고 넣는 것이 안전합니다.

비교

코드 검색 도구는 대체로 임베딩 색인을 만들고 그것을 계속 최신으로 유지해야 합니다. 이쪽은 결과물이 그냥 파일이라 에이전트가 다른 파일처럼 열고 따라갑니다. 유지 부담이 낮은 대신 설명 품질이 곧 값어치입니다.

최근 변경

저장소가 릴리스 노트를 따로 남기지 않아 변경 내역은 판 태그로 확인합니다. 배포판은 0.16.0 이고 반년간 커밋이 464건으로 움직임이 큽니다.

공식 변경 내역