PyPI - moai-adk - Versions diffs - 0.3.1__tar.gz → 0.3.3__tar.gz - Mend - Supply Chain Defender

moai-adk 0.3.1tar.gz → 0.3.3tar.gz

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 (87) hide show

{moai_adk-0.3.1 → moai_adk-0.3.3}/.gitignore RENAMED Viewed

@@ -47,6 +47,11 @@ env/
 *.swo
 *~
+# Claude Code (user-specific)
+AGENTS.md
+CLAUDE.md
+.claude/
 # OS
 .DS_Store
 Thumbs.db

{moai_adk-0.3.1 → moai_adk-0.3.3}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moai-adk
-Version: 0.3.1
+Version: 0.3.3
 Summary: MoAI Agentic Development Kit - SPEC-First TDD with Alfred SuperAgent
 Project-URL: Homepage, https://github.com/modu-ai/moai-adk
 Project-URL: Repository, https://github.com/modu-ai/moai-adk
@@ -48,7 +48,7 @@ Description-Content-Type: text/markdown
 **안내**: MoAI-ADK는 모두의AI 연구실에서 집필 중인 "(가칭) 에이전틱 코딩" 서적의 별책 부록 오픈 소스 프로젝트입니다.
-![MoAI-ADK CLI Interface](https://github.com/modu-ai/moai-adk/raw/main/docs/public/moai-tui_screen-light.png)
+![MoAI-ADK CLI Interface](https://github.com/modu-ai/moai-adk/raw/main/docs/public/MoAI-ADK-cli_screen.png)
 > **"SPEC이 없으면 CODE도 없다."**
@@ -56,7 +56,7 @@ Description-Content-Type: text/markdown
 ## 목차
-- [v0.3.0 주요 개선사항](#-v030-주요-개선사항)
+- [v0.3.x 주요 개선사항](#-v03x-주요-개선사항)
 - [Meet Alfred](#-meet-alfred---10개-ai-에이전트-팀)
 - [AI 모델 선택 가이드](#-ai-모델-선택-가이드)
 - [Quick Start](#-quick-start-3분-실전)
@@ -70,7 +70,7 @@ Description-Content-Type: text/markdown
 ---
-## 🆕 v0.3.0 주요 개선사항
+## 🆕 v0.3.x 주요 개선사항
 ### 🚀 핵심 기능 강화
@@ -170,9 +170,9 @@ moai-adk update
 ---
-## ▶◀ Meet Alfred - 10개 AI 에이전트 팀
+## 🎩 Meet Alfred - 10개 AI 에이전트 팀
-안녕하세요, 모두의AI SuperAgent **▶◀ Alfred**입니다!
+안녕하세요, 모두의AI SuperAgent **🎩 Alfred**입니다!
 ![Alfred Logo](https://github.com/modu-ai/moai-adk/raw/main/docs/public/alfred_logo.png)
@@ -186,7 +186,7 @@ moai-adk update
 - **Agentic Coding 적용**: 10개 AI 에이전트 팀이 자율적으로 SPEC 작성, TDD 구현, 문서 동기화 수행
 - **투명성**: 완벽하지 않은 부분을 숨기지 않고, 커뮤니티와 함께 개선해나가는 오픈소스
-### ▶◀ Alfred가 제공하는 4가지 핵심 가치
+### 🎩 Alfred가 제공하는 4가지 핵심 가치
 #### 1️⃣ 일관성 (Consistency)
 **SPEC → TDD → Sync** 3단계 파이프라인으로 플랑켄슈타인 코드 방지
@@ -226,13 +226,13 @@ Alfred는 **작업 특성**에 따라 각 에이전트에 최적 모델을 할
 **빠른 응답이 필요한 반복 작업 및 패턴 매칭**
-| 에이전트 | 역할 | 왜 Haiku? |
-|---------|------|-----------|
-| **doc-syncer** 📖 | 문서 동기화 | 패턴화된 문서 업데이트, Living Document 생성 |
-| **tag-agent** 🏷️ | TAG 시스템 관리 | 반복적 패턴 매칭, TAG 체인 검증 |
-| **git-manager** 🚀 | Git 워크플로우 | 정형화된 Git 명령어 실행, 브랜치/PR 생성 |
-| **trust-checker** ✅ | TRUST 원칙 검증 | 규칙 기반 체크리스트 확인 |
-| **Explore** 🔍 | 코드베이스 탐색 | 대량 파일 스캔, 키워드 검색 |
+| 에이전트            | 역할            | 왜 Haiku?                                    |
+| ------------------- | --------------- | -------------------------------------------- |
+| **doc-syncer** 📖    | 문서 동기화     | 패턴화된 문서 업데이트, Living Document 생성 |
+| **tag-agent** 🏷️     | TAG 시스템 관리 | 반복적 패턴 매칭, TAG 체인 검증              |
+| **git-manager** 🚀   | Git 워크플로우  | 정형화된 Git 명령어 실행, 브랜치/PR 생성     |
+| **trust-checker** ✅ | TRUST 원칙 검증 | 규칙 기반 체크리스트 확인                    |
+| **Explore** 🔍       | 코드베이스 탐색 | 대량 파일 스캔, 키워드 검색                  |
 **장점**:
 - ⚡ **속도 2~5배 향상**: 실시간 응답 (수 초 → 1초 이내)
@@ -243,13 +243,13 @@ Alfred는 **작업 특성**에 따라 각 에이전트에 최적 모델을 할
 **복잡한 판단과 창의적 설계가 필요한 작업**
-| 에이전트 | 역할 | 왜 Sonnet? |
-|---------|------|-----------|
-| **spec-builder** 🏗️ | SPEC 작성 | EARS 구조 설계, 복잡한 요구사항 분석 |
-| **code-builder** 💎 | TDD 구현 | 아키텍처 설계, 복잡한 리팩토링 |
-| **debug-helper** 🔬 | 디버깅 | 오류 원인 분석, 해결 방법 도출 |
-| **cc-manager** 🛠️ | Claude Code 설정 | 워크플로우 최적화, 복잡한 설정 |
-| **project-manager** 📋 | 프로젝트 초기화 | 전략 수립, 복잡한 의사결정 |
+| 에이전트              | 역할             | 왜 Sonnet?                           |
+| --------------------- | ---------------- | ------------------------------------ |
+| **spec-builder** 🏗️    | SPEC 작성        | EARS 구조 설계, 복잡한 요구사항 분석 |
+| **code-builder** 💎    | TDD 구현         | 아키텍처 설계, 복잡한 리팩토링       |
+| **debug-helper** 🔬    | 디버깅           | 오류 원인 분석, 해결 방법 도출       |
+| **cc-manager** 🛠️      | Claude Code 설정 | 워크플로우 최적화, 복잡한 설정       |
+| **project-manager** 📋 | 프로젝트 초기화  | 전략 수립, 복잡한 의사결정           |
 **장점**:
 - 🎯 **높은 품질**: 복잡한 코드 품질 보장
@@ -258,14 +258,14 @@ Alfred는 **작업 특성**에 따라 각 에이전트에 최적 모델을 할
 ### 사용 시나리오별 권장 모델
-| 시나리오 | 권장 모델 | 이유 |
-|---------|----------|------|
-| 🆕 **새 프로젝트 시작** | Sonnet | SPEC 설계, 아키텍처 결정 필요 |
-| 🔄 **반복 개발** | Haiku | 이미 정해진 패턴 반복 구현 |
-| 🐛 **버그 수정** | Sonnet | 원인 분석 및 해결 방법 도출 |
-| 📝 **문서 작성** | Haiku | Living Document 동기화 |
-| 🔍 **코드 탐색** | Haiku | 파일 검색, TAG 조회 |
-| ♻️ **리팩토링** | Sonnet | 구조 개선, 복잡한 변경 |
+| 시나리오               | 권장 모델 | 이유                          |
+| ---------------------- | --------- | ----------------------------- |
+| 🆕 **새 프로젝트 시작** | Sonnet    | SPEC 설계, 아키텍처 결정 필요 |
+| 🔄 **반복 개발**        | Haiku     | 이미 정해진 패턴 반복 구현    |
+| 🐛 **버그 수정**        | Sonnet    | 원인 분석 및 해결 방법 도출   |
+| 📝 **문서 작성**        | Haiku     | Living Document 동기화        |
+| 🔍 **코드 탐색**        | Haiku     | 파일 검색, TAG 조회           |
+| ♻️ **리팩토링**         | Sonnet    | 구조 개선, 복잡한 변경        |
 ### 모델 전환 팁
@@ -293,67 +293,62 @@ Alfred는 **작업 특성**에 따라 각 에이전트에 최적 모델을 할
 ### 📋 준비물
-- ✅ Python 3.13+ 또는 uv 설치
+- ✅ Python 3.13+
+- ✅ **uv** (필수 - pip보다 10-100배 빠름)
 - ✅ Claude Code 실행 중
 - ✅ Git 설치 (선택사항)
 ### ⚡ 3단계로 시작하기
-#### 1️⃣ 설치 (30초)
+#### 1️⃣ uv 설치 (필수)
+**uv는 pip보다 10-100배 빠른 Python 패키지 관리자입니다** (Rust 기반).
 ```bash
-# uv 권장 (빠른 성능)
-pip install uv
-uv pip install moai-adk
+# macOS/Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+# Windows (PowerShell)
+powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
+# 설치 확인
+uv --version
+```
-# 또는 pip 사용
-pip install moai-adk
+#### 2️⃣ moai-adk 설치 (10초)
+```bash
+uv pip install moai-adk
 # 설치 확인
 moai-adk --version
 ```
-#### 2️⃣ 초기화 (1분)
+#### 3️⃣ 프로젝트 시작 (1분)
-**새 프로젝트 생성:**
+**새 프로젝트:**
 ```bash
 moai-adk init my-project
 cd my-project
-# Claude Code 실행
 claude
 ```
-**기존 프로젝트에 설치:**
+**기존 프로젝트:**
 ```bash
 cd existing-project
 moai-adk init .
-# Claude Code 실행
 claude
 ```
-**Claude Code에서 프로젝트 초기화 (필수):**
+**Claude Code에서 초기화:**
 ```text
 /alfred:0-project
 ```
-Alfred가 자동으로:
-- `.moai/project/` 문서 3종 생성 (product/structure/tech.md)
-- 언어별 최적 도구 체인 설정
-- 프로젝트 컨텍스트 완벽 이해
-#### 3️⃣ 첫 기능 개발 (1분 30초)
-**Claude Code에서 3단계 워크플로우:**
+**첫 기능 개발:**
 ```text
-# SPEC 작성
-/alfred:1-spec "JWT 기반 사용자 로그인 API"
-# TDD 구현
+/alfred:1-spec "사용자 인증 기능"
 /alfred:2-build AUTH-001
-# 문서 동기화
 /alfred:3-sync
 ```
@@ -368,15 +363,11 @@ Alfred가 자동으로:
 ---
-## ⬆️ 업그레이드 가이드 (v0.2.x → v0.3.0)
+## ⬆️ 업그레이드 가이드 (v0.3.0 → v0.3.x)
 ### 1단계: 패키지 업데이트
 ```bash
-# pip
-pip install --upgrade moai-adk
-# uv 권장
 uv pip install --upgrade moai-adk
 ```
@@ -405,9 +396,17 @@ claude
 moai-adk status
 # 확인 항목
+# ✅ .moai/config.json → moai.version: "0.3.x"
 # ✅ .moai/config.json → project.moai_adk_version: "0.3.x"
-# ✅ .moai/config.json → project.optimized: true
 # ✅ 모든 커맨드 정상 작동
+# ✅ 템플릿 파일 병합 완료
+### v0.3.x 시리즈 주요 개선사항
+- **Event-Driven Checkpoint**: 위험한 작업 전 자동 백업
+- **BackupMerger**: 스마트 백업 병합 (사용자 파일 보존)
+- **버전 추적**: 자동 버전 감지 및 최적화 안내
+- **Claude Code Hooks 통합**: SessionStart, PreToolUse, PostToolUse 훅
 ```
 ---
@@ -519,12 +518,12 @@ moai-adk --help
 각 Alfred 커맨드는 적절한 에이전트를 호출하며, **자동으로 최적 모델**을 사용합니다:
-| 커맨드 | 에이전트 | 모델 | 작업 특성 | 예상 시간 |
-|-------|----------|------|----------|----------|
-| `/alfred:0-project` | project-manager 📋 | 세션 기본 모델 | 프로젝트 전략 수립, 복잡한 의사결정 | 1~2분 |
-| `/alfred:1-spec` | spec-builder 🏗️ | 세션 기본 모델 | EARS 명세 설계, 요구사항 분석 | 2~3분 |
-| `/alfred:2-build` | code-builder 💎 | 세션 기본 모델 | TDD 구현, 아키텍처 설계 | 3~5분 |
-| `/alfred:3-sync` | doc-syncer 📖 | **Haiku 지정** | Living Document 동기화, 패턴 기반 | 30초~1분 |
+| 커맨드              | 에이전트          | 모델           | 작업 특성                           | 예상 시간 |
+| ------------------- | ----------------- | -------------- | ----------------------------------- | --------- |
+| `/alfred:0-project` | project-manager 📋 | 세션 기본 모델 | 프로젝트 전략 수립, 복잡한 의사결정 | 1~2분     |
+| `/alfred:1-spec`    | spec-builder 🏗️    | 세션 기본 모델 | EARS 명세 설계, 요구사항 분석       | 2~3분     |
+| `/alfred:2-build`   | code-builder 💎    | 세션 기본 모델 | TDD 구현, 아키텍처 설계             | 3~5분     |
+| `/alfred:3-sync`    | doc-syncer 📖      | **Haiku 지정** | Living Document 동기화, 패턴 기반   | 30초~1분  |
 #### 온디맨드 에이전트 호출
@@ -547,14 +546,14 @@ moai-adk --help
 #### 모델별 성능 비교
-| 작업 유형 | Haiku (패스트) | Sonnet (스마트) | 실제 적용 |
-|---------|---------------|----------------|----------|
-| **SPEC 작성** | 1분 | 2~3분 | 세션 기본 모델 사용 |
-| **TDD 구현** | 2분 | 3~5분 | 세션 기본 모델 사용 |
-| **문서 동기화** | 30초 | 1~2분 | ✅ Haiku 지정 (3-sync) |
-| **TAG 검증** | 10초 | 30초 | ✅ Haiku 지정 (tag-agent) |
-| **Git 작업** | 5초 | 15초 | ✅ Haiku 지정 (git-manager) |
-| **디버깅** | 1분 | 2~3분 | 세션 기본 모델 사용 |
+| 작업 유형       | Haiku (패스트) | Sonnet (스마트) | 실제 적용                  |
+| --------------- | -------------- | --------------- | -------------------------- |
+| **SPEC 작성**   | 1분            | 2~3분           | 세션 기본 모델 사용        |
+| **TDD 구현**    | 2분            | 3~5분           | 세션 기본 모델 사용        |
+| **문서 동기화** | 30초           | 1~2분           | ✅ Haiku 지정 (3-sync)      |
+| **TAG 검증**    | 10초           | 30초            | ✅ Haiku 지정 (tag-agent)   |
+| **Git 작업**    | 5초            | 15초            | ✅ Haiku 지정 (git-manager) |
+| **디버깅**      | 1분            | 2~3분           | 세션 기본 모델 사용        |
 **핵심 설계**:
 - `/alfred:0-project`, `/alfred:1-spec`, `/alfred:2-build`: **사용자가 선택한 세션 기본 모델** 사용
@@ -679,13 +678,13 @@ Alfred가 함께 배우는 친구처럼 새로운 기술을 쉽게 설명하고,
 **언제 전환할까요?**
-| 상황 | 권장 스타일 | 이유 |
-|------|------------|------|
-| 🚀 **실무 개발** | Agentic Coding | Fast/Collab 자동 전환, 효율 중심 |
-| 📚 **MoAI-ADK 학습** | MoAI ADK Learning | SPEC-First, TAG, TRUST 개념 이해 |
-| 🎓 **새 기술 학습** | Study with Alfred | What-Why-How-Practice 4단계 |
-| 🔄 **반복 작업** | Agentic Coding (Fast) | 최소 설명, 빠른 실행 |
-| 🤝 **팀 협업** | Agentic Coding (Collab) | 트레이드오프 분석, 브레인스토밍 |
+| 상황                | 권장 스타일             | 이유                             |
+| ------------------- | ----------------------- | -------------------------------- |
+| 🚀 **실무 개발**     | Agentic Coding          | Fast/Collab 자동 전환, 효율 중심 |
+| 📚 **MoAI-ADK 학습** | MoAI ADK Learning       | SPEC-First, TAG, TRUST 개념 이해 |
+| 🎓 **새 기술 학습**  | Study with Alfred       | What-Why-How-Practice 4단계      |
+| 🔄 **반복 작업**     | Agentic Coding (Fast)   | 최소 설명, 빠른 실행             |
+| 🤝 **팀 협업**       | Agentic Coding (Collab) | 트레이드오프 분석, 브레인스토밍  |
 **스타일 전환 예시**:
 ```text
@@ -711,59 +710,59 @@ Alfred는 **17개 주요 프로그래밍 언어**를 지원하며, 각 언어에
 #### 백엔드 & 시스템 (8개)
-| 언어 | 테스트 프레임워크 | 린터/포매터 | 빌드 도구 | 타입 시스템 |
-|------|------------------|-------------|----------|------------|
-| **Python** | pytest | ruff, black | uv, pip | mypy |
-| **TypeScript** | Vitest, Jest | Biome, ESLint | npm, pnpm, bun | Built-in |
-| **Java** | JUnit | Checkstyle | Maven, Gradle | Built-in |
-| **Go** | go test | gofmt, golint | go build | Built-in |
-| **Rust** | cargo test | rustfmt, clippy | cargo | Built-in |
-| **Kotlin** | JUnit | ktlint | Gradle | Built-in |
-| **PHP** | PHPUnit | PHP CS Fixer | Composer | PHPStan |
-| **Ruby** | RSpec | RuboCop | Bundler | Sorbet |
+| 언어           | 테스트 프레임워크 | 린터/포매터     | 빌드 도구      | 타입 시스템 |
+| -------------- | ----------------- | --------------- | -------------- | ----------- |
+| **Python**     | pytest            | ruff, black     | uv, pip        | mypy        |
+| **TypeScript** | Vitest, Jest      | Biome, ESLint   | npm, pnpm, bun | Built-in    |
+| **Java**       | JUnit             | Checkstyle      | Maven, Gradle  | Built-in    |
+| **Go**         | go test           | gofmt, golint   | go build       | Built-in    |
+| **Rust**       | cargo test        | rustfmt, clippy | cargo          | Built-in    |
+| **Kotlin**     | JUnit             | ktlint          | Gradle         | Built-in    |
+| **PHP**        | PHPUnit           | PHP CS Fixer    | Composer       | PHPStan     |
+| **Ruby**       | RSpec             | RuboCop         | Bundler        | Sorbet      |
 #### 모바일 & 프론트엔드 (3개)
-| 언어/프레임워크 | 테스트 프레임워크 | 린터/포매터 | 빌드 도구 | 플랫폼 |
-|-----------------|------------------|-------------|----------|--------|
-| **Dart (Flutter)** | flutter test | dart analyze | flutter | iOS, Android, Web |
-| **Swift** | XCTest | SwiftLint | xcodebuild | iOS, macOS |
-| **JavaScript** | Jest, Vitest | ESLint, Prettier | webpack, Vite | Web, Node.js |
+| 언어/프레임워크    | 테스트 프레임워크 | 린터/포매터      | 빌드 도구     | 플랫폼            |
+| ------------------ | ----------------- | ---------------- | ------------- | ----------------- |
+| **Dart (Flutter)** | flutter test      | dart analyze     | flutter       | iOS, Android, Web |
+| **Swift**          | XCTest            | SwiftLint        | xcodebuild    | iOS, macOS        |
+| **JavaScript**     | Jest, Vitest      | ESLint, Prettier | webpack, Vite | Web, Node.js      |
 #### 시스템 & 스크립트 (6개)
-| 언어 | 테스트 프레임워크 | 린터/포매터 | 빌드 도구 | 특징 |
-|------|------------------|-------------|----------|------|
-| **C++** | Google Test | clang-format | CMake | 고성능 시스템 |
-| **C** | CUnit | clang-format | Make, CMake | 임베디드, 시스템 |
-| **C#** | NUnit, xUnit | StyleCop | MSBuild, dotnet | .NET 생태계 |
-| **Haskell** | HUnit | stylish-haskell | Cabal, Stack | 함수형 프로그래밍 |
-| **Shell** | Bats | shellcheck | - | 자동화 스크립트 |
-| **Lua** | busted | luacheck | - | 임베디드 스크립팅 |
+| 언어        | 테스트 프레임워크 | 린터/포매터     | 빌드 도구       | 특징              |
+| ----------- | ----------------- | --------------- | --------------- | ----------------- |
+| **C++**     | Google Test       | clang-format    | CMake           | 고성능 시스템     |
+| **C**       | CUnit             | clang-format    | Make, CMake     | 임베디드, 시스템  |
+| **C#**      | NUnit, xUnit      | StyleCop        | MSBuild, dotnet | .NET 생태계       |
+| **Haskell** | HUnit             | stylish-haskell | Cabal, Stack    | 함수형 프로그래밍 |
+| **Shell**   | Bats              | shellcheck      | -               | 자동화 스크립트   |
+| **Lua**     | busted            | luacheck        | -               | 임베디드 스크립팅 |
 ### 자동 언어 감지
 Alfred는 프로젝트 루트의 설정 파일을 자동으로 감지하여 언어와 도구 체인을 선택합니다:
-| 감지 파일 | 언어 | 추가 감지 |
-|----------|------|----------|
-| `pyproject.toml`, `requirements.txt` | Python | `setup.py`, `poetry.lock` |
-| `package.json` + `tsconfig.json` | TypeScript | `yarn.lock`, `pnpm-lock.yaml` |
-| `package.json` (tsconfig 없음) | JavaScript | `webpack.config.js`, `vite.config.js` |
-| `pom.xml`, `build.gradle` | Java | `settings.gradle`, `build.gradle.kts` |
-| `go.mod` | Go | `go.sum` |
-| `Cargo.toml` | Rust | `Cargo.lock` |
-| `pubspec.yaml` | Dart/Flutter | `flutter/packages/` |
-| `Package.swift` | Swift | `Podfile`, `Cartfile` |
-| `build.gradle.kts` + `kotlin` | Kotlin | `settings.gradle.kts` |
-| `composer.json` | PHP | `composer.lock` |
-| `Gemfile` | Ruby | `Gemfile.lock` |
-| `CMakeLists.txt` | C++ | `conanfile.txt` |
-| `Makefile` | C | `*.c`, `*.h` |
-| `*.csproj` | C# | `*.sln` |
-| `*.cabal` | Haskell | `stack.yaml` |
-| `*.sh` | Shell | `.bashrc`, `.zshrc` |
-| `*.lua` | Lua | `luarocks` |
+| 감지 파일                            | 언어         | 추가 감지                             |
+| ------------------------------------ | ------------ | ------------------------------------- |
+| `pyproject.toml`, `requirements.txt` | Python       | `setup.py`, `poetry.lock`             |
+| `package.json` + `tsconfig.json`     | TypeScript   | `yarn.lock`, `pnpm-lock.yaml`         |
+| `package.json` (tsconfig 없음)       | JavaScript   | `webpack.config.js`, `vite.config.js` |
+| `pom.xml`, `build.gradle`            | Java         | `settings.gradle`, `build.gradle.kts` |
+| `go.mod`                             | Go           | `go.sum`                              |
+| `Cargo.toml`                         | Rust         | `Cargo.lock`                          |
+| `pubspec.yaml`                       | Dart/Flutter | `flutter/packages/`                   |
+| `Package.swift`                      | Swift        | `Podfile`, `Cartfile`                 |
+| `build.gradle.kts` + `kotlin`        | Kotlin       | `settings.gradle.kts`                 |
+| `composer.json`                      | PHP          | `composer.lock`                       |
+| `Gemfile`                            | Ruby         | `Gemfile.lock`                        |
+| `CMakeLists.txt`                     | C++          | `conanfile.txt`                       |
+| `Makefile`                           | C            | `*.c`, `*.h`                          |
+| `*.csproj`                           | C#           | `*.sln`                               |
+| `*.cabal`                            | Haskell      | `stack.yaml`                          |
+| `*.sh`                               | Shell        | `.bashrc`, `.zshrc`                   |
+| `*.lua`                              | Lua          | `luarocks`                            |
 ### 언어별 TRUST 5원칙 적용
@@ -771,23 +770,23 @@ Alfred는 프로젝트 루트의 설정 파일을 자동으로 감지하여 언
 #### 주요 언어 TRUST 도구
-| 원칙 | Python | TypeScript | Java | Go | Rust | Ruby |
-|------|--------|------------|------|-----|------|------|
-| **T**est First | pytest | Vitest/Jest | JUnit | go test | cargo test | RSpec |
-| **R**eadable | ruff, black | Biome, ESLint | Checkstyle | gofmt | rustfmt | RuboCop |
-| **U**nified | mypy | Built-in | Built-in | Built-in | Built-in | Sorbet |
-| **S**ecured | bandit | eslint-plugin-security | SpotBugs | gosec | cargo-audit | Brakeman |
-| **T**rackable | @TAG | @TAG | @TAG | @TAG | @TAG | @TAG |
+| 원칙           | Python      | TypeScript             | Java       | Go       | Rust        | Ruby     |
+| -------------- | ----------- | ---------------------- | ---------- | -------- | ----------- | -------- |
+| **T**est First | pytest      | Vitest/Jest            | JUnit      | go test  | cargo test  | RSpec    |
+| **R**eadable   | ruff, black | Biome, ESLint          | Checkstyle | gofmt    | rustfmt     | RuboCop  |
+| **U**nified    | mypy        | Built-in               | Built-in   | Built-in | Built-in    | Sorbet   |
+| **S**ecured    | bandit      | eslint-plugin-security | SpotBugs   | gosec    | cargo-audit | Brakeman |
+| **T**rackable  | @TAG        | @TAG                   | @TAG       | @TAG     | @TAG        | @TAG     |
 #### 추가 언어 TRUST 도구
-| 원칙 | PHP | C++ | C# |
-|------|-----|-----|-----|
-| **T**est First | PHPUnit | Google Test | NUnit |
-| **R**eadable | PHP CS Fixer | clang-format | StyleCop |
-| **U**nified | PHPStan | Built-in | Built-in |
-| **S**ecured | RIPS | cppcheck | Security Code Scan |
-| **T**rackable | @TAG | @TAG | @TAG |
+| 원칙           | PHP          | C++          | C#                 |
+| -------------- | ------------ | ------------ | ------------------ |
+| **T**est First | PHPUnit      | Google Test  | NUnit              |
+| **R**eadable   | PHP CS Fixer | clang-format | StyleCop           |
+| **U**nified    | PHPStan      | Built-in     | Built-in           |
+| **S**ecured    | RIPS         | cppcheck     | Security Code Scan |
+| **T**rackable  | @TAG         | @TAG         | @TAG               |
 **공통 원칙**:
 - 모든 언어는 `@TAG 시스템`으로 SPEC→TEST→CODE→DOC 추적성 보장
@@ -944,11 +943,17 @@ Alfred가 모든 코드에 자동으로 적용하는 품질 기준입니다.
 # Python 버전 확인 (3.13+ 필요)
 python --version
-# uv 설치 (권장)
-pip install uv
+# uv 설치 확인
+uv --version
+# uv가 없다면 먼저 설치 (필수)
+# macOS/Linux:
+curl -LsSf https://astral.sh/uv/install.sh | sh
+# Windows:
+powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
-# 캐시 정리 후 재설치
-pip cache purge
+# moai-adk 재설치
 uv pip install moai-adk --force-reinstall
 ```
@@ -1020,7 +1025,7 @@ rg "@SPEC:" -n .moai/specs/
 ### 커뮤니티
 - **GitHub Discussions**: 질문, 아이디어, 피드백 공유
 - **Issue Tracker**: 버그 리포트, 기능 요청
-- **Email**: support@moduai.kr
+- **Email**: email@mo.ai.kr
 ### 기여하기
@@ -1051,4 +1056,4 @@ MoAI-ADK는 다음 프로젝트와 커뮤니티의 도움으로 만들어졌습
 **Made with ❤️ by MoAI Team**
-**▶◀ Alfred**: "여러분의 개발 여정을 함께하겠습니다!"
+**🎩 Alfred**: "여러분의 개발 여정을 함께하겠습니다!"