moai-adk 0.3.1__py3-none-any.whl → 0.3.3__py3-none-any.whl

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.

Potentially problematic release.

This version of moai-adk might be problematic. Click here for more details.

Files changed (37) hide show
  1. moai_adk/__init__.py +1 -1
  2. {moai_adk-0.3.1.dist-info → moai_adk-0.3.3.dist-info}/METADATA +152 -147
  3. {moai_adk-0.3.1.dist-info → moai_adk-0.3.3.dist-info}/RECORD +6 -37
  4. moai_adk/templates/.claude/agents/alfred/cc-manager.md +0 -474
  5. moai_adk/templates/.claude/agents/alfred/code-builder.md +0 -534
  6. moai_adk/templates/.claude/agents/alfred/debug-helper.md +0 -302
  7. moai_adk/templates/.claude/agents/alfred/doc-syncer.md +0 -175
  8. moai_adk/templates/.claude/agents/alfred/git-manager.md +0 -200
  9. moai_adk/templates/.claude/agents/alfred/project-manager.md +0 -152
  10. moai_adk/templates/.claude/agents/alfred/spec-builder.md +0 -256
  11. moai_adk/templates/.claude/agents/alfred/tag-agent.md +0 -247
  12. moai_adk/templates/.claude/agents/alfred/trust-checker.md +0 -332
  13. moai_adk/templates/.claude/commands/alfred/0-project.md +0 -523
  14. moai_adk/templates/.claude/commands/alfred/1-spec.md +0 -531
  15. moai_adk/templates/.claude/commands/alfred/2-build.md +0 -413
  16. moai_adk/templates/.claude/commands/alfred/3-sync.md +0 -552
  17. moai_adk/templates/.claude/hooks/alfred/README.md +0 -238
  18. moai_adk/templates/.claude/hooks/alfred/alfred_hooks.py +0 -165
  19. moai_adk/templates/.claude/hooks/alfred/core/__init__.py +0 -79
  20. moai_adk/templates/.claude/hooks/alfred/core/checkpoint.py +0 -271
  21. moai_adk/templates/.claude/hooks/alfred/core/context.py +0 -110
  22. moai_adk/templates/.claude/hooks/alfred/core/project.py +0 -284
  23. moai_adk/templates/.claude/hooks/alfred/core/tags.py +0 -244
  24. moai_adk/templates/.claude/hooks/alfred/handlers/__init__.py +0 -23
  25. moai_adk/templates/.claude/hooks/alfred/handlers/compact.py +0 -51
  26. moai_adk/templates/.claude/hooks/alfred/handlers/notification.py +0 -25
  27. moai_adk/templates/.claude/hooks/alfred/handlers/session.py +0 -80
  28. moai_adk/templates/.claude/hooks/alfred/handlers/tool.py +0 -71
  29. moai_adk/templates/.claude/hooks/alfred/handlers/user.py +0 -41
  30. moai_adk/templates/.claude/output-styles/alfred/agentic-coding.md +0 -635
  31. moai_adk/templates/.claude/output-styles/alfred/moai-adk-learning.md +0 -691
  32. moai_adk/templates/.claude/output-styles/alfred/study-with-alfred.md +0 -469
  33. moai_adk/templates/.claude/settings.json +0 -135
  34. moai_adk/templates/CLAUDE.md +0 -733
  35. {moai_adk-0.3.1.dist-info → moai_adk-0.3.3.dist-info}/WHEEL +0 -0
  36. {moai_adk-0.3.1.dist-info → moai_adk-0.3.3.dist-info}/entry_points.txt +0 -0
  37. {moai_adk-0.3.1.dist-info → moai_adk-0.3.3.dist-info}/licenses/LICENSE +0 -0
moai_adk/__init__.py CHANGED
@@ -4,5 +4,5 @@
4
4
  SPEC-First TDD Framework with Alfred SuperAgent
5
5
  """
6
6
 
7
- __version__ = "0.3.1"
7
+ __version__ = "0.3.3"
8
8
  __all__ = ["__version__"]
{moai_adk-0.3.1.dist-info → moai_adk-0.3.3.dist-info}/METADATA RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: moai-adk
3
- Version: 0.3.1
3
+ Version: 0.3.3
4
4
  Summary: MoAI Agentic Development Kit - SPEC-First TDD with Alfred SuperAgent
5
5
  Project-URL: Homepage, https://github.com/modu-ai/moai-adk
6
6
  Project-URL: Repository, https://github.com/modu-ai/moai-adk
@@ -48,7 +48,7 @@ Description-Content-Type: text/markdown
48
48
 
49
49
  **안내**: MoAI-ADK는 모두의AI 연구실에서 집필 중인 "(가칭) 에이전틱 코딩" 서적의 별책 부록 오픈 소스 프로젝트입니다.
50
50
 
51
- ![MoAI-ADK CLI Interface](https://github.com/modu-ai/moai-adk/raw/main/docs/public/moai-tui_screen-light.png)
51
+ ![MoAI-ADK CLI Interface](https://github.com/modu-ai/moai-adk/raw/main/docs/public/MoAI-ADK-cli_screen.png)
52
52
 
53
53
  > **"SPEC이 없으면 CODE도 없다."**
54
54
 
@@ -56,7 +56,7 @@ Description-Content-Type: text/markdown
56
56
 
57
57
  ## 목차
58
58
 
59
- - [v0.3.0 주요 개선사항](#-v030-주요-개선사항)
59
+ - [v0.3.x 주요 개선사항](#-v03x-주요-개선사항)
60
60
  - [Meet Alfred](#-meet-alfred---10개-ai-에이전트-팀)
61
61
  - [AI 모델 선택 가이드](#-ai-모델-선택-가이드)
62
62
  - [Quick Start](#-quick-start-3분-실전)
@@ -70,7 +70,7 @@ Description-Content-Type: text/markdown
70
70
 
71
71
  ---
72
72
 
73
- ## 🆕 v0.3.0 주요 개선사항
73
+ ## 🆕 v0.3.x 주요 개선사항
74
74
 
75
75
  ### 🚀 핵심 기능 강화
76
76
 
@@ -170,9 +170,9 @@ moai-adk update
170
170
 
171
171
  ---
172
172
 
173
- ## ▶◀ Meet Alfred - 10개 AI 에이전트 팀
173
+ ## 🎩 Meet Alfred - 10개 AI 에이전트 팀
174
174
 
175
- 안녕하세요, 모두의AI SuperAgent **▶◀ Alfred**입니다!
175
+ 안녕하세요, 모두의AI SuperAgent **🎩 Alfred**입니다!
176
176
 
177
177
  ![Alfred Logo](https://github.com/modu-ai/moai-adk/raw/main/docs/public/alfred_logo.png)
178
178
 
@@ -186,7 +186,7 @@ moai-adk update
186
186
  - **Agentic Coding 적용**: 10개 AI 에이전트 팀이 자율적으로 SPEC 작성, TDD 구현, 문서 동기화 수행
187
187
  - **투명성**: 완벽하지 않은 부분을 숨기지 않고, 커뮤니티와 함께 개선해나가는 오픈소스
188
188
 
189
- ### ▶◀ Alfred가 제공하는 4가지 핵심 가치
189
+ ### 🎩 Alfred가 제공하는 4가지 핵심 가치
190
190
 
191
191
  #### 1️⃣ 일관성 (Consistency)
192
192
  **SPEC → TDD → Sync** 3단계 파이프라인으로 플랑켄슈타인 코드 방지
@@ -226,13 +226,13 @@ Alfred는 **작업 특성**에 따라 각 에이전트에 최적 모델을 할
226
226
 
227
227
  **빠른 응답이 필요한 반복 작업 및 패턴 매칭**
228
228
 
229
- | 에이전트 | 역할 | 왜 Haiku? |
230
- |---------|------|-----------|
231
- | **doc-syncer** 📖 | 문서 동기화 | 패턴화된 문서 업데이트, Living Document 생성 |
232
- | **tag-agent** 🏷️ | TAG 시스템 관리 | 반복적 패턴 매칭, TAG 체인 검증 |
233
- | **git-manager** 🚀 | Git 워크플로우 | 정형화된 Git 명령어 실행, 브랜치/PR 생성 |
234
- | **trust-checker** ✅ | TRUST 원칙 검증 | 규칙 기반 체크리스트 확인 |
235
- | **Explore** 🔍 | 코드베이스 탐색 | 대량 파일 스캔, 키워드 검색 |
229
+ | 에이전트 | 역할 | 왜 Haiku? |
230
+ | ------------------- | --------------- | -------------------------------------------- |
231
+ | **doc-syncer** 📖 | 문서 동기화 | 패턴화된 문서 업데이트, Living Document 생성 |
232
+ | **tag-agent** 🏷️ | TAG 시스템 관리 | 반복적 패턴 매칭, TAG 체인 검증 |
233
+ | **git-manager** 🚀 | Git 워크플로우 | 정형화된 Git 명령어 실행, 브랜치/PR 생성 |
234
+ | **trust-checker** ✅ | TRUST 원칙 검증 | 규칙 기반 체크리스트 확인 |
235
+ | **Explore** 🔍 | 코드베이스 탐색 | 대량 파일 스캔, 키워드 검색 |
236
236
 
237
237
  **장점**:
238
238
  - ⚡ **속도 2~5배 향상**: 실시간 응답 (수 초 → 1초 이내)
@@ -243,13 +243,13 @@ Alfred는 **작업 특성**에 따라 각 에이전트에 최적 모델을 할
243
243
 
244
244
  **복잡한 판단과 창의적 설계가 필요한 작업**
245
245
 
246
- | 에이전트 | 역할 | 왜 Sonnet? |
247
- |---------|------|-----------|
248
- | **spec-builder** 🏗️ | SPEC 작성 | EARS 구조 설계, 복잡한 요구사항 분석 |
249
- | **code-builder** 💎 | TDD 구현 | 아키텍처 설계, 복잡한 리팩토링 |
250
- | **debug-helper** 🔬 | 디버깅 | 오류 원인 분석, 해결 방법 도출 |
251
- | **cc-manager** 🛠️ | Claude Code 설정 | 워크플로우 최적화, 복잡한 설정 |
252
- | **project-manager** 📋 | 프로젝트 초기화 | 전략 수립, 복잡한 의사결정 |
246
+ | 에이전트 | 역할 | 왜 Sonnet? |
247
+ | --------------------- | ---------------- | ------------------------------------ |
248
+ | **spec-builder** 🏗️ | SPEC 작성 | EARS 구조 설계, 복잡한 요구사항 분석 |
249
+ | **code-builder** 💎 | TDD 구현 | 아키텍처 설계, 복잡한 리팩토링 |
250
+ | **debug-helper** 🔬 | 디버깅 | 오류 원인 분석, 해결 방법 도출 |
251
+ | **cc-manager** 🛠️ | Claude Code 설정 | 워크플로우 최적화, 복잡한 설정 |
252
+ | **project-manager** 📋 | 프로젝트 초기화 | 전략 수립, 복잡한 의사결정 |
253
253
 
254
254
  **장점**:
255
255
  - 🎯 **높은 품질**: 복잡한 코드 품질 보장
@@ -258,14 +258,14 @@ Alfred는 **작업 특성**에 따라 각 에이전트에 최적 모델을 할
258
258
 
259
259
  ### 사용 시나리오별 권장 모델
260
260
 
261
- | 시나리오 | 권장 모델 | 이유 |
262
- |---------|----------|------|
263
- | 🆕 **새 프로젝트 시작** | Sonnet | SPEC 설계, 아키텍처 결정 필요 |
264
- | 🔄 **반복 개발** | Haiku | 이미 정해진 패턴 반복 구현 |
265
- | 🐛 **버그 수정** | Sonnet | 원인 분석 및 해결 방법 도출 |
266
- | 📝 **문서 작성** | Haiku | Living Document 동기화 |
267
- | 🔍 **코드 탐색** | Haiku | 파일 검색, TAG 조회 |
268
- | ♻️ **리팩토링** | Sonnet | 구조 개선, 복잡한 변경 |
261
+ | 시나리오 | 권장 모델 | 이유 |
262
+ | ---------------------- | --------- | ----------------------------- |
263
+ | 🆕 **새 프로젝트 시작** | Sonnet | SPEC 설계, 아키텍처 결정 필요 |
264
+ | 🔄 **반복 개발** | Haiku | 이미 정해진 패턴 반복 구현 |
265
+ | 🐛 **버그 수정** | Sonnet | 원인 분석 및 해결 방법 도출 |
266
+ | 📝 **문서 작성** | Haiku | Living Document 동기화 |
267
+ | 🔍 **코드 탐색** | Haiku | 파일 검색, TAG 조회 |
268
+ | ♻️ **리팩토링** | Sonnet | 구조 개선, 복잡한 변경 |
269
269
 
270
270
  ### 모델 전환 팁
271
271
 
@@ -293,67 +293,62 @@ Alfred는 **작업 특성**에 따라 각 에이전트에 최적 모델을 할
293
293
 
294
294
  ### 📋 준비물
295
295
 
296
- - ✅ Python 3.13+ 또는 uv 설치
296
+ - ✅ Python 3.13+
297
+ - ✅ **uv** (필수 - pip보다 10-100배 빠름)
297
298
  - ✅ Claude Code 실행 중
298
299
  - ✅ Git 설치 (선택사항)
299
300
 
300
301
  ### ⚡ 3단계로 시작하기
301
302
 
302
- #### 1️⃣ 설치 (30초)
303
+ #### 1️⃣ uv 설치 (필수)
304
+
305
+ **uv는 pip보다 10-100배 빠른 Python 패키지 관리자입니다** (Rust 기반).
303
306
 
304
307
  ```bash
305
- # uv 권장 (빠른 성능)
306
- pip install uv
307
- uv pip install moai-adk
308
+ # macOS/Linux
309
+ curl -LsSf https://astral.sh/uv/install.sh | sh
310
+
311
+ # Windows (PowerShell)
312
+ powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
313
+
314
+ # 설치 확인
315
+ uv --version
316
+ ```
308
317
 
309
- # 또는 pip 사용
310
- pip install moai-adk
318
+ #### 2️⃣ moai-adk 설치 (10초)
319
+
320
+ ```bash
321
+ uv pip install moai-adk
311
322
 
312
323
  # 설치 확인
313
324
  moai-adk --version
314
325
  ```
315
326
 
316
- #### 2️⃣ 초기화 (1분)
327
+ #### 3️⃣ 프로젝트 시작 (1분)
317
328
 
318
- **새 프로젝트 생성:**
329
+ **새 프로젝트:**
319
330
  ```bash
320
331
  moai-adk init my-project
321
332
  cd my-project
322
-
323
- # Claude Code 실행
324
333
  claude
325
334
  ```
326
335
 
327
- **기존 프로젝트에 설치:**
336
+ **기존 프로젝트:**
328
337
  ```bash
329
338
  cd existing-project
330
339
  moai-adk init .
331
-
332
- # Claude Code 실행
333
340
  claude
334
341
  ```
335
342
 
336
- **Claude Code에서 프로젝트 초기화 (필수):**
343
+ **Claude Code에서 초기화:**
337
344
  ```text
338
345
  /alfred:0-project
339
346
  ```
340
347
 
341
- Alfred가 자동으로:
342
- - `.moai/project/` 문서 3종 생성 (product/structure/tech.md)
343
- - 언어별 최적 도구 체인 설정
344
- - 프로젝트 컨텍스트 완벽 이해
345
-
346
- #### 3️⃣ 첫 기능 개발 (1분 30초)
347
-
348
- **Claude Code에서 3단계 워크플로우:**
348
+ **첫 기능 개발:**
349
349
  ```text
350
- # SPEC 작성
351
- /alfred:1-spec "JWT 기반 사용자 로그인 API"
352
-
353
- # TDD 구현
350
+ /alfred:1-spec "사용자 인증 기능"
354
351
  /alfred:2-build AUTH-001
355
-
356
- # 문서 동기화
357
352
  /alfred:3-sync
358
353
  ```
359
354
 
@@ -368,15 +363,11 @@ Alfred가 자동으로:
368
363
 
369
364
  ---
370
365
 
371
- ## ⬆️ 업그레이드 가이드 (v0.2.x → v0.3.0)
366
+ ## ⬆️ 업그레이드 가이드 (v0.3.0 → v0.3.x)
372
367
 
373
368
  ### 1단계: 패키지 업데이트
374
369
 
375
370
  ```bash
376
- # pip
377
- pip install --upgrade moai-adk
378
-
379
- # uv 권장
380
371
  uv pip install --upgrade moai-adk
381
372
  ```
382
373
 
@@ -405,9 +396,17 @@ claude
405
396
  moai-adk status
406
397
 
407
398
  # 확인 항목
399
+ # ✅ .moai/config.json → moai.version: "0.3.x"
408
400
  # ✅ .moai/config.json → project.moai_adk_version: "0.3.x"
409
- # ✅ .moai/config.json → project.optimized: true
410
401
  # ✅ 모든 커맨드 정상 작동
402
+ # ✅ 템플릿 파일 병합 완료
403
+
404
+ ### v0.3.x 시리즈 주요 개선사항
405
+
406
+ - **Event-Driven Checkpoint**: 위험한 작업 전 자동 백업
407
+ - **BackupMerger**: 스마트 백업 병합 (사용자 파일 보존)
408
+ - **버전 추적**: 자동 버전 감지 및 최적화 안내
409
+ - **Claude Code Hooks 통합**: SessionStart, PreToolUse, PostToolUse 훅
411
410
  ```
412
411
 
413
412
  ---
@@ -519,12 +518,12 @@ moai-adk --help
519
518
 
520
519
  각 Alfred 커맨드는 적절한 에이전트를 호출하며, **자동으로 최적 모델**을 사용합니다:
521
520
 
522
- | 커맨드 | 에이전트 | 모델 | 작업 특성 | 예상 시간 |
523
- |-------|----------|------|----------|----------|
524
- | `/alfred:0-project` | project-manager 📋 | 세션 기본 모델 | 프로젝트 전략 수립, 복잡한 의사결정 | 1~2분 |
525
- | `/alfred:1-spec` | spec-builder 🏗️ | 세션 기본 모델 | EARS 명세 설계, 요구사항 분석 | 2~3분 |
526
- | `/alfred:2-build` | code-builder 💎 | 세션 기본 모델 | TDD 구현, 아키텍처 설계 | 3~5분 |
527
- | `/alfred:3-sync` | doc-syncer 📖 | **Haiku 지정** | Living Document 동기화, 패턴 기반 | 30초~1분 |
521
+ | 커맨드 | 에이전트 | 모델 | 작업 특성 | 예상 시간 |
522
+ | ------------------- | ----------------- | -------------- | ----------------------------------- | --------- |
523
+ | `/alfred:0-project` | project-manager 📋 | 세션 기본 모델 | 프로젝트 전략 수립, 복잡한 의사결정 | 1~2분 |
524
+ | `/alfred:1-spec` | spec-builder 🏗️ | 세션 기본 모델 | EARS 명세 설계, 요구사항 분석 | 2~3분 |
525
+ | `/alfred:2-build` | code-builder 💎 | 세션 기본 모델 | TDD 구현, 아키텍처 설계 | 3~5분 |
526
+ | `/alfred:3-sync` | doc-syncer 📖 | **Haiku 지정** | Living Document 동기화, 패턴 기반 | 30초~1분 |
528
527
 
529
528
  #### 온디맨드 에이전트 호출
530
529
 
@@ -547,14 +546,14 @@ moai-adk --help
547
546
 
548
547
  #### 모델별 성능 비교
549
548
 
550
- | 작업 유형 | Haiku (패스트) | Sonnet (스마트) | 실제 적용 |
551
- |---------|---------------|----------------|----------|
552
- | **SPEC 작성** | 1분 | 2~3분 | 세션 기본 모델 사용 |
553
- | **TDD 구현** | 2분 | 3~5분 | 세션 기본 모델 사용 |
554
- | **문서 동기화** | 30초 | 1~2분 | ✅ Haiku 지정 (3-sync) |
555
- | **TAG 검증** | 10초 | 30초 | ✅ Haiku 지정 (tag-agent) |
556
- | **Git 작업** | 5초 | 15초 | ✅ Haiku 지정 (git-manager) |
557
- | **디버깅** | 1분 | 2~3분 | 세션 기본 모델 사용 |
549
+ | 작업 유형 | Haiku (패스트) | Sonnet (스마트) | 실제 적용 |
550
+ | --------------- | -------------- | --------------- | -------------------------- |
551
+ | **SPEC 작성** | 1분 | 2~3분 | 세션 기본 모델 사용 |
552
+ | **TDD 구현** | 2분 | 3~5분 | 세션 기본 모델 사용 |
553
+ | **문서 동기화** | 30초 | 1~2분 | ✅ Haiku 지정 (3-sync) |
554
+ | **TAG 검증** | 10초 | 30초 | ✅ Haiku 지정 (tag-agent) |
555
+ | **Git 작업** | 5초 | 15초 | ✅ Haiku 지정 (git-manager) |
556
+ | **디버깅** | 1분 | 2~3분 | 세션 기본 모델 사용 |
558
557
 
559
558
  **핵심 설계**:
560
559
  - `/alfred:0-project`, `/alfred:1-spec`, `/alfred:2-build`: **사용자가 선택한 세션 기본 모델** 사용
@@ -679,13 +678,13 @@ Alfred가 함께 배우는 친구처럼 새로운 기술을 쉽게 설명하고,
679
678
 
680
679
  **언제 전환할까요?**
681
680
 
682
- | 상황 | 권장 스타일 | 이유 |
683
- |------|------------|------|
684
- | 🚀 **실무 개발** | Agentic Coding | Fast/Collab 자동 전환, 효율 중심 |
685
- | 📚 **MoAI-ADK 학습** | MoAI ADK Learning | SPEC-First, TAG, TRUST 개념 이해 |
686
- | 🎓 **새 기술 학습** | Study with Alfred | What-Why-How-Practice 4단계 |
687
- | 🔄 **반복 작업** | Agentic Coding (Fast) | 최소 설명, 빠른 실행 |
688
- | 🤝 **팀 협업** | Agentic Coding (Collab) | 트레이드오프 분석, 브레인스토밍 |
681
+ | 상황 | 권장 스타일 | 이유 |
682
+ | ------------------- | ----------------------- | -------------------------------- |
683
+ | 🚀 **실무 개발** | Agentic Coding | Fast/Collab 자동 전환, 효율 중심 |
684
+ | 📚 **MoAI-ADK 학습** | MoAI ADK Learning | SPEC-First, TAG, TRUST 개념 이해 |
685
+ | 🎓 **새 기술 학습** | Study with Alfred | What-Why-How-Practice 4단계 |
686
+ | 🔄 **반복 작업** | Agentic Coding (Fast) | 최소 설명, 빠른 실행 |
687
+ | 🤝 **팀 협업** | Agentic Coding (Collab) | 트레이드오프 분석, 브레인스토밍 |
689
688
 
690
689
  **스타일 전환 예시**:
691
690
  ```text
@@ -711,59 +710,59 @@ Alfred는 **17개 주요 프로그래밍 언어**를 지원하며, 각 언어에
711
710
 
712
711
  #### 백엔드 & 시스템 (8개)
713
712
 
714
- | 언어 | 테스트 프레임워크 | 린터/포매터 | 빌드 도구 | 타입 시스템 |
715
- |------|------------------|-------------|----------|------------|
716
- | **Python** | pytest | ruff, black | uv, pip | mypy |
717
- | **TypeScript** | Vitest, Jest | Biome, ESLint | npm, pnpm, bun | Built-in |
718
- | **Java** | JUnit | Checkstyle | Maven, Gradle | Built-in |
719
- | **Go** | go test | gofmt, golint | go build | Built-in |
720
- | **Rust** | cargo test | rustfmt, clippy | cargo | Built-in |
721
- | **Kotlin** | JUnit | ktlint | Gradle | Built-in |
722
- | **PHP** | PHPUnit | PHP CS Fixer | Composer | PHPStan |
723
- | **Ruby** | RSpec | RuboCop | Bundler | Sorbet |
713
+ | 언어 | 테스트 프레임워크 | 린터/포매터 | 빌드 도구 | 타입 시스템 |
714
+ | -------------- | ----------------- | --------------- | -------------- | ----------- |
715
+ | **Python** | pytest | ruff, black | uv, pip | mypy |
716
+ | **TypeScript** | Vitest, Jest | Biome, ESLint | npm, pnpm, bun | Built-in |
717
+ | **Java** | JUnit | Checkstyle | Maven, Gradle | Built-in |
718
+ | **Go** | go test | gofmt, golint | go build | Built-in |
719
+ | **Rust** | cargo test | rustfmt, clippy | cargo | Built-in |
720
+ | **Kotlin** | JUnit | ktlint | Gradle | Built-in |
721
+ | **PHP** | PHPUnit | PHP CS Fixer | Composer | PHPStan |
722
+ | **Ruby** | RSpec | RuboCop | Bundler | Sorbet |
724
723
 
725
724
  #### 모바일 & 프론트엔드 (3개)
726
725
 
727
- | 언어/프레임워크 | 테스트 프레임워크 | 린터/포매터 | 빌드 도구 | 플랫폼 |
728
- |-----------------|------------------|-------------|----------|--------|
729
- | **Dart (Flutter)** | flutter test | dart analyze | flutter | iOS, Android, Web |
730
- | **Swift** | XCTest | SwiftLint | xcodebuild | iOS, macOS |
731
- | **JavaScript** | Jest, Vitest | ESLint, Prettier | webpack, Vite | Web, Node.js |
726
+ | 언어/프레임워크 | 테스트 프레임워크 | 린터/포매터 | 빌드 도구 | 플랫폼 |
727
+ | ------------------ | ----------------- | ---------------- | ------------- | ----------------- |
728
+ | **Dart (Flutter)** | flutter test | dart analyze | flutter | iOS, Android, Web |
729
+ | **Swift** | XCTest | SwiftLint | xcodebuild | iOS, macOS |
730
+ | **JavaScript** | Jest, Vitest | ESLint, Prettier | webpack, Vite | Web, Node.js |
732
731
 
733
732
  #### 시스템 & 스크립트 (6개)
734
733
 
735
- | 언어 | 테스트 프레임워크 | 린터/포매터 | 빌드 도구 | 특징 |
736
- |------|------------------|-------------|----------|------|
737
- | **C++** | Google Test | clang-format | CMake | 고성능 시스템 |
738
- | **C** | CUnit | clang-format | Make, CMake | 임베디드, 시스템 |
739
- | **C#** | NUnit, xUnit | StyleCop | MSBuild, dotnet | .NET 생태계 |
740
- | **Haskell** | HUnit | stylish-haskell | Cabal, Stack | 함수형 프로그래밍 |
741
- | **Shell** | Bats | shellcheck | - | 자동화 스크립트 |
742
- | **Lua** | busted | luacheck | - | 임베디드 스크립팅 |
734
+ | 언어 | 테스트 프레임워크 | 린터/포매터 | 빌드 도구 | 특징 |
735
+ | ----------- | ----------------- | --------------- | --------------- | ----------------- |
736
+ | **C++** | Google Test | clang-format | CMake | 고성능 시스템 |
737
+ | **C** | CUnit | clang-format | Make, CMake | 임베디드, 시스템 |
738
+ | **C#** | NUnit, xUnit | StyleCop | MSBuild, dotnet | .NET 생태계 |
739
+ | **Haskell** | HUnit | stylish-haskell | Cabal, Stack | 함수형 프로그래밍 |
740
+ | **Shell** | Bats | shellcheck | - | 자동화 스크립트 |
741
+ | **Lua** | busted | luacheck | - | 임베디드 스크립팅 |
743
742
 
744
743
  ### 자동 언어 감지
745
744
 
746
745
  Alfred는 프로젝트 루트의 설정 파일을 자동으로 감지하여 언어와 도구 체인을 선택합니다:
747
746
 
748
- | 감지 파일 | 언어 | 추가 감지 |
749
- |----------|------|----------|
750
- | `pyproject.toml`, `requirements.txt` | Python | `setup.py`, `poetry.lock` |
751
- | `package.json` + `tsconfig.json` | TypeScript | `yarn.lock`, `pnpm-lock.yaml` |
752
- | `package.json` (tsconfig 없음) | JavaScript | `webpack.config.js`, `vite.config.js` |
753
- | `pom.xml`, `build.gradle` | Java | `settings.gradle`, `build.gradle.kts` |
754
- | `go.mod` | Go | `go.sum` |
755
- | `Cargo.toml` | Rust | `Cargo.lock` |
756
- | `pubspec.yaml` | Dart/Flutter | `flutter/packages/` |
757
- | `Package.swift` | Swift | `Podfile`, `Cartfile` |
758
- | `build.gradle.kts` + `kotlin` | Kotlin | `settings.gradle.kts` |
759
- | `composer.json` | PHP | `composer.lock` |
760
- | `Gemfile` | Ruby | `Gemfile.lock` |
761
- | `CMakeLists.txt` | C++ | `conanfile.txt` |
762
- | `Makefile` | C | `*.c`, `*.h` |
763
- | `*.csproj` | C# | `*.sln` |
764
- | `*.cabal` | Haskell | `stack.yaml` |
765
- | `*.sh` | Shell | `.bashrc`, `.zshrc` |
766
- | `*.lua` | Lua | `luarocks` |
747
+ | 감지 파일 | 언어 | 추가 감지 |
748
+ | ------------------------------------ | ------------ | ------------------------------------- |
749
+ | `pyproject.toml`, `requirements.txt` | Python | `setup.py`, `poetry.lock` |
750
+ | `package.json` + `tsconfig.json` | TypeScript | `yarn.lock`, `pnpm-lock.yaml` |
751
+ | `package.json` (tsconfig 없음) | JavaScript | `webpack.config.js`, `vite.config.js` |
752
+ | `pom.xml`, `build.gradle` | Java | `settings.gradle`, `build.gradle.kts` |
753
+ | `go.mod` | Go | `go.sum` |
754
+ | `Cargo.toml` | Rust | `Cargo.lock` |
755
+ | `pubspec.yaml` | Dart/Flutter | `flutter/packages/` |
756
+ | `Package.swift` | Swift | `Podfile`, `Cartfile` |
757
+ | `build.gradle.kts` + `kotlin` | Kotlin | `settings.gradle.kts` |
758
+ | `composer.json` | PHP | `composer.lock` |
759
+ | `Gemfile` | Ruby | `Gemfile.lock` |
760
+ | `CMakeLists.txt` | C++ | `conanfile.txt` |
761
+ | `Makefile` | C | `*.c`, `*.h` |
762
+ | `*.csproj` | C# | `*.sln` |
763
+ | `*.cabal` | Haskell | `stack.yaml` |
764
+ | `*.sh` | Shell | `.bashrc`, `.zshrc` |
765
+ | `*.lua` | Lua | `luarocks` |
767
766
 
768
767
  ### 언어별 TRUST 5원칙 적용
769
768
 
@@ -771,23 +770,23 @@ Alfred는 프로젝트 루트의 설정 파일을 자동으로 감지하여 언
771
770
 
772
771
  #### 주요 언어 TRUST 도구
773
772
 
774
- | 원칙 | Python | TypeScript | Java | Go | Rust | Ruby |
775
- |------|--------|------------|------|-----|------|------|
776
- | **T**est First | pytest | Vitest/Jest | JUnit | go test | cargo test | RSpec |
777
- | **R**eadable | ruff, black | Biome, ESLint | Checkstyle | gofmt | rustfmt | RuboCop |
778
- | **U**nified | mypy | Built-in | Built-in | Built-in | Built-in | Sorbet |
779
- | **S**ecured | bandit | eslint-plugin-security | SpotBugs | gosec | cargo-audit | Brakeman |
780
- | **T**rackable | @TAG | @TAG | @TAG | @TAG | @TAG | @TAG |
773
+ | 원칙 | Python | TypeScript | Java | Go | Rust | Ruby |
774
+ | -------------- | ----------- | ---------------------- | ---------- | -------- | ----------- | -------- |
775
+ | **T**est First | pytest | Vitest/Jest | JUnit | go test | cargo test | RSpec |
776
+ | **R**eadable | ruff, black | Biome, ESLint | Checkstyle | gofmt | rustfmt | RuboCop |
777
+ | **U**nified | mypy | Built-in | Built-in | Built-in | Built-in | Sorbet |
778
+ | **S**ecured | bandit | eslint-plugin-security | SpotBugs | gosec | cargo-audit | Brakeman |
779
+ | **T**rackable | @TAG | @TAG | @TAG | @TAG | @TAG | @TAG |
781
780
 
782
781
  #### 추가 언어 TRUST 도구
783
782
 
784
- | 원칙 | PHP | C++ | C# |
785
- |------|-----|-----|-----|
786
- | **T**est First | PHPUnit | Google Test | NUnit |
787
- | **R**eadable | PHP CS Fixer | clang-format | StyleCop |
788
- | **U**nified | PHPStan | Built-in | Built-in |
789
- | **S**ecured | RIPS | cppcheck | Security Code Scan |
790
- | **T**rackable | @TAG | @TAG | @TAG |
783
+ | 원칙 | PHP | C++ | C# |
784
+ | -------------- | ------------ | ------------ | ------------------ |
785
+ | **T**est First | PHPUnit | Google Test | NUnit |
786
+ | **R**eadable | PHP CS Fixer | clang-format | StyleCop |
787
+ | **U**nified | PHPStan | Built-in | Built-in |
788
+ | **S**ecured | RIPS | cppcheck | Security Code Scan |
789
+ | **T**rackable | @TAG | @TAG | @TAG |
791
790
 
792
791
  **공통 원칙**:
793
792
  - 모든 언어는 `@TAG 시스템`으로 SPEC→TEST→CODE→DOC 추적성 보장
@@ -944,11 +943,17 @@ Alfred가 모든 코드에 자동으로 적용하는 품질 기준입니다.
944
943
  # Python 버전 확인 (3.13+ 필요)
945
944
  python --version
946
945
 
947
- # uv 설치 (권장)
948
- pip install uv
946
+ # uv 설치 확인
947
+ uv --version
948
+
949
+ # uv가 없다면 먼저 설치 (필수)
950
+ # macOS/Linux:
951
+ curl -LsSf https://astral.sh/uv/install.sh | sh
952
+
953
+ # Windows:
954
+ powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
949
955
 
950
- # 캐시 정리 후 재설치
951
- pip cache purge
956
+ # moai-adk 재설치
952
957
  uv pip install moai-adk --force-reinstall
953
958
  ```
954
959
 
@@ -1020,7 +1025,7 @@ rg "@SPEC:" -n .moai/specs/
1020
1025
  ### 커뮤니티
1021
1026
  - **GitHub Discussions**: 질문, 아이디어, 피드백 공유
1022
1027
  - **Issue Tracker**: 버그 리포트, 기능 요청
1023
- - **Email**: support@moduai.kr
1028
+ - **Email**: email@mo.ai.kr
1024
1029
 
1025
1030
  ### 기여하기
1026
1031
 
@@ -1051,4 +1056,4 @@ MoAI-ADK는 다음 프로젝트와 커뮤니티의 도움으로 만들어졌습
1051
1056
 
1052
1057
  **Made with ❤️ by MoAI Team**
1053
1058
 
1054
- **▶◀ Alfred**: "여러분의 개발 여정을 함께하겠습니다!"
1059
+ **🎩 Alfred**: "여러분의 개발 여정을 함께하겠습니다!"
{moai_adk-0.3.1.dist-info → moai_adk-0.3.3.dist-info}/RECORD RENAMED
@@ -1,4 +1,4 @@
1
- moai_adk/__init__.py,sha256=Y-spxLVkOa-UO3AdqtF2P1jNLoHoPAGxkTyTAA1glcg,216
1
+ moai_adk/__init__.py,sha256=mpLSP-71ayWFhL1JNsseYmqS0KiZPeZFIQIu7rzaKIk,216
2
2
  moai_adk/__main__.py,sha256=FUUtsqo_NkeY3VR35EjPPtkP3vPkUqRraE30TXMGFL4,2502
3
3
  moai_adk/cli/__init__.py,sha256=tidIaJnd4Pje_5QYRq7OvRRst4T3kaPlkw5QcPQ3l1Y,135
4
4
  moai_adk/cli/main.py,sha256=mHACHi27AP2N7fg7zhzOo1tlF1Jrlw1_AcbxMfpGLVE,306
@@ -37,38 +37,7 @@ moai_adk/core/template/languages.py,sha256=waeyA_MFy217bV9IiILc2gofG9RM9JhD-kdVG
37
37
  moai_adk/core/template/merger.py,sha256=dvKobOW4vXz-7GWKJpZFYxCMtR-LszcJZYbYFTL3XY0,4049
38
38
  moai_adk/core/template/processor.py,sha256=RccILmWbtYeOoz8BTMHAZcTmwdQ4cNzQZzb_6vC8M-o,11177
39
39
  moai_adk/templates/.gitignore,sha256=6VNKResdDpyaii3cmJA4pOLwK2PhYARIWkUODYtKyxg,310
40
- moai_adk/templates/CLAUDE.md,sha256=d9YtiRYK3_h5EW9TuSUwH6YsY8o1nSs1P6STu0CVtFc,27631
41
40
  moai_adk/templates/__init__.py,sha256=9YY0tDkKbDFCdUB7rJFtGq0CZbF2ftVSKF573iw0KJc,99
42
- moai_adk/templates/.claude/settings.json,sha256=f99ViKE_lXk2vzpXx8A65jacDOBMBDLOIgft4voGXb4,3000
43
- moai_adk/templates/.claude/agents/alfred/cc-manager.md,sha256=xP3V7QAI-08ga6hhF3J4fXbgiHUM08bJbT2nfE52Bq4,13883
44
- moai_adk/templates/.claude/agents/alfred/code-builder.md,sha256=S438wTt3llxpqIIkotVRYuEUthNkdRzsel0LsWgtbpk,20654
45
- moai_adk/templates/.claude/agents/alfred/debug-helper.md,sha256=2YDvuiLFcQBRhhHdOLX-o8YWwOSz3FwQ_lGTQiU-PH8,8497
46
- moai_adk/templates/.claude/agents/alfred/doc-syncer.md,sha256=kLwLvI-5oRjEG6fSlq8CwwsH3TbqrAY-OWZDcS_3IMo,6223
47
- moai_adk/templates/.claude/agents/alfred/git-manager.md,sha256=6mCCdAAwWUvT0dSJcRsgltwaCkX-oB5_DbQH3BcK880,8320
48
- moai_adk/templates/.claude/agents/alfred/project-manager.md,sha256=ju9OhnZ8Rc7x-B9EIamJ1q4V_9WC0lkentzOSX4_3dM,5804
49
- moai_adk/templates/.claude/agents/alfred/spec-builder.md,sha256=hpYLQ2A7TFP8Z1nUAYA1_c9o5qNFhc-Uuc8aSxU9ROI,10881
50
- moai_adk/templates/.claude/agents/alfred/tag-agent.md,sha256=FGa-BuOl64XEp0fJbQJbvaP-4aoacKKeTo3XJ6PoCx4,8174
51
- moai_adk/templates/.claude/agents/alfred/trust-checker.md,sha256=eIwFumcJfr66jWdAuWJ5LITHfzzsRBaITGD7iz8EYH4,11647
52
- moai_adk/templates/.claude/commands/alfred/0-project.md,sha256=6a19UVvi6BV6mX0312WbQJyN4nsKB7pggTlLgtxwcFM,17831
53
- moai_adk/templates/.claude/commands/alfred/1-spec.md,sha256=fs2S0yS8hKGTDlwLyT1nQOuUFIxLXT6g11w4GR2-jN4,20343
54
- moai_adk/templates/.claude/commands/alfred/2-build.md,sha256=KXi_NN8jafbSZ89wf5Iz_3NuxFklMezbu6HJy2-eHkk,16615
55
- moai_adk/templates/.claude/commands/alfred/3-sync.md,sha256=mxqGO8xKciTJkaBo0hYHXyV6IFAipQ4ra-mZzUVoASg,19393
56
- moai_adk/templates/.claude/hooks/alfred/README.md,sha256=lSvkOMpk8XYpV5hiq2j2jVNT4RCL3p-ha6UCV4-CPOg,7008
57
- moai_adk/templates/.claude/hooks/alfred/alfred_hooks.py,sha256=I-fEEnx6ZtGfcY2pdy0Lv-uwEvI9Bm7ktAkZjI2Yphc,7215
58
- moai_adk/templates/.claude/hooks/alfred/core/__init__.py,sha256=No6VZOruX83zHq48SGcOJiza6HIut9VtsVkevaaFT88,2490
59
- moai_adk/templates/.claude/hooks/alfred/core/checkpoint.py,sha256=vAm5hEqXUT2frkXFSrJf2W6uOd24Bi7O0Qr51ll51Jw,8543
60
- moai_adk/templates/.claude/hooks/alfred/core/context.py,sha256=0FBagGq9cvYFqmjl8eZvDL9g5KAh1KvTvHpQMvtR6v4,3410
61
- moai_adk/templates/.claude/hooks/alfred/core/project.py,sha256=h7s2D0e5zn0BKu3GReMVH93ojKOTkF6yyLWNnoJI6-0,9103
62
- moai_adk/templates/.claude/hooks/alfred/core/tags.py,sha256=QAT7Oh8eupawGiZnaYDEcPhdlm1LGyzVF-Hv6SKZ_5g,7711
63
- moai_adk/templates/.claude/hooks/alfred/handlers/__init__.py,sha256=i3tvIYiSgc72KO9qGNdIPe0vFwEkoWqOlYrq4wR4tbw,643
64
- moai_adk/templates/.claude/hooks/alfred/handlers/compact.py,sha256=H7vIyU8GrjvSE2DEeTh3MFkBmJ3xTQvku1_60Q95D3s,1529
65
- moai_adk/templates/.claude/hooks/alfred/handlers/notification.py,sha256=MjwaCRSbK4f-YvRC9CG4Rg8dhQir1gzPqF02x9O_4Gc,655
66
- moai_adk/templates/.claude/hooks/alfred/handlers/session.py,sha256=6zz0uJ3cYtnY8gXtoP0cRf6LmmQUfggLWIJduokd-Jw,2783
67
- moai_adk/templates/.claude/hooks/alfred/handlers/tool.py,sha256=bR7QpIYxuypQseWbAPmLYClS2wZUGbFflFj-IiiE26w,2224
68
- moai_adk/templates/.claude/hooks/alfred/handlers/user.py,sha256=iD0X_Aas8pwfFvPj30PaCPNs_Xo-9yVynxT27m-2O7k,1300
69
- moai_adk/templates/.claude/output-styles/alfred/agentic-coding.md,sha256=-Y0V-fRRZbAUH1f4kZX0y8i0Lo7GRjJddBMeZ0WV6gA,17906
70
- moai_adk/templates/.claude/output-styles/alfred/moai-adk-learning.md,sha256=NFnDfKsnKZlUrqmdXgxQT6jm2VQIyGvtBST1DJa9PiI,17232
71
- moai_adk/templates/.claude/output-styles/alfred/study-with-alfred.md,sha256=M1Fz1GTKP_pIYqrW41OGq3aeGxWAcjQN5NwNboLHBrU,12197
72
41
  moai_adk/templates/.github/PULL_REQUEST_TEMPLATE.md,sha256=Cbkc2YZzM1wiGC5XI0cbgksSvs7myJ8z9dqDynZas-E,2338
73
42
  moai_adk/templates/.github/workflows/moai-gitflow.yml,sha256=aD36D-wKSvjWHGGfy5lRvriMHVWSjtRojn6qzBdztu0,8701
74
43
  moai_adk/templates/.moai/config.json,sha256=pMmmcQgyZQJtbvsrpzjYiYZRwmLrSH9FBaMKTVNcj2w,2152
@@ -80,8 +49,8 @@ moai_adk/templates/.moai/project/tech.md,sha256=devxbvmgTG3_1x3dYNPHtje2gU1aJ403
80
49
  moai_adk/utils/__init__.py,sha256=fv-UwHv8r4-eedwRnDA9hFjo5QSZYXjctKDyE7XF10g,220
81
50
  moai_adk/utils/banner.py,sha256=TmZyJKXOnJpdbdn6NZDJC6a4hm051QudEvOfiKQhvI8,1873
82
51
  moai_adk/utils/logger.py,sha256=jYCWKvcN-tX17hZ-e2IPuHATwkQBFc_I1dd5fUTWxmY,5059
83
- moai_adk-0.3.1.dist-info/METADATA,sha256=VCYxylvKPZl5S0jQaB4rZjgfHYLlyh9QQ59NHWDid4A,34941
84
- moai_adk-0.3.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
85
- moai_adk-0.3.1.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
86
- moai_adk-0.3.1.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
87
- moai_adk-0.3.1.dist-info/RECORD,,
52
+ moai_adk-0.3.3.dist-info/METADATA,sha256=MRb__B-VI_Uy-IDYzI6h5T6nwjZ6vjKDLMjbIifyVLA,38274
53
+ moai_adk-0.3.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
54
+ moai_adk-0.3.3.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
55
+ moai_adk-0.3.3.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
56
+ moai_adk-0.3.3.dist-info/RECORD,,