aiwf 0.3.3 → 0.3.4

package/.claude/commands/aiwf/aiwf_infinite.md

@@ -0,0 +1,202 @@
+# 무한 에이전틱 루프 명령
+
+이 무한 생성 작업에 대해 깊이 생각하세요. 당신은 정교한 반복 생성 프로세스를 시작하려고 합니다. deep think
+
+**변수:**
+
+spec_file: $ARGUMENTS
+output_dir: $ARGUMENTS
+count: $ARGUMENTS
+
+**인자 파싱:**
+"$ARGUMENTS"에서 다음 인자들을 파싱합니다:
+
+1. `spec_file` - 마크다운 명세 파일 경로
+2. `output_dir` - 반복 결과가 저장될 디렉토리
+3. `count` - 반복 횟수 (1-N 또는 "infinite")
+
+**1단계: 명세 분석**
+`spec_file`의 명세 파일을 읽고 깊이 이해합니다. 이 파일은 다음을 정의합니다:
+
+- 생성할 콘텐츠 유형
+- 형식과 구조 요구사항
+- 특정 매개변수나 제약사항
+- 반복 간의 의도된 진화 패턴
+
+명세의 의도와 각 반복이 이전 작업을 어떻게 기반으로 해야 하는지 신중히 생각하세요.
+
+**2단계: 출력 디렉토리 탐색**
+현재 상태를 이해하기 위해 `output_dir`을 철저히 분석합니다:
+
+- 모든 기존 파일과 명명 패턴 나열
+- 현재 존재하는 가장 높은 반복 번호 식별
+- 기존 반복들 간의 콘텐츠 진화 분석
+- 이전 생성의 궤적 이해
+- 새로운 반복을 위한 격차나 기회 파악
+
+**3단계: 반복 전략**
+명세 분석과 기존 반복을 기반으로:
+
+- 시작 반복 번호 결정 (최고 기존 번호 + 1)
+- 각 새로운 반복이 독특하고 진화적일 방법 계획
+- 새로움을 유지하면서 이전 반복을 기반으로 구축하는 방법 고려
+- count가 "infinite"인 경우, 컨텍스트 제한까지 지속적 생성 준비
+
+**4단계: 병렬 에이전트 조율**
+최대 효율성과 창의적 다양성을 위해 여러 서브 에이전트를 병렬로 배포합니다:
+
+**서브 에이전트 배포 전략:**
+
+- count 1-5: 모든 에이전트 동시 실행
+- count 6-20: 5개 에이전트씩 배치로 실행하여 조율 관리
+- "infinite": 3-5개 에이전트의 웨이브를 실행하고, 컨텍스트를 모니터링하며 새로운 웨이브 생성
+
+**에이전트 할당 프로토콜:**
+각 서브 에이전트는 다음을 받습니다:
+
+1. **명세 컨텍스트**: 완전한 명세 파일 분석
+2. **디렉토리 스냅샷**: 실행 시점의 output_dir 현재 상태
+3. **반복 할당**: 특정 반복 번호 (시작*번호 + 에이전트*인덱스)
+4. **독특성 지시**: 기존 반복의 개념을 중복하지 않도록 명시적 지시
+5. **품질 기준**: 명세의 상세 요구사항
+
+**에이전트 작업 명세:**
+
+```
+작업: [OUTPUT_DIR]에 [SPEC_FILE]의 반복 [NUMBER] 생성
+
+당신은 반복 [NUMBER]를 생성하는 서브 에이전트 [X]입니다.
+
+컨텍스트:
+- 명세: [전체 명세 분석]
+- 기존 반복: [현재 output_dir 내용 요약]
+- 당신의 반복 번호: [NUMBER]
+- 할당된 창의적 방향: [탐색할 특정 혁신 차원]
+
+요구사항:
+1. 명세를 완전히 읽고 이해
+2. 기존 반복을 분석하여 출력이 독특한지 확인
+3. 명세 형식을 정확히 따라 콘텐츠 생성
+4. 명세 준수를 유지하면서 [할당된 혁신 차원]에 집중
+5. 지정된 정확한 이름 패턴으로 파일 생성
+6. 반복이 진정한 가치와 새로움을 추가하는지 확인
+
+산출물: 명세에 따른 단일 파일, 독특하고 혁신적인 콘텐츠 포함
+```
+
+**병렬 실행 관리:**
+
+- Task 도구를 사용하여 모든 할당된 서브 에이전트를 동시에 실행
+- 에이전트 진행과 완료 모니터링
+- 에이전트 실패 시 반복 번호 재할당으로 처리
+- 중복 반복 번호가 생성되지 않도록 보장
+- 완료된 모든 반복 수집 및 검증
+
+**5단계: 무한 모드 오케스트레이션**
+무한 생성 모드의 경우, 지속적인 병렬 웨이브를 조율합니다:
+
+**웨이브 기반 생성:**
+
+1. **웨이브 계획**: 컨텍스트 용량에 따라 다음 웨이브 크기(3-5 에이전트) 결정
+2. **에이전트 준비**: 각 새로운 웨이브를 위한 신선한 컨텍스트 스냅샷 준비
+3. **점진적 정교화**: 각 웨이브는 더 발전된 혁신 차원을 탐색해야 함
+4. **컨텍스트 모니터링**: 모든 에이전트와 메인 오케스트레이터의 총 컨텍스트 사용량 추적
+5. **우아한 종료**: 컨텍스트 한계에 접근하면 현재 웨이브를 완료하고 요약
+
+**무한 실행 사이클:**
+
+```
+WHILE 컨텍스트_용량 > 임계값:
+    1. 현재 output_dir 상태 평가
+    2. 다음 에이전트 웨이브 계획 (남은 컨텍스트에 따른 크기)
+    3. 점점 정교한 창의적 방향 할당
+    4. 병렬 서브 에이전트 웨이브 실행
+    5. 웨이브 완료 모니터링
+    6. 디렉토리 상태 스냅샷 업데이트
+    7. 남은 컨텍스트 용량 평가
+    8. 충분한 용량 있으면: 다음 웨이브로 계속
+    9. 한계에 접근하면: 최종 웨이브 완료하고 요약
+```
+
+**점진적 정교화 전략:**
+
+- **웨이브 1**: 단일 혁신 차원의 기본 기능 대체
+- **웨이브 2**: 향상된 상호작용이 있는 다차원 혁신
+- **웨이브 3**: 적응형 행동이 있는 복잡한 패러다임 조합
+- **웨이브 N**: 명세의 경계를 확장하는 혁명적 개념
+
+**컨텍스트 최적화:**
+
+- 각 웨이브는 컨텍스트 누적을 피하기 위해 신선한 에이전트 인스턴스 사용
+- 메인 오케스트레이터는 경량 상태 추적 유지
+- 컨텍스트 관리를 위한 완료된 반복의 점진적 요약
+- 후반 웨이브에서 덜 필수적인 세부사항의 전략적 제거
+
+**실행 원칙:**
+
+**품질 & 독특성:**
+
+- 각 반복은 진정으로 독특하고 가치있어야 함
+- 새로운 요소를 도입하면서 이전 작업을 기반으로 구축
+- 원래 명세와의 일관성 유지
+- 적절한 파일 구성과 명명 보장
+
+**병렬 조율:**
+
+- 창의적 다양성을 극대화하기 위해 서브 에이전트를 전략적으로 배포
+- 중복을 피하기 위해 각 에이전트에 독특한 혁신 차원 할당
+- 파일 명명 충돌을 방지하기 위한 타이밍 조정
+- 성공적인 완료와 품질을 위한 모든 에이전트 모니터링
+
+**확장성 & 효율성:**
+
+- 병렬 스트림 전체의 진화 궤적에 대해 깊이 생각 deep think
+- 무한 모드의 경우, 컨텍스트 소진 전 최대 가치있는 출력 최적화
+- 컨텍스트 한계를 지능적으로 관리하기 위한 웨이브 기반 생성 사용
+- 병렬 속도와 품질 및 조율 오버헤드의 균형
+
+**에이전트 관리:**
+
+- 각 서브 에이전트에 완전한 컨텍스트와 명확한 할당 제공
+- 반복 재할당으로 에이전트 실패를 우아하게 처리
+- 모든 병렬 출력이 전체 진행과 일관되게 통합되도록 보장
+
+**울트라 씽킹 지시:**
+생성을 시작하기 전에, 다음에 대해 확장된 사고를 수행하세요:
+
+**명세 & 진화:**
+
+- 명세의 더 깊은 의미
+- 반복 간 의미있는 진행을 만드는 방법
+- 각 반복을 가치있고 독특하게 만드는 것
+- 일관성과 혁신의 균형을 맞추는 방법
+
+**병렬 전략:**
+
+- 요청된 수에 대한 최적의 서브 에이전트 배포
+- 다양성을 극대화하기 위해 독특한 창의적 방향을 할당하는 방법
+- 무한 모드의 웨이브 크기와 타이밍
+- 여러 병렬 에이전트 간의 컨텍스트 관리
+
+**조율 과제:**
+
+- 병렬 스트림 간 중복 개념 방지 방법
+- 각 에이전트가 진정으로 독특한 출력을 생산하도록 보장하는 전략
+- 동시 쓰기가 있는 파일 명명과 디렉토리 구성 관리
+- 병렬 출력의 품질 관리 메커니즘
+
+**무한 모드 최적화:**
+
+- 지속적인 출력을 위한 웨이브 기반 생성 패턴
+- 여러 웨이브에 걸친 점진적 정교화 전략
+- 컨텍스트 용량 모니터링과 우아한 종료 계획
+- 병렬 생성 속도와 혁신 깊이의 균형
+
+**위험 완화:**
+
+- 에이전트 실패와 반복 재할당 처리
+- 병렬 실행에도 불구하고 일관된 전체 진행 보장
+- 전체 시스템의 컨텍스트 창 한계 관리
+- 모든 병렬 출력의 명세 준수 유지
+
+이러한 병렬 조율 과제에 대한 깊은 분석으로 실행을 시작하고, 최대 창의적 출력과 효율성을 위해 서브 에이전트를 활용하여 각 단계를 체계적으로 진행하세요.

package/.claude/commands/aiwf/aiwf_initialize.md

@@ -0,0 +1,134 @@
+# AIWF 프레임워크 초기화
+
+적응형, 상호작용적 프로세스를 통해 AIWF 프로젝트 관리 프레임워크를 초기화합니다.
+
+## 정확히 다음 항목들로 TODO 생성
+
+1. 프로젝트 스캔 및 분석
+2. 사용자와 상호작용적 확인
+3. 기존 AIWF 문서 확인
+4. 문서 생성 프로세스 안내
+5. AIWF를 위한 첫 번째 마일스톤 생성
+6. 프로젝트 매니페스트 생성
+7. 다음 단계 제공
+
+## 모든 TODO 항목에 대한 세부사항
+
+### 1. 프로젝트 스캔 및 분석
+
+**프로젝트 특성 탐지:**
+
+- package.json, requirements.txt, composer.json 등 확인
+- 프로젝트 유형 식별 (Node.js, Python, PHP 등)
+- 전체 프로젝트 구조 스캔
+- 새 프로젝트인지 기존 프로젝트인지 확인
+- 기존 문서 찾기 (README, docs/ 등)
+
+**발견사항을 간단히 정리** - 필수 사항만 식별
+
+### 2. 사용자와 상호작용적 확인
+
+**발견사항을 대화형으로 제시:**
+
+```
+이것은 [프로젝트 이름]이라는 [프로젝트 유형] 프로젝트인 것으로 확인됩니다.
+맞습니까? AIWF 설정을 계속 진행해도 될까요?
+```
+
+**계속하기 전에 사용자 확인 받기**
+
+### 3. 기존 AIWF 문서 확인
+
+**.aiwf/ 디렉토리에서 스캔:**
+
+- 01_PROJECT_DOCS/의 모든 문서
+- 02_REQUIREMENTS/의 모든 마일스톤
+- 기존 스프린트나 태스크
+- 현재 매니페스트 상태
+
+**상호작용적 결정:**
+
+- 문서가 발견된 경우: "기존 문서를 발견했습니다: [목록]. 이것들을 사용하거나 확장할까요?"
+- 문서가 없는 경우: "아직 AIWF 문서가 없습니다. 계속하기 전에 복사하고 싶은 기존 프로젝트 문서가 있나요?"
+
+**사용자가 선택할 수 있는 옵션:**
+
+- 기존 문서 사용
+- 새 문서 추가
+- 새로 시작
+- 먼저 수동으로 문서 추가하기 위해 취소
+
+### 4. 문서 생성 프로세스 안내
+
+**사용자 선택에 따라:**
+
+**새로 시작하거나 확장하는 경우:**
+
+- 코드베이스의 심층 분석 수행
+- 주요 구성요소와 아키텍처 패턴 식별
+- 분석을 바탕으로 ARCHITECTURE.md 초안 생성
+- Q&A 스타일로 정제하고 완성:
+  - "이 프로젝트의 주요 목적은 무엇인가요?"
+  - "핵심 기술적 결정사항은 무엇인가요?"
+  - "중요한 제약사항이나 요구사항이 있나요?"
+
+**기존 문서를 사용하는 경우:**
+
+- 기존 문서를 가져와서 적응
+- AIWF 관련 섹션 작성
+- 프레임워크 구조와의 호환성 보장
+
+**대화형이고 적응적으로 유지**
+
+### 5. AIWF를 위한 첫 번째 마일스톤 생성
+
+**적절한 첫 번째 마일스톤 결정:**
+
+- 새 프로젝트인 경우: 설정/기반 마일스톤으로 시작
+- 기존 프로젝트인 경우: 현재 단계를 식별하고 적절한 마일스톤 생성
+
+**상호작용적 마일스톤 생성:**
+
+- "프로젝트 상태를 바탕으로 다음 마일스톤 생성을 제안합니다: [이름]"
+- "이 마일스톤에서 무엇에 집중하고 싶으신가요?"
+- 초기 요구사항이 포함된 마일스톤 구조 생성
+- 범위를 현실적이고 집중적으로 유지
+
+### 6. 프로젝트 매니페스트 생성
+
+**다음을 사용하여 매니페스트 자동 생성:**
+
+- 설정 중에 수집된 정보
+- 생성/가져온 문서
+- 현재 마일스톤 세부사항
+- 프로젝트 메타데이터
+
+**사용자 상호작용 불필요** - 완료될 때 알리기만 하세요
+
+### 7. 다음 단계 제공
+
+**설정을 바탕으로 맞춤형 안내:**
+
+```
+✅ [프로젝트 이름]에 대한 AIWF 초기화 완료!
+
+현재 설정:
+- 프로젝트 유형: [유형]
+- 현재 마일스톤: [마일스톤]
+- 문서: [생성/가져온 항목]
+
+다음 단계:
+- 아키텍처 검토: 01_PROJECT_DOCS/ARCHITECTURE.md
+- 마일스톤 요구사항 확인: 02_REQUIREMENTS/[마일스톤]/
+- 첫 번째 태스크 시작: /project:aiwf:create_general_task
+
+개발을 시작할 준비가 완료되었습니다!
+```
+
+## 적응형 프로세스 노트
+
+- **대화형 유지** - 양식처럼이 아닌 자연스럽게 질문하기
+- **스마트하게** - AI를 사용하여 맥락을 이해하고 지능적인 제안 만들기
+- **유연성 허용** - 사용자가 언제든지 건너뛰기, 취소, 수정 가능
+- **가치에 집중** - 특정 프로젝트에 유용한 것만 생성
+- **단순하게 유지** - 옵션이나 세부사항으로 압도하지 않기

package/.claude/commands/aiwf/aiwf_issue_create.md

@@ -0,0 +1,65 @@
+# 태스크에서 GitHub 이슈 생성
+
+태스크 파일을 기반으로 GitHub 이슈를 자동으로 생성합니다.
+
+## 정확히 다음 5개 항목으로 TODO 생성
+
+1. Parse task file and extract information
+2. Generate issue template
+3. Create issue via GitHub API
+4. Update task file with issue number
+5. Report results
+
+## 1 · Parse Task File
+
+Get task ID from <$ARGUMENTS>:
+- Sprint tasks: Search `.aiwf/03_SPRINTS/`
+- General tasks: Search `.aiwf/04_GENERAL_TASKS/`
+
+Extract from task file:
+- Title
+- Description
+- Acceptance criteria
+- Labels (sprint number, task type)
+
+## 2 · Generate Issue Template
+
+```markdown
+## 📋 Task: {task_title}
+
+### Description
+{task_description}
+
+### Acceptance Criteria
+{acceptance_criteria}
+
+### Related Information
+- Task ID: {task_id}
+- Sprint: {sprint_id}
+- Task file: `.aiwf/.../{task_file}`
+```
+
+## 3 · Create GitHub Issue
+
+```bash
+gh issue create \
+  --title "{task_id}: {task_title}" \
+  --body "{issue_body}" \
+  --label "task,{sprint_label}" \
+  --assignee "@me"
+```
+
+Capture the created issue number
+
+## 4 · Update Task File
+
+Add to task file frontmatter:
+```yaml
+github_issue: #{issue_number}
+```
+
+## 5 · Report Results
+
+✅ **Issue Created**: #{issue_number}
+🔗 **Link**: {issue_url}
+📄 **Task**: {task_id}

package/.claude/commands/aiwf/aiwf_link_feature_to_milestone.md

@@ -0,0 +1,57 @@
+# Feature를 마일스톤에 연결
+
+Feature Ledger를 마일스톤 및 스프린트와 연결합니다.
+
+```bash
+cd .aiwf && node ../claude-code/aiwf/ko/commands/feature-ledger.js link-milestone "$@"
+```
+
+## 설명
+
+Feature를 특정 마일스톤과 스프린트에 연결하여 프로젝트 계획과 동기화합니다.
+
+### 🎯 연결 옵션
+- 마일스톤 연결 (필수)
+- 스프린트 연결 (선택)
+- 태스크 연결 (선택)
+- 우선순위 자동 조정
+
+### 📝 사용법
+```bash
+# 마일스톤에만 연결
+/project:aiwf:link_feature_to_milestone FL001 M02
+
+# 마일스톤과 스프린트에 연결
+/project:aiwf:link_feature_to_milestone FL001 M02 --sprint=S01_M02
+
+# 태스크까지 연결
+/project:aiwf:link_feature_to_milestone FL001 M02 --sprint=S01_M02 --task=TX01_S01
+
+# 대화형 모드
+/project:aiwf:link_feature_to_milestone
+```
+
+### 🔄 자동 업데이트
+- Feature 파일에 마일스톤 정보 추가
+- 마일스톤 파일에 Feature 참조 추가
+- 스프린트 메타데이터 업데이트
+- 우선순위 동기화
+
+## 예시 출력
+```
+✅ Feature-마일스톤 연결 완료
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Feature: FL001 - User Authentication System
+마일스톤: M02 - Context Engineering Enhancement
+스프린트: S01_M02 - context_foundation
+
+📊 연결 결과:
+- Feature 파일 업데이트 ✓
+- 마일스톤 참조 추가 ✓
+- 스프린트 메타 업데이트 ✓
+
+🔗 관련 파일:
+- .aiwf/06_FEATURE_LEDGERS/active/FL001_user_authentication.md
+- .aiwf/02_REQUIREMENTS/M02_Context_Engineering_Enhancement/M02_milestone_meta.md
+- .aiwf/03_SPRINTS/S01_M02_context_foundation/S01_M02_sprint_meta.md
+```

package/.claude/commands/aiwf/aiwf_list_features.md

@@ -0,0 +1,54 @@
+# Feature 목록 조회
+
+Feature Ledger 목록을 다양한 필터와 형식으로 조회합니다.
+
+```bash
+cd .aiwf && node ../claude-code/aiwf/ko/commands/feature-ledger.js list "$@"
+```
+
+## 설명
+
+프로젝트의 모든 Feature를 상태, 우선순위, 카테고리 등으로 필터링하여 조회합니다.
+
+### 🎯 필터 옵션
+- `--status=<status>` - 상태별 필터 (active, completed, paused, archived, all)
+- `--milestone=<milestone>` - 마일스톤별 필터 (예: M02)
+- `--priority=<priority>` - 우선순위별 필터 (critical, high, medium, low)
+- `--category=<category>` - 카테고리별 필터 (feature, enhancement, bugfix, refactor)
+
+### 📊 출력 형식
+- `--format=table` - 테이블 형식 (기본값)
+- `--format=list` - 리스트 형식
+- `--format=dashboard` - 대시보드 형식
+
+### 🔄 정렬 옵션
+- `--sort=id` - Feature ID 순 (기본값)
+- `--sort=updated` - 최근 업데이트 순
+- `--sort=priority` - 우선순위 순
+- `--sort=progress` - 진행률 순
+
+### 📝 사용법
+```bash
+# 모든 active Feature 조회
+/project:aiwf:list_features
+
+# M02 마일스톤의 high 우선순위 Feature
+/project:aiwf:list_features --milestone=M02 --priority=high
+
+# 대시보드 형식으로 전체 현황 보기
+/project:aiwf:list_features --status=all --format=dashboard
+```
+
+## 예시 출력 (테이블 형식)
+```
+📋 Feature Ledger 목록
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ID    | Title                  | Status    | Priority | Progress
+------+------------------------+-----------+----------+---------
+FL001 | User Authentication    | active    | high     | 75%
+FL002 | Dashboard Redesign     | active    | medium   | 40%
+FL003 | API Rate Limiting      | completed | critical | 100%
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+총 3개 Feature | Active: 2 | Completed: 1
+```