aiwf 0.3.7 → 0.3.12

package/.claude/commands/aiwf/aiwf_testing_review.md

@@ -1,198 +0,0 @@
-# 테스팅 리뷰 - 탑 다운 실행
-
-아키텍처, 진행 상황, 기술 결정에 초점을 맞춘 포괄적인 프로젝트 수준 리뷰를 수행합니다.
-
-## 전제조건 확인
-
-**먼저**, 테스팅 전략 문서가 존재하는지 확인하세요:
-
-- `.aiwf/01_PROJECT_DOCS/TESTING_STRATEGY.md` 확인
-- 찾을 수 없는 경우, 사용자에게 알립니다: "테스팅 전략 문서가 없습니다. 새로 만들어드릴까요, 아니면 일반적인 테스트 품질 검토로 진행할까요?"
-- 사용자가 전략 없이 진행하려는 경우, 일반적인 테스트 품질 원칙에 초점을 맞춰 검토를 조정합니다
-
-## 정확히 다음 7개 항목으로 TODO 생성
-
-1. 테스팅 전략 문서 로드 (또는 검토 기준 정의)
-2. 테스트 구현 구조 분석
-3. 테스트-코드 정렬 평가
-4. 잘못 정렬되거나 불필요한 테스트 식별
-5. 핵심 기능 커버리지 평가
-6. 수정 권장사항 생성
-7. 정렬 보고서 생성
-
-단계별로 따라가며 각 단계에 대한 다음 지침을 엄격히 준수하세요.
-
-## 모든 TODO 항목에 대한 세부사항
-
-### 1. 테스팅 전략 문서 로드 (또는 검토 기준 정의)
-
-**옵션 A - 전략 문서가 존재하는 경우:**
-
-- `.aiwf/01_PROJECT_DOCS/TESTING_STRATEGY.md` 로드
-- 주요 원칙과 우선순위 추출
-- 테스트해야 할 것과 하지 말아야 할 것 식별
-- 커버리지 기대치와 품질 게이트 주목
-- 테스팅 철학 이해
-
-**옵션 B - 전략 문서가 없는 경우:**
-검토 기준으로 일반적인 모범 사례를 사용:
-
-- 테스트는 구현이 아닌 동작에 초점을 맞춰야 함
-- 핵심 경로에는 커버리지가 있어야 함
-- 테스트는 유지보수 가능하고 명확해야 함
-- 단순한 getter/setter 과도 테스트 피하기
-- 커버리지와 유지보수 부담 간의 균형
-
-이 검토에 사용되는 접근법을 **문서화**하세요.
-
-### 2. 테스트 구현 구조 분석
-
-현재 테스트 코드베이스를 **검토**하세요:
-
-- 테스트 실행을 위해 test.md 명령 사용 (@.claude/commands/aiwf/aiwf_test.md)
-- 테스트 디렉토리 구조와 조직 탐색
-- 테스트 카테고리와 그 목적 식별
-- 테스트 명명 규칙과 패턴 확인
-- 테스트 인프라나 유틸리티 주목
-
-**개수 세기가 아닌 존재하는 것을 이해하는 데 집중하세요.**
-
-### 3. 테스트-코드 정렬 평가
-
-테스트를 실제 구현과 **비교**하세요:
-
-- 각 주요 구성요소에 대해 테스트가 기능과 일치하는지 확인
-- 동작 대 구현 세부사항을 테스트하는 테스트 식별
-- 과도한 설정이나 모킹이 있는 테스트 찾기
-- 리팩토링 시 자주 깨지는 테스트 찾기
-- 테스트 복잡성이 코드 복잡성과 일치하는지 확인
-
-**핵심 질문:** 테스트가 사용자가 중요하게 여기는 것을 검증하는가?
-
-### 4. 잘못 정렬되거나 불필요한 테스트 식별
-
-가치를 제공하지 않는 테스트를 **검색**하세요:
-
-**전략 문서를 사용하는 경우:**
-
-- 전략에서 "건너뛰기"로 표시된 영역의 테스트
-- 정의된 범위를 벗어난 테스트
-- 전략 가이드라인에 따라 과도하게 명시된 테스트
-
-**일반 원칙을 사용하는 경우:**
-
-- 단순한 기능에 대한 과도하게 설계된 테스트
-- 모든 리팩토링에서 깨지는 테스트
-- 중요하지 않은 기능의 에지 케이스 테스트
-- 과도한 모킹/설정이 있는 테스트
-- 성능 요구사항 없는 성능 테스트
-
-**수정하거나 제거할 특정 테스트 목록을 생성하세요.**
-
-### 5. 핵심 기능 커버리지 평가
-
-필수 기능에 적절한 테스트가 있는지 **검증**하세요:
-
-**전략 문서를 사용하는 경우:**
-
-- 전략에서 정의된 높은 우선순위 영역의 커버리지 확인
-- 전략별 요구사항이 테스트되는지 검증
-
-**모든 검토에 대해:**
-
-- 핵심 경로 테스트의 차이 식별
-- 해당되는 경우 인증/권한 확인
-- 중요한 작업의 오류 처리 검증
-- 필요한 곳에 데이터 무결성 테스트 존재 보장
-- 통합 지점이 테스트되는지 확인
-
-**해결이 필요한 특정 차이를 기록하세요.**
-
-### 6. 수정 권장사항 생성
-
-구체적이고 실행 가능한 권장사항을 **생성**하세요:
-
-각 발견사항에 대해:
-
-- 테스트 파일과 함수 명시
-- 수정이 필요한 이유 설명
-- 구체적인 변경사항 제안 (제거, 단순화, 추가)
-- 도움이 된다면 개선된 접근법의 예시 제공
-
-**형식:**
-
-```
-파일: tests/test_example.py::test_function_name
-문제: [문제점]
-조치: [해야 할 일]
-이유: [전략과 일치하는 이유]
-```
-
-### 7. 정렬 보고서 생성
-
-테스트-전략 정렬에 대한 집중된 보고서를 **생성**하세요:
-
-- 시스템 날짜 명령을 사용하여 현재 타임스탬프 가져오기
-- `.aiwf/10_STATE_OF_PROJECT/YYYY-MM-DD-HH-MM-test-alignment.md`에 보고서 생성
-
-**보고서 구조:**
-
-```markdown
-# 테스트-전략 정렬 검토 - [YYYY-MM-DD HH:MM]
-
-## 정렬 요약
-
-테스팅 전략과의 전반적인 정렬: [우수 | 양호 | 개선 필요 | 부족]
-
-주요 발견사항:
-
-- [테스트 스위트 건강상태에 대한 주요 발견사항]
-- [커버리지에 대한 주요 발견사항]
-- [유지보수 부담에 대한 주요 발견사항]
-
-## 수정이 필요한 테스트
-
-### 제거 (과도하게 설계되었거나 범위를 벗어남)
-
-[이유와 함께 특정 테스트 목록]
-
-### 단순화 (목적에 비해 너무 복잡함)
-
-[단순화 접근법과 함께 특정 테스트 목록]
-
-### 추가 (핵심 격차)
-
-[핵심 경로에 대한 특정 누락된 테스트 목록]
-
-## 권장 조치
-
-### 즉시 (차단 문제)
-
-- [ ] [파일/테스트 참조와 함께 구체적인 조치]
-
-### 단기 (품질 개선)
-
-- [ ] [파일/테스트 참조와 함께 구체적인 조치]
-
-### 장기 (기술 부채)
-
-- [ ] [파일/테스트 참조와 함께 구체적인 조치]
-
-## 테스트 건강 지표
-
-- 테스트가 코드 목적과 일치: [예 | 부분적으로 | 아니오]
-- 핵심 경로 커버됨: [예 | 부분적으로 | 아니오]
-- 유지보수 부담 합리적: [예 | 부분적으로 | 아니오]
-- 테스트가 개발 속도 지원: [예 | 부분적으로 | 아니오]
-
-## 구현 예시
-
-[필요한 경우, 테스트 개선의 전후 예시 표시]
-
-## 다음 검토
-
-권장 검토 시기: [X주/스프린트]
-다음 검토 집중 영역: [모니터링할 특정 영역]
-```
-
-**중요:** 메트릭이 아닌 정렬과 균형에 초점을 맞추세요. 목표는 프로젝트의 실제 요구를 충족하는 테스트입니다.

package/.claude/commands/aiwf/aiwf_tm-run-all-subtask.md

@@ -1,210 +0,0 @@
-# 전체 작업 지능형 실행
-
-Arguments: $ARGUMENTS
-
-프로젝트의 모든 작업(전체 task 또는 특정 작업의 하위 작업)을 지능적으로 분석하고 최적화된 순서로 실행합니다.
-
-## 지능형 분석 및 실행
-
-### 컨텍스트 분석
-
-실행 전 다음 요소들을 분석합니다:
-
-- **작업 의존성**: 작업 간 의존 관계 파악 (상위-하위, 작업-작업 간)
-- **작업 복잡도**: 각 작업의 난이도와 예상 소요 시간
-- **현재 상태**: 진행 중인 작업, 블록된 작업, 완료된 작업 식별
-- **사용자 패턴**: 이전 작업 수행 방식과 선호도
-- **프로젝트 우선순위**: 전체 프로젝트 관점에서의 중요도
-
-### 스마트 실행 전략
-
-상황에 따른 최적화된 실행 방식:
-
-**의존성 기반 실행**:
-
-- 의존 관계가 있는 작업들을 올바른 순서로 배치
-- 병렬 처리 가능한 작업들 식별
-- 차단된 작업의 의존성 해결 우선
-
-**복잡도 기반 실행**:
-
-- 간단한 작업 먼저 → 빠른 성취감과 모멘텀
-- 복잡한 작업 먼저 → 집중력이 높을 때 어려운 작업 처리
-
-**시간대별 최적화**:
-
-- 오전: 복잡한 작업 우선
-- 오후: 루틴한 작업이나 리뷰 작업
-- 저녁: 마무리 작업이나 문서화
-
-**우선순위 기반 실행**:
-
-- 프로젝트 전체 관점에서 중요한 작업 우선
-- 마일스톤 달성에 필요한 작업 우선
-
-## 워크플로우
-
-### 1. 전체 프로젝트 분석
-
-```bash
-# 모든 작업 조회
-task-master get-tasks --with-subtasks
-
-# 의존성 검증
-task-master validate-dependencies
-
-# 복잡도 분석
-task-master complexity-report
-```
-
-### 2. 실행 모드 결정
-
-**전체 프로젝트 실행**:
-
-- 모든 pending 상태의 작업을 대상
-- 전체 프로젝트 완료를 목표
-
-**특정 작업 및 하위 작업 실행**:
-
-- 특정 작업과 그 하위 작업들을 대상
-- 해당 작업 완료를 목표
-
-### 3. 지능형 실행 순서 결정
-
-```bash
-# 다음 실행 가능한 작업 찾기
-task-master next
-
-# 실행 가능한 모든 작업 나열 (차단되지 않은 작업들)
-task-master get-tasks --status=pending --with-subtasks
-```
-
-### 4. 최적화된 작업 실행
-
-**전체 작업 실행 루프**:
-
-```bash
-# 실행 가능한 작업이 있는 동안 반복
-while [ "$(task-master next)" != "No tasks available" ]; do
-  CURRENT_TASK=$(task-master next --format=id)
-
-  # 작업 정보 표시
-  echo "=== 실행 중: Task $CURRENT_TASK ==="
-  task-master show $CURRENT_TASK
-
-  # 하위 작업이 있는지 확인
-  if task-master show $CURRENT_TASK | grep -q "subtasks"; then
-    echo "하위 작업 실행 시작..."
-    # 하위 작업들을 순차적으로 실행
-    for subtask in $(task-master show $CURRENT_TASK --subtasks-only --format=ids); do
-      echo "--- 하위 작업 $subtask 실행 ---"
-      task-master show $subtask
-
-      # 실제 구현 로직 수행
-      echo "작업 구현 중..."
-
-      # 완료 표시
-      task-master set-status --id=$subtask --status=done
-      echo "하위 작업 $subtask 완료"
-    done
-  else
-    # 단일 작업 실행
-    echo "단일 작업 실행 중..."
-
-    # 실제 구현 로직 수행
-    echo "작업 구현 중..."
-  fi
-
-  # 작업 완료 표시
-  task-master set-status --id=$CURRENT_TASK --status=done
-  echo "Task $CURRENT_TASK 완료"
-  echo ""
-done
-
-echo "모든 실행 가능한 작업이 완료되었습니다!"
-```
-
-### 5. 진행 상황 추적 및 학습
-
-- 실행 패턴 기록
-- 예상 vs 실제 소요 시간 학습
-- 효율성 메트릭 수집
-- 차단된 작업들에 대한 해결 방안 제안
-
-### 6. 완료 후 상태 분석
-
-```bash
-# 전체 프로젝트 상태 확인
-task-master get-tasks --status=all
-
-# 차단된 작업들 확인
-task-master get-tasks --status=blocked,deferred
-
-# 다음 마일스톤까지의 진행률
-echo "프로젝트 진행률 분석..."
-```
-
-## 학습 모드
-
-이 명령어는 실행 패턴을 학습합니다:
-
-- **실행 순서 최적화**: 성공적인 패턴 기억
-- **시간 예측 개선**: 실제 소요 시간 데이터 축적
-- **개인 선호도 학습**: 사용자의 작업 스타일 적응
-- **효율성 향상**: 생산성 높은 워크플로우 식별
-- **프로젝트 패턴 학습**: 프로젝트 유형별 최적 실행 전략
-
-## 사용법
-
-```bash
-# 전체 프로젝트의 모든 작업 실행
-/tm run-all-tasks
-
-# 특정 작업과 그 하위 작업들 실행
-/tm run-all-tasks <task-id>
-
-# 실행 전략 지정
-/tm run-all-tasks --strategy=dependency   # 의존성 우선
-/tm run-all-tasks --strategy=complexity   # 복잡도 우선
-/tm run-all-tasks --strategy=priority     # 우선순위 우선
-/tm run-all-tasks --strategy=time         # 시간대 최적화
-
-# 특정 상태의 작업만 실행
-/tm run-all-tasks --status=pending        # pending 작업만
-/tm run-all-tasks --status=in-progress    # 진행 중인 작업만
-
-# 드라이런 모드 (실제 실행 없이 계획만 표시)
-/tm run-all-tasks --dry-run
-
-# 대화형 모드 (각 작업 실행 전 확인)
-/tm run-all-tasks --interactive
-```
-
-## 지능형 기능
-
-### 자동 중단점
-
-- 차단된 작업 발견 시 자동 일시 정지
-- 의존성 해결 제안
-- 대안 작업 경로 제시
-
-### 진행률 예측
-
-- 남은 작업량 기반 완료 시간 예측
-- 일일/주간 목표 달성 가능성 분석
-- 프로젝트 전체 완료 예상 시점
-
-### 컨텍스트 기반 제안
-
-실행 완료 후 상황별 다음 액션:
-
-- **모든 작업 완료** → 프로젝트 완료 축하 + 다음 프로젝트 제안
-- **일부 작업 차단됨** → 차단 해제 방법 제안 + 대체 작업 제안
-- **복잡한 작업 남음** → 휴식 제안 + 작업 분할 제안
-- **의존성 문제** → 의존 관계 재구성 제안
-
-### 스마트 배치
-
-- **에너지 수준 고려**: 오전에는 복잡한 작업, 오후에는 단순한 작업
-- **컨텍스트 스위칭 최소화**: 유사한 작업들을 그룹핑하여 연속 실행
-- **병렬 처리 기회**: 독립적인 작업들의 동시 진행 제안