단테랩스AI/ML

BlueKiwi: Claude Code를 위한 워크플로우 엔진 및 에이전트 제어 시스템

자율 AI 에이전트의 유연성과 결정론적 워크플로우의 일관성을 결합하여 업무 자동화의 품질을 보장하는 오픈소스 플랫폼 BlueKiwi를 소개합니다.

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

핵심 요약

BlueKiwi는 에이전트에게 단계별 지침(Harness)을 제공하여 누가 실행해도 동일한 품질의 결과가 나오도록 돕습니다. MCP와 스킬 연동을 통해 터미널 기반 에이전트를 웹 UI에서 설계한 워크플로우대로 제어할 수 있습니다.

배경

AI 도입 현장에서 개인의 역량에 따라 결과물의 품질이 달라지는 '워크플로우 자산화'의 어려움을 해결하기 위해 개발되었습니다.

대상 독자

Claude Code 등 AI 코딩 도구를 실무에 도입하려는 개발자 및 기업 내 AX 담당자

의미 / 영향

BlueKiwi는 개인의 프롬프트 엔지니어링 역량에 의존하던 AI 활용 방식을 조직 차원의 자산화된 워크플로우 방식으로 전환시킨다. 이를 통해 기업은 에이전트 도입 시 발생하는 품질 불균형 문제를 해결하고 표준화된 AI 업무 프로세스를 구축할 수 있다. 오픈소스 프로젝트로서 커뮤니티의 워크플로우 공유를 통해 에이전트 활용의 진입장벽을 낮추는 역할을 할 것으로 기대된다.

챕터별 상세

01:41

AX 현장의 현실과 워크플로우 자산화 문제

기업들이 AI를 도입할 때 겪는 가장 큰 문제는 개인의 AI 활용 역량에 따라 결과물의 품질이 들쭉날쭉하다는 점이다. 체계적인 시스템이 부재하면 사람이 바뀔 때마다 노하우가 사라지고 거버넌스 유지가 불가능해진다. 이를 해결하기 위해 유연한 '스킬'과 고정된 '워크플로우'를 결합하는 시도가 필요하다. 자율 에이전트의 판단력을 활용하면서도 일관된 결과를 보장하는 시스템 구축이 AX의 핵심이다.

03:28

BlueKiwi의 핵심 개념: 하네스(Harness) 엔지니어링

에이전트가 스스로 절차를 따르도록 설계하는 구조를 '하네스'라고 정의한다. 기존 n8n이 코드를 직접 실행하는 방식이라면, BlueKiwi는 노드가 에이전트에게 지침을 전달하는 방식을 취한다. 이는 에이전트의 유연한 판단력을 극대화하면서도 정해진 레일(고속도로) 위를 달리게 하여 목적지에 정확히 도달하게 만든다. 하네스는 CLAUDE.md, 스킬, MCP 서버, 워크플로우 지침 등 다양한 요소로 구성된다.

05:34

BlueKiwi의 3가지 노드 타입

워크플로우를 구성하는 노드는 Action, Gate, Loop 세 가지로 나뉜다. Action은 에이전트가 사람의 개입 없이 자동으로 작업을 수행하는 단계이다. Gate는 사람이 직접 확인하고 승인하거나 수정 요청을 내리는 HITL(Human-In-The-Loop) 단계이다. Loop는 특정 조건이 충족될 때까지 사용자에게 질문을 던져 컨텍스트를 확보하는 소크라테스식 대화 단계이다. 이 세 조합으로 어떤 복잡한 업무 흐름도 설계 가능하다.

07:24

BlueKiwi 설치 및 로컬 환경 세팅

npm을 통해 간편하게 설치할 수 있으며 SQLite를 내장하여 별도의 DB 설정 없이 즉시 실행 가능하다. `npm install -g bluekiwi` 명령어로 설치 후 `bluekiwi start`를 입력하면 로컬 서버가 구동된다. 웹 UI(localhost:3102)에 접속하여 관리자 계정을 생성하면 대시보드 기능을 사용할 수 있다. 팀 단위 협업이 필요한 경우에는 도커(Docker)를 이용한 셀프 호스팅 방식도 지원한다.

bash

npm install -g bluekiwi
bluekiwi start

BlueKiwi를 전역으로 설치하고 서버를 실행하는 명령어

12:45

에이전트 연동을 위한 MCP 및 스킬 설정

Claude Code나 Codex 같은 외부 도구와 연동하기 위해 API 키를 발급받고 초기화 과정을 거친다. 웹 UI 설정 메뉴에서 API 키를 생성한 후 터미널에서 `bluekiwi init` 명령어를 실행하여 연동한다. 이 과정에서 에이전트가 BlueKiwi 서버와 통신할 수 있도록 MCP 서버와 전용 스킬들이 자동으로 설치된다. 설치가 완료되면 `/bk-help` 명령어를 통해 사용 가능한 스킬 목록을 확인할 수 있다.

15:40

음성 입력을 활용한 워크플로우 설계 데모

Typeless라는 AI 음성 받아쓰기 도구를 활용하여 복잡한 요구사항을 말로 설명하고 워크플로우를 생성한다. 유튜브 URL을 입력받아 자막을 추출하고 인사이트를 정리하여 Threads 포스팅 초안을 만드는 과정을 설계했다. Claude Code 터미널에서 `/bk-design` 명령과 함께 구어체 요구사항을 전달하면 AI가 자동으로 노드 구조를 제안한다. 생성된 워크플로우는 웹 UI에서 시각적으로 확인하고 세부 지침을 수정할 수 있다.

Typeless는 불필요한 추임새를 제거하고 전문적인 텍스트로 변환해주는 AI 딕테이션 앱이다.

bash

claude --dangerously-skip-permissions

Claude Code 실행 시 BlueKiwi 에이전트에게 제어권을 넘기기 위해 권한 확인을 건너뛰는 옵션

24:46

실전 워크플로우 실행 및 피드백 루프

설계된 워크플로우를 `/bk-start` 명령어로 실행하면 에이전트가 단계별로 작업을 수행한다. 각 단계의 진행 상황은 웹 UI에서 실시간 타임라인으로 모니터링할 수 있다. Gate 노드에서는 에이전트가 생성한 결과물을 웹에서 직접 확인하고 '승인' 또는 '수정 요청'을 보낼 수 있다. 작업 완료 후에는 설문을 통해 워크플로우의 만족도를 기록하며, `/bk-improve` 명령어로 지침을 지속적으로 개선하여 품질을 높인다.

text

/bk-design [워크플로우 요구사항]

Claude Code 터미널에서 새로운 워크플로우 설계를 요청하는 명령어

실무 Takeaway

에이전트의 자율성에만 의존하지 말고 BlueKiwi의 Harness 구조를 통해 단계별 지침을 제공해야 일관된 품질을 얻을 수 있다
Gate 노드를 활용하여 자동화 프로세스 중간에 인간의 검토(HITL) 단계를 배치함으로써 실무 적용 가능한 수준의 안전성을 확보할 수 있다
워크플로우 실행 후 발생하는 피드백을 DB에 축적하고 이를 기반으로 지침을 지속적으로 개선하는 '개선 루프'가 AX 성공의 핵심이다
MCP 프로토콜을 통해 터미널 기반의 에이전트 도구들을 웹 UI 기반의 시각적 워크플로우 엔진과 결합하여 관리 효율성을 높일 수 있다

언급된 리소스

GitHubBlueKiwi GitHub

DemoBlueKiwi Community

문서BlueKiwi 소개 슬라이드

AI 분석 전체 내용 보기

AI 요약 · 북마크 · 개인 피드 설정 — 무료

출처 · 인용 안내

원문 발행 2026. 04. 17.수집 2026. 04. 18.출처 타입 YOUTUBE

인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.