[Claude Code] bkit (Vibecoding Kit)

Claude Code용 AI 네이티브 개발 프레임워크. PDCA 방법론 + 9단계 파이프라인으로 개발 전 과정을 자동화함.
만든 곳: 팝업스튜디오(Popup Studio) | 사이트: https://www.bkit.ai

---

PDCA 방법론이 뭔지 먼저

PDCA는 1950년대 품질관리 분야에서 나온 지속적 개선 사이클임. 원래 제조업에서 불량률 줄이려고 쓰던 방법론인데, 소프트웨어 개발에도 그대로 적용됨.

  ┌──────────┐
  │  PLAN    │  ← 목표 설정, 계획 수립
  └────┬─────┘
       ↓
  ┌──────────┐
  │   DO     │  ← 계획대로 실행
  └────┬─────┘
       ↓
  ┌──────────┐
  │  CHECK   │  ← 결과 점검, 갭 분석
  └────┬─────┘
       ↓
  ┌──────────┐
  │   ACT    │  ← 개선 조치, 다음 사이클 반영
  └──────────┘
       ↓ (다시 PLAN으로)

단계	개발에 대입하면
Plan	기능 요구사항 정리, 계획 문서 작성, 설계
Do	실제 코드 구현
Check	구현 결과 검토, 설계 대비 갭 분석, 테스트
Act	미흡한 부분 수정, 리포트 작성, 다음 기능에 반영

핵심은 한 번 만들고 끝이 아니라, 계속 돌리는 루프라는 점임. bkit은 이 사이클을 AI가 자동으로 돌려주는 구조임. 개발자가 "대충 만들어줘"라고 하면 끝나는 게 아니라, AI가 계획 세우고 → 구현하고 → 스스로 점검하고 → 부족한 부분 채우는 과정을 반복함.

---

한 줄 요약

"AI한테 코드만 시키는 도구"가 아니라, 기획 → 설계 → 구현 → 검증 → 회고까지 전 과정을 AI랑 같이 체계적으로 하는 프레임워크임.

---

뭔데 이게

• Claude Code 전용 플러그인임 (Gemini CLI 버전도 있음)
• PDCA(Plan-Do-Check-Act) 방법론을 개발 워크플로에 그대로 얹은 구조임
• "프롬프트 잘 쓰기"가 아니라 Context Engineering — AI가 항상 올바른 맥락을 받을 수 있게 시스템을 설계하는 철학 기반임
• 208개 유틸 함수, 28개 스킬, 21개 에이전트가 내장돼 있음
• Apache 2.0 라이선스 오픈소스임

---

핵심 철학

개념	설명
Context over Prompts	프롬프트 잘 쓰는 것보다 AI가 받는 맥락 자체를 잘 설계하는 게 중요함
Constraints over Features	무한 설정 대신 의도적 제약 → 학습 난이도 낮추고 일관성 확보함
Document-Driven	코드 짜기 전에 반드시 계획 문서 작성 → 설계 문서 → 구현 → 갭 분석 → 리포트 순으로 흐름 강제함

---

무엇으로 구성돼 있나

bkit-claude-code/
├── .claude-plugin/    # 플러그인 메타정보
├── commands/          # 슬래시 명령어 정의
├── agents/            # 역할별 AI 에이전트
├── skills/            # 도메인 스킬 (지식 모듈)
├── hooks/             # 이벤트 자동화 (SessionStart, PreToolUse 등)
├── templates/         # 문서 템플릿
└── .claude/           # 독립 실행 가능한 Claude 설정

---

주요 구성 요소

에이전트 (21개)

• CTO Lead — 전체 아키텍처 총괄
• Frontend Architect — UI/UX 설계
• Security Architect — 보안 취약점 분석
• Product Manager — 요구사항 정리 및 우선순위
• QA Strategist — 테스트 전략
• Gap Detector — 설계-구현 간 갭 분석
• PDCA Iterator — Evaluator-Optimizer 반복 루프
• 등등

스킬 (28개)

도메인 지식 모듈. AI가 특정 영역을 더 잘 이해하게 해주는 단위임.

명령어 (주요 슬래시 커맨드)

명령어	역할
/bkit:learn-claude-code	튜토리얼 모드 — Claude Code + bkit 사용법 학습
/bkit:init-starter	Starter 레벨 프로젝트 초기화
/bkit:init-dynamic	Dynamic 레벨 프로젝트 초기화
/bkit:init-enterprise	Enterprise 레벨 프로젝트 초기화
/bkit:pdca-plan	기능 계획 문서 생성
/bkit:pdca-design	설계 문서 생성
/bkit:pdca-iterate	갭 분석 + 자동 수정 반복 (최대 5회, 90% 임계값)
/bkit:pdca-report	완료 리포트 생성

---

사용 흐름

1. 학습
   /bkit:learn-claude-code
   └─ Claude Code + bkit 기본 개념 익히기

2. 프로젝트 초기화
   규모에 맞게 선택:
   └─ Starter → Dynamic → Enterprise

3. 개발 루프 (PDCA)
   /bkit:pdca-plan
     → /bkit:pdca-design
       → 직접 구현
         → /bkit:pdca-iterate  (AI가 자동으로 갭 찾고 수정)
           → /bkit:pdca-report

---

프로젝트 레벨 3단계

레벨	대상	특징
Starter	개인 / 소규모	핵심 기능만, 빠른 시작
Dynamic	팀 / 중간 규모	에이전트 팀, 커스터마이징 가능
Enterprise	기업 / 대형 서비스	풀 파이프라인, 조직 맞춤 플레이북

---

자동화 레이어 구조

레이어	역할
hooks.json	SessionStart / PreToolUse / PostToolUse 이벤트 처리
Skill Frontmatter	스킬 단위 훅
Agent Frontmatter	에이전트 단위 훅
Description Triggers	Triggers: 키워드 매칭으로 자동 발동
Scripts (45개)	실제 Node.js 로직 실행

---

성능 지표 (공식 주장)

• MVP 개발: 기존 36개월 → **1주1개월**로 단축
• 단순 기능 구현: 수일 → 2~4시간
• 10명 팀 업무 → 1명 바이브 코더가 대체 가능 수준

---

설치

Claude Code 마켓플레이스에서 설치하거나, GitHub 레포에서 직접 .claude/ 폴더에 필요한 부분만 복사해서 씀.

• 레포: https://github.com/popup-studio-ai/bkit-claude-code
• Gemini CLI 버전: https://github.com/popup-studio-ai/bkit-gemini