ww-w-ai/bkit-claude-code

해결하는 문제

bkit는 Claude Code용 플러그인으로, AI 기반 개발을 구조화된 시스템으로 전환합니다. AI가 원래 설계나 요구사항과 일치하지 않지만 보기에 타당한 코드를 생성하는 '감성 코딩( vibes-coding)' 문제를 엄격한 검증, 컨텍스트 관리, 다중 에이전트 오케스트레이션 워크플로우를 도입함으로써 해결합니다.

작동 방식

bkit는 전용 에이전트와 품질 게이트를 사용하는 '컨텍스트 엔지니어링' 접근법을 구현합니다. 주로 세 가지 주요 명령어로 작동합니다:

• /sprint: 다중 기능 릴리스를 관리하며, AI가 집중력을 잃거나 메모리 부족에 빠지지 않도록 '컨텍스트 예산 스프린트'(일반적으로 ≤ 75K 토큰)로 분할합니다. 마스터 플랜을 사용해 세션 간 진행 상황을 추적합니다.
• /pdca: 단일 기능에 대해 '계획-실행-검증-개선' 루프를 실행합니다. PM, CTO, 개발자, QA 전문 에이전트 팀이 PRD, 설계 문서, 코드를 생성한 후 설계와 일치하는지 검증합니다.
• /control: 자율성 조절 다이얼(레벨 0-4)로, 프로세스가 완전 수동에서 완전 자율까지 다양한 수준으로 작동하도록 설정할 수 있습니다.

품질을 보장하기 위해 bkit는 품질 게이트(예: M1 matchRate)를 사용하여 설계 사양과 생성된 코드 간의 일치도를 측정합니다. 일치율이 90% 미만일 경우 시스템은 자동으로 자체 수리 사이클을 트리거합니다.

대상 사용자

• AI 코딩 초보자: 고급 엔지니어의 직관이 없어도 프로덕션 수준 소프트웨어를 배포하고 싶은 사람.
• 솔로 개발자 및 인디 빌더: 프론트엔드, 백엔드, QA, 보안을 병렬로 처리할 수 있는 '박스 안의 팀'이 필요한 사람.
• 팀 리더: 단일 AI 세션의 컨텍스트 창을 초과하는 복잡한 릴리스를 관리하는 사람.
• 영어 외 언어 사용자: 8개 언어 자동 감지 기능을 통해 다양한 언어로 요구사항을 기술할 수 있는 사용자.

주요 특징

• 컨텍스트 예산 스프린트: 프로젝트를 의존성 인식 가능한 관리 가능한 조각으로 분할하여 컨텍스트 창 오버플로우를 방지합니다.
• 코드 기반 문서화: '문서 = 코드' 철학을 따르며, 모든 기능마다 PRD, 설계, 보고서를 생성하여 검증의 계약서로 활용합니다.
• 자동 자체 수리: gap-detector와 pdca-iterator를 사용해 설계 사양에서 벗어난 코드를 자동으로 수정합니다.
• 다중 에이전트 오케스트레이션: pm-lead, cto-lead, qa-lead와 같은 전문 에이전트를 생성하여 개발 생애 주기의 다양한 단계를 처리합니다.
• 세부 품질 게이트: 7층 데이터 흐름 무결성 검사 포함 11개의 구체적인 게이트를 제공합니다.