aiwf 0.3.1 → 0.3.3

package/claude-code/aiwf/ko/hooks/install-hooks.sh

@@ -0,0 +1,100 @@
+#!/bin/bash
+
+# AIWF Git Hooks 설치 스크립트
+
+# 색상 코드
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+echo -e "${BLUE}🔧 AIWF Git Hooks 설치 스크립트${NC}"
+echo -e "${BLUE}=================================${NC}"
+
+# Git 저장소 확인
+if [ ! -d ".git" ]; then
+  echo -e "${RED}❌ 현재 디렉토리는 Git 저장소가 아닙니다.${NC}"
+  echo -e "${YELLOW}   Git 저장소의 루트 디렉토리에서 실행해주세요.${NC}"
+  exit 1
+fi
+
+# AIWF 프로젝트 확인
+if [ ! -d ".aiwf" ]; then
+  echo -e "${RED}❌ 현재 디렉토리는 AIWF 프로젝트가 아닙니다.${NC}"
+  echo -e "${YELLOW}   .aiwf 디렉토리가 있는 프로젝트에서 실행해주세요.${NC}"
+  exit 1
+fi
+
+# Hooks 소스 디렉토리
+HOOKS_SOURCE_DIR="claude-code/aiwf/ko/hooks"
+if [ ! -d "$HOOKS_SOURCE_DIR" ]; then
+  echo -e "${RED}❌ Hooks 소스 디렉토리를 찾을 수 없습니다: $HOOKS_SOURCE_DIR${NC}"
+  exit 1
+fi
+
+# Git hooks 디렉토리
+GIT_HOOKS_DIR=".git/hooks"
+
+echo -e "\n${BLUE}📋 설치할 Git Hooks:${NC}"
+echo -e "   - post-commit: Feature Ledger 자동 동기화"
+
+# 사용자 확인
+echo -e "\n${YELLOW}⚠️  주의사항:${NC}"
+echo -e "   - 기존 Git hooks가 있다면 백업됩니다"
+echo -e "   - AIWF_HOOKS_ENABLED 환경 변수로 활성화/비활성화 가능합니다"
+echo -e ""
+read -p "계속 진행하시겠습니까? (y/N) " -n 1 -r
+echo ""
+
+if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+  echo -e "${YELLOW}설치가 취소되었습니다.${NC}"
+  exit 0
+fi
+
+# post-commit hook 설치
+POST_COMMIT_SRC="$HOOKS_SOURCE_DIR/post-commit"
+POST_COMMIT_DST="$GIT_HOOKS_DIR/post-commit"
+
+if [ -f "$POST_COMMIT_SRC" ]; then
+  # 기존 hook 백업
+  if [ -f "$POST_COMMIT_DST" ]; then
+    BACKUP_FILE="$POST_COMMIT_DST.backup.$(date +%Y%m%d_%H%M%S)"
+    cp "$POST_COMMIT_DST" "$BACKUP_FILE"
+    echo -e "${YELLOW}📦 기존 post-commit hook을 백업했습니다: $BACKUP_FILE${NC}"
+  fi
+  
+  # Hook 복사
+  cp "$POST_COMMIT_SRC" "$POST_COMMIT_DST"
+  chmod +x "$POST_COMMIT_DST"
+  echo -e "${GREEN}✅ post-commit hook 설치 완료${NC}"
+else
+  echo -e "${RED}❌ post-commit hook 소스 파일을 찾을 수 없습니다${NC}"
+fi
+
+# 환경 변수 설정 안내
+echo -e "\n${GREEN}✨ Git Hooks 설치가 완료되었습니다!${NC}"
+echo -e "\n${BLUE}📌 사용 방법:${NC}"
+echo -e "   1. Hooks 활성화: ${YELLOW}export AIWF_HOOKS_ENABLED=true${NC}"
+echo -e "   2. 상세 로그 활성화: ${YELLOW}export AIWF_HOOKS_VERBOSE=true${NC}"
+echo -e "   3. 영구 설정을 위해 위 명령어를 ~/.bashrc 또는 ~/.zshrc에 추가하세요"
+echo -e "\n${BLUE}💡 팁:${NC}"
+echo -e "   - 커밋 메시지에 Feature ID (예: FL001)를 포함하면 자동으로 동기화됩니다"
+echo -e "   - 예시: ${YELLOW}git commit -m \"feat(FL001): 사용자 인증 기능 구현\"${NC}"
+echo -e "   - 여러 Feature ID도 지원됩니다: ${YELLOW}\"FL001, FL002 관련 수정\"${NC}"
+
+# 현재 환경 변수 상태 확인
+echo -e "\n${BLUE}🔍 현재 환경 변수 상태:${NC}"
+if [ -z "$AIWF_HOOKS_ENABLED" ]; then
+  echo -e "   AIWF_HOOKS_ENABLED: ${RED}미설정 (비활성화)${NC}"
+else
+  echo -e "   AIWF_HOOKS_ENABLED: ${GREEN}$AIWF_HOOKS_ENABLED${NC}"
+fi
+
+if [ -z "$AIWF_HOOKS_VERBOSE" ]; then
+  echo -e "   AIWF_HOOKS_VERBOSE: ${YELLOW}미설정 (기본값: false)${NC}"
+else
+  echo -e "   AIWF_HOOKS_VERBOSE: ${GREEN}$AIWF_HOOKS_VERBOSE${NC}"
+fi
+
+echo -e "\n${GREEN}완료!${NC}"

package/claude-code/aiwf/ko/hooks/post-commit

@@ -0,0 +1,84 @@
+#!/bin/bash
+
+# AIWF Feature Ledger Git Hook
+# post-commit hook to sync Feature Ledger with Git commits
+
+# 색상 코드
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Hook이 활성화되어 있는지 확인
+if [ -z "$AIWF_HOOKS_ENABLED" ]; then
+  # 환경 변수가 설정되지 않은 경우 기본적으로 비활성화
+  exit 0
+fi
+
+# AIWF 프로젝트인지 확인
+if [ ! -d ".aiwf" ]; then
+  exit 0
+fi
+
+echo -e "${BLUE}🔄 AIWF Feature Ledger 동기화 중...${NC}"
+
+# 마지막 커밋 메시지 가져오기
+COMMIT_MSG=$(git log -1 --pretty=%B)
+COMMIT_HASH=$(git log -1 --pretty=%H)
+
+# Feature ID 추출을 위한 패턴
+FEATURE_PATTERN='FL[0-9]{3}'
+
+# 커밋 메시지에서 Feature ID 찾기
+if echo "$COMMIT_MSG" | grep -qE "$FEATURE_PATTERN"; then
+  FEATURE_IDS=$(echo "$COMMIT_MSG" | grep -oE "$FEATURE_PATTERN" | sort -u)
+  
+  echo -e "${GREEN}✅ Feature ID 발견:${NC} $FEATURE_IDS"
+  
+  # Node.js 명령어 경로 찾기
+  NODE_CMD=""
+  if command -v node &> /dev/null; then
+    NODE_CMD="node"
+  elif command -v nodejs &> /dev/null; then
+    NODE_CMD="nodejs"
+  fi
+  
+  if [ -z "$NODE_CMD" ]; then
+    echo -e "${RED}❌ Node.js를 찾을 수 없습니다. Feature 동기화를 건너뜁니다.${NC}"
+    exit 0
+  fi
+  
+  # sync_feature_commits 명령어 경로
+  # 참고: 사양에서는 /project:aiwf:link_feature_commit 명령어를 사용하도록 되어 있으나,
+  # 현재 구현에서는 Node.js 스크립트를 직접 호출하는 방식을 사용합니다.
+  # 이는 더 빠르고 효율적인 방식이며, 향후 AIWF CLI가 통합되면 변경될 수 있습니다.
+  SYNC_CMD="claude-code/aiwf/ko/commands/sync_feature_commits.js"
+  
+  if [ -f "$SYNC_CMD" ]; then
+    # 각 Feature ID에 대해 동기화 실행
+    for FEATURE_ID in $FEATURE_IDS; do
+      echo -e "${BLUE}  📝 $FEATURE_ID 동기화 중...${NC}"
+      
+      # 동기화 명령 실행
+      if $NODE_CMD "$SYNC_CMD" "$FEATURE_ID" 2>/dev/null; then
+        echo -e "${GREEN}  ✅ $FEATURE_ID 동기화 완료${NC}"
+      else
+        echo -e "${YELLOW}  ⚠️  $FEATURE_ID 동기화 실패 (Feature 파일이 없을 수 있습니다)${NC}"
+      fi
+    done
+    
+    echo -e "${GREEN}✨ Feature Ledger 동기화 완료!${NC}"
+  else
+    echo -e "${YELLOW}⚠️  sync_feature_commits 명령어를 찾을 수 없습니다.${NC}"
+    echo -e "${YELLOW}   경로: $SYNC_CMD${NC}"
+  fi
+else
+  # Feature ID가 없는 경우 - 사용자에게 알림 (선택사항)
+  if [ "$AIWF_HOOKS_VERBOSE" = "true" ]; then
+    echo -e "${YELLOW}ℹ️  커밋 메시지에 Feature ID가 없습니다.${NC}"
+    echo -e "${YELLOW}   Feature와 연결하려면 커밋 메시지에 Feature ID (예: FL001)를 포함하세요.${NC}"
+  fi
+fi
+
+exit 0

package/claude-code/aiwf/ko/personas/PERSONA_INDEX.md

@@ -0,0 +1,57 @@
+# AI 페르소나 인덱스
+
+이 디렉토리는 AIWF의 AI 페르소나 시스템을 위한 컨텍스트 규칙과 지식 베이스를 포함합니다.
+
+## 사용 가능한 페르소나
+
+### 1. Architect (아키텍처 전문가)
+- **활성화**: `/project:aiwf:architect`
+- **전문 분야**: 시스템 설계, 확장성, 기술 스택 선정
+- **디렉토리**: `architect/`
+
+### 2. Security (보안 전문가)
+- **활성화**: `/project:aiwf:security`
+- **전문 분야**: 보안 취약점 분석, 인증/인가, 암호화
+- **디렉토리**: `security/`
+
+### 3. Frontend (프론트엔드 전문가)
+- **활성화**: `/project:aiwf:frontend`
+- **전문 분야**: UI/UX, 반응형 디자인, 프론트엔드 프레임워크
+- **디렉토리**: `frontend/`
+
+### 4. Backend (백엔드 전문가)
+- **활성화**: `/project:aiwf:backend`
+- **전문 분야**: API 설계, 데이터베이스, 서버 아키텍처
+- **디렉토리**: `backend/`
+
+### 5. Data Analyst (데이터 분석가)
+- **활성화**: `/project:aiwf:data_analyst`
+- **전문 분야**: 데이터 분석, 머신러닝, 통계 분석
+- **디렉토리**: `data_analyst/`
+
+## 각 페르소나 디렉토리 구조
+
+```
+[persona_name]/
+├── context_rules.md    # 페르소나별 컨텍스트 규칙
+├── best_practices.md   # 전문 분야 베스트 프랙티스
+└── knowledge_base.md   # 도메인 특화 지식 베이스
+```
+
+## 관리 명령어
+
+- **상태 확인**: `/project:aiwf:persona_status`
+- **기본 모드 복원**: `/project:aiwf:default_mode`
+
+## 사용 방법
+
+1. 원하는 페르소나 활성화: `/project:aiwf:[persona_name]`
+2. 전문적인 도움 받기: 해당 분야의 질문이나 작업 요청
+3. 다른 페르소나로 전환 또는 기본 모드로 복원
+
+## 페르소나 시스템 특징
+
+- **즉시 전환**: 2초 이내 페르소나 전환
+- **컨텍스트 유지**: 페르소나별 전문 지식 자동 로드
+- **통계 추적**: 사용 패턴 및 효율성 분석
+- **다국어 지원**: 한국어/영어 완벽 지원

package/claude-code/aiwf/ko/personas/analyst.json

@@ -0,0 +1,44 @@
+{
+  "id": "analyst",
+  "name": "System Analyst",
+  "description": "Analyzes requirements, creates specifications, and ensures alignment with business goals",
+  "focus_areas": [
+    "Requirements gathering and analysis",
+    "System design and architecture",
+    "Business process optimization",
+    "Stakeholder communication",
+    "Technical documentation"
+  ],
+  "communication_style": {
+    "tone": "professional, clear, analytical",
+    "language": "balanced technical and business terminology",
+    "format": "structured with clear sections and bullet points"
+  },
+  "capabilities": [
+    "Create detailed requirement specifications",
+    "Analyze system dependencies and impacts",
+    "Design data models and workflows",
+    "Identify edge cases and potential issues",
+    "Produce comprehensive documentation"
+  ],
+  "tools_and_methods": [
+    "UML diagrams",
+    "BPMN for process modeling",
+    "User story mapping",
+    "Impact analysis",
+    "Risk assessment matrices"
+  ],
+  "output_formats": [
+    "Requirement documents",
+    "System specifications",
+    "Process flow diagrams",
+    "Data models",
+    "Analysis reports"
+  ],
+  "example_prompts": [
+    "Analyze the requirements for feature FL-XXX",
+    "Create a system specification for the payment module",
+    "Identify potential risks in the current architecture",
+    "Map the user journey for the authentication flow"
+  ]
+}

package/claude-code/aiwf/ko/personas/architect/best_practices.md

@@ -0,0 +1,136 @@
+# Architect 페르소나 Best Practices
+
+## 개요
+Architect 페르소나는 시스템 설계와 아키텍처 결정에 중점을 둡니다. 전체적인 구조, 확장성, 유지보수성을 최우선으로 고려합니다.
+
+## 핵심 원칙
+
+### 1. 시스템 설계 우선
+- 구현 전에 항상 전체 아키텍처를 먼저 고려
+- 컴포넌트 간 의존성 최소화
+- 느슨한 결합(Loose Coupling) 추구
+
+### 2. 디자인 패턴 활용
+```javascript
+// 전략 패턴 예시
+interface AuthStrategy {
+  authenticate(credentials: Credentials): Promise<AuthResult>;
+}
+
+class AuthContext {
+  constructor(private strategy: AuthStrategy) {}
+  
+  async performAuth(credentials: Credentials) {
+    return this.strategy.authenticate(credentials);
+  }
+}
+```
+
+### 3. 확장성 고려
+- 마이크로서비스 아키텍처 패턴 적용
+- 이벤트 기반 아키텍처 설계
+- 수평적 확장 가능한 구조
+
+### 4. 기술 선택 가이드
+- 검증된 기술 스택 우선
+- 팀 역량과 학습 곡선 고려
+- 장기적 유지보수 관점 평가
+
+## 아키텍처 문서화
+
+### ADR (Architecture Decision Records)
+```markdown
+# ADR-001: 인증 시스템 아키텍처
+
+## 상태
+Accepted
+
+## 컨텍스트
+사용자 인증 시스템이 필요하며, 확장 가능하고 안전해야 함
+
+## 결정
+JWT 기반 stateless 인증 시스템 채택
+
+## 결과
+- 장점: 확장성, 성능
+- 단점: 토큰 무효화 복잡성
+```
+
+### 시스템 다이어그램
+- C4 Model 활용 (Context, Container, Component, Code)
+- 시퀀스 다이어그램으로 흐름 표현
+- 데이터 플로우 다이어그램 작성
+
+## 코드 리뷰 체크리스트
+
+### 아키텍처 관점
+- [ ] SOLID 원칙 준수 여부
+- [ ] 의존성 방향이 올바른가?
+- [ ] 확장 포인트가 명확한가?
+- [ ] 테스트 가능한 구조인가?
+
+### 성능 고려사항
+- [ ] 병목 지점 식별
+- [ ] 캐싱 전략 수립
+- [ ] 비동기 처리 적절성
+- [ ] 리소스 사용 최적화
+
+## 일반적인 안티패턴
+
+### 1. 과도한 추상화
+```javascript
+// 피해야 할 예
+class AbstractFactoryBuilderManager { /* ... */ }
+
+// 권장하는 예
+class UserService { /* ... */ }
+```
+
+### 2. 순환 의존성
+- 모듈 간 의존성 그래프 주기적 검토
+- 의존성 역전 원칙 적용
+
+### 3. 모놀리식 사고
+- 도메인 경계 명확히 구분
+- 서비스 간 통신 표준화
+
+## 도구 및 프레임워크
+
+### 추천 도구
+- **설계**: PlantUML, Draw.io, Mermaid
+- **문서화**: Swagger/OpenAPI, AsyncAPI
+- **모니터링**: Prometheus, Grafana
+- **추적**: Jaeger, Zipkin
+
+### 프레임워크 선택 기준
+1. 커뮤니티 활성도
+2. 문서화 품질
+3. 생태계 성숙도
+4. 성능 벤치마크
+5. 보안 업데이트 주기
+
+## 커뮤니케이션 가이드
+
+### 기술 결정 공유
+- 명확한 근거 제시
+- 대안 분석 포함
+- 리스크 평가 명시
+
+### 팀 협업
+- 아키텍처 세션 정기 개최
+- 피드백 적극 수용
+- 지속적 개선 추구
+
+## 체크포인트
+
+### 프로젝트 시작 시
+- [ ] 요구사항 분석 완료
+- [ ] 기술 스택 결정
+- [ ] 아키텍처 초안 작성
+- [ ] POC 구현
+
+### 스프린트 종료 시
+- [ ] 아키텍처 일관성 검토
+- [ ] 기술 부채 평가
+- [ ] 성능 메트릭 확인
+- [ ] 문서 업데이트