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

moai_adk/templates/.claude/commands/alfred/2-build.md

@@ -1,413 +0,0 @@
----
-name: alfred:2-build
-description: 구현할 SPEC ID (예: SPEC-001) 또는 all로 모든 SPEC 구현: 언어별 최적화된 TDD 구현 (Red-Green-Refactor) with SQLite3 tags.db
-argument-hint: "SPEC-ID - 구현할 SPEC ID (예: SPEC-001) 또는 all로 모든 SPEC 구현"
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - MultiEdit
-  - Bash(python3:*)
-  - Bash(pytest:*)
-  - Bash(npm:*)
-  - Bash(node:*)
-  - Bash(git:*)
-  - Task
-  - WebFetch
-  - Grep
-  - Glob
-  - TodoWrite
----
-
-# ⚒️ MoAI-ADK 2단계: 언어별 최적화된 TDD 구현 (Red-Green-Refactor)
-
-## 🎯 커맨드 목적
-
-SPEC 문서를 분석하여 언어별 최적화된 TDD 사이클(Red-Green-Refactor)로 고품질 코드를 구현합니다.
-
-**TDD 구현 대상**: $ARGUMENTS
-
-> **표준 2단계 워크플로우** (자세한 내용: `CLAUDE.md` - "Alfred 커맨드 실행 패턴" 참조)
-
-## 📋 실행 흐름
-
-1. **SPEC 분석**: 요구사항 추출 및 복잡도 평가
-2. **구현 전략 수립**: 언어별 최적화된 TDD 접근법 결정
-3. **사용자 확인**: 구현 계획 검토 및 승인
-4. **TDD 구현**: RED → GREEN → REFACTOR 사이클 실행
-5. **Git 작업**: git-manager를 통한 단계별 커밋 생성
-
-## 🔗 연관 에이전트
-
-- **Primary**: code-builder (💎 수석 개발자) - TDD 구현 전담
-- **Quality Gate**: trust-checker (✅ 품질 보증 리드) - TRUST 원칙 검증 (자동)
-- **Secondary**: git-manager (🚀 릴리스 엔지니어) - Git 커밋 전담
-
-## 💡 사용 예시
-
-사용자가 다음과 같이 커맨드를 실행할 수 있습니다:
-- `/alfred:2-build SPEC-001` - 특정 SPEC 구현
-- `/alfred:2-build all` - 모든 SPEC 일괄 구현
-- `/alfred:2-build SPEC-003 --test` - 테스트만 실행
-
-## 🔍 STEP 1: SPEC 분석 및 구현 계획 수립
-
-먼저 지정된 SPEC을 분석하여 구현 계획을 수립하고 사용자 확인을 받습니다.
-
-### 🔍 코드베이스 탐색 (권장)
-
-**기존 코드 구조를 파악하거나 유사 패턴을 찾아야 하는 경우** Explore 에이전트를 먼저 활용합니다:
-
-```
-Task tool 호출 (Explore 에이전트):
-- subagent_type: "Explore"
-- description: "기존 코드 구조 및 패턴 탐색"
-- prompt: "SPEC-$ARGUMENTS와 관련된 기존 코드를 탐색해주세요:
-          - 유사한 기능 구현 코드 (src/)
-          - 참고할 테스트 패턴 (tests/)
-          - 아키텍처 패턴 및 디자인 패턴
-          - 사용 중인 라이브러리 및 버전 (package.json, requirements.txt)
-          thoroughness 레벨: medium"
-```
-
-**Explore 에이전트 사용 시점**:
-- ✅ 기존 코드 구조/패턴 파악이 필요한 경우
-- ✅ 유사 기능의 구현 방식을 참고해야 할 때
-- ✅ 프로젝트의 아키텍처 규칙을 이해해야 할 때
-- ✅ 사용 중인 라이브러리 및 버전 확인
-
-### ⚙️ 에이전트 호출 방법
-
-**STEP 1에서는 Task tool을 사용하여 code-builder 에이전트를 호출합니다**:
-
-```
-Task tool 호출 예시:
-- subagent_type: "code-builder"
-- description: "SPEC 분석 및 TDD 계획 수립"
-- prompt: "$ARGUMENTS 의 SPEC을 분석하여 TDD 구현 계획을 수립해주세요.
-          분석 모드로 실행하며, 다음을 포함해야 합니다:
-          1. SPEC 요구사항 추출 및 복잡도 평가
-          2. 언어별 최적화된 TDD 전략 수립
-          3. 라이브러리 버전 확인 (WebSearch 사용)
-          4. 구현 계획 보고서 생성
-          5. 사용자 승인 대기
-          (선택) Explore 결과: $EXPLORE_RESULTS"
-```
-
-### SPEC 분석 진행
-
-1. **SPEC 문서 분석**
-   - 요구사항 추출 및 복잡도 평가
-   - 기술적 제약사항 확인
-   - 의존성 및 영향 범위 분석
-   - (선택) Explore 결과 기반 기존 코드 구조 파악
-
-2. **구현 전략 수립**
-   - 프로젝트 언어 감지 및 최적화된 구현 전략
-   - TDD 접근 방식 결정 (언어별 도구 선택)
-   - 예상 작업 범위 및 시간 산정
-
-3. **라이브러리 버전 확인 및 명시 (필수)**
-   - **웹 검색**: `WebSearch`를 통해 사용할 모든 라이브러리의 최신 안정 버전 확인
-   - **버전 명시**: 구현 계획 보고서에 라이브러리별 정확한 버전 명시 (예: `fastapi>=0.118.3`)
-   - **안정성 우선**: 베타/알파 버전 제외, 프로덕션 안정 버전만 선택
-   - **호환성 확인**: 라이브러리 간 버전 호환성 검증
-   - **검색 키워드 예시**:
-     - `"FastAPI latest stable version 2025"`
-     - `"SQLAlchemy 2.0 latest stable version 2025"`
-     - `"React 18 latest stable version 2025"`
-
-4. **구현 계획 보고**
-   - 단계별 구현 계획 제시
-   - 잠재적 위험 요소 식별
-   - 품질 게이트 체크포인트 설정
-   - **라이브러리 버전 명시 (필수)**
-
-### 사용자 확인 단계
-
-구현 계획 검토 후 다음 중 선택하세요:
-- **"진행"** 또는 **"시작"**: 계획대로 TDD 구현 시작
-- **"수정 [내용]"**: 계획 수정 요청
-- **"중단"**: 구현 작업 중단
-
----
-
-## 🚀 STEP 2: TDD 구현 실행 (사용자 승인 후)
-
-사용자 승인 후 **Task tool을 사용하여 code-builder 에이전트를 호출**합니다.
-
-### ⚙️ 에이전트 호출 방법
-
-**STEP 2에서는 Task tool을 사용하여 code-builder를 호출하고, 필요 시 tag-agent도 호출합니다**:
-
-```
-1. code-builder 호출 (TDD 구현):
-   - subagent_type: "code-builder"
-   - description: "TDD 구현 실행"
-   - prompt: "STEP 1에서 승인된 계획에 따라 TDD 구현을 실행해주세요.
-             구현 모드로 실행하며, RED → GREEN → REFACTOR 사이클을 수행합니다.
-             $ARGUMENTS"
-
-2. tag-agent 호출 (TAG 검증 - 필요 시):
-   - subagent_type: "tag-agent"
-   - description: "TAG 체인 무결성 검증"
-   - prompt: "$ARGUMENTS 의 TAG 체인 무결성을 검증해주세요.
-             @SPEC, @TEST, @CODE TAG의 완전성을 확인하고,
-             고아 TAG 및 중복 TAG를 탐지해주세요."
-
-3. git-manager 호출 (Git 커밋 - TDD 완료 후):
-   - subagent_type: "git-manager"
-   - description: "TDD 커밋 생성"
-   - prompt: "RED → GREEN → REFACTOR 단계별로 구조화된 커밋을 생성해주세요."
-```
-
-## 🔗 언어별 TDD 최적화
-
-### 프로젝트 언어 감지 및 최적 라우팅
-
-`@agent-code-builder`는 프로젝트의 언어를 자동으로 감지하여 최적의 TDD 도구와 워크플로우를 선택합니다:
-
-- **언어 감지**: 프로젝트 파일(package.json, pyproject.toml, go.mod 등) 분석
-- **도구 선택**: 언어별 최적 테스트 프레임워크 자동 선택
-- **TAG 적용**: 코드 파일에 @TAG 주석 직접 작성
-- **사이클 실행**: RED → GREEN → REFACTOR 순차 진행
-
-### TDD 도구 매핑
-
-#### 백엔드/시스템
-
-| SPEC 타입 | 구현 언어 | 테스트 프레임워크 | 성능 목표 | 커버리지 목표 |
-|-----------|-----------|-------------------|-----------|---------------|
-| **CLI/시스템** | TypeScript | Jest + ts-node | < 18ms | 95%+ |
-| **API/백엔드** | TypeScript | Jest + SuperTest | < 50ms | 90%+ |
-| **프론트엔드** | TypeScript | Jest + Testing Library | < 100ms | 85%+ |
-| **데이터 처리** | TypeScript | Jest + Mock | < 200ms | 85%+ |
-| **Python 프로젝트** | Python | pytest + mypy | 사용자 정의 | 85%+ |
-
-#### 모바일 프레임워크
-
-| SPEC 타입 | 구현 언어 | 테스트 프레임워크 | 성능 목표 | 커버리지 목표 |
-|-----------|-----------|-------------------|-----------|---------------|
-| **Flutter 앱** | Dart | flutter test + widget test | < 100ms | 85%+ |
-| **React Native** | TypeScript | Jest + RN Testing Library | < 100ms | 85%+ |
-| **iOS 앱** | Swift | XCTest + XCUITest | < 150ms | 80%+ |
-| **Android 앱** | Kotlin | JUnit + Espresso | < 150ms | 80%+ |
-
-## 🚀 최적화된 에이전트 협업 구조
-
-- **Phase 1**: `code-builder` 에이전트가 전체 TDD 사이클(Red-Green-Refactor)을 일괄 처리합니다.
-- **Phase 2**: `git-manager` 에이전트가 TDD 완료 후 모든 커밋을 한 번에 처리합니다.
-- **단일 책임 원칙**: code-builder는 전체 TDD 구현, git-manager는 Git 작업 일괄 처리
-- **배치 처리**: 단계별 중단 없이 연속적인 TDD 사이클 실행
-- **에이전트 간 호출 금지**: 각 에이전트는 독립적으로 실행, 커맨드 레벨에서만 순차 호출
-
-## 🔄 2단계 워크플로우 실행 순서
-
-### Phase 1: 분석 및 계획 단계
-
-**SPEC 분석기**가 다음을 수행:
-
-1. **SPEC 문서 로딩**: 지정된 SPEC ID 또는 all 모드에 따른 문서 분석
-2. **복잡도 평가**: 구현 범위, 기술적 제약사항, 의존성 분석
-3. **언어별 구현 전략**: 프로젝트 언어별 최적화 방안 제시
-4. **구현 계획 생성**: 단계별 TDD 접근 방식 및 예상 작업량 산정
-5. **사용자 승인 대기**: 계획 검토 및 피드백 수집
-
-### Phase 2: TDD 구현 단계 (승인 후)
-
-`code-builder` 에이전트가 사용자 승인 후 **연속적으로** 수행:
-
-1. **RED**: 실패하는 테스트 작성 및 확인
-2. **GREEN**: 최소 구현으로 테스트 통과 확인
-3. **REFACTOR**: 코드 품질 개선 및 TRUST 원칙 검증
-4. **품질 검증**: 린터, 테스트 커버리지, 보안 검사 일괄 실행
-
-### Phase 2.5: 품질 검증 게이트 (자동 실행)
-
-TDD 구현 완료 후 `trust-checker` 에이전트가 **자동으로** 품질 검증을 수행합니다.
-
-**자동 실행 조건**:
-- TDD 구현 완료 시 자동 호출
-- 사용자 요청 시 수동 호출 가능
-
-**검증 항목**:
-- **T (Test First)**: 테스트 커버리지 ≥ 85%
-- **R (Readable)**: 코드 가독성 (파일≤300 LOC, 함수≤50 LOC, 복잡도≤10)
-- **U (Unified)**: 아키텍처 통합성 (모듈 의존성 검증)
-- **S (Secured)**: 보안 검증 (입력 검증, 로깅)
-- **T (Trackable)**: @TAG 추적성 무결성
-
-**실행 방식**: Alfred가 TDD 구현 완료 시 자동으로 trust-checker 에이전트를 호출하여 빠른 품질 검증을 수행합니다.
-
-**검증 결과 처리**:
-
-✅ **Pass (모든 기준 충족)**:
-- Phase 3 (Git 작업)로 진행
-- 품질 리포트 생성
-
-⚠️ **Warning (일부 기준 미달)**:
-- 경고 표시
-- 사용자 선택: "계속 진행" 또는 "수정 후 재검증"
-
-❌ **Critical (필수 기준 미달)**:
-- Git 커밋 차단
-- 개선 필요 항목 상세 보고
-- code-builder 재호출 권장
-
-**검증 생략 옵션**: 품질 검증을 건너뛰려면 `--skip-quality-check` 옵션을 사용합니다.
-
-### Phase 3: Git 작업 (git-manager)
-
-`git-manager` 에이전트가 TDD 완료 후 **한 번에** 수행:
-
-1. **체크포인트 생성**: TDD 시작 전 백업 포인트
-2. **구조화된 커밋**: RED→GREEN→REFACTOR 단계별 커밋 생성
-3. **최종 동기화**: 모드별 Git 전략 적용 및 원격 동기화
-
-
-## 📋 STEP 1 실행 가이드: SPEC 분석 및 계획 수립
-
-### 1. SPEC 문서 분석
-
-Alfred는 code-builder 에이전트를 호출하여 SPEC 문서를 확인하고 TDD 구현 계획을 수립합니다.
-
-#### 분석 체크리스트
-
-- [ ] **요구사항 명확성**: SPEC의 기능 요구사항이 구체적인가?
-- [ ] **기술적 제약**: 성능, 호환성, 보안 요구사항 확인
-- [ ] **의존성 분석**: 기존 코드와의 연결점 및 영향 범위
-- [ ] **복잡도 평가**: 구현 난이도 및 예상 작업량
-
-### 2. 구현 전략 결정
-
-#### TypeScript 구현 기준
-
-| SPEC 특성 | 구현 언어 | 이유 |
-|-----------|-----------|------|
-| CLI/시스템 도구 | TypeScript | 고성능 (18ms), 타입 안전성, SQLite3 통합 |
-| API/백엔드 | TypeScript | Node.js 생태계, Express/Fastify 호환성 |
-| 프론트엔드 | TypeScript | React/Vue 네이티브 지원 |
-| 데이터 처리 | TypeScript | 고성능 비동기 처리, 타입 안전성 |
-| 사용자 Python 프로젝트 | Python 도구 지원 | MoAI-ADK가 Python 프로젝트 개발 도구 제공 |
-
-#### TDD 접근 방식
-
-- **Bottom-up**: 유틸리티 → 서비스 → API
-- **Top-down**: API → 서비스 → 유틸리티
-- **Middle-out**: 핵심 로직 → 양방향 확장
-
-### 3. 구현 계획 보고서 생성
-
-다음 형식으로 계획을 제시합니다:
-
-```
-## 구현 계획 보고서: [SPEC-ID]
-
-### 📊 분석 결과
-- **복잡도**: [낮음/중간/높음]
-- **예상 작업시간**: [시간 산정]
-- **주요 기술 도전**: [기술적 어려움]
-
-### 🎯 구현 전략
-- **선택 언어**: [Python/TypeScript + 이유]
-- **TDD 접근법**: [Bottom-up/Top-down/Middle-out]
-- **핵심 모듈**: [주요 구현 대상]
-
-### 📦 라이브러리 버전 (필수 - 웹 검색 기반)
-**백엔드 의존성** (예시):
-| 패키지 | 최신 안정 버전 | 설치 명령 |
-|--------|--------------|----------|
-| FastAPI | 0.118.3 | fastapi>=0.118.3 |
-| SQLAlchemy | 2.0.43 | sqlalchemy>=2.0.43 |
-
-**프론트엔드 의존성** (예시):
-| 패키지 | 최신 안정 버전 | 설치 명령 |
-|--------|--------------|----------|
-| React | 18.3.1 | react@^18.3.1 |
-| Vite | 7.1.9 | vite@^7.1.9 |
-
-**중요 호환성 정보**:
-- [특정 버전 요구사항]
-- [알려진 호환성 이슈]
-
-### ⚠️ 위험 요소
-- **기술적 위험**: [예상 문제점]
-- **의존성 위험**: [외부 의존성 이슈]
-- **일정 위험**: [지연 가능성]
-
-### ✅ 품질 게이트
-- **테스트 커버리지**: [목표 %]
-- **성능 목표**: [구체적 지표]
-- **보안 체크포인트**: [검증 항목]
-
----
-**승인 요청**: 위 계획으로 진행하시겠습니까?
-("진행", "수정 [내용]", "중단" 중 선택)
-```
-
----
-
-## 🚀 STEP 2 실행 가이드: TDD 구현 (승인 후)
-
-사용자가 **"진행"** 또는 **"시작"**을 선택한 경우에만 Alfred는 code-builder 에이전트를 호출하여 TDD 구현을 시작하고 RED-GREEN-REFACTOR 사이클을 수행합니다.
-
-### TDD 단계별 가이드
-
-1. **RED**: Given/When/Then 구조로 실패 테스트 작성. 언어별 테스트 파일 규칙을 따르고, 실패 로그를 간단히 기록합니다.
-2. **GREEN**: 테스트를 통과시키는 최소한의 구현만 추가합니다. 최적화는 REFACTOR 단계로 미룹니다.
-3. **REFACTOR**: 중복 제거, 명시적 네이밍, 구조화 로깅/예외 처리 보강. 필요 시 추가 커밋으로 분리합니다.
-
-**TRUST 5원칙 연계** (상세: `development-guide.md` - "TRUST 5원칙"):
-- **T (Test First)**: RED 단계에서 SPEC 기반 테스트 작성
-- **R (Readable)**: REFACTOR 단계에서 가독성 개선 (파일≤300 LOC, 함수≤50 LOC)
-- **T (Trackable)**: 모든 단계에서 @TAG 추적성 유지
-
-> TRUST 5원칙은 기본 권장치만 제공하므로, `simplicity_threshold`를 초과하는 구조가 필요하다면 SPEC 또는 ADR에 근거를 남기고 진행하세요.
-
-## 에이전트 역할 분리
-
-### code-builder 전담 영역
-
-- TDD Red-Green-Refactor 코드 구현
-- 테스트 작성 및 실행
-- TRUST 5원칙 검증
-- 코드 품질 체크
-- 언어별 린터/포매터 실행
-
-### git-manager 전담 영역
-
-- 모든 Git 커밋 작업 (add, commit, push)
-- TDD 단계별 체크포인트 생성
-- 모드별 커밋 전략 적용
-- 깃 브랜치/태그 관리
-- 원격 동기화 처리
-
-## 품질 게이트 체크리스트
-
-- 테스트 커버리지 ≥ `.moai/config.json.test_coverage_target` (기본 85%)
-- 린터/포매터 통과 (`ruff`, `eslint --fix`, `gofmt` 등)
-- 구조화 로깅 또는 관측 도구 호출 존재 확인
-- @TAG 업데이트 필요 변경 사항 메모 (다음 단계에서 doc-syncer가 사용)
-
----
-
-## 🧠 Context Management (컨텍스트 관리)
-
-> 자세한 내용: `.moai/memory/development-guide.md` - "Context Engineering" 섹션 참조
-
-### 이 커맨드의 핵심 전략
-
-**우선 로드**: `.moai/specs/SPEC-XXX/spec.md` (구현 대상 요구사항)
-**Compaction 권장**: TDD 구현 완료 후 `/alfred:3-sync` 진행 전
-
-**권장사항**: TDD 구현이 완료되었습니다. 다음 단계(`/alfred:3-sync`) 진행 전 `/clear` 또는 `/new` 명령으로 새로운 대화 세션을 시작하면 더 나은 성능과 컨텍스트 관리를 경험할 수 있습니다.
-
----
-
-## 다음 단계
-
-**권장사항**: 다음 단계 진행 전 `/clear` 또는 `/new` 명령으로 새로운 대화 세션을 시작하면 더 나은 성능과 컨텍스트 관리를 경험할 수 있습니다.
-
-- TDD 구현 완료 후 `/alfred:3-sync`로 문서 동기화 진행
-- 모든 Git 작업은 git-manager 에이전트가 전담하여 일관성 보장
-- 에이전트 간 직접 호출 없이 커맨드 레벨 오케스트레이션만 사용