pai-zero 0.10.3 → 0.11.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/README.md +100 -16
  2. package/dist/bin/pai.js +1028 -405
  3. package/dist/bin/pai.js.map +1 -1
  4. package/dist/cli/index.js +1028 -405
  5. package/dist/cli/index.js.map +1 -1
  6. package/package.json +1 -1
package/README.md CHANGED
@@ -4,15 +4,87 @@
4
4
 
5
5
  ---
6
6
 
7
+ ## 사용자 시나리오
8
+
9
+ ### A. 처음 설치하고 나서
10
+
11
+ ```bash
12
+ npm install -g pai-zero
13
+ pai # ← 환영 화면 + 다음 단계 안내 자동 출력
14
+ ```
15
+
16
+ ### B. 새 프로젝트 시작 (모드 3단계 선택)
17
+
18
+ ```bash
19
+ pai init my-app
20
+ # ? 어떤 수준의 프로젝트인가요?
21
+ # 🧪 prototype 빠른 검증 (아이디어·UI 목업·컨셉 시연)
22
+ # 🔬 poc PoC 웹개발 (동작 데모·기본 기능 구현)
23
+ # 🏭 production 운영 서비스 (테스트·QA·배포·모니터링)
24
+ ```
25
+
26
+ 선택에 따른 플러그인 매트릭스:
27
+
28
+ | 플러그인 | prototype | poc | production |
29
+ |---|:-:|:-:|:-:|
30
+ | github | ✓ | ✓ | ✓ |
31
+ | openspec | ✓ | ✓ | ✓ |
32
+ | roboco | ✓ | ✓ | ✓ |
33
+ | omc | — | ✓ | ✓ |
34
+ | vercel | — | opt | opt |
35
+ | gstack | — | — | ✓ |
36
+ | harness | — | — | ✓ |
37
+ | supabase | — | — | opt |
38
+
39
+ ### C. 기존 PAI 프로젝트에서 재실행
40
+
41
+ ```bash
42
+ pai init # 또는 pai status
43
+ # 현재 모드: prototype
44
+ # ? 어떤 작업을 할까요?
45
+ # 📊 AI 개발 준비도 평가 (pai grade — 6카테고리 점수)
46
+ # ➕ 플러그인 추가·모드 승격 (pai add — prototype → poc → production)
47
+ # 🩺 환경 점검 (pai check — Node/Git/Claude/OMC)
48
+ ```
49
+
50
+ ### D. 모드 승격
51
+
52
+ ```bash
53
+ pai add
54
+ # 현재 모드: prototype
55
+ # 다음 단계: poc
56
+ # 승격 시 추가되는 플러그인: omc, vercel
57
+ # ? poc 수준으로 승격하시겠어요? (y/N)
58
+ ```
59
+
60
+ ### E. CI 품질 게이트
61
+
62
+ ```bash
63
+ pai grade --fail-under 70 --output report.md
64
+ # 70점 미만이면 exit 1 — GitHub Actions에서 PR 블록 가능
65
+ ```
66
+
67
+ ---
68
+
69
+ ## v0.11 변경 사항 (Breaking)
70
+
71
+ - **OMC 설치 방식 전환**: 기존 `npx -y github:Yeachan-Heo/oh-my-claudecode install` 호출을 제거하고, Claude Code 네이티브 플러그인 마켓플레이스에 등록하는 방식으로 바꿨습니다.
72
+ - PAI는 `~/.claude/settings.json`에 `extraKnownMarketplaces.omc`와 `enabledPlugins["oh-my-claudecode@omc"]`만 안전 병합합니다. 실제 설치는 Claude Code 기동 시 자동으로 수행됩니다.
73
+ - **이점**: 공급망 안전성↑, 버전 고정 가능, 사내망/Windows 호환성↑, 제거 단순화.
74
+ - 등록 실패 시 사용자에게 수동 명령 `/plugin install Yeachan-Heo/oh-my-claudecode` 안내만 제공합니다 (npx 폴백 없음).
75
+ - **명령어 이름 정리**(예정): `pai env setup → add`, `doctor → check`, `evaluate → grade`, `validate → test`, `pipeline → run`, `/pai install → /pai add`. v0.12에서 alias 도입, v0.13에서 구 명령어 제거 예정.
76
+
77
+ ---
78
+
7
79
  ## 빠른 시작
8
80
 
9
81
  ```bash
10
82
  npx pai-zero init # 프로젝트 초기화
11
- npx pai-zero evaluate # 품질 평가
12
- npx pai-zero pipeline # 전체 파이프라인 실행
83
+ npx pai-zero grade # 품질 평가 (구: evaluate)
84
+ npx pai-zero run # 전체 파이프라인 실행 (구: pipeline)
13
85
  ```
14
86
 
15
- > 설치 후에는 `pai init`, `pai evaluate` 등 짧은 명령어도 사용 가능합니다.
87
+ > 설치 후에는 `pai init`, `pai grade` 등 짧은 명령어도 사용 가능합니다.
16
88
 
17
89
  ---
18
90
 
@@ -25,31 +97,43 @@ Environment → Design → Execution → Validation → Evaluation
25
97
 
26
98
  | 단계 | 명령어 | 설명 |
27
99
  |------|--------|------|
28
- | Environment | `pai init` / `pai env setup` | 프로젝트 분석, 인터뷰, 설정 생성 |
100
+ | Environment | `pai init` / `pai add` | 프로젝트 분석, 인터뷰, 설정 생성 |
29
101
  | Design | `pai design init` / `pai design validate` | OpenSpec PRD + OMC 관리 |
30
102
  | Execution | Claude Code에서 직접 수행 | OMC 기반 AI 코드 생성 |
31
- | Validation | `pai validate` | gstack 테스트 + harness 검증 |
32
- | Evaluation | `pai evaluate` | 6카테고리 가중 점수 (vibe-ready) |
103
+ | Validation | `pai test` | gstack 테스트 + harness 검증 |
104
+ | Evaluation | `pai grade` | 6카테고리 가중 점수 (vibe-ready) |
33
105
 
34
106
  ---
35
107
 
36
- ## 명령어
108
+ ## 명령어 (v0.11+)
37
109
 
38
110
  ```bash
39
111
  npx pai init # 초기화 (신규/기존 자동 감지)
40
- npx pai env setup # 환경 설정 (플러그인 추가)
41
- npx pai env doctor # 환경 헬스 체크
42
- npx pai env status # 프로젝트 상태
112
+ npx pai add # 플러그인 추가 (Mockup → Production)
113
+ npx pai check # 환경 점검 (Node/Git/Claude Code/OMC)
114
+ npx pai status # 프로젝트 상태
115
+ npx pai help # 명령어 안내
43
116
  npx pai design init # PRD/OMC 템플릿 생성
44
117
  npx pai design validate # PRD 완성도 검증
45
- npx pai validate # 테스트 / 하네스 검증
46
- npx pai evaluate # AI 품질 평가
47
- npx pai evaluate --fail-under 70 # CI 모드 (점수 미달 시 exit 1)
48
- npx pai evaluate --verbose # 상세 findings 출력
49
- npx pai pipeline # 전체 5단계 실행
50
- npx pai pipeline --from validation # 특정 단계부터 실행
118
+ npx pai test # 테스트 / 하네스 검증
119
+ npx pai grade # AI 품질 평가
120
+ npx pai grade --fail-under 70 # CI 모드 (점수 미달 시 exit 1)
121
+ npx pai grade --verbose # 상세 findings 출력
122
+ npx pai run # 전체 5단계 파이프라인 실행
123
+ npx pai run --from validation # 특정 단계부터 실행
51
124
  ```
52
125
 
126
+ ### 구 명령어 호환 (v0.13 까지 유지, 경고 1회 출력)
127
+
128
+ | 구 | 신 |
129
+ |---|---|
130
+ | `pai env setup`, `pai install` | `pai add` |
131
+ | `pai env doctor` | `pai check` |
132
+ | `pai env status` | `pai status` |
133
+ | `pai validate` | `pai test` |
134
+ | `pai evaluate` | `pai grade` |
135
+ | `pai pipeline` | `pai run` |
136
+
53
137
  ---
54
138
 
55
139
  ## 품질 평가 (6카테고리)