task-pdca

Task-Driven Auto-PDCA workflow plugin for Claude Code.

TODO.md 기반 Task 번호로 개발을 시작하면, 6단계 PDCA 사이클이 자동으로 진행됩니다.

Features

• 6-Phase Workflow: Init → Plan → Do → Review → Check → Done
• 7-Item Code Quality Gate: sideeffect, duplication, reuse, separation of concerns, complexity, workaround, resource lifecycle
• Evidence-Based Coding: API/framework 사용 전 공식 문서 조회 강제 (상상코딩 방지)
• Impact Analysis: 코드 변경 전 모든 caller/consumer 영향 분석
• Reuse Analysis: 설계 전 기존 코드 재사용 가능 여부 탐색
• bkit Integration: bkit 설치 시 gap-detector, pdca-iterator, report-generator 자동 활용 (미설치 시 수동 fallback)
• Skill Lifecycle: 프로젝트 도메인 스펙을 Skill로 관리

Skills

Skill	Trigger	Description
/task N	"Task 10 시작", "/task 10"	PDCA 워크플로우 실행
/code-guard	공유 코드 수정 시	PRE(영향분석) + POST(품질 검증)
/skill-manage	스펙/패턴 변경 시	프로젝트 Skill 생성/수정/삭제

Installation

# GitHub에서 설치
claude plugin install https://github.com/GoodGangLabs/task-pdca

Usage

1. TODO.md 작성

프로젝트에 {project}/docs/TODO.md를 만들고 Task를 정의합니다:

## Tasks

- [ ] Task 1: 로그인 기능 구현
- [ ] Task 2: 채팅 UI 개선
- [진행중] Task 3: WebSocket 재연결 로직
- [완료] Task 4: 오디오 파이프라인 리팩토링

2. Task 시작

"Task 1 시작" 또는 "/task 1"

3. 자동 진행

Phase 0: TODO.md에서 Task 찾기 → [진행중] 상태 변경
Phase 1: 영향분석 + 재사용분석 + 문서 근거 → PLAN.md → 사용자 컨펌 대기
Phase 2: Pre-coding 체크리스트 → 구현 → DO.md
Phase 3: 7항목 코드 품질 REVIEW (전수 통과 필수)
Phase 4: 테스트 + GAP 분석 → CHECK.md
Phase 5: 보고서 → git diff --stat → 커밋 컨펌 대기

4. 사용자 개입 지점

시점	할 일
Phase 1 끝	Plan 확인 → "진행해" 또는 수정 요청
Phase 5 끝	변경 확인 → "커밋해" 또는 수정 요청

PDCA Documents

Task마다 4개 문서에 기록됩니다:

문서	단계	내용
PLAN.md	Phase 1	계획, 영향분석, 재사용분석
DO.md	Phase 2-3	구현 내용, 코드 품질 리뷰 결과
CHECK.md	Phase 4	테스트 결과, GAP 분석
ACT.md	Phase 4	갭 발견 시 수정 내역

bkit Integration

bkit 플러그인이 설치되어 있으면 Phase 4~5에서 자동 활용:

bkit Agent	역할
gap-detector	PLAN ↔ 코드 자동 대조, Match Rate % 산출
pdca-iterator	Match Rate < 90% 시 자동 수정 루프 (최대 5회)
report-generator	Plan+Do+Check 통합 보고서 자동 생성

bkit 미설치 시 기존 수동 프로세스로 동작합니다.

License

MIT