Vibe-Kanban 도입기

배경

• AI는 GPT Plus를 구독하여 사용하는 과정에서 현 회사에서 팀장님께서 api를 활용한 여러가지 툴에 대해 설명해주신 것 중
  VIBE-KANBAN이 굉장히 유용해보여 알아보고 적용해보려고 합니다.

VIBE-KANBAN이란?

• BloopAI에서 개발한 오픈소스 툴로, AI 코딩 에이전트(예: Claude Code, Gemini CLI, Codex 등)를 Kanban 보드
  형태로 관리할 수 있게 해줍니다.
• 코드 생성형 AI 에이전트(api key 기반)를 여러 개 동시에 활용하거나 순차적으로 구성하고 실행 흐름을 한눈에 관리할 수
  있도록 만들어진 칸반 보드 기반 오케스트레이션 도구입니다.

---

• 여러 AI 에이전트에 개발 업무를 맡기고, 이를 기획→실행→코드 리뷰→PR 생성 등 흐름을 시각적으로 관리할 수 있는 도구

Core Features & Capabilities

1. Kanban과 통합된 Coding Agent가 인식하는 테스크 관리

• 기존의 Kanban모델과 함께 Coding Agent가 통합된 Task는 하단과 같이 작업이 관리됩니다.
  • 코딩(테스크)에 대한 설명을 작업 생성과 함께 description을 전달합니다.
  • ai model을 사용하는 것 처럼 작업의 카테고리에 해당하는 template을 전달해 효율성 증대가 가능합니다.

2. GitHub등과의 통합

• github등과 통합되고 agent가 작업 시 브렌치를 새로 생성하여 기존의 브렌치에 영향을 주지 않고 작업을 수행합니다.
  • 이후 해당 브렌치는 create pr을 통해 생성할 시 작업자의 의도와 함께 pr을 생성하여 동료 평가를 진행할 수 있고
    이를 통해 각 작업 단위마다 의도를 명확히 하고 팀내 공유를 원활하게 하도록 도와줍니다.

3. Multi Ai Agent Integration

• 다양한 agent와 통합할 수 있고 각 agent는 기능을 세분화해 강점을 가진 부분들로 작업을 분할할 수 있습니다.
  • Code Generation
  • Test Writing
  • Bug Fixing
  • Refactoring
  • Code Review

ps.

• kanban형태로 진행되며 각 단계는 사진과 같이 나와있으며 단계별로 카드를 이동하며 부족한 내용은 다시
  ai에게 요구하여 진행할 수 있고 이러한 모든 과정들을 기록해 완전한 추적 가능성 및 재현성을 보장합니다.

VIBE-KANBAN 설치 방법

---

현재 저는 Mac Os를 기준으로 진행하고 있기 때문에 Mac Os 기반으로 설치를 진행하며 타 OS등은 공식
레퍼런스를 참고하시면 됩니다.

 

사전 준비사항

Node.js ≥ 18
pnpm ≥ 8

1. 로컬 command

npx vibe-kanban

로컬에서 터미널을 통해 해당 커맨드를 실행하고 나면 설치 및 실행까지 진행되며 random port를 통해 실행되고 웹 ui가 뜨게됩니다.

2. docker

• 공식 github링크에 dockerfile이 존재하여 추후 해당 도커파일을 기반으로 이미지를 생성하고 각 파일의 볼륨 경로를
  이해한 뒤 docker-compose.yml 예제와 함께 추가하겠습니다.

VIBE-KANBAN 실 사용 예제

 

VIBE-KANBAN은 사용자가 Task를 생성하여 각 단계별로 Task가 이동하고 이를 AI Agent가 보조하며 해당 작업을

Git에 pr을 올리는 형태로 진행이 되며 상단의 사진은 한눈에 보는 diagram이며 실제 진행해보며 각 단계를 사진과 같이
제가 각 단계에서 진행하려고 했던 의도를 명시했습니다.

 

 

Create Project를 클릭하여 하루하루 스터디를 진행하는 git 링크를 기반으로 하는 프로젝트를 생성했고 이후 별다른 템플릿은
전달하지 않은 상태로 task를 생성하여 칸반 형태로 스터디 template을 생성하는 예시 task를 진행했습니다.

 

 

위 사진처럼 최종적으로는 Done 단계에 위치를 시켰지만 Create Task를 생성하면 To Do 단계로 가거나 Create&Start를
선택하여 바로 진행하게 되면 In Progress를 넘어 In Review상태에 도달하게 되고 몇번의 수정을 거쳐 상태를 변경했습니다.

 

 

Vibe-Kanban에서 생성된 작업은 Create PR을 통해 자동으로 PR로 전환되며, GitHub에서 병합 또는 종료(Close)됩니다.
PR 생성과 Description 작성 등의 과정이 자동화되어, 동료와의 개발 협업을 보다 간결하고 효율적으로 지원합니다.

 

Reference

https://github.com/BloopAI/vibe-kanban
https://www.vibekanban.com/docs/getting-started
https://xthemadgenius.medium.com/vibe-kanban-the-visual-taskboard-built-for-ai-coding-agents-1be27c3ac8fc