pdd-kit의 개요
Itai Gendler의 pdd-kit는 그가 Product-Driven Development라고 부르는 방식을 위한 오픈소스 툴킷입니다. 기능마다 명세를 쓰는 대신, 저장소에 제품을 엔터티, 인터페이스, 도메인, 기능, 여정, 비즈니스 규칙, 변형으로 기술하는 product-model/ 디렉터리 하나를 둡니다. 에이전트와 사람이 이 공유 모델을 읽고, 검증 단계가 코드를 그것과 대조합니다.
npx pdd-toolkit install로 설치하며, 모델을 둘러보는 Nuxt 기반 보고서 UI와 완성된 칸반 보드 예제 같은 청사진을 제공합니다. 저자는 이를 spec-kit, OpenSpec 같은 명세 주도 개발 도구와 대비시킵니다. 그것들은 변경마다 버릴 명세를 쓰지만, pdd-kit는 코드 옆에 살아 있는 모델 하나를 유지합니다.
저장소는 MIT 라이선스이며 GitHub 스타는 약 97개이고, pdd-toolkit npm 패키지는 0.38.0(2026년 10월 25일)입니다. 2026년 7월에 만든 관리자 한 명의 새 프로젝트입니다.
pdd-kit, 쓸 만한 가치가 있습니까?
pdd-kit의 전제는 제품이 이미 티켓, 문서, 채팅, 코드에 흩어져 존재하며, 코딩 에이전트마다 이를 매번 처음부터 다르게 재구성한다는 것입니다. 답은 그 제품을 git으로 추적하는 모델로 한 번 써 두고 에이전트가 읽게 하는 것입니다. 기능마다 새 명세를 만드는 spec-kit, OpenSpec과는 실질적으로 다릅니다. pdd-kit는 엔터티, 여정, 비즈니스 규칙을 팀 전체와 모든 에이전트가 공유하는 상시 문서로 유지합니다.
모델은 자유로운 산문이 아니라 구조화돼 있습니다. product-model/ 디렉터리는 엔터티, 인터페이스, 도메인, 기능, 여정, 비즈니스 규칙('주문당 최대 3개', '환불은 관리자만' 같은 문구), 기능 플래그나 요금제 등급을 위한 변형을 나눕니다. 보고서 UI가 이를 렌더링하고, 칸반 보드 청사진은 코드 없이 완전한 모델을 담고 있어 도입 전에 모양을 볼 수 있습니다. 모델과 코드가 같은 풀 리퀘스트에서 바뀌므로, 제품이 무엇인지와 코드가 무엇을 하는지의 어긋남이 리뷰에서 드러나도록 되어 있습니다.
무게는 모든 명세 워크플로가 지는 것과 같되 앞당겨졌을 뿐입니다. 누군가 모델을 쓰고 유지해야 하며, 에이전트가 믿기 때문에 코드보다 뒤처진 모델은 없는 것보다 나쁩니다. 완료란 코드가 승인된 모델과 일치하는 것이라는 pdd-kit 자체의 정의는 모델이 최신으로 유지될 때만 성립하며, 리뷰어의 규율 외에는 이를 강제하는 것이 없습니다.
솔직한 한계는 채택입니다. 스타 약 97개, 포크 열 개, 관리자 한 명, 빠르게 나오는 릴리스(10월 하순 0.38.0)로, 정착된 표준이 아니라 아이디어를 증명하는 초기 프로젝트입니다. 개념은 spec-kit보다 흥미롭지만 실적은 그 일부에 불과하며, 팀의 프로세스를 pdd-kit에 거는 것은 한 사람이 계속 출시한다는 데 거는 것입니다.
제 역할을 하는 곳
제품 규칙이 Slack과 낡은 문서 세 개에 흩어진 엔지니어 네 명의 SaaS 팀
제품이 실제로 어떻게 동작하는지에 대한 단일 출처를 코딩 에이전트에 주기
npx pdd-toolkit install을 실행하고, 기존 저장소를 제품 모델로 옮기고, 에이전트가 만들기 전에 읽도록 여정과 비즈니스 규칙을 product-model/ 아래에 둡니다. 무료이며, 비용은 첫 모델을 쓰는 시간과 풀 리퀘스트마다 갱신하는 규율입니다.
청구 규칙이 복잡한 제품에 에이전트 코딩을 도입하는 테크 리드
에이전트가 환불과 세금 로직을 매번 다르게 다시 만들지 않게 하기
규칙을 모델의 비즈니스 규칙과 변형으로 담으면 검증 단계가 변경을 그것과 대조합니다. 효과는 도메인 복잡성에 비례하므로, CRUD 앱은 모델링 수고를 되찾지 못합니다.
새 프로젝트를 두고 pdd-kit와 spec-kit을 비교하는 개발자
기능별 명세와 상시 제품 모델 사이에서 결정하기
칸반 보드 청사진과 보고서 UI로 모델 형식을 본 뒤, 팀을 표준화하기 전에 스타 97개 프로젝트를 훨씬 널리 채택된 spec-kit과 따져 보십시오.
도입 전 확인할 점
- 설정
- 저장소에서 npx pdd-toolkit install을 실행한 뒤 기존 코드베이스를 제품 모델로 옮깁니다. 보고서 UI로 둘러보고, kanban-board 같은 청사진이 형식을 보여 줍니다. 요구 사항은 Node 와 지원되는 코딩 에이전트뿐입니다.
- 연동
- 코딩 에이전트 자체의 모델로 동작합니다. 에이전트를 대체하지 않고 명세 주도 도구(spec-kit, OpenSpec)와 나란히 놓입니다. 모델과 코드를 git에서 함께 검토합니다.
- 데이터와 개인정보
- 로컬에서 실행되며 Markdown을 저장소에 씁니다. 모델 내용은 에이전트의 모델 제공사로 갑니다. README에 텔레메트리 설명은 없습니다. MIT 라이선스이며 공개된 보안 권고는 없습니다.
- 대규모 사용 시 비용
- 유료 에디션은 없습니다. 실제 비용은 제품 모델을 쓰고 유지하는 일과, 변경마다 모델을 코드와 맞추는 리뷰어의 시간입니다.
- 제한
- 열린 이슈 약 14개. 관리자 한 명. 빠른 릴리스 주기로 명령이 바뀜. 실제 도메인 복잡성이 없는 제품에서는 모델링 부담이 이득보다 커서 가치가 없음.
좋은 점
- 기능마다 다시 쓰는 명세가 아닌 지속되는 제품 모델
- git 안의 구조화된 엔터티, 여정, 규칙, 변형
- 배울 수 있는 보고서 UI와 완성된 칸반 보드 청사진
- 검증 단계가 코드를 승인된 모델과 대조
아쉬운 점
- 스타 약 97개, 관리자 한 명, 실전 검증 없음
- 낡은 모델은 모델이 없는 것보다 에이전트를 더 오도함
- 빠른 릴리스 속도로 명령과 템플릿이 바뀜
- 실제 도메인 복잡성이 있는 제품에서만 부담이 보상됨
추천 대상
기능마다 쓰고 버리는 명세 대신 git 안에 살아 있는 제품 정의 하나를 원하는, 코딩 에이전트를 쓰는 팀.
