오픈소스 엔진 · 사람이 검토 · 늘 최신 상태

AI가 만든 것을,
사람이 이해하게.

도클로는 AI가 만든 코드베이스를 읽고, 사람이 읽고 검토하고 인수인계할 수 있는 제품 문서로 바꿉니다. 모든 문장은 근거가 된 코드로 추적되고, 에이전트는 같은 진실을 MCP로 조회합니다.

9월 중 오픈 예정 · 지금은 가입 없이 라이브 데모 체험

01 · 격차

AI는 앱을 내놓습니다.
이해는 아무도 내놓지 않죠.

"오, 굉장히 그럴싸한데?"

프롬프트 두 번, 앱이 돌아간다

"그래서 이걸… 뭘 어떻게 사용하지?"

도클로가 시작된 질문

두 번째 질문은 사라지지 않습니다. 클라이언트에게 납품할 때, 동료가 코드를 물려받을 때, 아무도 기록해 두지 않은 기능을 에이전트가 고칠 때 되돌아옵니다. AI가 만든 코드의 3분의 2는 "거의 맞다"는 평가를 받는데, 모자란 3분의 1은 대개 코드가 아닙니다. 맥락입니다. 이게 무엇인지, 누구를 위한 것인지, 왜 이렇게 동작하는지.

"almost right": Stack Overflow 개발자 설문, 2025

02 · 단위

파일은 기계의 단위.
Dok은 사람의 단위.

도클로는 코드베이스를 Dok으로 정리합니다. 로그인, 결제, 권한처럼 비즈니스 의미를 갖는 가장 작은 단위로요. 각 Dok은 여섯 가지 질문에 답합니다.

CHKT-CHECKOUTactiveweb
목적
로그인한 고객이 상점을 떠나지 않고 장바구니를 결제할 수 있게 한다.
1
사람
고객 · 시스템 (ROLE-CUSTOMER)
2
흐름
주소 입력 → Stripe 결제 → 시스템이 재고 확보 → 웹훅이 주문 확정.
3
규칙
재고는 10분간 확보. 주문 생성은 웹훅에서만, 클라이언트에서는 절대 하지 않는다.
4
성공 기준
✓ 결제가 실패하면 확보가 풀리고 장바구니는 그대로 남는다.
5
근거
app/checkout/actions.ts · lib/stripe/client.ts · +5 files
6
  • 1
    왜 존재하는가

    제품의 언어로 쓴 의도. 읽는 데 전문 용어가 필요 없습니다.

  • 2
    누가 쓰는가

    누군가의 기억이 아니라 코드에서 추출한 역할.

  • 3
    어떻게 흐르는가

    사람이 밟는 단계와 그 사이 시스템이 하는 일.

  • 4
    어떤 규칙이 있는가

    "왜 안 돼요?"를 설명해 주는 제한, 권한, 정책.

  • 5
    잘 되는지 어떻게 아는가

    QA에 그대로 넘겨도 되는 인수 기준.

  • 6
    코드는 어디 있는가

    결정적으로 주입되는 소스 앵커. 모델이 추측하지 않습니다.

Code→Dok→Hub→Understanding· Dok은 JSON으로 당신의 git에 저장됩니다. 역할·용어·화면과 함께 모여 Hub가 됩니다.

03 · 방법

저장소에서 공유된 이해까지,
네 단계.

01

스캔

저장소를 가리키면 결정적 파싱이 라우트, 컴포넌트, 상태, import 그래프를 지도로 만듭니다. 이 층위에는 모델이 없습니다.

$ doklo scan
✓ 312 files · 23 routes · 87 components
02

초안

도클로가 코드에서 Dok 초안을 씁니다. Dok당 한 번의 호출, Dok당 1크레딧 — 확인은 언제나 무료입니다. 소스 앵커는 모델 손이 닿지 않는 곳에서 결정적으로 붙습니다.

$ doklo generate
● CHKT-CHECKOUT drafted · 7 anchors · conf 0.92
03
사람의 단계

직접 검토

모든 Dok은 draft로 도착합니다. 읽고, 고치고, 승인하는 건 사람입니다. 사람이 active로 표시한 것만 기록이 됩니다. 무엇도 스스로 발행되지 않습니다.

draft→ 나 →active
Studio에서 승인 · 재생성돼도 내 수정은 보존
04

함께 이해

사람은 승인된 Dok에서 렌더된 Live Docs를 읽습니다. 에이전트는 같은 Hub를 MCP로 조회합니다. 하나의 맥락, 두 독자, 갈라지지 않는 진실.

agent › doklo.get_dok("CHKT-CHECKOUT")
← active · fresh · 7 anchors
04 · 인수인계

클라이언트가 실제로 이해할 수 있는 소프트웨어를 납품하세요.

Live Docs는 검토를 마친 Dok에서 렌더됩니다. 클라이언트가 따라 할 수 있는 도움말 페이지, 그리고 그 뒤로 커지는 카탈로그. 코드가 어긋나면 문서가 먼저 압니다.

도움말 페이지클라이언트에게 건네는 기능별 가이드html · mdstable
릴리스 다이제스트실제로 무엇이 달라졌는지, 고객의 언어로htmlexperimental
도움말 인덱스모든 기능을 한 그루의 트리로htmlexperimental
운영 매뉴얼납품 검수 때 건네는 관리자 안내서hwpxexperimental
요구사항 추적표요구사항 ↔ 코드 ↔ 시험, 감리를 위해xlsxexperimental

엔진에는 템플릿 16종이 실려 있습니다. 오늘 stable을 약속하는 건 하나뿐이고, 나머지는 자격을 얻을 때까지 opt-in입니다. 그 정직함이 제품입니다.

help-page · CHKT-CHECKOUT · ko코드와 동기화됨
도움말 센터 · 결제

결제하기

세 단계로 장바구니를 결제합니다. 결제가 진행되는 동안 상품은 10분간 확보됩니다.

단계별 안내
  1. 배송지를 입력하고 배송 속도를 고릅니다.
  2. 카드로 결제합니다. 추가 인증은 화면 안에서 바로 뜹니다.
  3. 끝. 1분 안에 확인 메일이 도착합니다.
막힐 때
  1. 결제에는 이메일 인증이 필요합니다. 먼저 받은편지함을 확인하세요.
검토된 dok 1개에서 렌더 · 소스 앵커 7개 · 손으로 쓴 문장 없음
05 · 증명coming

에이전트가 만든 변경,
스스로 증명하게 하세요.

Live Review는 변경된 앱을 실제 브라우저에서 직접 눌러 보며 설명합니다. 라이브로 지켜보다가 멈추고, 화면의 컴포넌트를 짚어 질문하고, 판정을 남기세요 — 동작과 문서가 함께 승인됩니다.

실제 브라우저, 실제 실행서버의 Chromium이 변경을 라이브로 시연합니다 — 스크린샷 넘기기가 아니라
보이는 그대로 짚기시연을 멈추고 바로 그 컴포넌트에 코멘트 — 코드와 Dok에 앵커됩니다
느낌이 아니라 판정각 작업은 증거와 승인, 그리고 같은 세션에서 갱신되는 문서로 닫힙니다

준비 중입니다 — Live Docs 다음에 나옵니다. Pro는 자기 앱에서 돌리고, 누구나 샘플 리뷰로 먼저 체험할 수 있습니다.

06 · 토대

썩지 않는 이해.

믿을 수 없는 문서는 없느니만 못합니다. 네 가지 보증이 이해를 정직하게 지켜서, 기대어도 되게 만듭니다.

anchored

모든 문장이 코드를 인용합니다

소스 앵커는 import 그래프에서 결정적으로 주입됩니다. 모델이 지어내지 않습니다. 전체 프로덕션 실행에서 환각 앵커 0.

drift-aware

낡은 문서는 낡았다고 말합니다

각 Dok은 아래 깔린 코드의 logic_hash를 품습니다. 코드가 움직이면 Studio, Live Docs, MCP 어디서든 stale로 표시되고, doklo sync 한 번이면 따라잡습니다.

human-approved

검토 없이는 아무것도 나가지 않습니다

AI는 초안을 쓰고, 기록은 사람이 만듭니다. stable 파이프라인은 사람이 명시적으로 승인한 Dok만 렌더하고, 당신의 수정은 재생성에서 살아남습니다.

yours

소스는 당신 것으로 남습니다

소스 코드는 분석이 도는 동안만 일시 클론되고, 저장되지 않으며, 잡이 끝나면 파기됩니다. Hub는 명시적으로 연결한 것만 저장합니다. 발행·MCP·drift 감지가 서 있는 전제입니다.

07 · 에이전트

에이전트도
같은 진실을 읽습니다.

Cursor와 Claude Code가 Hub를 MCP로 조회합니다. 상태, 신선도, 소스 앵커까지 함께요. 답변은 Dok을 인용하고 Dok은 코드를 인용합니다. 낡은 README가 방에서 제일 똑똑한 존재이던 시절은 끝납니다.

CursorClaude Code모든 MCP 클라이언트
agent › doklo.search_doks("환불 보류")
← CHKT-CHECKOUT · active · fresh
  규칙: 주문 생성은 웹훅에서만
  앵커: 7 files · 사람이 검토함

AI가 만든 것을,
사람이 이해하게.

repo를 연결하고, 도클로가 Dok 초안을 쓰는 걸 지켜보고, 클라이언트에게 건넬 도움말 페이지를 발행하세요.

라이브 데모 체험하기 →

9월 중 오픈 예정 · 지금 라이브 제품을 둘러보세요