aiwf 0.3.4 → 0.3.6

package/.aiwf/00_PROJECT_MANIFEST.md

@@ -2,10 +2,10 @@
 
 **프로젝트명**: AIWF (AI Workflow Framework)  
 **생성일**: 2025-07-02  
-**마지막 업데이트**: 2025-07-10  
+**마지막 업데이트**: 2025-07-16  
 **프로젝트 유형**: Node.js NPM 패키지  
-**현재 버전**: 0.3.0
-**최고 마일스톤**: M02
+**현재 버전**: 0.3.1
+**최고 마일스톤**: M03
 **최고 스프린트**: S03
 
 ## 프로젝트 개요
@@ -31,7 +31,6 @@ AIWF는 Claude Code와의 통합을 위해 설계된 마크다운 기반 프로
 ### 진행 중
 
 - **T14_S03**: 기본 프로젝트 템플릿 구축 (in_progress → 2025-07-10 06:20 시작)
-
 ### 계획됨
 
 - 계획된 태스크 없음
@@ -66,9 +65,11 @@ AIWF는 Claude Code와의 통합을 위해 설계된 마크다운 기반 프로
 | ID  | 이름                            | 상태    | 진행률 | 시작일     | 완료일 |
 | --- | ------------------------------- | ------- | ------ | ---------- | ------ |
 | M02 | Context_Engineering_Enhancement | 완료 | 100%   | 2025-07-08 | 2025-07-08 |
+| M03 | AIWF_Simplification_Reliability | 계획 중 | 0%    | TBD        | TBD    |
 
 ### 마일스톤 상세
 - [x] [M02: Context Engineering Enhancement](02_REQUIREMENTS/M02_Context_Engineering_Enhancement/M02_milestone_meta.md) - 상태: 완료
+- [ ] [M03: AIWF 단순화 및 신뢰성 강화](02_REQUIREMENTS/M03_Simone_Integration_Enhancement/M03_milestone_meta.md) - 상태: 계획 중
 
 ## 스프린트 목록
 
@@ -161,23 +162,35 @@ AIWF는 Claude Code와의 통합을 위해 설계된 마크다운 기반 프로
 
 ## 향후 계획
 
+### M03: AIWF 단순화 및 신뢰성 강화 (계획 중)
+
+**목표**: 태스크 상태 불일치 해결 및 CLI 인터페이스 단순화
+
+1. **Week 1: 프로젝트 정리 및 기초 구축**:
+   - 프로젝트 구조 정리 (중복 파일 제거, 모듈화)
+   - JSON 기반 태스크 인덱스 시스템 설계
+   - CLI 실행 파일 기본 구현
+
+2. **Week 2: 핵심 기능 구현**:
+   - 태스크 무결성 검사 시스템
+   - 안전한 상태 변경 명령어
+   - 기본 AI 도우미 (research, plan)
+
+3. **Week 3: 통합 및 완성**:
+   - 향상된 사용자 경험 (컬러 출력, 에러 메시지)
+   - 테스트 및 문서화
+   - v0.4.0 릴리즈 준비
+
+**제거된 오버엔지니어링**: SQLite DB, MCP 서버 통합, 웹 대시보드, 병렬 처리
+
+### 레거시 목표
+
 1. **즉시 조치 필요 사항**:
    - Feature Ledger CLI 명령어 구현 (aiwf_create_feature_ledger, aiwf_update_feature_status 등)
    - AI 도구 템플릿 4개 추가 (GitHub Copilot, Cursor, Windsurf, Augment)
    - 프로젝트 템플릿 시스템 구현
    - `.aiwf/ai-tools/` 및 `.aiwf/07_AI_PERSONAS/` 디렉토리 생성
 
-2. **단기 목표 (1-2주)**:
-   - M02 DoD 항목 완전 충족
-   - 테스크 파일과 구현 상태 동기화
-   - 누락된 기능 구현 완료
-
-3. **중기 목표 (1개월)**:
-   - 다음 마일스톤 계획 수립
-   - 사용자 피드백 반영
-   - 프로덕션 준비
-
-4. **장기 목표 (분기)**:
+2. **장기 목표**:
    - 새로운 언어 지원 추가
-   - AI 도구 통합 확대
    - 커뮤니티 생태계 구축

package/.aiwf/02_REQUIREMENTS/M03_Simone_Integration_Enhancement/M03_milestone_meta.md

@@ -0,0 +1,55 @@
+# M03: AIWF 단순화 및 신뢰성 강화
+
+**생성일**: 2025-07-16 11:45:29  
+**수정일**: 2025-07-16 17:20:00  
+**상태**: 계획 중  
+**우선순위**: 높음  
+**예상 완료**: 2025-08-06 (3주)  
+
+## 마일스톤 개요
+
+AIWF 프레임워크의 핵심 문제인 태스크 상태 불일치를 해결하고, 복잡한 CLI 인터페이스를 단순화하여 신뢰할 수 있는 프로젝트 관리 도구로 발전시키는 마일스톤입니다.
+
+## 핵심 목표
+
+### 태스크 무결성 보장
+- [ ] JSON 기반 태스크 인덱스 구현
+- [ ] 파일-인덱스 간 무결성 검사 도구
+- [ ] 안전한 상태 변경 시스템
+
+### 사용성 개선
+- [ ] 간단한 CLI 실행 파일 (`aiwf` 명령어)
+- [ ] 직관적인 상태 표시 및 에러 메시지
+- [ ] 자동완성 및 도움말 시스템
+
+### 기본 AI 도우미
+- [ ] 프로젝트 내 검색 (`aiwf research`)
+- [ ] 간단한 계획 도움 (`aiwf plan`)
+- [ ] 페르소나 기반 응답
+
+## 제거된 오버엔지니어링 항목
+
+- ~~SQLite 데이터베이스~~ → JSON 인덱스
+- ~~MCP 서버 통합~~ → 제거
+- ~~고급 웹 대시보드~~ → 터미널 출력
+- ~~병렬 처리 시스템~~ → 제거
+- ~~지능형 자동화~~ → 제거
+
+## 예상 결과물
+
+1. **AIWF v0.4.0**: 신뢰할 수 있는 단순한 태스크 관리 시스템
+2. **통합 CLI**: 직관적인 명령어 인터페이스
+3. **무결성 보장**: 태스크 상태 불일치 0% 달성
+4. **모듈화**: 큰 파일 분리로 유지보수성 향상
+
+## 성공 지표
+
+- 태스크 상태 불일치: 0% 달성
+- CLI 명령어 타이핑: 50% 감소
+- 무결성 검사 시간: < 1초
+- 새 사용자 학습 시간: 10분 이내
+
+## 관련 문서
+
+- [단순화 구현 계획](SPECS_AIWF_Simplified_Plan.md)
+- [M02 Context Engineering 완료 상태](../M02_Context_Engineering_Enhancement/M02_milestone_meta.md)

package/.aiwf/02_REQUIREMENTS/M03_Simone_Integration_Enhancement/SPECS_AIWF_Simplified_Plan.md

@@ -0,0 +1,221 @@
+# AIWF 단순화 계획: 신뢰할 수 있는 단순함
+
+**생성일**: 2025-07-16 17:20:00  
+**버전**: v0.3.1 → v0.4.0  
+**기간**: 3주 계획  
+**기반**: steig/claude-simone 분석 + 오버엔지니어링 제거  
+
+## 📋 프로젝트 개요
+
+### 현재 상태
+- **AIWF v0.3.1**: 마크다운 기반 프로젝트 관리 프레임워크
+- **완료된 기능**: Feature Ledger, AI 페르소나, Context 압축, AI 도구 통합
+- **핵심 문제**: LLM 실수로 인한 태스크 상태 불일치, 복잡한 CLI 인터페이스
+
+### 목표 상태
+- **AIWF v0.4.0**: 신뢰할 수 있는 단순한 태스크 관리 시스템
+- **핵심 가치**: 단순함, 신뢰성, 사용 편의성
+- **경쟁력**: 파일 기반 + 무결성 보장
+
+---
+
+## 🎯 핵심 문제 해결
+
+### 1. 태스크 상태 불일치 문제
+**현재 문제**:
+```
+- 진행중/완료/대기 태스크 수 불일치
+- LLM이 파일 업데이트 시 실수
+- 수동으로 매번 확인 필요
+- 일관성 없는 상태 관리
+```
+
+**해결 방안**:
+- JSON 기반 태스크 인덱스 (`task-index.json`)
+- 무결성 검사 도구 (`aiwf check`)
+- 안전한 상태 변경 (`aiwf task done TX001`)
+
+### 2. 복잡한 CLI 인터페이스
+**현재 문제**:
+```bash
+# 너무 복잡한 경로
+node claude-code/aiwf/ko/commands/ai-persona.js activate backend
+```
+
+**해결 방안**:
+```bash
+# 간단한 명령어
+aiwf persona activate backend
+aiwf status
+aiwf task done TX001
+```
+
+---
+
+## 🚀 3주 개발 계획
+
+### Week 1: 프로젝트 정리 및 기초 구축
+#### Day 1-2: 프로젝트 구조 정리
+- [x] 백업 파일 및 중복 파일 제거
+- [x] 언어별 중복 구조 분석
+- [ ] 큰 파일 모듈화 (index.js 1,950줄 → 모듈별 분리)
+
+#### Day 3-4: 태스크 인덱스 시스템 설계
+- [ ] JSON 기반 태스크 인덱스 구조 설계
+- [ ] 파일 스캔 및 상태 추출 로직 구현
+- [ ] 무결성 검사 알고리즘 구현
+
+#### Day 5-7: CLI 실행 파일 기본 구현
+- [ ] `bin/aiwf` 실행 파일 생성
+- [ ] 기본 명령어 매핑 (`status`, `help`, `version`)
+- [ ] 프로젝트 루트 자동 탐지
+
+### Week 2: 핵심 기능 구현
+#### Day 8-10: 태스크 무결성 시스템
+- [ ] 태스크 상태 추출 및 인덱싱
+- [ ] 불일치 감지 및 리포팅
+- [ ] 자동 수정 제안 시스템
+
+#### Day 11-12: 안전한 상태 변경
+- [ ] `aiwf task done/start/block` 명령어
+- [ ] 원자적 파일 업데이트
+- [ ] 롤백 메커니즘
+
+#### Day 13-14: 기본 AI 도우미
+- [ ] `aiwf research` - 프로젝트 내 검색
+- [ ] `aiwf plan` - 간단한 계획 도움
+- [ ] 페르소나 기반 응답
+
+### Week 3: 통합 및 완성
+#### Day 15-17: 향상된 사용자 경험
+- [ ] 컬러풀한 출력 및 진행 표시
+- [ ] 에러 메시지 개선
+- [ ] 자동완성 지원
+
+#### Day 18-19: 테스트 및 문서화
+- [ ] 통합 테스트 작성
+- [ ] 사용자 가이드 업데이트
+- [ ] 성능 벤치마크
+
+#### Day 20-21: 릴리즈 준비
+- [ ] 버전 0.4.0 패키징
+- [ ] 호환성 테스트
+- [ ] 릴리즈 노트 작성
+
+---
+
+## 📊 기술 명세
+
+### 태스크 인덱스 구조
+```json
+{
+  "lastUpdated": "2025-07-16T17:20:00Z",
+  "summary": {
+    "total": 45,
+    "pending": 12,
+    "in_progress": 3,
+    "completed": 30
+  },
+  "tasks": {
+    "TX001": {
+      "file": "04_GENERAL_TASKS/TX001_api_optimization.md",
+      "title": "API 최적화",
+      "status": "completed",
+      "priority": "high",
+      "updated": "2025-07-15T10:30:00Z"
+    }
+  }
+}
+```
+
+### CLI 명령어 구조
+```bash
+# 핵심 명령어
+aiwf status                    # 프로젝트 상태 표시
+aiwf check                     # 무결성 검사
+aiwf fix                       # 자동 수정
+aiwf task done TX001          # 태스크 완료
+aiwf task start TX002         # 태스크 시작
+aiwf research "API 최적화"     # 프로젝트 내 검색
+aiwf plan "인증 시스템"        # 계획 도움
+```
+
+### 파일 구조 (모듈화)
+```
+lib/
+├── installer.js              # 설치 관련 로직
+├── language-detector.js      # 언어 감지
+├── template-manager.js       # 템플릿 관리
+├── task-index.js             # 태스크 인덱싱
+├── integrity-checker.js      # 무결성 검사
+└── ai-helper.js              # AI 도우미
+```
+
+---
+
+## ❌ 제거된 오버엔지니어링 항목들
+
+### 제거된 복잡한 기능들
+- ~~SQLite 데이터베이스~~ → JSON 인덱스
+- ~~MCP 서버 통합~~ → 제거
+- ~~고급 웹 대시보드~~ → 터미널 출력
+- ~~병렬 처리 시스템~~ → 제거
+- ~~지능형 자동화~~ → 제거
+- ~~다층 캐싱 시스템~~ → 간단한 메모리 캐시
+
+### 제거 이유
+1. **복잡성 증가**: 유지보수 비용 증가
+2. **사용 빈도 낮음**: 실제 사용하지 않을 기능들
+3. **핵심 문제 해결과 거리멀음**: 태스크 상태 불일치 해결이 우선
+4. **단순함 추구**: 신뢰할 수 있는 단순함이 목표
+
+---
+
+## 🎯 성공 지표
+
+### 기능성 지표
+- [ ] 태스크 상태 불일치 0% 달성
+- [ ] CLI 명령어 타이핑 50% 감소
+- [ ] 무결성 검사 시간 < 1초
+
+### 사용성 지표
+- [ ] 새 사용자 10분 내 기본 사용 가능
+- [ ] 에러 메시지 이해도 90% 이상
+- [ ] 문서 없이도 직관적 사용 가능
+
+### 신뢰성 지표
+- [ ] 파일 손상 없는 상태 변경
+- [ ] 롤백 성공률 100%
+- [ ] 동시 수정 충돌 방지
+
+---
+
+## 🔧 다음 액션 아이템
+
+### 이번 주 (Week 1)
+1. **index.js 모듈화**
+   ```bash
+   mkdir -p lib
+   # 1,950줄 파일을 기능별로 분리
+   ```
+
+2. **태스크 인덱스 프로토타입**
+   ```bash
+   # .aiwf/state/task-index.json 생성
+   # 기본 스캔 로직 구현
+   ```
+
+3. **CLI 실행 파일 기본 구조**
+   ```bash
+   mkdir -p bin
+   touch bin/aiwf
+   chmod +x bin/aiwf
+   ```
+
+### 핵심 원칙
+- **파일이 진실의 원천**: 인덱스는 캐시일 뿐
+- **언제든 재생성 가능**: 데이터 손실 방지
+- **수동 편집 항상 가능**: 복잡한 GUI 없이
+- **Git으로 모든 변경 추적**: 투명성 보장
+
+이 계획은 **신뢰할 수 있는 단순함**을 추구하며, 실제 사용자가 겪는 핵심 문제를 해결하는 데 집중합니다.

package/.aiwf/03_SPRINTS/S03_M02_ecosystem_integration/S03_M02_sprint_meta.md

@@ -74,7 +74,6 @@ last_updated: 2025-07-08T18:35:00Z
 - [x] 한국어/영어 100% 지원
 
 ## 태스크 목록
-
 ### AI 도구 통합 (1개 태스크)
 - [x] [TX_T13_S03: AI 도구 통합 템플릿 개발](TX_T13_S03_AI_도구_통합_템플릿_개발.md)
 

package/.aiwf/metrics/metrics.json

@@ -0,0 +1,18 @@
+{
+  "sessions": [],
+  "personaPerformance": {},
+  "taskOutcomes": [],
+  "aggregated": {
+    "eventCounts": {
+      "persona_switch": 1
+    },
+    "personaSwitches": [
+      {
+        "from": "developer",
+        "to": "architect",
+        "trigger": "auto",
+        "timestamp": 1752885541651
+      }
+    ]
+  }
+}

package/.aiwf/personas/current.json

@@ -0,0 +1,5 @@
+{
+  "name": "developer",
+  "description": "일반 개발자 (기본값)",
+  "activatedAt": "2025-07-19T01:15:42.150Z"
+}

package/.aiwf/test-results-s02.json

@@ -4,27 +4,27 @@
     {
       "name": "Persona Switching Time",
       "status": "passed",
-      "executionTime": 0.3060533329999998,
+      "executionTime": 0.303858287,
       "criteria": "< 2 seconds"
     },
     {
       "name": "Pre-commit Hook Installation",
       "status": "passed",
-      "executionTime": 0.0006559580000002824,
+      "executionTime": 0.007028295000000071,
       "criteria": "Hook installed or installable"
     },
     {
       "name": "Multi-language Support",
       "status": "passed",
-      "executionTime": 0.0004612090000000535,
+      "executionTime": 0.0037783789999994042,
       "criteria": "Korean/English commands"
     },
     {
       "name": "Performance Baseline",
       "status": "passed",
-      "executionTime": 0.05384158300000035,
+      "executionTime": 0.0728547009999993,
       "criteria": "< 5 seconds total",
-      "actualValue": "0.05s"
+      "actualValue": "0.07s"
     }
   ],
   "summary": {