pdca

/pdca - PDCA 워크플로우

help

인자가 help이면 아래 도움말만 출력하고 실행을 중단한다:

/pdca — PDCA 워크플로우 관리

사용법:
  /pdca {subcommand} {feature}

하위 명령:
  plan      요구사항 정의 + API 초안 + 데이터 모델 초안
  design    DB 스키마 상세 + API 상세 + 패키지 구조
  do        Entity → Repo → Service → Controller → DTO → Test 구현
  analyze   설계 vs 구현 Gap 분석
  iterate   Match Rate < 90% 시 자동 수정 반복
  report    완료 보고서 생성
  status    현재 PDCA 상태 조회
  next      다음 단계 안내
  archive   완료된 feature 아카이브
  cleanup   완료된 모든 feature 일괄 아카이브
  force-stop  PDCA 미완료 차단 해제 (강제 종료)

예시:
  /pdca plan user-management
  /pdca design user-management
  /pdca do user-management
  /pdca status
  /pdca next
  /pdca force-stop
  /pdca archive user-management
  /pdca cleanup

관련 명령:
  /crud — CRUD 일괄 생성
  /test — 테스트 코드 생성
  /loop — 자동 반복 실행

하위 명령

/pdca plan {feature}

요구사항 정의 + API 초안 + 데이터 모델 초안

컨벤션: templates/shared/ask-user-convention.md 참조

1. feature명으로 PDCA 상태 파일 생성 (.pdca/{feature}.status.json)
2. spring-architect 에이전트 호출
3. AskUserQuestion 도구로 요구사항 수집 (줄글 질문 금지):
   • Q1 (header: "핵심 기능"): 주요 기능 선택 (multiSelect: true, 도메인에 맞는 선택지 동적 생성)
   • Q2 (header: "사용자 역할"): 역할 선택 (multiSelect: true, 예: 일반 사용자/관리자/게스트)
   • Q3 (header: "외부 연동"): 외부 시스템 연동 여부 (예: 없음/소셜 로그인/결제 PG/알림 서비스)
   • Q4 (header: "인증 방식"): 인증 방식 선택 (예: JWT/Session/OAuth2, 해당 시에만)
4. Plan 문서 생성 (.pdca/{feature}/plan.md):
   • 요구사항 목록
   • API 엔드포인트 초안 (Method + Path + 설명)
   • Entity 초안 (이름 + 주요 필드)
   • 기술적 고려사항
5. 상태 업데이트: plan → completed

/pdca design {feature}

DB 스키마 상세 + API 상세 + 패키지 구조

1. Plan 문서 로드 및 확인
2. 병렬 설계 — 다음 Task들을 한 메시지에서 동시에 호출:
   • Task 1 (domain-expert): DB 스키마 상세 설계 (테이블, 컬럼, 제약조건, 인덱스)
   • Task 2 (api-expert): API 상세 스펙 (Request/Response Body, 상태 코드)
3. spring-architect가 결과를 통합하여 Design 문서 생성 (.pdca/{feature}/design.md):
   • DB 테이블 스키마
   • API 상세 스펙
   • Entity 관계도
   • 패키지별 클래스 목록
   • 구현 순서
4. 상태 업데이트: design → completed

/pdca do {feature}

Entity → Repo → Service → Controller → DTO → Test 구현