방치된 리포지토리에서 87,000달러 가치의 Obsidian vault로: 3단계 추출 패턴

우리 대부분은 몇 달 동안 열어보지 않은 리포지토리(repos)로 가득 찬 폴더를 가지고 있습니다. 여기 제가 죄책감 대신 패키지화된 개발자 제품으로 이러한 리포지토리들을 변환하기 위해 사용해 온 패턴이 있습니다.

3단계 파이프라인 (The three-pass pipeline)
핵심 아이디어는 설명(descriptions)이 아니라 결정(decisions)을 추출하는 것입니다. 파일 수준의 요약은 미래의 독자에게 무용지물입니다. 그들이 원하는 것은 원작자가 보존하고자 했던 암묵적인 추론(implicit reasoning)입니다.

1단계 — 파일 수준 추출 (Pass 1 — file-level extraction)
모든 파일에 대해 모델에게 네 가지를 요청합니다: 목적(purpose), 공개 인터페이스(public surface), 숨겨진 불변량(hidden invariants), 그리고 1에서 5 사이의 위험 점수(risk score)입니다. 위험 점수가 비결입니다. 이는 모델이 핵심적인 로직(load-bearing logic)을 찾도록 강제합니다.

2단계 — 모듈 수준 클러스터링 (Pass 2 — module-level clustering)
1단계의 모든 결과를 다시 입력하여 불변량을 공유하는 파일 클러스터(clusters)를 요청합니다. 각 클러스터는 상태(status), 맥락(context), 결정(decision), 그리고 결과(consequences)를 포함하는 아키텍처 결정 기록(Architecture Decision Record, ADR)이 됩니다.

3단계 — 아키텍처 수준 그래프 (Pass 3 — architecture-level graph)
ADR 전체에 Leiden 클러스터링을 적용하여 횡단적 개념(cross-cutting concepts)을 드러냅니다. 각 그래프 노드에는 '이것이 유지보수자에게 왜 중요한가'에 대한 한 단락의 노트를 포함합니다. Leiden은 작은 그래프에서 일반적인 모듈성(vanilla modularity)보다 더 안정적인 클러스터 경계를 제공합니다.

여기서 Sonnet 4.6이 중요한 이유
1M 토큰의 컨텍스트 윈도우(context window)를 통해, 파일별로 먼저 요약하지 않고도 전체 리포지토리(whole-repo) 단계를 실행할 수 있습니다. 파일별 요약은 상호 참조(cross-references)가 끊어지는 지점입니다. 일단 압축하면 그래프 단계에서 의존하는 링크들을 잃게 됩니다.

Obsidian으로 패키징하기
Graphify(Claude Code 기술, 약 37K stars)에는 그래프를 백링크(backlinks)가 이미 연결된 마크다운 볼트(markdown vault)로 작성하는 --obsidian 플래그가 있습니다. ADR 템플릿을 추가하면 단순한 데이터 덤프가 아닌 하나의 제품이 됩니다.

빠른 데모
3단계 가격 책정
$0 — 두 개의 ADR과 그래프 뷰가 포함된 샘플러 볼트(sampler vault)
$49 — 모든 ADR과 개념 노트가 포함된 전체 볼트(full vault)
$149 — 구매자가 자신의 코드에 파이프라인을 직접 실행할 수 있도록 원본 프롬프트(raw prompts)와 ADR 템플릿이 포함된 전체 볼트

Gumroad에서 판매되는 상위 개발자 볼트들은 연간 3,000개 이상의 복사본을 판매하므로, 시장의 잠재력은 실재합니다.

당신의 리포지토리(repo)에서 직접 시도해 보세요. Graphify 프로젝트를 확인하거나 cptdigital.com에서 더 자세한 가이드를 확인하실 수 있습니다. 병목 현상(bottleneck)은 모델이 아니라, 거의 항상 1단계(pass 1)를 위한 프롬프트(prompt)에서 발생합니다.