106장
부록 F. bkit 심화 — 스킬과 개발 파이프라인
bkit의 스킬, 9단계 개발 파이프라인, 프로젝트 레벨 구분을 정리합니다.
bkit이란
bkit(Vibecoding Kit)은 Claude Code 위에 올려진 프롬프트 엔지니어링 프레임워크입니다.
Claude Code 자체는 AI가 파일을 읽고 쓰고 실행하는 도구입니다. bkit은 그 위에 개발 방법론(PDCA + 9단계 파이프라인)과 전문화된 스킬들을 얹어서, 규모 있는 프로젝트도 체계적으로 만들 수 있게 해줍니다.
이 튜토리얼에서 쓴 /pdca plan, /pdca analyze가 bkit 스킬입니다.
스킬 전체 목록
스킬은 Claude Code 채팅창에서 /스킬이름으로 실행합니다.
PDCA 워크플로우
bkit의 핵심은 /pdca 명령어입니다. 뒤에 단계명을 붙여서 사용합니다.
| 명령어 | 역할 |
|---|---|
/pdca plan <기능명> | 요구사항 인터뷰 → 계획 문서 생성 |
/pdca design <기능명> | 계획 문서 → 설계 문서 생성 (DB, API, 컴포넌트 구조) |
/pdca do <기능명> | 구현 범위 승인 후 단계별 구현 |
/pdca analyze <기능명> | 계획 대비 구현 갭 분석 보고 |
/pdca iterate <기능명> | 갭 분석 결과 자동 수정 반복 |
/pdca report <기능명> | 완료 보고서 생성 |
/pdca pm <기능명> | PM 에이전트 팀 분석 (페르소나, PRD 등) |
/pdca status | 현재 진행 상태 확인 |
/pdca next | 다음 단계 안내 |
7장에서 쓴 /pdca plan, 9장에서 쓴 /pdca analyze가 각각 Plan, Check 단계에 해당합니다.
스킬이 일반 대화와 다른 점
일반 대화는 Claude가 맥락 없이 응답합니다. 스킬은 다릅니다.
/pdca plan login을 실행하면:
/pdca plan login 입력
↓
bkit이 기획 모드로 전환
↓
요구사항 인터뷰 (무엇을 만들지 단계별로 질문)
↓
계획 문서 자동 생성 (docs/01-plan/ 폴더에 저장)
↓
체크포인트 — 진행할지 승인 요청
스킬은 .claude/ 폴더 안의 파일로 정의되어 있습니다. /bkit을 입력하면 사용 가능한 전체 명령어 목록을 볼 수 있습니다.
개발 지원 스킬
| 명령어 | 역할 |
|---|---|
/code-review <경로> | 코드 품질·버그·베스트 프랙티스 검토 |
/zero-script-qa | Docker 로그 기반 스크립트 없는 QA |
/development-pipeline | 9단계 개발 파이프라인 전체 가이드 |
/rollback | 체크포인트 생성 및 이전 상태 복원 |
/btw <제안> | 작업 중 개선 아이디어 즉시 수집 |
프로젝트 초기화 스킬
| 명령어 | 역할 |
|---|---|
/starter init <이름> | 정적 웹 프로젝트 시작 (HTML/CSS/Next.js) |
/dynamic init <이름> | 풀스택 앱 시작 (bkend.ai BaaS 연동) |
/enterprise init <이름> | 엔터프라이즈 시스템 시작 (K8s/Terraform) |
학습·설정 스킬
| 명령어 | 역할 |
|---|---|
/claude-code-learning | Claude Code 설정 및 사용법 학습 |
/skill-status | 현재 로드된 스킬 목록 확인 |
/bkit | bkit 전체 명령어 도움말 보기 |
PDCA 파이프라인
각 단계가 문서를 남기고, 그 문서가 다음 단계의 입력이 됩니다.
| 단계 | 산출물 | 명령어 |
|---|---|---|
| PM Analysis | 요구사항 문서, 페르소나 | /pdca pm |
| Plan | 계획 문서 | /pdca plan |
| Design | 설계 문서 (DB 스키마, API, 컴포넌트) | /pdca design |
| Do | 실제 구현 | /pdca do |
| Analyze(Check) | 갭 분석 보고서 | /pdca analyze |
| Act | 개선 기록 + 다음 사이클 준비 | (직접 기록) |
이 튜토리얼은 Plan → Do → Analyze → Act 네 단계만 다뤘습니다. 전체 파이프라인은 Dynamic 레벨부터 본격적으로 활용됩니다.
CTO 에이전트와 멀티 에이전트 팀
에이전트 팀이 뭔지 궁금하다면
bkit에는 CTO 에이전트라는 특별한 역할이 있습니다. 여러 전문 에이전트를 하나의 팀으로 묶어 복잡한 프로젝트를 처리하는 오케스트레이터입니다.
구조
사용자 요청
↓
CTO 에이전트 (전체 지휘)
↓ 역할 분배
├── 프론트엔드 에이전트 — UI/컴포넌트 설계
├── 백엔드 에이전트 — API/데이터베이스 설계
├── 보안 에이전트 — 취약점 검토
├── QA 에이전트 — 테스트 전략
└── 리포트 에이전트 — 결과 종합 보고
혼자서 전부 잘 하는 AI 한 명보다, 각 분야 전문가 AI들이 나눠서 검토하는 구조입니다. 결과물의 품질이 다릅니다.
이게 “에이전트 오케스트레이션”인 이유
일반적인 AI 사용은 이렇습니다.
나 → AI → 답변
에이전트 팀은 이렇습니다.
나 → CTO 에이전트 → 여러 전문 에이전트 → 각자 작업 → CTO가 종합 → 나
CTO가 “지금 이 태스크는 프론트엔드 문제야, 저 태스크는 보안 문제야”라고 판단해서 알맞은 전문가 에이전트에게 넘깁니다. 이 구조를 멀티 에이전트 오케스트레이션이라고 합니다.
언제 필요한가요
이 튜토리얼 수준(Starter)에서는 필요 없습니다. Enterprise 레벨, 즉 여러 명이 협업하고 보안·인증·인프라가 얽힌 큰 프로젝트에서 진가를 발휘합니다.
Starter → 혼자, AI 한 명과 대화
Dynamic → 혼자 또는 소규모, 여러 스킬 활용
Enterprise → CTO 에이전트가 팀 전체를 지휘
bkit 공식 사이트 → bkit.ai 에서 더 자세히 볼 수 있습니다.
프로젝트 레벨
bkit은 프로젝트 규모에 따라 세 레벨로 구분합니다.
Starter
- 오픈소스 레포 커스터마이징
- 간단한 정적 사이트 (지금 이 튜토리얼)
- 주로 쓰는 스킬:
/pdca plan,/pdca analyze - 파이프라인: Plan → Do → Check → Act
Dynamic
- API 연동이 있는 서비스
- 사용자 인증 (로그인/회원가입)
- 데이터베이스 연동
- 주로 쓰는 스킬:
/pdca plan,/pdca design,/pdca analyze - 파이프라인: PM → Plan → Design → Do → Check → Act
Enterprise
- 마이크로서비스 아키텍처
- CI/CD 파이프라인
- 보안 요구사항 (OWASP, 인증/인가)
- 대규모 팀 협업
- 전체 9단계 파이프라인
언제 다음 레벨로 가나요
다음 상황이 되면 Dynamic을 고려합니다.
- “사용자가 로그인해서 자기 데이터만 보여야 한다”
- “외부 API(날씨, 지도, 결제 등)를 연결해야 한다”
- “서버에 데이터를 저장하고 여러 기기에서 접근해야 한다”
지금 만든 라이프 위키 수준에서는 Starter로 충분합니다.
공식 문서
| 문서 | 링크 |
|---|---|
| Claude Code 공식 문서 | docs.anthropic.com/claude-code |
| bkit 공식 사이트 | bkit.ai |
| bkit GitHub (오픈소스) | github.com/popup-studio-ai/bkit-starter |