aiwf 0.3.8 → 0.3.13

package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_do_task.md

@@ -1,109 +0,0 @@
-# 인수 기반 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-code/aiwf/ko/.claude/commands/aiwf/aiwf_docs.md

@@ -1,225 +0,0 @@
-# 문서 업데이트
-
-현재 프로젝트 문서를 분석하고 구현 진행 상황과 최근 변경 사항을 반영하도록 업데이트합니다.
-
-## 정확히 다음 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-code/aiwf/ko/.claude/commands/aiwf/aiwf_evaluate.md

@@ -1,92 +0,0 @@
-# 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('aiwf', [
-  'evaluate',
-  ...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-code/aiwf/ko/.claude/commands/aiwf/aiwf_get_feature_details.md

@@ -1,78 +0,0 @@
-# Feature 상세 정보 조회
-
-특정 Feature Ledger의 상세 정보를 확인합니다.
-
-```bash
-aiwf get-feature-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 구현 진행 중
-```