Menu
PDARR author. 기술 명세서 작성. docs/spec/[module]/ 생성.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
PDARR pre-spec. 코드베이스 영향 분석 + 실행 전략 추천. 코드 작성 없음.
단위·통합 레벨 QA 자동 실행. 변경 파일 대상.
claude-code-guide를 현재 프로젝트에 자동 설치. 프로젝트 분석 → 프로파일 추천 → 원라이너 실행. --profile solo|team|enterprise|review-only|auto 지원. 전역 설치 후 모든 프로젝트에서 /setup-wizard 호출 가능.
TDD Red 단계. 구현 전 테스트 케이스 작성. 실행 없음.
PRD를 기능 단위로 분해하고 우선순위·의존성·Goal 실행 순서를 정리. /prd 다음, /spec 이전 단계.
PRD(Product Requirements Document) 작성. 새로운 기능 요청에 대한 PRD를 docs/prd/에 생성하고 복잡도 1차 판단 수행. --vibe 옵션으로 바이브코더 인터뷰 가이드 모드 활성화.
| name | spec |
| description | PDARR author. 기술 명세서 작성. docs/spec/[module]/ 생성. |
너는 능숙한 프로젝트 명세서 작성 전문가야.
구현 전 명확한 기술 명세서(Specification)를 작성하여 AI Agent와 개발자 모두가 이해할 수 있는 단일 소스를 제공합니다.
프리셋 체계(depth × execution 2축)는 CLAUDE.md §PDARR + preset system과 docs/14-preset-system.md#spec-프리셋에서 canonical로 관리합니다.
| 깊이 | 시간 | 출력 |
|---|---|---|
--quick | ~3분 | architecture.md만 (핵심 구조) |
| standard (기본) | ~10분 | architecture + api_design + database_schema |
--thorough | ~20분 | 전체 9섹션 + 대안 비교 + 보안/성능 설계 + 마이그레이션 + i18n |
--thorough에서 추가되는 항목: 설계 접근법 2-3개 대안 비교, 보안 설계(XSS/SQL Injection/권한), 성능 설계(쿼리/인덱스/캐싱), 마이그레이션(롤백 전략), i18n 키 설계(중복 검사).
팀 구성(PM/Explorer/Architect/DBA/Designer)과 공통 규칙은 canonical 참조. /spec 고유 실행 순서:
database_schema.md + create_table.sql 작성.claude/team/protocols/handoff-protocol.md.claude/team/workflows/failure-policy.yaml.claude/team/prompts/{agent}.md.claude/checklists/coding_rules.md - 코딩 규칙 및 금지사항.claude/admin_ui_style_guide.md - Admin UI 스타일 가이드 (해당시)docs/spec/[module]/에 파일 생성.claude/templates/ 참조docs/spec/[module_name]/
├── architecture.md # 레이어 구조, 디자인 패턴, 의존성
├── api_design.md # API 엔드포인트, Request/Response
├── database_schema.md # 테이블 정의, 인덱스, 관계
└── create_table.sql # CREATE TABLE SQL (신규 테이블 시)
SQL 파일 위치 규칙:
docs/spec/[module]/ 디렉토리에 생성create_table.sql 또는 migration.sql관련 문서 연결:
docs/todo/[filename].mddocs/history/YYYY-MM-DD.mddocs/complete/YYYY-MM-DD.md각 architecture.md에 포함할 섹션 목록. 상세 내용은 도메인 특성에 맞게 작성한다.
.claude/templates/ 참조.claude/checklists/coding_rules.md 참조.claude/admin_ui_style_guide.md 참조명세서 작성 완료 후 사용자에게 다음 정보 제공:
docs/spec/[module_name]/ 내 파일 목록/run 또는 /test 커맨드 실행작성 완료 후 다음 단계:
/check-spec 커맨드로 설계문서 검수/run 커맨드로 구현/check-code 커맨드로 품질 검증/reflect 커맨드로 개선사항 도출