Craft Docs — 20인 스타트업이 전사 에이전트 도구로 엔지니어링과 비개발 업무를 재창조한 방법

1. 왜 이 사례인가

문서 협업 도구 크래프트(Craft Docs)는 100만 명 이상의 활성 사용자와 5만 곳 이상의 유료 고객을 보유한 5년 차 테크 스타트업입니다. 2021년 애플 ‘올해의 Mac 앱(Mac App of the Year)‘을 수상할 만큼 높은 제품 완성도와 엔지니어링 역량을 갖춘 팀이지만, 2023~2024년 불어닥친 생성형 AI 열풍 속에서도 실질적인 효용이 없는 ‘보여주기식 기능(Copilot slop)‘을 철저히 배제해 왔습니다.

하지만 2025년 말 프론티어 추론 모델과 에이전트의 성능이 임계점을 넘어서자, 창업자 발린트 오로스(Balint Orosz)는 크리스마스 연휴 2주 동안 Claude Code를 활용해 전사 전용 시각적 데스크톱 도구인 ‘Craft Agents’를 직접 개발했습니다. 2026년 1월 5일, 전사 직원에게 이 도구의 사용을 의무화하고 최상위 AI 모델 구독을 무제한 지원하며 전면적인 AI 네이티브 전환을 단행했습니다.

전환의 성과는 수치로 즉각 드러났습니다. 고객 지원팀의 티켓 처리 시간은 20~30분에서 2~3분으로 90% 단축되었고, 5년간 미뤄왔던 60개 백엔드 서비스의 Serverless 마이그레이션(예상 소요 기간 3~4개월)을 단 1명의 엔지니어가 1주일 만에 완결했습니다. 개발팀의 주간 티켓 해결량은 15~20건에서 100건 이상으로 5배 이상 급증했습니다.

기술 조직뿐 아니라 비엔지니어링 부서(고객 지원, 마케팅, HR, 재무)가 코딩 에이전트를 직접 다뤄 개발팀 의존도를 낮추고, 전통적인 소프트웨어 개발 수명 주기(SDLC)를 근본적으로 혁신한 생생한 현장 기록입니다.

2. Problem

Craft Docs가 AI 도입 과정에서 겪은 구조적 장벽과 기존 조직 운영의 비효율은 다음과 같았습니다.

초기 AI의 리텐션(Stickiness) 실패: 2022년 GPT-3.5 기반 어시스턴트를 발 빠르게 도입했으나 일회성 유입에 그쳤고, 지속적인 사용자 유지(Retention)를 만들어내지 못했습니다. 실질적인 효용이 검증되지 않은 AI 기능을 섣불리 확장했다가는 브랜드 신뢰도만 깎아먹는다는 교훈을 얻었습니다.
비개발 직군의 터미널(TUI) 접근 장벽: Claude Code와 Claude Agent SDK 기반으로 사내 프로토타입(Craft Terminal)을 만들었으나, 텍스트 기반 터미널 환경은 비개발자들에게 심각한 진입 장벽이었습니다. 여러 작업을 병렬로 처리하기 어렵고 장기 실행 계획을 한눈에 검토하기도 불편해 전사적 확산이 불가능했습니다.
부서 간 핸드오프와 엔지니어링 병목:
- 마케팅팀의 웹페이지 제작 및 수정 요청에 프론트엔드 엔지니어가 순환 배정되면서 개발자는 단순 작업에 피로를 느끼고 마케팅은 지원 부족을 겪었습니다.
- 고객 지원팀은 버그 제보가 들어올 때마다 코드 재현 여부를 확인하기 위해 엔지니어를 호출해야 했고, 티켓 하나를 처리하는 데 20~30분이 소모되었습니다.
장기 기술 부채의 누적: 60개 마이크로서비스의 Serverless 버전 업그레이드처럼 위험도가 높고 기계적인 마이그레이션 작업은 3~4개월 이상의 공수가 예상되어 5년 동안 엄두를 내지 못하고 방치되었습니다.

확인된 사실: 2022~2024년 얕은 코파일럿 유행 거부, 터미널 UI의 비개발자 사용성 한계 확인, 마케팅 웹 배포 지원 피로도 누적, 고객 지원의 엔지니어링 에스컬레이션 병목(티켓당 20~30분 소요), 60개 서비스 업그레이드 5년간 지연.

3. Solution

Craft는 시각적 에이전트 인터페이스를 자체 구축하고, 전사 워크플로를 에이전트 중심으로 전면 재설계했습니다.

3.1 시각적 데스크톱 에이전트 도구 ‘Craft Agents’ 개발

발린트 오로스는 Electron 기반의 크로스 플랫폼 데스크톱 앱 ‘Craft Agents’를 2주 만에 개발해 전사에 배포하고 아파치 2.0 라이선스로 오픈소스 공개했습니다.

멀티 에이전트 시각화: 터미널을 탈피해 이메일이나 슬랙 클라이언트와 유사한 UI를 제공하며, 다수의 비동기 작업 창을 한눈에 보며 전환할 수 있도록 했습니다.
데이터 소스(Sources) 추상화 및 자격 증명 프록시: Craft Docs뿐 아니라 사내 데이터베이스, Linear, Zendesk, REST API, MCP 서버를 에이전트의 데이터 소스로 연결했습니다. 특히 API 호출 시 에이전트에게 실제 API 키를 노출하지 않고 도구가 중간에서 헤더에 인증 정보를 주입하는 보안 프록시 구조를 취했습니다.
3단계 실행 권한 제어: 안전한 프로덕션 작업을 위해 Explore(읽기 전용 기본 모드), Ask to Edit(수정 전 사용자 승인 필수), Auto(자율 쓰기 모드)의 3가지 권한 레벨을 도입했습니다.

3.2 비개발 부서의 자율 워크플로 구축

고객 지원, 마케팅, HR, 재무 부서가 엔지니어링 팀의 개입 없이 슬래시 명령어 형태의 자체 스킬(Skills)을 구축해 업무를 자동화했습니다.

고객 지원 (CS):
- /triage: 유입된 수많은 티켓을 3개씩 묶어 병렬 워커 에이전트를 동적으로 기동해 자동 분류합니다.
- /get-user-data: 백엔드 API를 조회해 사용자의 플랜, 결제 상태, 기능 플래그 정보를 Zendesk 티켓에 자동 보강합니다.
- /bug-report: 고객의 장애 보고서를 Craft 실제 소스 코드와 대조해 원인을 분석하고, Linear 이슈를 검색해 중복 여부를 확인한 뒤 코드가 가리키는 파일 경로가 포함된 엔지니어링 티켓을 자동 발행하고 고객 응답 초안을 작성합니다.
마케팅: 마케팅 인턴과 기획자가 엔지니어 지원 없이 론칭 페이지, 제품 비교 페이지 등 웹사이트를 직접 구축 및 배포했습니다.
HR & 재무: 헝가리 노동법 기반 연령별 연차 계산을 위한 BambooHR 연동 도구 자체 제작, Revolut 계좌 내역 CSV와 직원 Slack 영수증 채널을 대조해 회계 양식을 자동으로 변환했습니다.

3.3 엔지니어링의 패러다임 전환과 ‘불가능 미션’ 챌린지

개발 조직(엔지니어 20명)은 직접 코드를 작성하던 방식에서 벗어나 5개 이상의 병렬 에이전트를 관리하는 1인 책임 스쿼드(One-person responsibility squad) 체제로 개편되었습니다.

‘불가능한 목표’ 챌린지: 매주 첫 미팅에서 “객관적으로 2~3개월이 걸려 1주일 안에는 절대 불가능한 작업”을 목표로 설정한 뒤 모든 AI 역량을 쏟아붓도록 했습니다.
- 이 방식을 통해 1명의 엔지니어가 5년 묵은 60개 서비스의 Serverless 3→4 마이그레이션과 패키지 매니저(Bun) 전환을 단 1주일 만에 완결했습니다. 배포 시간은 2.5분에서 1분으로 단축되었습니다.
코드 리뷰 프로세스 해체: 제품 철학을 공유하는 소수 아키텍트가 직접 머지 권한을 갖고, 일반 개발자의 PR은 기능 제안으로 흡수하여 아키텍처 일관성을 유지했습니다. 복잡한 서드파티 SDK 대신 에이전트가 REST API 엔드포인트를 직접 호출하도록 단순화했습니다.

확인된 사실: Electron 기반 Craft Agents 구축(2주 개발, Apache 2.0 공개), 자격 증명 주입 프록시, 3단계 권한(Explore/Ask to Edit/Auto), CS 전용 스킬(/triage, /bug-report, /get-user-data 등), 마케팅/HR/재무 자체 자동화, 1인 60개 서비스 Serverless 마이그레이션(1주일 소요), 주간 ‘불가능 목표’ 챌린지 운영.

4. Impact

The Pragmatic Engineer에 공개된 주요 정량적 성과는 다음과 같습니다.

지표	전환 전	전환 후	비고
CS 티켓당 처리 시간	20~30분	2~3분 (약 −90%)	1차 응대 및 맥락 수집 시간
60개 백엔드 서비스 마이그레이션	예상 3~4개월 (5년 지연)	1주일 (엔지니어 1명)	Serverless 4 + Bun 전환
서비스 배포 소요 시간	2.5분	1분 (−60%)	마이그레이션 결과
엔지니어링 팀 주간 이슈 해결량	15~20건/주	100건 이상/주 (5배 이상)	고도 활용(Optimizer) 팀 기준
마케팅 웹페이지 제작 엔지니어링 공수	상시 페어링 순환 배정	0명 (비개발자 직접 구축)	마케팅 인턴 및 전담팀 자율 제작
AI 도구 개발 기간	-	2주	Claude Code 활용해 데스크톱 앱 완성

정성적으로는 고객 지원팀이 엔지니어를 호출해 코드를 확인하던 에스컬레이션 빈도가 급감했고, 엔지니어링 팀은 마케팅 지원이나 기계적 마이그레이션 부채에서 벗어나 제품의 핵심 아키텍처와 장기 과제에 온전히 집중할 수 있게 되었습니다.

확인된 사실: 티켓 처리 20~30분→2~3분, 60개 서비스 마이그레이션 3~4개월→1주일(1인), 배포 시간 2.5분→1분, 주간 해결 티켓 15~20건→100+건, 마케팅 웹 엔지니어 개입 제로.

5. Insight

비개발 직군이 에이전트를 잡을 때 엔지니어링 병목이 진짜로 풀립니다. 전통적인 기업에서 엔지니어링 리소스는 사내 요청(마케팅 페이지, CS 버그 확인, HR 연동)을 쳐내느라 늘 고갈됩니다. 비개발자가 직접 에이전트를 다뤄 코드 저장소를 조회하고 연동 도구를 만들게 되자, 엔지니어의 집중을 방해하던 컨텍스트 스위칭과 인터럽트가 근본적으로 차단되었습니다.

UI-first SaaS에서 API-first 인프라로 이동하고 있습니다. Craft Docs는 연간 2만 달러를 요구하던 Zendesk의 AI 기능 대신 자체 에이전트 워크플로를 붙였습니다. 에이전트가 데이터 조회와 조작을 주도하는 환경에서는 화려하지만 무거운 SaaS UI의 가치가 급락하며, 빠르고 안정적인 API 엔드포인트를 제공하는 벤더가 살아남습니다.

조직 문화적 마찰과 직무 정체성의 재정의가 필요합니다. 생산성이 5~10배 폭발하는 이면에 심각한 성장통이 뒤따랐습니다. 코드 작성 자체에서 장인 정신을 느끼고 사내 지식의 중심 역할을 하던 창립 멤버급 시니어 엔지니어가 소외감을 느껴 퇴사했습니다. 이제 엔지니어의 핵심 경쟁력은 ‘코드를 직접 쓰는 속도’가 아니라 ‘문제를 정의하고 여러 에이전트를 지휘하는 시스템 아키텍트’로 전환되고 있습니다.

복제 조건과 한계. 이 급진적 모델은 엔지니어 20명 규모의 민첩한 스타트업이며, 창업자가 직접 도구를 코딩하고 전사 문화를 강하게 이끌 수 있었기에 가능했습니다. 엄격한 분업 체계와 복잡한 승인 절차를 가진 대규모 조직에서는 PR 없는 아키텍트 승인 방식이나 비개발자의 프로덕션 코드 접근을 그대로 모방하기 어렵습니다.

한 줄로: AI 전환의 돌파구는 개발자의 코딩 속도를 높이는 데 있지 않고, 시각화된 에이전트 도구로 비개발 부서의 엔지니어링 의존성을 끊어내 조직 전체의 실행 속도를 재정렬하는 데 있습니다.

6. 원문에 없는 추정 (구현 가설)

6.1 비개발 직군 전용의 Git 격리 브랜칭 및 프리뷰 배포 파이프라인

근거: 원문은 마케팅팀 인턴이 엔지니어 없이 웹페이지를 구축하고, HR팀이 BambooHR 연동 도구를 직접 만들어 배포하며, 도구 모드 중 ‘Auto’가 존재한다고 명시합니다.

비개발 직군이 메인 브랜치에 직접 코드를 푸시하거나 프로덕션 데이터베이스를 손상하지 않도록 보호하기 위해, Craft Agents는 백그라운드에서 격리된 Git 워크플로를 강제했을 것입니다. 마케팅이나 HR 담당자가 프롬프트를 입력하면 도구는 로컬이나 원격 저장소에 임시 피처 브랜치를 자동 생성하고 변경 사항을 커밋했을 것입니다. 이후 Vercel이나 Cloudflare Pages의 프리뷰 배포 웹훅을 호출하여 담당자가 브라우저에서 즉시 시각적으로 검증할 수 있는 프리뷰 URL을 생성했을 가능성이 높습니다. 검증이 완료된 변경점만 사전 정의된 린터와 자동화 테스트를 통과한 후 아키텍트의 원클릭 승인(또는 자동 병합 규칙)을 통해 메인에 반영되었을 것으로 추정됩니다.

6.2 CS 버그 분석 스킬의 코드베이스 AST 인덱싱 및 Linear 중복 탐지 메커니즘

근거: 원문은 CS 부서의 /bug-report 스킬이 Craft의 실제 소스 코드를 조회해 기술적 근본 원인 분석(Root cause analysis)을 수행하고, Linear의 기존 이슈와 대조하여 관련 티켓을 연결하거나 새 티켓을 연다고 설명합니다.

대규모 클라이언트 코드베이스 전체를 매 티켓마다 LLM 프롬프트에 통째로 밀어넣는 것은 비용과 지연 시간 면에서 불가능합니다. 따라서 Craft Agents 내부의 소스 코드 연동 계층은 사내 Git 저장소의 최신 커밋을 기반으로 AST(추상 구문 트리) 파싱 및 심볼 인덱싱(ctags/LSP 기반) 또는 의미론적 코드 임베딩 벡터 저장소를 사전 구축해 두었을 것입니다. 고객이 입력한 에러 메시지나 화면 경로 키워드를 바탕으로 관련 파일과 함수 스니펫을 선별 검색한 뒤, Linear API를 통해 유사 키워드를 가진 오픈 상태의 이슈 목록을 조회하여 LLM에게 비교 컨텍스트로 제공하는 2단계 검색-추론 파이프라인을 구축했을 가능성이 높습니다.

7. 출처

The Pragmatic Engineer — Inside a five-year-old startup’s rapid AI makeover
https://newsletter.pragmaticengineer.com/p/ai-first-makeover-craft
발행일: 2026-01-27 (Gergely Orosz, featuring Balint Orosz, Gyula Halmos, Tamas Fazekas)