buildarc
Leonardo M. (leonardomjq) · 코딩 · 생산성
buildarc는 Claude Code에서 나눈 대화 기록을 읽어 공유할 수 있는 콘텐츠로 바꿔 주는 오픈소스 명령줄 도구다. 프로젝트 폴더에서 명령을 하나만 실행하면 이미 지나간 세션에서 결정, 전환점, 막다른 길을 뽑아내 X 스레드, LinkedIn 게시물, 빌드 저널로 다듬는다. 모든 것은 로컬에 남고 설정도 필요 없으며, npx로 실행할 수 있는 작은 Node.js 패키지로 배포된다. 게시할 시간을 끝내 내지 못하는 사람을 위한 build in public 도구라고 생각하면 된다.
buildarc 소개
buildarc란 무엇인가
buildarc는 Claude Code를 쓰면서 자신이 만드는 것을 공유하고 싶은 개발자를 위한 CLI 콘텐츠 도구다. Claude Code가 이미 디스크에 써 둔 기록에서 Claude Code 빌드 스토리를 그대로 복원한다. 새로 설치할 것도 없다. 기록을 시작해야 하는 세션도 없다.
해결하는 문제는 익숙하다. 프로젝트를 끝내고 "이거에 대해 올려야지" 하고 생각한 뒤, 결국 하지 않는다. 채팅 로그 50개를 챗봇에 붙여 넣거나 스레드를 손으로 쓰는 수고가 얻는 것보다 크기 때문이다. buildarc는 기존 Claude Code 세션을 재료로 삼아 거기서 스토리를 복원한다. 프로젝트 자체 README에 따르면 그 기원은 45개가 넘는 세션에 걸친 ScoutAgent라는 SaaS 빌드였다. 그 빌드의 이야기는 buildarc가 구해 내기 전까지 읽히지 않은 .jsonl 파일 속에서 거의 사라질 뻔했다.
다만 AI가 이야기를 쓰는 단계는 Claude Code 자체에 의존한다. buildarc는 기존 Claude 설치를 써서 당신의 말투로 게시물을 쓰기 때문에, Claude Code를 설정해 두지 않았다면 추출 요약은 얻어도 다듬어진 글은 얻지 못한다. 또한 Claude Code 기록만 읽고, 다른 코딩 어시스턴트의 세션은 읽지 않는다.
시작하기
- 평소처럼 Claude Code로 무언가를 만든다. buildarc는 남겨진 기록을 읽으므로 따로 캡처하는 단계가 없다.
- 프로젝트 디렉터리에서 터미널을 열고
npx buildarc를 실행한다. 도구가 프로젝트를 스스로 감지하고, 설정 파일도 필요 없다. - 세션을 읽게 한다.
.jsonl파일을 보통 몇 초 만에 분석하고, 찾아낸 핵심 순간을 분류한다. - 메뉴에서 형식을 고른다. X 스레드, LinkedIn 게시물, 빌드 저널, 전부 다, 또는 요약만.
- 프로젝트 루트의
.buildarc/폴더에서 생성된 파일을 복사한다. 각 파일은 그것이 쓰인 플랫폼에 붙여 넣기만 하면 된다.
제품 정보
buildarc의 요금, 지원 플랫폼, 성능을 한눈에 확인해 보세요.
추천 대상
이 도구가 가장 잘 맞는 사용자, 작업, 상황입니다.
사용자
- 공개적으로 만드는 인디 개발자
- Claude Code를 쓰는 1인 창업자
- 개발자 애드보킷과 테크니컬 라이터
작업
- 일주일치 코드로 X 스레드 초안 잡기
- 출시에 관한 LinkedIn 업데이트 쓰기
- 빌드 저널 이어 쓰기
활용 상황
- 프로젝트를 마무리하고 그에 대해 올리고 싶을 때
- 프로젝트가 실제로 어떻게 흘러갔는지 돌아볼 때
- 비밀을 흘리지 않고 빌드를 공유할 때
주요 기능
명령 하나짜리 워크플로
도구 전체가 단 하나의 명령 뒤에서 돌아간다. npx buildarc다. 현재 디렉터리에서 프로젝트를 자동 감지하고, 관련 기록을 읽고, 짧은 메뉴로 안내한다. 설정 없음. 계정 없음. 관리할 설정 파일도 없다.
세 가지 출력 형식
buildarc는 X 스레드, LinkedIn 게시물, 빌드 저널을 쓰며, 한 번 실행으로 셋 다 만들 수 있다. X 스레드 생성기와 LinkedIn 게시물 생성기를 겸한다. 스레드 옵션은 단일 게시물이 아니라 여러 트윗짜리 스레드를 만들고, 저널 형식은 계속 덧붙일 수 있는 날짜별 글로 나온다.
2계층 파이프라인
추출은 즉각적이고 로컬이며, 이야기 만들기는 AI가 맡는다. 첫 계층이 .jsonl 파일을 분석해 순간을 결정, 전환점, 감정, 지시, 질문으로 분류한다. 둘째 계층이 그 요약을 Claude에 보내 당신의 말투로 게시물을 쓴다. 이 분리가 느린 부분을 선택 사항으로 만든다.
프로젝트를 아는 맥락
이 도구는 package.json과 git remote를 읽어 CTA에 쓸 실제 세부 정보를 끌어온다. 그래서 생성된 스레드는 일반적인 앱을 설명하는 대신 당신 프로젝트의 이름을 대고 연결할 수 있다. 이게 중요하다. 아무 데도 가리키지 않는 게시물은 대개 무시당한다.
프라이버시와 비밀 가리기
모든 것이 당신의 기기에서 돌아가고, 데이터 전송도 텔레메트리도 없다. 무엇인가 공유 가능해지기 전에 스크러버가 API 키, Bearer 토큰, 연결 문자열, .env 형식 비밀을 눈에 보이는 [REDACTED] 표시로 바꾼다. 무엇이 제거됐는지 정확히 볼 수 있다.
의존성 제로
buildarc는 Node.js 내장 기능만으로 만들어졌고 실행 시 어떤 패키지도 끌어오지 않는다. 설치가 몇 초 만에 끝난다. 가끔 한 번 돌릴 작업을 위해 거대한 의존성 트리를 끌고 다니는 도구와는 실제로 다르다.
설계부터 소급적
이 도구는 이미 지나간 세션을 다루므로 앞으로 일하는 방식을 바꿀 이유가 없다. Claude Code를 몇 달째 쓰고 있는가? 그 작업의 이야기는 이미 디스크에 놓여 읽히기를 기다린다.
장단점
장점
- 대부분의 개발자가 건너뛰는 일, 곧 자기 작업에 관해 쓰는 일을 명령 하나로 바꾼다.
- 완전히 오프라인으로 돌아가고 텔레메트리도 없어, 민감한 프로젝트 세부 정보가 당신 기기에 남는다.
- 비밀 스크러버가 가림을 조용히가 아니라 눈에 띄게 표시해, 무엇이 바뀌었는지 확인할 수 있다.
- 실행 시 의존성이 없어 설치가 가볍고 도구가 빠르다.
- 기존 Claude Code 세션에 소급해 작동하므로 새로운 녹화 단계가 없다.
단점
- Claude Code 기록만 읽으므로 Cursor, Copilot 등 다른 어시스턴트 사용자는 아무것도 얻지 못한다.
- AI 이야기 단계에는 Claude Code가 설치돼 있어야 한다. 없으면 원본 추출 요약만 얻는다.
- 생성된 콘텐츠는 편집하지 않는 한 여전히 AI가 도운 흔적이 남고, 이를 눈치채는 독자도 있다.
자주 묻는 질문
Claude Code 기록을 읽어 공유 가능한 콘텐츠로 바꾼다. X 스레드, LinkedIn 게시물, 빌드 저널이다. 프로젝트 디렉터리에서 npx buildarc를 실행하고 메뉴에서 형식을 고르면 된다.
관련 콘텐츠
buildarc와 관련된 도구, 스킬, 아티클을 살펴보세요.
buildarc 대안
Forefront
Forefront · 코딩Forefront는 오픈소스 AI로 무언가를 만드는 웹 플랫폼이다. 대표적인 오픈소스 언어 모델을 자신의 데이터로 미세 조정하고, 성능을 평가하고, API로 실행하거나 내보내 직접 호스팅할 수 있다. 폐쇄형 플랫폼의 편의를 원하면서도 모델과 데이터의 소유권은 놓지 않으려는 개발자가 대상이다.
Startkit
StartKit.AI · 코딩Startkit은 AI SaaS와 AI 래퍼 제품을 만들기 위한 보일러플레이트다. 지루한 부분을 미리 연결해 둔 AI 스타트업 보일러플레이트라고 생각하면 된다. 인증, Stripe와 Lemon Squeezy 결제, 사용량 제한, 트랜잭션 이메일, 그리고 OpenAI, Anthropic, Groq, Llama와 통신하는 AI API 스타터 키트가 포함된다. 저장소를 복제하고 가격을 정한 뒤 사용자가 실제로 돈을 내는 부분에 착수하면 된다. React와 Tailwind 위의 Next.js로 만들어졌기 때문에 보일러플레이트 코드의 상당 부분이 이미 익숙하게 느껴진다.
Testim
Tricentis · 코딩Testim은 웹, 모바일, Salesforce 애플리케이션 전반에 걸쳐 엔드투엔드 테스트를 만들고 실행하는 AI 기반 테스트 자동화 플랫폼이다. 머신러닝에 기대어 인터페이스가 바뀌어도 테스트를 안정적으로 유지하므로, 팀은 깨진 셀렉터를 고치는 데 쓰는 시간을 줄인다. 오늘부터 쓸 수 있는 자동화 테스트 도구치고 나쁘지 않다. 브라우저에서 동작을 녹화해 테스트를 만들고, 더 세밀한 제어가 필요하면 JavaScript를 더한다. 바쁜 QA 팀에게 탄탄한 선택이다.