기술 검증 명령

사용자 입력 (선택적)

text

$ARGUMENTS

선택적 입력:

•비어있음: analysis.md 기반으로 자동 판단 및 검증 수행
•있음: 사용자 지시사항 반드시 고려 (예: 특정 검증 방법 지정, 추가 확인 사항)

개요

•
전제조건 확인:
- •docs/work/{name}/analysis.md 존재 확인
- •없으면 오류: "/workflow-analyze를 먼저 실행하세요"
•
분석 문서 로드:
- •analysis.md에서 선택된 접근법 추출
- •핵심 기술적 가정 및 위험 요소 식별
•
검증 방법 결정:
- •
  상황에 맞는 검증 접근법 선택:
  - •프로토타입 구현
  - •UI/UX 검증 (Playwright MCP)
  - •TDD 방식
  - •라이브러리/API 탐색
  - •기술 문서 조사
  - •사용자 검증 위임
•
검증 실행:
- •선택한 검증 방법 수행
- •필요 시 __prototype__/{feature-name}/에 프로토타입 코드 생성
- •결과 및 증거 수집
•
결과 평가:
- •상태 판단: ✅ 성공 / ⚠️ 부분 성공 / ❌ 실패
- •발견사항 및 제약사항 문서화
•
문서 작성:
- •docs/work/{name}/validation.md 생성 (한글)
- •명확한 다음 단계 권장사항 포함

핵심 규칙

📝 문서 작성 언어

중요: 모든 문서는 한글로 작성해야 합니다.

🎯 검증 원칙

•핵심 위험 요소만 집중: 핵심 기술적 불확실성만 검증
•실용적 접근: 완벽한 검증보다 충분한 확신
•명확한 판단: 성공/실패 명시 + 다음 단계 제시

✅ 해야 할 것

•불확실한 것만 검증
•최소한의 작동 코드 생성 (프로토타입)
•모든 발견사항 명확히 문서화
•실행 가능한 다음 단계 제공
•맥락 파악 위해 analysis.md 참조
•__prototype__/ 디렉토리에 프로토타입 저장

❌ 하지 말아야 할 것

•전체 구현 (execute 단계용)
•자명한/알려진 사실 검증
•analysis.md 내용 반복
•애매한 결론 ("아마도 될 것 같다")
•과도한 검증

🔬 검증 방법 선택

불확실성 유형별 선택:

불확실성 유형	검증 방법	산출물
핵심 로직 실현성	프로토타입 구현	작동 코드 + 결과
UI/UX 변경	Playwright 검증	스크린샷 + 테스트 결과
복잡한 알고리즘	TDD 방식	테스트 코드 + 엣지 케이스
외부 의존성	라이브러리 탐색	샘플 코드 + 호환성
표준/패턴	문서 조사	요약 + 권장사항
환경 특수성	사용자 위임	테스트 가이드 + 체크리스트

📁 프로토타입 코드 관리

위치: __prototype__/{feature-name}/

작성 방법:

•실제 코드베이스에서 직접 검증 (파일 수정 OK)
•검증 완료 후 핵심 로직만 __prototype__/에 정리
•실제 코드는 커밋하지 않음 (원상복구 또는 그대로 둬도 됨)

목적:

•plan/execute 단계에서 참고용
•검증된 핵심 로직 보관
•기술적 실현 가능성 증명

문서 템플릿

생성할 파일:

생성할 파일: docs/work/{작업명}/validation.md (한글)

템플릿 A: AI 완료 검증

markdown

# 기술 검증 보고서

## 🎯 검증 목표

**핵심 질문**: [검증하려는 기술적 불확실성]
**검증 범위**: [검증 대상 및 제외 사항]

---

## 🔬 검증 방법

**선택한 방법**: [프로토타입/테스트/조사 등]
**검증 환경**: [사용한 도구 및 설정]

---

## 📊 검증 결과

**상태**: ✅ 성공 / ⚠️ 부분 성공 / ❌ 실패

**핵심 발견사항**:

- [주요 발견 1]
- [주요 발견 2]

---

## 💡 발견된 사항

### 긍정적 요소

- [예상대로 작동하는 부분]
- [추가로 발견한 장점]

### 제약사항/리스크

- [기술적 제약]
- [성능 이슈]
- [호환성 문제]

---

## 🛠️ 프로토타입 코드 (생성한 경우)

**위치**: `__prototype__/{feature-name}/`

**핵심 구현**:

- [구현한 핵심 로직 설명]
- [테스트 방법 및 결과]

---

## ✅ 권장사항

**다음 단계**: `/workflow-plan` 진행 / `/workflow-analyze` 재검토

**구현시 주의사항**:

- [주의사항 1]
- [주의사항 2]

📊 검증 상태 가이드라인

✅ 성공 기준

•모든 핵심 기술적 가정 검증됨
•차단 이슈 없음
•구현 경로 명확
•다음: /workflow-plan 진행

⚠️ 부분 성공 기준

•주요 접근법은 작동하나 제약 존재
•우회 방법 또는 대안 가능
•트레이드오프 수용 가능
•다음: 제약사항 문서화, 사용자 확인 필요

❌ 실패 기준

•핵심 접근법 실현 불가능
•우회 방법 없는 차단 이슈
•근본적인 가정 무효
•다음: /workflow-analyze 재검토 필요

실행

이제 위 지침에 따라 검증 작업을 시작하세요.