aiwf 0.3.3 → 0.3.4

package/.claude/commands/aiwf/aiwf_do_task.md

@@ -0,0 +1,109 @@
+# 인수 기반 AIWF 태스크 처리
+
+**중요:** 위에서 아래로 순서대로 진행하세요 - 단계를 건너뛰지 마세요!
+
+**정확히 다음 8개 항목으로 할 일 목록을 생성하세요**
+
+1. 인수에서 범위 분석
+2. 태스크 파일 식별
+3. 태스크 분석
+4. 상태를 진행 중으로 설정
+5. 태스크 작업 실행
+6. 플레이스홀더
+7. 코드 리뷰 실행
+8. 태스크 상태 완료 처리
+
+## 1 · 인수에서 범위 분석
+
+<$ARGUMENTS> ⇒ 태스크 ID, 스프린트 ID, 또는 빈 값 (현재 스프린트에서 다음 열린 태스크 선택).
+
+## 2 · 태스크 파일 식별
+
+.aiwf/03_SPRINTS/와 .aiwf/04_GENERAL_TASKS/에서 검색합니다.
+일치하는 열린 태스크가 없으면 일시정지하고 사용자에게 진행 방법을 문의합니다.
+
+## 3 · 태스크 분석
+
+태스크 설명을 읽습니다. 불분명한 점이 있으면 계속하기 전에 명확화 질문을 합니다.
+
+**중요한 맥락 검증:** 태스크를 실행하기 전에 다음 작업들을 위한 병렬 서브에이전트를 실행합니다:
+
+1. **스프린트 맥락:** 태스크가 현재 스프린트 범위에 속하는지 확인
+2. **의존성:** 먼저 완료해야 할 의존 태스크가 있는지 확인
+3. **요구사항:** `.aiwf/02_REQUIREMENTS/`에서 관련 요구사항 문서 읽기
+4. **범위 검증:** 태스크가 현재 스프린트 목표와 일치하는지 확인
+5. **GitHub 이슈 확인:** 태스크 파일에 `github_issue` 필드가 있는지 확인
+
+**중요:** 태스크가 미래 스프린트의 기능을 참조하거나 충족되지 않은 의존성이 있으면 일시정지하고 명확화를 요청합니다.
+
+**GitHub 이슈 생성 (선택사항):**
+
+- 태스크에 GitHub 이슈가 없고 사용자가 이슈 추적을 원하는 경우
+- `/project:aiwf:issue_create {task_id}` 명령어 사용을 제안합니다
+
+## 4 · 상태를 진행 중으로 설정
+
+- 현재 로컬 타임스탬프 확인 (YYYY-MM-DD HH:MM)
+- 프론트매터의 **status: in_progress**로 업데이트하고 업데이트 시간 설정
+- ./aiwf/00_PROJECT_MANIFEST.md에서 태스크 진행 중, 업데이트 시간, 현재 스프린트 상태로 업데이트
+- **GitHub 이슈 업데이트 (존재하는 경우):**
+  ```bash
+  gh issue comment {issue_number} --body "🚀 태스크 작업이 시작되었습니다."
+  gh issue edit {issue_number} --add-label "in-progress"
+  ```
+
+## 5 · 태스크 작업 실행
+
+- 설명, 목표, 승인 기준을 따릅니다
+- .aiwf/01_PROJECT_DOCS/와 .aiwf/02_REQUIREMENTS/의 지원 문서를 참조합니다
+- 하위 태스크를 반복 처리:
+  1. 다음 미완료 하위 태스크를 선택합니다
+  2. 필요에 따라 문서를 참조하여 필요한 변경사항을 구현합니다
+  3. 하위 태스크를 완료로 표시합니다
+  4. `[YYYY-MM-DD HH:MM]: <메시지>` 형식으로 **## 출력 로그**에 로그 항목을 추가합니다
+  5. 모든 하위 태스크가 완료될 때까지 반복합니다
+
+## 6 · 플레이스홀더
+
+플레이스홀더 - 다음 단계로 진행하세요
+
+## 7 · 코드 리뷰 실행
+
+코드 리뷰를 위해 다음 단계를 순서대로 수행합니다
+
+- @.claude/commands/aiwf/aiwf_code_review.md를 포함하고 태스크 ID를 범위로 사용합니다
+- 파일의 지침에 따라 **병렬 서브에이전트**에서 코드 리뷰를 실행합니다
+- 완료되면 결과에 따라 적절히 조치합니다
+- 결과를 이해하고 분석합니다
+- **실패** 시:
+  - 문제를 철저히 이해합니다
+  - 리뷰에서 식별된 하위 태스크로 현재 태스크를 확장합니다
+  - "5 · 태스크 작업 실행"으로 돌아갑니다
+- **통과** 시:
+  - 다음 단계로 진행합니다
+
+## 8 · 태스크 상태 완료 처리
+
+- 태스크 상태를 **completed**로 설정합니다
+- 파일명에서 완료 인식이 가능하도록 태스크 파일명을 적절히 변경합니다 (TX[TASK_ID]...)
+- .aiwf/00_PROJECT_MANIFEST.md를 업데이트하여 새 상태를 반영합니다
+- **GitHub 이슈 업데이트 (존재하는 경우):**
+  ```bash
+  gh issue comment {issue_number} --body "✅ 태스크가 완료되었습니다."
+  gh issue edit {issue_number} --remove-label "in-progress" --add-label "completed"
+  ```
+- 사용자에게 **결과 보고**
+
+  ✅ **결과**: 성공에 대한 간단한 설명
+
+  🔎 **범위**: 식별된 태스크 또는 처리되지 않은 이유
+
+  💬 **요약**: 수행된 작업 또는 차단된 이유에 대한 한 문단 요약
+
+  ⏭️ **다음 단계**: 권장 후속 조치
+
+- 사용자를 위한 **제안**:
+
+  - 🛠️ /project:aiwf:commit `TASK_ID`를 사용하여 변경사항을 git에 커밋
+  - 🔀 /project:aiwf:pr_create `TASK_ID`를 사용하여 Pull Request 생성
+  - 🧹 /clear를 사용하여 다음 태스크 시작 전 컨텍스트 정리

package/.claude/commands/aiwf/aiwf_docs.md

@@ -0,0 +1,225 @@
+# 문서 업데이트
+
+현재 프로젝트 문서를 분석하고 구현 진행 상황과 최근 변경 사항을 반영하도록 업데이트합니다.
+
+## 정확히 다음 10개 항목으로 TODO 생성
+
+1. 문서 업데이트 범위 분석
+2. 프로젝트 매니페스트 및 마일스톤 검토
+3. 스프린트 문서 상태 평가
+4. 필요시 ARCHITECTURE.md 업데이트
+5. 마일스톤 요구사항 문서 업데이트
+6. 스프린트 문서 업데이트
+7. PROJECT_MANIFEST.md 검토 및 업데이트
+8. README.md 및 프로젝트 문서 업데이트
+9. 추가 문서 폴더 업데이트
+10. 문서 업데이트 요약 생성
+
+각 단계별로 다음 지침을 엄격히 따라 진행하세요.
+
+## 각 TODO 항목의 상세 내용
+
+### 1. 문서 업데이트 범위 분석
+
+확인: <$ARGUMENTS>
+
+비어있으면 전체 문서 검토를 수행합니다. 그렇지 않으면 <$ARGUMENTS>를 해석하여 특정 초점 영역(마일스톤, 스프린트, 아키텍처 구성 요소 등)을 식별합니다.
+
+**중요:** 먼저 `.aiwf/00_PROJECT_MANIFEST.md`를 읽어 다음을 이해하세요:
+- 현재 마일스톤 및 스프린트 상태
+- 완료된 작업 vs 진행 중인 작업 vs 계획된 작업
+- 문서화가 필요한 최근 변경 사항
+
+### 2. 프로젝트 매니페스트 및 마일스톤 검토
+
+**병렬 에이전트 사용:**
+- `.aiwf/00_PROJECT_MANIFEST.md`를 읽어 현재 상태 확인
+- `.aiwf/02_REQUIREMENTS/`의 모든 마일스톤 요구사항 읽기
+- 마지막 문서 업데이트 이후 변경된 사항 식별
+- 상태 업데이트가 필요한 완료된 마일스톤 확인
+
+### 3. 스프린트 문서 상태 평가
+
+**병렬 에이전트 사용:**
+- `.aiwf/03_SPRINTS/`로 이동하여 현재 및 완료된 스프린트 찾기
+- 스프린트 메타 파일을 읽어 산출물 이해
+- 각 스프린트 내 작업 완료 상태 확인
+- 상태 업데이트나 완료 표시가 필요한 스프린트 식별
+
+### 4. 필요시 ARCHITECTURE.md 업데이트
+
+- `.aiwf/01_PROJECT_DOCS/ARCHITECTURE.md` 읽기
+- 구현을 검토하여 아키텍처가 발전했는지 확인
+- 구조가 변경된 경우 다이어그램 업데이트
+- 구현 중 발견된 새 컴포넌트나 모듈 추가
+- 최근 스프린트 동안 내려진 아키텍처 결정 문서화
+
+**중요:** 아키텍처가 실제로 변경된 경우에만 업데이트하세요. 사소한 세부사항으로 수정하지 마세요.
+
+### 5. 마일스톤 요구사항 문서 업데이트
+
+활성 또는 최근 완료된 각 마일스톤에 대해:
+- `.aiwf/02_REQUIREMENTS/M{N}_*/`로 이동
+- `requirements.md`를 다음과 함께 업데이트:
+  - ✅ 완료된 요구사항
+  - 🚧 진행 중인 항목 (완료율 포함)
+  - 📋 아직 시작하지 않은 계획된 항목
+  - ❌ 연기되거나 제거된 요구사항 (정당화 포함)
+- 복잡한 기능에 대한 구현 노트 추가
+- 요구사항 변경이나 명확화 문서화
+
+### 6. 스프린트 문서 업데이트
+
+현재 및 최근 완료된 스프린트에 대해:
+- `.aiwf/03_SPRINTS/S{N}_*/`로 이동
+- 스프린트 메타 파일을 다음과 함께 업데이트:
+  - 현재 상태 (PLANNED/IN_PROGRESS/COMPLETED)
+  - 완료 백분율
+  - 실제 vs 계획된 산출물
+- 개별 작업 파일 업데이트:
+  - 완료된 작업을 ✅로 표시
+  - 구현 노트 추가
+  - 차단 사항이나 도전 과제 문서화
+  - 관련 코드 파일에 링크
+
+### 7. PROJECT_MANIFEST.md 검토 및 업데이트
+
+매니페스트를 다음과 함께 업데이트:
+- **현재 상태**: 마일스톤 및 스프린트 진행 상황 업데이트
+- **스프린트 추적**: 완료된 스프린트 표시, 현재 스프린트 업데이트
+- **산출물**: 각 산출물의 완료 상태 업데이트
+- **최근 성과**: 주목할 만한 완료 사항 추가
+- **알려진 이슈**: 차단 사항이나 기술 부채 문서화
+- **다음 단계**: 완료된 작업을 기반으로 업데이트
+
+**형식 예시:**
+```markdown
+## 현재 상태
+- **활성 마일스톤**: M01 - [이름] (75% 완료)
+- **현재 스프린트**: S03 - [초점] (진행 중 - 40% 완료)
+- **마지막 업데이트**: YYYY-MM-DD HH:MM
+
+## 스프린트 진행 상황
+
+### 현재 스프린트 (S03)
+**상태**: 진행 중 (40% 완료)
+**산출물**:
+- ✅ [완료된 기능] - 완료
+- 🚧 [진행 중인 기능] - 60% 완료
+- 📋 [계획된 기능] - 시작 전
+```
+
+### 8. README.md 및 프로젝트 문서 업데이트
+
+**프로젝트의 메인 README.md 검토 및 업데이트:**
+- 프로젝트 루트에 README.md 존재 여부 확인
+- 범위가 발전한 경우 프로젝트 설명 업데이트
+- 최근 변경 사항을 기반으로 설치/설정 지침 새로고침
+- 새 기능으로 사용 예제 업데이트
+- 배지 추가/업데이트 (빌드 상태, 테스트 커버리지, 버전)
+- 새 의존성이나 요구사항 문서화
+- 프로세스가 변경된 경우 기여 가이드라인 업데이트
+- 엔드포인트가 변경된 경우 API 문서 새로고침
+
+**검토할 주요 섹션:**
+- 프로젝트 개요 및 목적
+- 기능 목록 (완료/진행 중/계획됨 표시)
+- 설치 및 설정 지침
+- 사용 예제 및 코드 스니펫
+- 구성 옵션
+- API 참조 (해당하는 경우)
+- 기여 가이드라인
+- 라이선스 정보
+
+### 9. 추가 문서 폴더 업데이트
+
+**프로젝트 전체의 모든 문서 검색 및 업데이트:**
+
+**확인할 일반적인 문서 위치:**
+- `docs/` - 메인 문서 폴더
+- `documentation/` - 대체 문서 폴더
+- `doc/` - 간단한 형식의 문서 폴더
+- `api-docs/` - API 전용 문서
+- 프로젝트 루트의 `*.md` 파일 (CONTRIBUTING.md, CHANGELOG.md 등)
+
+**발견된 각 문서 폴더에 대해:**
+- 오래된 정보가 있는 모든 마크다운 파일 검토
+- 구현 세부사항으로 기술 사양 업데이트
+- 새 기능으로 사용자 가이드 새로고침
+- 새 엔드포인트/변경사항으로 API 문서 업데이트
+- 브레이킹 체인지가 도입된 경우 마이그레이션 가이드 추가
+- 알려진 이슈/해결책으로 문제 해결 섹션 업데이트
+
+**확인할 특정 파일:**
+- `CHANGELOG.md` - 최근 변경 사항 및 버전 업데이트 추가
+- `CONTRIBUTING.md` - 변경된 경우 개발 워크플로우 업데이트
+- `docs/setup.md` - 설치/구성 단계 새로고침
+- `docs/api.md` - API 엔드포인트 및 예제 업데이트
+- `docs/deployment.md` - 배포 절차 업데이트
+- `docs/testing.md` - 새 테스트 절차 문서화
+
+**문서 일관성 검사:**
+- 모든 문서에서 버전 번호가 일관되는지 확인
+- 코드 예제가 현재 구현에서 여전히 작동하는지 확인
+- UI/아키텍처가 변경된 경우 스크린샷/다이어그램 업데이트
+- 모든 링크(내부 및 외부)가 유효한지 확인
+- 전체적으로 용어가 일관되는지 확인
+
+### 10. 문서 업데이트 요약 생성
+
+모든 문서 업데이트의 요약 보고서 작성:
+
+```markdown
+# 문서 업데이트 요약 - [YYYY-MM-DD]
+
+## 업데이트된 파일
+
+### AIWF 문서
+- `.aiwf/00_PROJECT_MANIFEST.md` - [변경 사항 간략 설명]
+- `.aiwf/01_PROJECT_DOCS/ARCHITECTURE.md` - [업데이트된 경우]
+- `.aiwf/02_REQUIREMENTS/M01_*/requirements.md` - [상태 업데이트]
+- `.aiwf/03_SPRINTS/S0N_*/meta.md` - [스프린트 상태 변경]
+
+### 프로젝트 문서
+- `README.md` - [메인 프로젝트 문서 업데이트]
+- `CHANGELOG.md` - [버전 및 변경 이력 업데이트]
+- `CONTRIBUTING.md` - [기여 가이드라인 업데이트]
+- `docs/*.md` - [특정 문서 파일 업데이트]
+- 기타 문서 폴더 - [추가 업데이트 목록]
+
+## 주요 변경 사항
+1. [주요 문서 변경 또는 업데이트]
+2. [추가된 새 섹션]
+3. [적용된 상태 업데이트]
+
+## 업데이트 후 프로젝트 상태
+- **마일스톤 진행률**: M01 X% (이전 Y%)
+- **스프린트 진행률**: S0N X% (이전 Y%)
+- **문서 커버리지**: [문서 완성도 평가]
+
+## 권장 사항
+- [식별된 문서 격차]
+- [제안된 문서 개선 사항]
+- [명확화가 필요한 영역]
+```
+
+## 가이드라인
+
+- 원래 요구사항과 계획 보존 (취소선이나 상태 마커 사용)
+- 일관된 상태 표시자 유지 (✅, 🚧, 📋, ❌)
+- 실제 구현을 기반으로 백분율 업데이트
+- 원래 계획에서 벗어난 사항을 정당화와 함께 문서화
+- 문서를 간결하면서도 포괄적으로 유지
+- 모든 날짜와 타임스탬프가 최신인지 확인
+- 관련 문서 섹션 간 상호 참조
+- 예상 위치뿐만 아니라 프로젝트 전체에서 모든 .md 파일 검색
+- 독립 문서 파일에 대한 루트 디렉토리 확인
+- 문서의 모든 코드 예제가 여전히 작동하는지 확인
+- 새 팀 구성원이 문서에 접근할 수 있는지 확인
+
+**중요:** 문서는 현실을 반영해야 합니다. 열망적인 목표가 아닌 실제 구현 상태를 기반으로 업데이트하세요.
+
+**핵심:** 문서 위치를 가정하지 마세요. 항상 전체 프로젝트에서 다음을 검색하세요:
+- 모든 디렉토리의 `*.md` 파일
+- 일반적인 이름: README, CHANGELOG, CONTRIBUTING, LICENSE, INSTALL, USAGE
+- 예상치 못한 위치의 문서 (예: src/, lib/ 또는 기타 코드 디렉토리 내부)

package/.claude/commands/aiwf/aiwf_evaluate.md

@@ -0,0 +1,92 @@
+# aiwf evaluate
+
+AI 응답 품질을 간단하게 평가합니다.
+
+## 실행
+
+```javascript
+const { spawn } = require('child_process');
+const path = require('path');
+
+// .aiwf 디렉토리로 이동하여 명령 실행
+const cwd = path.join(process.cwd(), '.aiwf');
+const args = process.argv.slice(2); // 추가 인자 전달
+
+const proc = spawn('node', [
+  '../claude-code/aiwf/ko/commands/evaluate.js',
+  ...args
+], { cwd, stdio: 'inherit' });
+
+proc.on('error', (err) => {
+  console.error('명령 실행 실패:', err.message);
+});
+```
+
+## 설명
+
+경량화된 평가 시스템으로 AI 응답 품질을 모니터링합니다. 기본적으로 백그라운드에서 자동 실행되며, 필요할 때만 상세 정보를 확인할 수 있습니다.
+
+## 사용 옵션
+
+### 기본 사용 (빠른 평가)
+```bash
+aiwf evaluate
+```
+현재 페르소나의 최근 평가 통계를 간단히 표시합니다.
+
+### 상세 분석
+```bash
+aiwf evaluate --detailed
+# 또는
+aiwf evaluate -d
+```
+모든 페르소나의 상세 통계와 개선 제안을 표시합니다.
+
+### 평가 히스토리
+```bash
+aiwf evaluate --history
+# 또는
+aiwf evaluate -h
+```
+최근 10개의 평가 기록을 시간순으로 표시합니다.
+
+### 주간 통계
+```bash
+aiwf evaluate --stats
+# 또는
+aiwf evaluate -s
+```
+일주일간의 평가 통계와 페르소나별 활용도를 표시합니다.
+
+## 자동 평가 시스템
+
+이 명령어는 수동으로 실행할 수 있지만, 실제로는 다음 상황에서 자동으로 백그라운드 평가가 수행됩니다:
+
+- 페르소나 전환 시
+- 컨텍스트 압축 시
+- AI 응답 생성 후 (향후 구현)
+
+평가 점수가 60% 미만일 때만 자동으로 피드백이 표시되므로, 작업 흐름을 방해하지 않습니다.
+
+## 평가 기준
+
+### 3가지 핵심 지표
+1. **역할 일치도 (50%)**: 페르소나 특성 반영 정도
+2. **작업 관련성 (30%)**: 요청된 작업과의 관련성
+3. **기본 품질 (20%)**: 응답의 구조와 내용
+
+### 점수 해석
+- 80% 이상: 훌륭함 🎉
+- 60-79%: 양호함 ✅
+- 60% 미만: 개선 필요 💡
+
+## 예시 출력
+
+```
+🔍 최근 응답 평가
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+현재 페르소나: architect
+평균 점수: 0.75
+평가 횟수: 23
+추세: 📈 개선 중
+```

package/.claude/commands/aiwf/aiwf_get_feature_details.md

@@ -0,0 +1,78 @@
+# Feature 상세 정보 조회
+
+특정 Feature Ledger의 상세 정보를 확인합니다.
+
+```bash
+cd .aiwf && node ../claude-code/aiwf/ko/commands/feature-ledger.js details "$@"
+```
+
+## 설명
+
+Feature ID를 통해 해당 Feature의 모든 정보를 상세하게 조회합니다.
+
+### 🎯 출력 형식
+- `--format=full` - 전체 정보 (기본값)
+- `--format=summary` - 요약 정보
+- `--format=technical` - 기술적 세부사항
+- `--format=progress` - 진행 상황 중심
+
+### 📝 사용법
+```bash
+# 전체 상세 정보
+/project:aiwf:get_feature_details FL001
+
+# 요약 정보만 보기
+/project:aiwf:get_feature_details FL001 --format=summary
+
+# 기술적 세부사항 확인
+/project:aiwf:get_feature_details FL001 --format=technical
+```
+
+### 📋 표시 정보
+- Feature 메타데이터
+- 개발 진행 상황
+- 관련 태스크 및 커밋
+- 담당자 및 리뷰어
+- 타임라인 및 마일스톤
+- 기술적 세부사항
+
+## 예시 출력 (전체 정보)
+```
+🎯 Feature 상세 정보
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📌 기본 정보
+Feature ID: FL001
+제목: User Authentication System
+상태: active
+우선순위: high
+카테고리: feature
+
+📊 진행 상황
+진행률: 75%
+시작일: 2025-07-05
+예상 완료일: 2025-07-12
+소요 시간: 5일 경과
+
+🎯 마일스톤 & 스프린트
+마일스톤: M02 - Context Engineering Enhancement
+스프린트: S01_M02 - context_foundation
+
+👥 담당자
+개발자: @developer1
+리뷰어: @reviewer1, @reviewer2
+
+📝 설명
+JWT 기반 사용자 인증 시스템 구현. OAuth2.0 소셜 로그인 지원 포함.
+
+🔧 기술 스택
+- Backend: Node.js, Express, JWT
+- Database: PostgreSQL
+- Frontend: React, Redux
+
+📈 진행 내역
+[2025-07-05] Feature 생성
+[2025-07-06] 데이터베이스 스키마 설계 완료
+[2025-07-08] JWT 인증 기본 구현 완료
+[2025-07-10] OAuth2.0 구현 진행 중
+```