aiwf 0.3.7 → 0.3.12

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

@@ -1,100 +0,0 @@
-#!/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

@@ -1,84 +0,0 @@
-#!/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

@@ -1,57 +0,0 @@
-# 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

@@ -1,44 +0,0 @@
-{
-  "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

@@ -1,136 +0,0 @@
-# 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 구현
-
-### 스프린트 종료 시
-- [ ] 아키텍처 일관성 검토
-- [ ] 기술 부채 평가
-- [ ] 성능 메트릭 확인
-- [ ] 문서 업데이트