BlueKiwi — Claude Code에 워크플로를 이식한 오픈소스 AX 솔루션
단테랩스 단태가 AX 컨설팅 현장에서 부딪힌 “워크플로 자산화” 문제를 해결하기 위해 만든 오픈소스 프로젝트. Claude Code / Codex 같은 자율 에이전트에 n8n 스타일 워크플로 레일을 깔아주는 하네스 엔진.
메타
- 발표자: 단테(단테랩스)
- 업로드: 2026-04-17
- 길이: 39분
- 링크: https://youtu.be/ByWdkxs8BUw
- GitHub / 사이트: bluekiwi.work
문제 정의 — 왜 만들었나
기업 AX 컨설팅 현장에서 반복되는 패턴:
- Claude Code, Codex 같은 도구는 다운로드시켜 줄 수 있다.
- 그러나 팀의 자산으로 만드는 것은 어렵다.
- 같은 업무라도 어제 결과와 오늘 결과가 다르다.
- A가 쓸 때와 B가 쓸 때 품질이 다르다 → 시스템이 아닌 개인기.
진단: “워크플로가 자산화되지 않는다”가 본질 문제. 각자의 AI 활용 역량에 기대는 구조라 사람이 바뀌면 노하우도 사라진다.
기존 시도의 한계
| 도구 | 강점 | 한계 |
|---|---|---|
| Claude Code의 Skills | 일관된 그라운드 룰 설정, 결과 통제 가능 | 항상 같은 결과를 보장하지는 못함 |
| n8n 같은 노코드 워크플로 | 시각적, 비개발자 친화 | 노드의 틀에 가두면 에이전트의 자율적 판단력이 사라짐 |
→ 단계별 지침은 주되, 각 단계 안에서는 자율성을 부여해야 한다. 이를 “하네스(Harness)“라 부른다.
핵심 비유: 지하철 vs 오프로드 지프 vs 고속도로
- n8n = 지하철/트램: 레일을 벗어나지 않지만 자유도 0
- Claude Code 단독 = 오프로드 지프: 어디든 가지만 목적지에 못 닿을 수도 있음
- BlueKiwi = 고속도로: 자율 에이전트가 포장도로를 따라가게 만들어 일관성과 퍼포먼스를 동시에 확보
BlueKiwi 아키텍처
노드 3종 (= 에이전트에게 지침을 하달하는 단계)
n8n의 노드는 “코드 실행 단위”지만 BlueKiwi의 노드는 에이전트에게 주는 지침 단위.
| 노드 타입 | 역할 | 비유 |
|---|---|---|
| 액션(Action) | 사람 개입 없이 자동 실행 | n8n의 일반 노드와 유사 |
| 게이트(Gate) | 사람이 확인·선택·의사 결정 ([[wiki/concepts/human-in-the-loop | HITL]]) |
| 루프(Loop) | 조건 충족까지 질문·답변 반복 | 소크라테스식 명확화 질문 |
웹 UI 구성
| 항목 | n8n 대응 |
|---|---|
| Workflows | Workflows |
| Tasks | Executions |
| Credentials | Credentials |
| 지침(Instructions) | Node와 동일 개념 — Skill에 가까움 |
지침은 재사용 가능한 조각으로 누적해두면 노드에 가져다 쓸 수 있다.
실행 모델
- BlueKiwi는 CLI + 서버로 동작 (
bluekiwi start→ localhost:3102) - 개인용: SQLite 내장, Docker 불필요
- 팀용: Docker 기반 셀프 호스팅
- Claude Code / Codex / Cursor / Antigravity 등 Skill + MCP 지원 도구라면 모두 연동 가능
- API 키 발급 → 인라인 설치 명령 1줄 → MCP·Skill 자동 설치
데모 — YouTube → Threads 자동 포스팅 워크플로
라이브 시연한 전체 파이프라인:
BK design슬래시 명령으로 워크플로 디자인 (요구사항을 Typeless 음성 전사로 입력)- URL 입력 → 자막 추출 → 핵심 인사이트 3개 추출 → 쓰레드 초안 + 해시태그 생성 → 비주얼 셀렉션 게이트 (목업 렌더링) → 사용자 승인 → 발행
- 워크플로 자동 생성 시점에 노드 타입(액션/게이트)을 사용자가 선택
BK start한 마디로 실행, 가장 적합한 워크플로를 시스템이 자동 추천- 워크플로 종료 시 단계별 코멘트로 개선 사항을 DB에 기록 →
BK improve로 자동 개선
비교 발언: “순수 Claude Code만으로 같은 작업을 하면 시행착오가 많고 정립까지 오래 걸리지만, BlueKiwi를 쓰면 헤매지 않고 절차대로 간다 → 업무 효율 극단적 개선.”
부가 도구 추천: Typeless
- 음성을 텍스트로 전사하되 머뭇거림·중복·외래어 혼용을 자동 정제
- 한국어 STT 품질 우수, 사전 기능으로 전문 용어 정확 전사
- 무료 (주당 8,000 단어)
- 모바일·카카오톡에서도 활용 가능
→ 바이브 코딩 초기 브레인스토밍 단계에서 강력 추천.
핵심 명제 (IDEAS)
- AX의 본질은 워크플로의 자산화 + 팀 단위 내제화다.
- 결정론 시스템에는 하네스가 필요 없다 — 자율 에이전트가 있을 때만 필요.
- 하네스 = 자율성을 살리면서 목표 궤도로 끌어오는 가드레일.
- Skills는 그라운드 룰까지, 워크플로는 단계별 절차까지 보장한다.
- n8n의 노드 ≠ BlueKiwi의 노드 → 후자는 “에이전트 지침 단위”로 재정의.
- HITL은 게이트, 명확화는 루프 — 사람 개입을 두 형태로 분리.
- 워크플로 설계 자체를 바이브 코딩으로 끝낸다 → 학습 곡선 제거.
- 비주얼 셀렉션 게이트로 UI 검토 단계를 워크플로에 자연스럽게 삽입.
- 워크플로 1.0은 완성품이 아니다 — 코멘트 → improve 루프로 진화.
- 팀 공유 워크플로 라이브러리(bluekiwi.work)가 조직 자산화의 핵심.
INSIGHTS
- AX = 도구 도입이 아니라 워크플로 내제화. 결국 “팀 단위 하네스”를 어떻게 만드는가가 AX 성공의 핵심 변수.
- 에이전트 + 결정론적 워크플로의 결합은 하네스 엔지니어링의 한 구현으로, Hermes·Superpowers·OpenClaw와 같은 계열의 진화 방향.
- 한국형 AX 컨설팅 현장의 페인 포인트가 그대로 제품 설계에 녹아 있어, 사내 AI 코칭·교육 커리큘럼에 즉시 응용 가능.
QUOTES
“워크플로가 자산화가 안 되니까 사람이 바뀌면 품질도 같이 바뀐다. A가 하면 잘 되는데 B가 하면 결과가 달라진다.”
“에이전트에게 단계별로 어떤 지침서를 주되 그 각 단계 안에서는 자율성을 부여해 주는 것 — 그것을 다른 말로 하네스라고 부른다.”
“n8n을 쓰면 지하철을 타는 것과 같다. 자유도가 없지만 레일을 벗어나지 않는다. Claude Code는 오프로드 지프 — 어디든 갈 수 있지만 목적지에 못 닿으면 의미가 없다. BlueKiwi는 그 사이에 고속도로를 내준다.”
“n8n의 노드는 코드를 실행하는 노드이지만, BlueKiwi의 노드는 에이전트에게 하나의 지침을 하달하는 단계다.”
“AX가 다른 게 없다. 팀 단위로 하네싱이 될 수 있도록 해주면 된다. 지식 내제화를 도와줄 수 있는 AI 사용법, 그게 이제 핵심이다.”
REFERENCES
- 사람·조직: 단테(단테랩스), Dante’s Datalab
- 도구: BlueKiwi, n8n, Claude Code, Codex, Cursor, Antigravity, Typeless
- 컨셉: 하네스 엔지니어링, Node-based Workflow, HITL, 워크플로 자산화, AX(AI Transformation), 바이브 코딩
- 사이트: bluekiwi.work (워크플로 공유 커뮤니티)
HABITS / RECOMMENDATIONS
- 반복 패턴 업무부터 BlueKiwi 워크플로로 옮겨보기.
- 단계별 코멘트 →
BK improve루프를 3회만 돌려도 완성도 높은 워크플로 생성 가능 (발표자 경험). - 워크플로 설계 단계에서 음성 입력(Typeless) +
BK design조합으로 초기 모호함을 빠르게 정리. - 팀 적용 시: 설정 > 팀 관리 > 팀원 초대(이메일) → 같은 워크플로 공유.
- bluekiwi.work에 본인 워크플로를 publish하여 커뮤니티와 학습 자산 공유.
운영 적용 메모 (개인용)
- DAP 관점: 운영요청·장애 대응 같은 반복 패턴 업무에 액션+게이트 노드 조합으로 표준 절차 자산화 가능 — Claude Code 기반 운영 보조 흐름 구축에 직접 활용.
- 교육 관점: AX 전임 교수 커리큘럼에서 “하네스 엔지니어링” 모듈의 데모 도구로 BlueKiwi 후보. n8n(결정론) → Claude Code(자율) → BlueKiwi(혼합) 3단 비교 슬라이드 구성 가능.
- 연관 작업: jyp-garden의
/ingest,/blog-write같은 스킬 자체가 이미 같은 사상의 워크플로 자산화 시도 — BlueKiwi 노드 모델과 비교 분석할 가치 있음.
원본
- 자막 파일:
00-Inbox/youtube/ByWdkxs8BUw.ko-orig.vtt - 정제 텍스트:
00-Inbox/youtube/ByWdkxs8BUw.cleaned.txt