Repo Transplant가 Claude Code에 던지는 질문: URL 한 줄과 문장 하나로 기능을 다시 찾는 법

다른 프로젝트의 코드를 내 프로젝트에 가져올 때 가장 어려운 것은 “어떤 기능이 어디에 있는지”를 찾는 것입니다. 검색 키워드를 잘못 정하면 관련 파일을 건드리지도 못하고, 너무 광범위하게 검색하면 노이즈만 많습니다. hs-hui는 10월 31일 repo-transplant를 공개했습니다. GitHub URL과 한 문장을 입력하면, 기존 코드의 기능을 찾아 다시 빌드하는 도구입니다. 이 글은 원문과 저장소 문서를 읽은 뒤, URL과 문장으로 기능을 찾는 과정을 로컬 예제로 재현한 기록입니다. repo-transplant 자체를 빌드하거나 Claude Code와 연결해 실행하지는 않았습니다.

“URL + 한 문장”이 의미하는 것

원문은 repo-transplant를 “give Claude Code a GitHub URL + sentence to find/rebuild features”라고 소개합니다. 저장소 URL을 입력하면 Claude Code가 그 저장소를 탐색하고, 사용자가 제공한 한 문장의 의도를 해석해 관련 기능을 찾아냅니다.

이미지: hs-hui/repo-transplant 공식 저장소 스크린샷.

이 설계가 의미하는 것은 두 가지입니다. 첫째, 검색 키워드를 사용자가 직접 정할 필요가 없습니다. “로그인 기능 가져오기” 같은 자연어 문장으로 의도를 전달합니다. 둘째, 소스 저장소의 구조를 Claude Code가 직접 탐색하므로, 파일 이름이나 폴더 구조에 얽매이지 않습니다.

기능 찾기의 세 단계

repo-transplant가 수행하는 작업은 세 단계로 나눌 수 있습니다.

첫째, 저장소 클론입니다. URL로 지정된 저장소를 로컬에 복사합니다. 이 단계는 Git 명령어 하나로 완료할 수 있지만, repo-transplant는 저장소 크기·브랜치·파일 수를 먼저 확인한 뒤 적절한 옵션으로 클론합니다.

둘째, 의도 해석입니다. 사용자가 제공한 한 문장을 분석하여, 어떤 기능이 필요한지 추론합니다. “비밀번호 재설정 기능”이라면 이메일 발송, 토큰 생성, 유효기간 검증 등의 하위 기능을 포함할 수 있습니다.

셋째, 기능 매핑입니다. 클론한 저장소에서 관련 코드를 찾아내어, 목표 프로젝트에 적용할 수 있는 형태로 제안합니다.

Node.js로 재현한 작은 예제

CodeBridge는 Node.js로 repo-transplant의 핵심 흐름을 작은 예제로 구현했습니다. 실제 repo-transplant의 구현을 재현한 것이 아니라, URL 입력 → 클론 → 검색 → 제안이라는 흐름만 보여줍니다.

import { execSync } from "node:child_process";
import fs from "node:fs";
import path from "node:path";

async function transplant(url, intent) {
  const cloneDir = path.join("/tmp", `transplant-${Date.now()}`);

  // Step 1: Clone the repository
  console.log(`[step 1] cloning ${url}`);
  execSync(`git clone --depth 1 ${JSON.stringify(url)} ${cloneDir}`, {
    stdio: "inherit"
  });

  // Step 2: Search for files matching the intent
  console.log(`[step 2] searching for: ${intent}`);
  const keywords = intent.split(/\s+/).filter((w) => w.length > 2);
  const files = execSync(
    `cd ${cloneDir} && grep -rl --include='*.js' --include='*.ts' --include='*.py' ${JSON.stringify(keywords.join("|"))} 2>/dev/null || true`,
    { encoding: "utf8" }
  ).trim().split("\n").filter(Boolean);

  // Step 3: Suggest relevant files
  console.log(`[step 3] found ${files.length} candidates:`);
  for (const file of files.slice(0, 5)) {
    const relPath = path.relative(cloneDir, file).replace(/^\/+/, "");
    console.log(`  → ${relPath}`);
  }

  // Cleanup
  fs.rmSync(cloneDir, { recursive: true, force: true });
  return files.slice(0, 5);
}

export { transplant };

이 예제는 repo-transplant의 구현을 그대로 옮긴 것이 아닙니다. URL 입력 → Git clone → 키워드 검색 → 파일 제안이라는 흐름만 보여줍니다. 실제 repo-transplant는 Claude Code의 LLM 추론을 사용해 의도를 더 정교하게 해석할 수 있습니다.

repo-transplant를 고를 때 확인할 질문

repo-transplant의 문서를 읽고 바로 적용할 수 있는 점검 항목을 정리하면 다음과 같습니다.

도입 전에 남는 제약

repo-transplant에는 모델 제공자가 기본으로 들어 있지 않습니다. Claude Code의 추론 능력을 전제로 하므로, 모델에 따라 검색 품질이 달라질 수 있습니다. 원문은 URL과 한 문장으로 간단하게 시작할 수 있다는 장점을 강조하지만, 대규모 저장소나 복잡한 프로젝트에서는 검색 정확도가 떨어질 수 있습니다.

기능 매핑의 정확도, 대규모 저장소 처리 시간, 비공개 저장소 지원 여부는 이 글에서 측정하지 않았습니다. 특히 “한 문장”으로 모든 의도를 정확히 해석하는 것은 아니며, 검색 결과의 품질은 모델과 저장소 구조에 따라 달라집니다.

repo-transplant에서 배울 점은 URL 입력 방식이나 Git clone 명령어가 아닙니다. 기능 찾기를 검색 키워드 정렬에서 자연어 의도 전달로 바꾸는 구조입니다. 다음에 다른 프로젝트의 코드를 가져올 때는 검색어보다 “무엇을 얻고 싶은지”를 한 문장으로 정리해 보시길 권합니다.

아래 유료 강의는 Claude Code를 포함한 AI 코딩 하네스의 검증과 제약 설계를 다룹니다. repo-transplant 자체의 사용법이나 이 실험의 재현을 제공하는 강의는 아니며, 링크는 홍보 링크입니다.