NotesAI / bkit / Workflow / PM

bkit: AI 개발에 계획과 검증을 연결하는 방법

bkit의 PDCA 흐름을 바탕으로 요구사항, 구현, 검증을 연결하는 AI 개발 작업 방식을 정리합니다.

AI로 개발하다 보면 코드는 빠르게 늘어나는데, 무엇을 완료했다고 봐야 할지는 오히려 흐려질 때가 있습니다. 대화가 길어지면서 처음의 요구사항이 빠지기도 하고, 화면이 동작한다는 이유만으로 작업을 끝내기도 합니다.

이때 필요한 것은 요청을 더 많이 입력하는 일이 아니라, 요청과 결과를 연결하는 기준입니다. bkit은 이런 관점에서 살펴볼 만한 도구입니다.

bkit은 어떤 도구인가

bkit은 Claude Code에서 체계적인 개발 흐름을 지원하는 플러그인입니다. 핵심 개념 중 하나는 **PDCA(Plan–Do–Check–Act)**입니다. 계획을 세우고, 실행하고, 결과를 확인한 뒤, 발견한 차이를 다음 수정에 반영하는 방식입니다.

이 글은 bkit의 PDCA를 중심으로 작업 관리 방법을 설명합니다. Claude Code용 플러그인을 Codex에서 그대로 실행하는 설치 가이드는 아닙니다. 다른 개발 도구에서도 계획과 검증을 문서로 연결하는 원칙은 참고할 수 있지만, 명령어와 자동화 기능의 지원 여부는 별도로 확인해야 합니다.

시작할 때 완료 조건을 적는다

“검색 기능을 개선해줘”라는 요청만으로는 작업 범위가 분명하지 않습니다. 속도를 높이는 것인지, 결과를 읽기 쉽게 만드는 것인지, 검색 실패를 줄이는 것인지부터 정해야 합니다.

예를 들어 검색 화면을 개선한다면 다음처럼 계획을 구체화할 수 있습니다.

  • 사용자가 검색어를 입력하고 결과를 확인할 수 있다.
  • 결과가 없을 때 현재 상태와 다음 행동을 안내한다.
  • 키보드만으로 검색과 결과 이동이 가능하다.
  • 모바일에서도 입력창과 주요 동작을 사용할 수 있다.

이 목록은 설명 자료이면서 검증 기준입니다. 구현 전에 작성해 두면 AI가 어느 부분까지 처리해야 하는지, 사람이 무엇을 확인해야 하는지 같은 문장으로 이야기할 수 있습니다.

계획, 구현, 검증을 연결한다

PDCA를 적용한다고 해서 처음부터 많은 문서를 만들 필요는 없습니다. 작업의 크기에 맞춰 필요한 정보를 남기면 됩니다.

기록 남길 내용
계획 해결할 문제, 작업 범위, 완료 조건
설계 화면 흐름, 데이터 처리, 예외 상황
구현 상태 완료한 항목과 남은 항목
검증 결과 확인 방법, 실제 결과, 발견한 문제
후속 조치 수정할 내용과 다시 확인할 항목

작은 수정은 하나의 문서 안에 모두 적어도 됩니다. 여러 사람이 함께하거나 작업이 길어지면 문서를 나누고 서로 연결하는 편이 좋습니다.

중요한 것은 파일 개수가 아니라 추적 가능성입니다. 어떤 요구사항 때문에 코드를 바꿨는지, 그 변경이 기대한 결과를 냈는지 다시 확인할 수 있어야 합니다.

Check에서는 실행 결과를 남긴다

AI가 “완료했습니다”라고 답한 것은 검증 결과가 아닙니다. 빌드 성공도 모든 요구사항을 충족했다는 뜻은 아닙니다.

검색 기능이라면 정상 결과뿐 아니라 빈 검색어, 결과 없음, 긴 검색어, 오류 상황도 확인해야 합니다. 화면 작업이라면 표시 상태와 함께 클릭, 키보드 이동, 작은 화면에서의 사용성을 살펴봐야 합니다.

검증 기록에는 가능하면 세 가지를 남깁니다. 무엇을 확인했는지, 어떻게 확인했는지, 결과가 어땠는지입니다. 확인하지 못한 항목은 미확인으로 표시합니다. 그러면 다음 작업자가 완료된 부분과 추가 확인이 필요한 부분을 구분할 수 있습니다.

점수보다 빠진 요구사항을 본다

자동 분석이나 체크리스트에서 높은 점수가 나오더라도, 평가 항목이 부실하면 실제 품질을 설명하기 어렵습니다. 예를 들어 파일이 존재하는지만 확인하는 기준으로는 사용자가 기능을 끝까지 사용할 수 있는지 알 수 없습니다.

“일치율 90%” 같은 숫자를 사용할 때는 무엇을 기준으로 계산했는지 함께 봐야 합니다. 빠진 10%가 핵심 기능일 수도 있습니다. 점수는 참고 자료로 두고, 충족하지 못한 요구사항과 그 영향을 확인하는 편이 실용적입니다.

Act 단계에서는 발견한 문제를 수정하고 해당 항목을 다시 검증합니다. 작업 중 새로 생긴 아이디어는 기존 누락 사항과 구분해 범위가 계속 커지는 것을 막습니다.

문서도 유지 비용이 있다

모든 변경에 같은 절차를 적용하면 관리 작업이 구현보다 커질 수 있습니다. 문구 한 줄 수정과 새로운 결제 흐름 개발에 필요한 검증 깊이는 다릅니다.

작업이 작다면 완료 조건과 확인 결과만 간단히 남겨도 됩니다. 영향 범위가 크거나 되돌리기 어려운 변경이라면 설계와 검증 기록을 더 자세히 작성합니다. 코드가 바뀌었는데 문서가 그대로라면 다음 작업에 잘못된 기준을 줄 수 있으므로 함께 갱신해야 합니다.

bkit을 이해할 때 유용한 관점은 AI가 일을 마쳤다고 말하는 시점보다, 사람이 결과를 판단할 수 있는 상태를 만드는 과정에 주목하는 것입니다. 계획에서 적은 문장이 검증 결과까지 이어지면 대화가 길어져도 작업의 목적을 놓치기 어려워집니다.

UI·UX 작업의 판단 기준은 UI UX Pro Max: AI에게 UI·UX 개선 기준을 주는 방법에서 이어서 정리했습니다.


참고: bkit 공식 저장소. 설치 방식과 지원 기능은 공식 문서에서 확인할 수 있습니다.