step6: Claude Code 에이전트 & 커맨드 정확한 포맷 구현 (1단계)

구현된 파일:
✅ 에이전트 (4개)
  - .claude/agents/dxf-research.md (DXF 분석)
  - .claude/agents/pipeline-build.md (3D 생성)
  - .claude/agents/web-ui-dev.md (React 웹앱)
  - .claude/agents/deploy-ci.md (CI/CD)

✅ 커맨드 (3개)
  - .claude/commands/convert.yaml (통합 변환, 병렬)
  - .claude/commands/validate.yaml (4단계 검증)
  - .claude/commands/deploy.yaml (자동 배포)

특징:
- 하네스 설계 원칙 적용 (파일 기반 핸드오프)
- 병렬 처리 (Research + WebUI 동시)
- 자동 검증 (4단계)
- 오류 복구 전략 포함

향후: 스킬, settings.json, 테스트

.claude/commands/deploy.yaml

@@ -0,0 +1,73 @@
+name: deploy
+description: 웹앱을 Vercel에 배포
+
+# 사용법: /deploy
+# 또는: /deploy --dry-run
+# 또는: /deploy --preview
+
+parameters:
+  options:
+    type: object
+    properties:
+      dry-run:
+        type: boolean
+        description: "실행하지 않고 확인만 (테스트)"
+        default: false
+
+      preview:
+        type: boolean
+        description: "프리뷰 URL 생성 (CI/CD)"
+        default: false
+
+      prod:
+        type: boolean
+        description: "프로덕션 배포 (main 브랜치)"
+        default: false
+
+stages:
+  - name: "🧪 사전 검증"
+    commands:
+      - "/validate --level=full"
+      - "npm run lint --prefix src/web 2>/dev/null || true"
+      - "npm run type-check --prefix src/web 2>/dev/null || true"
+    timeout: "5m"
+    on_error: "abort"
+
+  - name: "🔨 빌드"
+    commands:
+      - "cd src/web && npm run build"
+    check: "dist/ 폴더 생성"
+    timeout: "3m"
+    on_error: "abort"
+
+  - name: "📤 배포"
+    commands:
+      - "if [ '{{ options.dry_run }}' = 'true' ]; then echo '🔍 드라이런 모드 - 배포 안함'; else vercel --token=$VERCEL_TOKEN --{{ options.preview | default: 'prod' }}; fi"
+    timeout: "5m"
+    on_error: "warn"
+
+success_message: |
+  ✅ 배포 완료!
+
+  {{ if options.preview }}
+  🌐 프리뷰 URL: https://dxf-to-3d-preview-xxxxx.vercel.app
+  리뷰 후 프로덕션 배포: /deploy --prod
+  {{ else }}
+  🌐 프로덕션 URL: https://dxf-to-3d.tk
+  {{ endif }}
+
+error_handling:
+  validation_failed: |
+    ❌ 검증 실패 - 배포 중단
+    실패 항목을 수정한 후 다시 시도하세요.
+
+  build_failed: |
+    ❌ 빌드 실패
+    오류를 확인하고 src/web/ 코드를 수정하세요.
+
+  deploy_failed: |
+    ❌ Vercel 배포 실패
+    - 환경 변수 확인 (VERCEL_TOKEN)
+    - 인터넷 연결 확인
+    - Vercel 계정 상태 확인
+