bkit Vibecoding Kit 개념 정리

핵심 요약

bkit은 Claude Code 안에서 PDCA 방법론을 기반으로 개발 프로세스를 구조화해 주는 확장 도구로, 계획부터 배포·회고까지를 자동 문서화와 반복 개선 루프로 지원합니다.

마켓플레이스를 통해 설치하고, 프로젝트별 .claude/ 폴더에 일부 요소만 복사해 원하는 방식으로 커스터마이징하며, 명령어와 에이전트·스킬을 조합해 AI-네이티브 개발 워크플로를 만드는 것이 핵심입니다.

bkit이란 무엇인가

bkit은 Claude Code용 플러그인으로, "AI에게 그냥 부탁하는 개발"을 "구조화된 프로세스를 가진 개발"로 바꿔 주는 도구입니다.

이 도구의 중심에는 PDCA(Plan-Do-Check-Act)라는 고전적인 개선 사이클이 있고, 여기에 Anthropic의 에이전트 아키텍처(Evaluator-Optimizer 패턴)와 여러 자동화 스크립트, 명령어, 에이전트가 결합돼 있습니다.

결과적으로 bkit을 사용하면, 기능을 개발할 때 매번 "어떻게 시켜야 하지?"를 고민하기보다, 이미 준비된 단계별 명령어와 문서 템플릿을 통해 일관된 방식으로 개발을 진행할 수 있습니다.

bkit의 핵심 철학과 기능 구조

bkit은 크게 세 가지 축으로 이해하면 쉽습니다.

첫째, PDCA 기반 워크플로입니다. 기능을 만들 때 계획 문서를 만들고, 설계를 정리하고, 구현 후 분석·수정·보고·아카이브까지 이어지는 흐름을 하나의 체계로 제공합니다.

둘째, AI 도우미들의 집합입니다. 11개 특화 에이전트, 18개 스킬(도메인 지식), 20개 명령어, 21개 스크립트가 준비되어 있어, 단순한 "코드 자동완성"이 아니라 "개발 파이프라인 전체를 관리하는 AI 시스템"처럼 동작합니다.

셋째, Evaluator-Optimizer 패턴과 Check-Act 루프입니다. AI가 스스로 결과를 평가(Evaluate)하고 개선(Optimize)하는 반복 사이클을 돌면서, 기능 구현의 부족한 부분을 찾아 수정하는 자동 반복(갭 분석 + 수정)을 지원합니다.

프로젝트 레벨과 9단계 개발 파이프라인

bkit은 프로젝트의 규모와 복잡도에 따라 세 단계의 레벨을 가정합니다.

Starter는 정적 웹사이트, 포트폴리오처럼 HTML/CSS/JS로 만드는 간단한 프로젝트에 맞춰져 있고, Dynamic은 Next.js + BaaS 같은 풀스택 웹 앱, Enterprise는 마이크로서비스·Kubernetes·Terraform까지 포함한 대규모 시스템을 대상으로 합니다.

이들 레벨에서 공통으로 사용하는 것이 9단계 개발 파이프라인입니다. 요구 분석, 스키마 설계, 구현, 테스트, 배포 등의 단계를 PDCA와 연결해, "어디까지 진행됐고, 어떤 문서가 있으며, 다음에 무엇을 해야 하는지"를 문서와 명령어를 통해 추적 가능하게 만드는 구조입니다.

설치와 마켓플레이스 활용

bkit은 Claude Code의 마켓플레이스를 통해 설치하는 것이 기본입니다.

우선 사용자 로컬의 Claude 설정에 bkit 마켓플레이스를 추가하고, 그 안에서 bkit 플러그인을 설치하는 흐름입니다.

# 마켓플레이스 추가
/plugin marketplace add popup-studio-ai/bkit-claude-code

# 플러그인 설치
/plugin install bkit

Claude Code UI의 Marketplaces/Discover 탭에서 bkit와 bkit-starter를 보며 설치·업데이트를 관리할 수 있으며, ~/.claude/settings.json에서 플러그인 자동 업데이트를 켜둘 수도 있습니다.

{
  "plugins": {
    "autoUpdate": true
  }
}

폴더 구조와 구성 요소 이해

bkit은 여러 타입의 구성 요소로 나뉘어 있고, 각각 역할이 다릅니다.

루트에는 플러그인 메타정보를 담은 .claude-plugin/plugin.json, 마켓플레이스 정보인 marketplace.json, 그리고 중앙 설정 파일인 bkit.config.json이 있습니다.

commands/에는 슬래시 명령 정의가, agents/에는 특정 역할을 맡은 AI 에이전트 정의가, skills/에는 도메인 지식과 컨텍스트가 들어 있습니다.

hooks/와 scripts/는 특정 이벤트(예: 명령 실행 전후)에 연동되는 자동화 스크립트를 담고, templates/는 계획서·설계서·분석 보고서 등 문서 형태를 통일하는 템플릿을 제공합니다.

커스터마이징: 프로젝트에 맞게 바꾸는 방법

bkit의 중요한 특징은 "원본 플러그인은 유지하되, 필요한 부분만 내 프로젝트에 덮어써 쓰는" 방식의 커스터마이징입니다.

Claude Code는 설정과 구성 요소를 불러올 때, 프로젝트의 .claude/ 폴더 → 사용자 전역 ~/.claude/ → 플러그인 설치 경로 순으로 우선순위를 둡니다.

즉, 플러그인 설치 경로에 있는 파일 중 일부를 프로젝트 내 .claude/로 복사해 수정하면, 그 파일만 커스텀 버전으로 작동하고 나머지는 그대로 플러그인 기본값을 사용합니다.

# 플러그인 설치 위치 확인
ls ~/.claude/plugins/bkit/

# 원하는 스킬 파일만 프로젝트로 복사
mkdir -p .claude/skills/starter
cp ~/.claude/plugins/bkit/skills/starter/SKILL.md .claude/skills/starter/

이렇게 복사된 파일은 플러그인 업데이트가 되어도 덮어쓰지 않으며, 삭제하면 다시 플러그인의 기본 정의가 사용됩니다.

조직에서 공용 템플릿, 에이전트 성격, 명령어 동작을 바꾸고 싶을 때 이 패턴을 사용하면 됩니다.

주요 명령어와 실제 사용 흐름

bkit을 실제로 쓸 때는 주로 슬래시 명령어를 통해 기능을 호출합니다.

학습용으로는 Claude Code 사용법과 bkit 개념을 설명해 주는 명령을 사용할 수 있습니다.

/bkit:learn-claude-code

프로젝트를 초기화할 때는 만든 서비스 수준에 맞춰 다음 명령을 선택합니다.

/bkit:init-starter      # 정적 웹사이트
/bkit:init-dynamic      # 풀스택 + BaaS
/bkit:init-enterprise   # 마이크로서비스 + K8s

PDCA 워크플로를 따라 진행할 때는 기능 단위로 계획·설계·반복 개선·분석·보고·아카이브를 호출합니다.

/bkit:pdca-plan {feature}      # 기능 계획 문서 생성
/bkit:pdca-design {feature}    # 설계 문서 생성
/bkit:pdca-iterate {feature}   # 평가-최적화 반복
/bkit:pdca-analyze             # 전체 갭 분석
/bkit:pdca-report              # 완료 보고서
/bkit:archive {feature}        # 완료된 문서 아카이브

이 흐름을 반복하다 보면, 기능별로 문서와 코드, 개선 히스토리가 함께 축적되는 "AI-네이티브 개발 일지"가 자연스럽게 만들어집니다.

언어 지원과 설정 방식

bkit은 사용자의 언어를 두 가지 방식으로 처리합니다.

하나는 트리거 키워드입니다. 예를 들어 "정적 웹", "초보자", "API 설계" 같은 한국어 표현을 사용하면, 이를 바탕으로 사용 목적을 추론해 적절한 레벨이나 스킬을 선택합니다. 이는 영어·한국어·일본어·중국어·스페인어·프랑스어·독일어·이탈리아어 등 8개 언어에서 동작합니다.

다른 하나는 응답 언어 설정입니다. Claude Code의 설정 파일 어디에서든 language 값을 지정하면, Claude가 기본적으로 어떤 언어로 답할지를 고정할 수 있습니다.

{
  "language": "korean"
}

이 설정은 .claude/settings.local.json(개인용), .claude/settings.json(프로젝트 공용), ~/.claude/settings.json(전역) 중 어느 곳에 두느냐에 따라 적용 범위가 달라집니다.

트리거 키워드는 어느 언어로 쓰든 상관없고, language는 "답변 언어를 강제하는 스위치"라고 이해하면 됩니다.

개발 외 활용 가능성

bkit은 기본적으로 소프트웨어 개발을 위한 도구지만, 그 안의 개념 일부는 비개발 영역에도 응용할 수 있습니다.

예를 들어 PDCA 흐름 자체는 프로젝트 관리, 업무 프로세스 개선, 학습 계획 수립 등 "계획-실행-점검-개선"이 필요한 어떤 활동에도 그대로 적용 가능합니다.

또한 설계 문서, 계획 문서, 분석 보고서 템플릿들은 "어떤 일을 구조적으로 정리해 쓰는 법"의 좋은 예시가 되므로, 비개발 프로젝트를 계획할 때 참고 프레임워크로 사용할 수 있습니다.

다만 일반적인 글쓰기, 리서치, 일상 업무라면 bkit 없이 순수 Claude Code만 사용하는 것이 더 단순하고 편리하다는 점도 함께 명시되어 있습니다.

라이선스, 기여, 조직 도입 시 유의점

bkit은 Apache License 2.0으로 배포되며, 재배포 시 NOTICE 파일을 포함해야 합니다.

공식 저장소에 기여하고 싶다면 GitHub의 CONTRIBUTING 가이드를 따르며, main 브랜치는 보호되어 있어 PR 리뷰 후에만 병합되는 방식으로 운영됩니다.

인사이트

bkit은 "AI에게 똑똑하게 시키는 법"이 아니라 "AI와 함께 일하는 프로세스 자체를 설계하는 도구"에 가깝습니다.

개인 개발자는 작은 프로젝트라도 /bkit:pdca-plan → /bkit:pdca-design → 구현 → /bkit:pdca-iterate → /bkit:pdca-report 흐름을 한 번 경험해 보면, 문서와 코드가 함께 쌓이는 느낌을 체감할 수 있습니다.

조직 입장에서는 에이전트, 스킬, 템플릿을 커스터마이징해 "우리 회사용 개발 플레이북"을 Claude Code 안에 구현하는 방식으로 도입하는 것이 좋으며, 처음엔 Starter 레벨부터 시작해 Dynamic/Enterprise로 점진적으로 확장하는 전략이 부담을 줄여 줍니다.

출처 및 참고:

https://github.com/popup-studio-ai/bkit-claude-code