aiwf 0.3.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/CHANGELOG.md +38 -36
  2. package/CLAUDE.md +8 -209
  3. package/README.md +25 -5
  4. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_docs.md +225 -0
  5. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_language_manager.md +287 -0
  6. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_language_status.md +246 -0
  7. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_switch_language.md +160 -0
  8. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_code_review.md +62 -62
  9. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_commit.md +111 -111
  10. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_create_general_task.md +106 -106
  11. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_create_milestone_plan.md +127 -127
  12. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_create_sprint_tasks.md +130 -130
  13. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_create_sprints_from_milestone.md +87 -87
  14. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_do_task.md +72 -72
  15. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_docs.md +225 -0
  16. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_initialize.md +86 -86
  17. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_issue_create.md +3 -3
  18. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_language_manager.md +287 -0
  19. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_language_status.md +246 -0
  20. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_pr_create.md +14 -14
  21. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_prime.md +5 -5
  22. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_project_review.md +39 -39
  23. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_switch_language.md +160 -0
  24. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_test.md +76 -77
  25. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_testing_review.md +120 -120
  26. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_ultrathink_general.md +209 -266
  27. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_yolo.md +226 -226
  28. package/docs/AI-WORKFLOW.ko.md +9 -2
  29. package/docs/AI-WORKFLOW.md +9 -2
  30. package/docs/COMMANDS_GUIDE.ko.md +93 -3
  31. package/docs/COMMANDS_GUIDE.md +94 -4
  32. package/docs/Enhanced_Installation_Flow_Design.md +498 -0
  33. package/docs/PRD.ko.md +110 -58
  34. package/docs/PRD.md +110 -58
  35. package/index.js +1240 -20
  36. package/jest.config.js +4 -0
  37. package/language-cli.js +279 -0
  38. package/language-utils.js +330 -0
  39. package/package.json +12 -4
  40. package/scripts/validate-commands.cjs +338 -0
  41. package/scripts/validate-commands.js +254 -0
  42. package/tests/basic.test.js +62 -0
  43. package/tests/commands.test.js +127 -0
  44. package/tests/installer.test.js +129 -0
  45. package/tests/language-utils.test.js +271 -0
  46. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_prime_context.md +0 -5
  47. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_prime_context.md +0 -8
@@ -1,109 +1,109 @@
1
- # $Argument 기반 AIWF 태스크 처리
1
+ # 인수 기반 AIWF 태스크 처리
2
2
 
3
- **IMPORTANT:** Follow from Top to Bottom - don't skip anything!
3
+ **중요:** 위에서 아래로 순서대로 진행하세요 - 단계를 건너뛰지 마세요!
4
4
 
5
- **CREATE A TODO LIST** with exactly these 8 items
5
+ **정확히 다음 8개 항목으로 할 일 목록을 생성하세요**
6
6
 
7
- 1. Analyse scope from argument
8
- 2. Identify task file
9
- 3. Analyse the task
10
- 4. Set status to in_progress
11
- 5. Execute task work
12
- 6. Placeholder
13
- 7. Execute Code review
14
- 8. Finalize Task status
7
+ 1. 인수에서 범위 분석
8
+ 2. 태스크 파일 식별
9
+ 3. 태스크 분석
10
+ 4. 상태를 진행 중으로 설정
11
+ 5. 태스크 작업 실행
12
+ 6. 플레이스홀더
13
+ 7. 코드 리뷰 실행
14
+ 8. 태스크 상태 완료 처리
15
15
 
16
- ## 1 · Analyse scope from argument
16
+ ## 1 · 인수에서 범위 분석
17
17
 
18
- <$ARGUMENTS> ⇒ Task ID, Sprint ID, or empty (select next open task in current sprint).
18
+ <$ARGUMENTS> ⇒ 태스크 ID, 스프린트 ID, 또는 빈 값 (현재 스프린트에서 다음 열린 태스크 선택).
19
19
 
20
- ## 2 · Identify task file
20
+ ## 2 · 태스크 파일 식별
21
21
 
22
- Search .aiwf/03_SPRINTS/ and .aiwf/04_GENERAL_TASKS/.
23
- If no open task matches, pause and ask the user how to proceed.
22
+ .aiwf/03_SPRINTS/와 .aiwf/04_GENERAL_TASKS/에서 검색합니다.
23
+ 일치하는 열린 태스크가 없으면 일시정지하고 사용자에게 진행 방법을 문의합니다.
24
24
 
25
- ## 3 · Analyse the task
25
+ ## 3 · 태스크 분석
26
26
 
27
- Read the task description. If anything is unclear, ask clarifying questions before continuing.
27
+ 태스크 설명을 읽습니다. 불분명한 점이 있으면 계속하기 전에 명확화 질문을 합니다.
28
28
 
29
- **CRITICAL CONTEXT VALIDATION:** Before executing any task spin up Parallel Subagents for these tasks:
29
+ **중요한 맥락 검증:** 태스크를 실행하기 전에 다음 작업들을 위한 병렬 서브에이전트를 실행합니다:
30
30
 
31
- 1. **Sprint Context:** Confirm task belongs to current sprint scope
32
- 2. **Dependencies:** Check if any dependent tasks need to be completed first
33
- 3. **Requirements:** Read relevant requirements docs in `.aiwf/02_REQUIREMENTS/`
34
- 4. **Scope Verification:** Ensure task aligns with current sprint objectives
35
- 5. **GitHub Issue Check:** Check if task file has a `github_issue` field
31
+ 1. **스프린트 맥락:** 태스크가 현재 스프린트 범위에 속하는지 확인
32
+ 2. **의존성:** 먼저 완료해야 할 의존 태스크가 있는지 확인
33
+ 3. **요구사항:** `.aiwf/02_REQUIREMENTS/`에서 관련 요구사항 문서 읽기
34
+ 4. **범위 검증:** 태스크가 현재 스프린트 목표와 일치하는지 확인
35
+ 5. **GitHub 이슈 확인:** 태스크 파일에 `github_issue` 필드가 있는지 확인
36
36
 
37
- **IMPORTANT:** If task references functionality from future sprints or has unmet dependencies, pause and ask for clarification.
37
+ **중요:** 태스크가 미래 스프린트의 기능을 참조하거나 충족되지 않은 의존성이 있으면 일시정지하고 명확화를 요청합니다.
38
38
 
39
- **GitHub Issue Creation (Optional):**
39
+ **GitHub 이슈 생성 (선택사항):**
40
40
 
41
- - If task doesn't have a GitHub issue and user wants issue tracking
42
- - Suggest using `/project:aiwf:issue_create {task_id}` command
41
+ - 태스크에 GitHub 이슈가 없고 사용자가 이슈 추적을 원하는 경우
42
+ - `/project:aiwf:issue_create {task_id}` 명령어 사용을 제안합니다
43
43
 
44
- ## 4 · Set status to in_progress
44
+ ## 4 · 상태를 진행 중으로 설정
45
45
 
46
- - Find out the current local timestamp (YYYY-MM-DD HH:MM).
47
- - Update front-matter to **status: in_progress** and set Updated time
48
- - Update ./aiwf/00_PROJECT_MANIFEST.md to set task in progress, updated time and current Sprint Status.
49
- - **GitHub Issue Update (if exists):**
46
+ - 현재 로컬 타임스탬프 확인 (YYYY-MM-DD HH:MM)
47
+ - 프론트매터의 **status: in_progress**로 업데이트하고 업데이트 시간 설정
48
+ - ./aiwf/00_PROJECT_MANIFEST.md에서 태스크 진행 중, 업데이트 시간, 현재 스프린트 상태로 업데이트
49
+ - **GitHub 이슈 업데이트 (존재하는 경우):**
50
50
  ```bash
51
- gh issue comment {issue_number} --body "🚀 Task work has started."
51
+ gh issue comment {issue_number} --body "🚀 태스크 작업이 시작되었습니다."
52
52
  gh issue edit {issue_number} --add-label "in-progress"
53
53
  ```
54
54
 
55
- ## 5 · Execute task work
55
+ ## 5 · 태스크 작업 실행
56
56
 
57
- - Follow Description, Goal and Acceptance Criteria.
58
- - Consult supporting docs in .aiwf/01_PROJECT_DOCS/ and .aiwf/02_REQUIREMENTS/.
59
- - Iterate over subtasks:
60
- 1. Pick the next incomplete subtask.
61
- 2. Implement the required changes, consulting docs as needed.
62
- 3. Mark the subtask done.
63
- 4. Append a log entry to **## Output Log** using the format `[YYYY-MM-DD HH:MM]: <message>`.
64
- 5. Repeat until all subtasks are complete.
57
+ - 설명, 목표, 승인 기준을 따릅니다
58
+ - .aiwf/01_PROJECT_DOCS/와 .aiwf/02_REQUIREMENTS/의 지원 문서를 참조합니다
59
+ - 하위 태스크를 반복 처리:
60
+ 1. 다음 미완료 하위 태스크를 선택합니다
61
+ 2. 필요에 따라 문서를 참조하여 필요한 변경사항을 구현합니다
62
+ 3. 하위 태스크를 완료로 표시합니다
63
+ 4. `[YYYY-MM-DD HH:MM]: <메시지>` 형식으로 **## 출력 로그**에 로그 항목을 추가합니다
64
+ 5. 모든 하위 태스크가 완료될 때까지 반복합니다
65
65
 
66
- ## 6 · Placeholder
66
+ ## 6 · 플레이스홀더
67
67
 
68
- Placeholder - just move on to the next step
68
+ 플레이스홀더 - 다음 단계로 진행하세요
69
69
 
70
- ## 7 · Execute Code Review
70
+ ## 7 · 코드 리뷰 실행
71
71
 
72
- Follow these steps for a Code Review (in order)
72
+ 코드 리뷰를 위해 다음 단계를 순서대로 수행합니다
73
73
 
74
- - include @.claude/commands/aiwf/aiwf_code_review.md and use the Task ID as Scope.
75
- - Follow the instructions in the file to run a code review in **PARALLEL SUBAGENTS**
76
- - When done continue acting on the results accordingly
77
- - Understand and think about the results
78
- - on **FAIL**
79
- - thoroughly understand the problem
80
- - extend the Current Task with the Subtasks identified by the review
81
- - go back to "5 · Execute task work"
82
- - on **PASS**
83
- - move on to next step
74
+ - @.claude/commands/aiwf/aiwf_code_review.md를 포함하고 태스크 ID를 범위로 사용합니다
75
+ - 파일의 지침에 따라 **병렬 서브에이전트**에서 코드 리뷰를 실행합니다
76
+ - 완료되면 결과에 따라 적절히 조치합니다
77
+ - 결과를 이해하고 분석합니다
78
+ - **실패** 시:
79
+ - 문제를 철저히 이해합니다
80
+ - 리뷰에서 식별된 하위 태스크로 현재 태스크를 확장합니다
81
+ - "5 · 태스크 작업 실행"으로 돌아갑니다
82
+ - **통과** 시:
83
+ - 다음 단계로 진행합니다
84
84
 
85
- ## 8 · Finalize task status
85
+ ## 8 · 태스크 상태 완료 처리
86
86
 
87
- - set the Task status to **completed**
88
- - Rename the Task file accordingly to enable proper Completed recognition from the filename (TX[TASK_ID]...)
89
- - Update .aiwf/00_PROJECT_MANIFEST.md to reflect the new status
90
- - **GitHub Issue Update (if exists):**
87
+ - 태스크 상태를 **completed**로 설정합니다
88
+ - 파일명에서 완료 인식이 가능하도록 태스크 파일명을 적절히 변경합니다 (TX[TASK_ID]...)
89
+ - .aiwf/00_PROJECT_MANIFEST.md를 업데이트하여 새 상태를 반영합니다
90
+ - **GitHub 이슈 업데이트 (존재하는 경우):**
91
91
  ```bash
92
- gh issue comment {issue_number} --body "✅ Task has been completed."
92
+ gh issue comment {issue_number} --body "✅ 태스크가 완료되었습니다."
93
93
  gh issue edit {issue_number} --remove-label "in-progress" --add-label "completed"
94
94
  ```
95
- - **Report** the result to the user
95
+ - 사용자에게 **결과 보고**
96
96
 
97
- ✅ **Result**: Quick statement of success
97
+ ✅ **결과**: 성공에 대한 간단한 설명
98
98
 
99
- 🔎 **Scope**: Identified task or reason none was processed
99
+ 🔎 **범위**: 식별된 태스크 또는 처리되지 않은 이유
100
100
 
101
- 💬 **Summary**: One-paragraph recap of what was done or why blocked
101
+ 💬 **요약**: 수행된 작업 또는 차단된 이유에 대한 한 문단 요약
102
102
 
103
- ⏭️ **Next steps**: Recommended follow-up actions
103
+ ⏭️ **다음 단계**: 권장 후속 조치
104
104
 
105
- - **Suggestions** for the User:
105
+ - 사용자를 위한 **제안**:
106
106
 
107
- - 🛠️ Use /project:aiwf:commit `TASK_ID` to commit the changes to git
108
- - 🔀 Use /project:aiwf:pr_create `TASK_ID` to create a Pull Request
109
- - 🧹 Use /clear to clear the context before starting the next Task
107
+ - 🛠️ /project:aiwf:commit `TASK_ID`를 사용하여 변경사항을 git에 커밋
108
+ - 🔀 /project:aiwf:pr_create `TASK_ID`를 사용하여 Pull Request 생성
109
+ - 🧹 /clear를 사용하여 다음 태스크 시작 전 컨텍스트 정리
@@ -0,0 +1,225 @@
1
+ # 문서 업데이트
2
+
3
+ 현재 프로젝트 문서를 분석하고 구현 진행 상황과 최근 변경 사항을 반영하도록 업데이트합니다.
4
+
5
+ ## 정확히 다음 10개 항목으로 TODO 생성
6
+
7
+ 1. 문서 업데이트 범위 분석
8
+ 2. 프로젝트 매니페스트 및 마일스톤 검토
9
+ 3. 스프린트 문서 상태 평가
10
+ 4. 필요시 ARCHITECTURE.md 업데이트
11
+ 5. 마일스톤 요구사항 문서 업데이트
12
+ 6. 스프린트 문서 업데이트
13
+ 7. PROJECT_MANIFEST.md 검토 및 업데이트
14
+ 8. README.md 및 프로젝트 문서 업데이트
15
+ 9. 추가 문서 폴더 업데이트
16
+ 10. 문서 업데이트 요약 생성
17
+
18
+ 각 단계별로 다음 지침을 엄격히 따라 진행하세요.
19
+
20
+ ## 각 TODO 항목의 상세 내용
21
+
22
+ ### 1. 문서 업데이트 범위 분석
23
+
24
+ 확인: <$ARGUMENTS>
25
+
26
+ 비어있으면 전체 문서 검토를 수행합니다. 그렇지 않으면 <$ARGUMENTS>를 해석하여 특정 초점 영역(마일스톤, 스프린트, 아키텍처 구성 요소 등)을 식별합니다.
27
+
28
+ **중요:** 먼저 `.aiwf/00_PROJECT_MANIFEST.md`를 읽어 다음을 이해하세요:
29
+ - 현재 마일스톤 및 스프린트 상태
30
+ - 완료된 작업 vs 진행 중인 작업 vs 계획된 작업
31
+ - 문서화가 필요한 최근 변경 사항
32
+
33
+ ### 2. 프로젝트 매니페스트 및 마일스톤 검토
34
+
35
+ **병렬 에이전트 사용:**
36
+ - `.aiwf/00_PROJECT_MANIFEST.md`를 읽어 현재 상태 확인
37
+ - `.aiwf/02_REQUIREMENTS/`의 모든 마일스톤 요구사항 읽기
38
+ - 마지막 문서 업데이트 이후 변경된 사항 식별
39
+ - 상태 업데이트가 필요한 완료된 마일스톤 확인
40
+
41
+ ### 3. 스프린트 문서 상태 평가
42
+
43
+ **병렬 에이전트 사용:**
44
+ - `.aiwf/03_SPRINTS/`로 이동하여 현재 및 완료된 스프린트 찾기
45
+ - 스프린트 메타 파일을 읽어 산출물 이해
46
+ - 각 스프린트 내 작업 완료 상태 확인
47
+ - 상태 업데이트나 완료 표시가 필요한 스프린트 식별
48
+
49
+ ### 4. 필요시 ARCHITECTURE.md 업데이트
50
+
51
+ - `.aiwf/01_PROJECT_DOCS/ARCHITECTURE.md` 읽기
52
+ - 구현을 검토하여 아키텍처가 발전했는지 확인
53
+ - 구조가 변경된 경우 다이어그램 업데이트
54
+ - 구현 중 발견된 새 컴포넌트나 모듈 추가
55
+ - 최근 스프린트 동안 내려진 아키텍처 결정 문서화
56
+
57
+ **중요:** 아키텍처가 실제로 변경된 경우에만 업데이트하세요. 사소한 세부사항으로 수정하지 마세요.
58
+
59
+ ### 5. 마일스톤 요구사항 문서 업데이트
60
+
61
+ 활성 또는 최근 완료된 각 마일스톤에 대해:
62
+ - `.aiwf/02_REQUIREMENTS/M{N}_*/`로 이동
63
+ - `requirements.md`를 다음과 함께 업데이트:
64
+ - ✅ 완료된 요구사항
65
+ - 🚧 진행 중인 항목 (완료율 포함)
66
+ - 📋 아직 시작하지 않은 계획된 항목
67
+ - ❌ 연기되거나 제거된 요구사항 (정당화 포함)
68
+ - 복잡한 기능에 대한 구현 노트 추가
69
+ - 요구사항 변경이나 명확화 문서화
70
+
71
+ ### 6. 스프린트 문서 업데이트
72
+
73
+ 현재 및 최근 완료된 스프린트에 대해:
74
+ - `.aiwf/03_SPRINTS/S{N}_*/`로 이동
75
+ - 스프린트 메타 파일을 다음과 함께 업데이트:
76
+ - 현재 상태 (PLANNED/IN_PROGRESS/COMPLETED)
77
+ - 완료 백분율
78
+ - 실제 vs 계획된 산출물
79
+ - 개별 작업 파일 업데이트:
80
+ - 완료된 작업을 ✅로 표시
81
+ - 구현 노트 추가
82
+ - 차단 사항이나 도전 과제 문서화
83
+ - 관련 코드 파일에 링크
84
+
85
+ ### 7. PROJECT_MANIFEST.md 검토 및 업데이트
86
+
87
+ 매니페스트를 다음과 함께 업데이트:
88
+ - **현재 상태**: 마일스톤 및 스프린트 진행 상황 업데이트
89
+ - **스프린트 추적**: 완료된 스프린트 표시, 현재 스프린트 업데이트
90
+ - **산출물**: 각 산출물의 완료 상태 업데이트
91
+ - **최근 성과**: 주목할 만한 완료 사항 추가
92
+ - **알려진 이슈**: 차단 사항이나 기술 부채 문서화
93
+ - **다음 단계**: 완료된 작업을 기반으로 업데이트
94
+
95
+ **형식 예시:**
96
+ ```markdown
97
+ ## 현재 상태
98
+ - **활성 마일스톤**: M01 - [이름] (75% 완료)
99
+ - **현재 스프린트**: S03 - [초점] (진행 중 - 40% 완료)
100
+ - **마지막 업데이트**: YYYY-MM-DD HH:MM
101
+
102
+ ## 스프린트 진행 상황
103
+
104
+ ### 현재 스프린트 (S03)
105
+ **상태**: 진행 중 (40% 완료)
106
+ **산출물**:
107
+ - ✅ [완료된 기능] - 완료
108
+ - 🚧 [진행 중인 기능] - 60% 완료
109
+ - 📋 [계획된 기능] - 시작 전
110
+ ```
111
+
112
+ ### 8. README.md 및 프로젝트 문서 업데이트
113
+
114
+ **프로젝트의 메인 README.md 검토 및 업데이트:**
115
+ - 프로젝트 루트에 README.md 존재 여부 확인
116
+ - 범위가 발전한 경우 프로젝트 설명 업데이트
117
+ - 최근 변경 사항을 기반으로 설치/설정 지침 새로고침
118
+ - 새 기능으로 사용 예제 업데이트
119
+ - 배지 추가/업데이트 (빌드 상태, 테스트 커버리지, 버전)
120
+ - 새 의존성이나 요구사항 문서화
121
+ - 프로세스가 변경된 경우 기여 가이드라인 업데이트
122
+ - 엔드포인트가 변경된 경우 API 문서 새로고침
123
+
124
+ **검토할 주요 섹션:**
125
+ - 프로젝트 개요 및 목적
126
+ - 기능 목록 (완료/진행 중/계획됨 표시)
127
+ - 설치 및 설정 지침
128
+ - 사용 예제 및 코드 스니펫
129
+ - 구성 옵션
130
+ - API 참조 (해당하는 경우)
131
+ - 기여 가이드라인
132
+ - 라이선스 정보
133
+
134
+ ### 9. 추가 문서 폴더 업데이트
135
+
136
+ **프로젝트 전체의 모든 문서 검색 및 업데이트:**
137
+
138
+ **확인할 일반적인 문서 위치:**
139
+ - `docs/` - 메인 문서 폴더
140
+ - `documentation/` - 대체 문서 폴더
141
+ - `doc/` - 간단한 형식의 문서 폴더
142
+ - `api-docs/` - API 전용 문서
143
+ - 프로젝트 루트의 `*.md` 파일 (CONTRIBUTING.md, CHANGELOG.md 등)
144
+
145
+ **발견된 각 문서 폴더에 대해:**
146
+ - 오래된 정보가 있는 모든 마크다운 파일 검토
147
+ - 구현 세부사항으로 기술 사양 업데이트
148
+ - 새 기능으로 사용자 가이드 새로고침
149
+ - 새 엔드포인트/변경사항으로 API 문서 업데이트
150
+ - 브레이킹 체인지가 도입된 경우 마이그레이션 가이드 추가
151
+ - 알려진 이슈/해결책으로 문제 해결 섹션 업데이트
152
+
153
+ **확인할 특정 파일:**
154
+ - `CHANGELOG.md` - 최근 변경 사항 및 버전 업데이트 추가
155
+ - `CONTRIBUTING.md` - 변경된 경우 개발 워크플로우 업데이트
156
+ - `docs/setup.md` - 설치/구성 단계 새로고침
157
+ - `docs/api.md` - API 엔드포인트 및 예제 업데이트
158
+ - `docs/deployment.md` - 배포 절차 업데이트
159
+ - `docs/testing.md` - 새 테스트 절차 문서화
160
+
161
+ **문서 일관성 검사:**
162
+ - 모든 문서에서 버전 번호가 일관되는지 확인
163
+ - 코드 예제가 현재 구현에서 여전히 작동하는지 확인
164
+ - UI/아키텍처가 변경된 경우 스크린샷/다이어그램 업데이트
165
+ - 모든 링크(내부 및 외부)가 유효한지 확인
166
+ - 전체적으로 용어가 일관되는지 확인
167
+
168
+ ### 10. 문서 업데이트 요약 생성
169
+
170
+ 모든 문서 업데이트의 요약 보고서 작성:
171
+
172
+ ```markdown
173
+ # 문서 업데이트 요약 - [YYYY-MM-DD]
174
+
175
+ ## 업데이트된 파일
176
+
177
+ ### AIWF 문서
178
+ - `.aiwf/00_PROJECT_MANIFEST.md` - [변경 사항 간략 설명]
179
+ - `.aiwf/01_PROJECT_DOCS/ARCHITECTURE.md` - [업데이트된 경우]
180
+ - `.aiwf/02_REQUIREMENTS/M01_*/requirements.md` - [상태 업데이트]
181
+ - `.aiwf/03_SPRINTS/S0N_*/meta.md` - [스프린트 상태 변경]
182
+
183
+ ### 프로젝트 문서
184
+ - `README.md` - [메인 프로젝트 문서 업데이트]
185
+ - `CHANGELOG.md` - [버전 및 변경 이력 업데이트]
186
+ - `CONTRIBUTING.md` - [기여 가이드라인 업데이트]
187
+ - `docs/*.md` - [특정 문서 파일 업데이트]
188
+ - 기타 문서 폴더 - [추가 업데이트 목록]
189
+
190
+ ## 주요 변경 사항
191
+ 1. [주요 문서 변경 또는 업데이트]
192
+ 2. [추가된 새 섹션]
193
+ 3. [적용된 상태 업데이트]
194
+
195
+ ## 업데이트 후 프로젝트 상태
196
+ - **마일스톤 진행률**: M01 X% (이전 Y%)
197
+ - **스프린트 진행률**: S0N X% (이전 Y%)
198
+ - **문서 커버리지**: [문서 완성도 평가]
199
+
200
+ ## 권장 사항
201
+ - [식별된 문서 격차]
202
+ - [제안된 문서 개선 사항]
203
+ - [명확화가 필요한 영역]
204
+ ```
205
+
206
+ ## 가이드라인
207
+
208
+ - 원래 요구사항과 계획 보존 (취소선이나 상태 마커 사용)
209
+ - 일관된 상태 표시자 유지 (✅, 🚧, 📋, ❌)
210
+ - 실제 구현을 기반으로 백분율 업데이트
211
+ - 원래 계획에서 벗어난 사항을 정당화와 함께 문서화
212
+ - 문서를 간결하면서도 포괄적으로 유지
213
+ - 모든 날짜와 타임스탬프가 최신인지 확인
214
+ - 관련 문서 섹션 간 상호 참조
215
+ - 예상 위치뿐만 아니라 프로젝트 전체에서 모든 .md 파일 검색
216
+ - 독립 문서 파일에 대한 루트 디렉토리 확인
217
+ - 문서의 모든 코드 예제가 여전히 작동하는지 확인
218
+ - 새 팀 구성원이 문서에 접근할 수 있는지 확인
219
+
220
+ **중요:** 문서는 현실을 반영해야 합니다. 열망적인 목표가 아닌 실제 구현 상태를 기반으로 업데이트하세요.
221
+
222
+ **핵심:** 문서 위치를 가정하지 마세요. 항상 전체 프로젝트에서 다음을 검색하세요:
223
+ - 모든 디렉토리의 `*.md` 파일
224
+ - 일반적인 이름: README, CHANGELOG, CONTRIBUTING, LICENSE, INSTALL, USAGE
225
+ - 예상치 못한 위치의 문서 (예: src/, lib/ 또는 기타 코드 디렉토리 내부)
@@ -1,134 +1,134 @@
1
1
  # AIWF 프레임워크 초기화
2
2
 
3
- Initialize the AIWF project management framework through an adaptive, interactive process.
3
+ 적응형, 상호작용적 프로세스를 통해 AIWF 프로젝트 관리 프레임워크를 초기화합니다.
4
4
 
5
- ## Create a TODO with EXACTLY these items
5
+ ## 정확히 다음 항목들로 TODO 생성
6
6
 
7
- 1. Scan and analyze the project
8
- 2. Interactive confirmation with user
9
- 3. Check for existing AIWF documents
10
- 4. Guide document creation process
11
- 5. Create first milestone for AIWF
12
- 6. Generate project manifest
13
- 7. Provide next steps
7
+ 1. 프로젝트 스캔 및 분석
8
+ 2. 사용자와 상호작용적 확인
9
+ 3. 기존 AIWF 문서 확인
10
+ 4. 문서 생성 프로세스 안내
11
+ 5. AIWF를 위한 첫 번째 마일스톤 생성
12
+ 6. 프로젝트 매니페스트 생성
13
+ 7. 다음 단계 제공
14
14
 
15
- ## DETAILS on every TODO item
15
+ ## 모든 TODO 항목에 대한 세부사항
16
16
 
17
- ### 1. Scan and analyze the project
17
+ ### 1. 프로젝트 스캔 및 분석
18
18
 
19
- **Detect project characteristics:**
19
+ **프로젝트 특성 탐지:**
20
20
 
21
- - Check for package.json, requirements.txt, composer.json, etc.
22
- - Identify project type (Node.js, Python, PHP, etc.)
23
- - Scan overall project structure
24
- - Check if this is a new or existing project
25
- - Look for existing documentation (README, docs/, etc.)
21
+ - package.json, requirements.txt, composer.json 등 확인
22
+ - 프로젝트 유형 식별 (Node.js, Python, PHP 등)
23
+ - 전체 프로젝트 구조 스캔
24
+ - 새 프로젝트인지 기존 프로젝트인지 확인
25
+ - 기존 문서 찾기 (README, docs/ 등)
26
26
 
27
- **Keep findings brief** - Just identify the essentials
27
+ **발견사항을 간단히 정리** - 필수 사항만 식별
28
28
 
29
- ### 2. Interactive confirmation with user
29
+ ### 2. 사용자와 상호작용적 확인
30
30
 
31
- **Present findings conversationally:**
31
+ **발견사항을 대화형으로 제시:**
32
32
 
33
33
  ```
34
- I found this to be a [project type] project named [detected name].
35
- Is this correct? Should I proceed with AIWF setup?
34
+ 이것은 [프로젝트 이름]이라는 [프로젝트 유형] 프로젝트인 것으로 확인됩니다.
35
+ 맞습니까? AIWF 설정을 계속 진행해도 될까요?
36
36
  ```
37
37
 
38
- **Get user confirmation before continuing**
38
+ **계속하기 전에 사용자 확인 받기**
39
39
 
40
- ### 3. Check for existing AIWF documents
40
+ ### 3. 기존 AIWF 문서 확인
41
41
 
42
- **Scan .aiwf/ directory for:**
42
+ **.aiwf/ 디렉토리에서 스캔:**
43
43
 
44
- - Any documents in 01_PROJECT_DOCS/
45
- - Any milestones in 02_REQUIREMENTS/
46
- - Any existing sprints or tasks
47
- - Current manifest status
44
+ - 01_PROJECT_DOCS/의 모든 문서
45
+ - 02_REQUIREMENTS/의 모든 마일스톤
46
+ - 기존 스프린트나 태스크
47
+ - 현재 매니페스트 상태
48
48
 
49
- **Interactive decision:**
49
+ **상호작용적 결정:**
50
50
 
51
- - If documents found: "I found existing documents: [list]. Should we work with these or extend them?"
52
- - If no documents: "No AIWF documents found yet. Do you have any existing project documentation you'd like to copy in before we continue?"
51
+ - 문서가 발견된 경우: "기존 문서를 발견했습니다: [목록]. 이것들을 사용하거나 확장할까요?"
52
+ - 문서가 없는 경우: "아직 AIWF 문서가 없습니다. 계속하기 전에 복사하고 싶은 기존 프로젝트 문서가 있나요?"
53
53
 
54
- **Allow user to:**
54
+ **사용자가 선택할 수 있는 옵션:**
55
55
 
56
- - Use existing documents
57
- - Add new documents
58
- - Start fresh
59
- - Cancel to add documents manually first
56
+ - 기존 문서 사용
57
+ - 새 문서 추가
58
+ - 새로 시작
59
+ - 먼저 수동으로 문서 추가하기 위해 취소
60
60
 
61
- ### 4. Guide document creation process
61
+ ### 4. 문서 생성 프로세스 안내
62
62
 
63
- **Based on user's choice:**
63
+ **사용자 선택에 따라:**
64
64
 
65
- **If starting fresh or extending:**
65
+ **새로 시작하거나 확장하는 경우:**
66
66
 
67
- - Perform deep analysis of the codebase
68
- - Identify key components and architecture patterns
69
- - Create draft ARCHITECTURE.md based on analysis
70
- - Use Q&A style to refine and complete:
71
- - "What's the main purpose of this project?"
72
- - "What are the key technical decisions?"
73
- - "Any important constraints or requirements?"
67
+ - 코드베이스의 심층 분석 수행
68
+ - 주요 구성요소와 아키텍처 패턴 식별
69
+ - 분석을 바탕으로 ARCHITECTURE.md 초안 생성
70
+ - Q&A 스타일로 정제하고 완성:
71
+ - "이 프로젝트의 주요 목적은 무엇인가요?"
72
+ - "핵심 기술적 결정사항은 무엇인가요?"
73
+ - "중요한 제약사항이나 요구사항이 있나요?"
74
74
 
75
- **If using existing docs:**
75
+ **기존 문서를 사용하는 경우:**
76
76
 
77
- - Import and adapt existing documentation
78
- - Fill in any AIWF-specific sections
79
- - Ensure compatibility with framework structure
77
+ - 기존 문서를 가져와서 적응
78
+ - AIWF 관련 섹션 작성
79
+ - 프레임워크 구조와의 호환성 보장
80
80
 
81
- **Keep it conversational and adaptive**
81
+ **대화형이고 적응적으로 유지**
82
82
 
83
- ### 5. Create first milestone for AIWF
83
+ ### 5. AIWF를 위한 첫 번째 마일스톤 생성
84
84
 
85
- **Determine appropriate first milestone:**
85
+ **적절한 첫 번째 마일스톤 결정:**
86
86
 
87
- - If new project: Start with setup/foundation milestone
88
- - If existing project: Identify current phase and create appropriate milestone
87
+ - 새 프로젝트인 경우: 설정/기반 마일스톤으로 시작
88
+ - 기존 프로젝트인 경우: 현재 단계를 식별하고 적절한 마일스톤 생성
89
89
 
90
- **Interactive milestone creation:**
90
+ **상호작용적 마일스톤 생성:**
91
91
 
92
- - "Based on the project state, I suggest creating milestone: [name]"
93
- - "What would you like to focus on in this milestone?"
94
- - Create milestone structure with initial requirements
95
- - Keep scope realistic and focused
92
+ - "프로젝트 상태를 바탕으로 다음 마일스톤 생성을 제안합니다: [이름]"
93
+ - "이 마일스톤에서 무엇에 집중하고 싶으신가요?"
94
+ - 초기 요구사항이 포함된 마일스톤 구조 생성
95
+ - 범위를 현실적이고 집중적으로 유지
96
96
 
97
- ### 6. Generate project manifest
97
+ ### 6. 프로젝트 매니페스트 생성
98
98
 
99
- **Automatically generate manifest using:**
99
+ **다음을 사용하여 매니페스트 자동 생성:**
100
100
 
101
- - Information gathered during setup
102
- - Created/imported documentation
103
- - Current milestone details
104
- - Project metadata
101
+ - 설정 중에 수집된 정보
102
+ - 생성/가져온 문서
103
+ - 현재 마일스톤 세부사항
104
+ - 프로젝트 메타데이터
105
105
 
106
- **No user interaction needed** - Just inform when complete
106
+ **사용자 상호작용 불필요** - 완료될 때 알리기만 하세요
107
107
 
108
- ### 7. Provide next steps
108
+ ### 7. 다음 단계 제공
109
109
 
110
- **Customized guidance based on setup:**
110
+ **설정을 바탕으로 맞춤형 안내:**
111
111
 
112
112
  ```
113
- ✅ AIWF initialized for [project name]!
113
+ ✅ [프로젝트 이름]에 대한 AIWF 초기화 완료!
114
114
 
115
- Current setup:
116
- - Project type: [type]
117
- - Current milestone: [milestone]
118
- - Documents: [created/imported]
115
+ 현재 설정:
116
+ - 프로젝트 유형: [유형]
117
+ - 현재 마일스톤: [마일스톤]
118
+ - 문서: [생성/가져온 항목]
119
119
 
120
- Next steps:
121
- - Review your architecture: 01_PROJECT_DOCS/ARCHITECTURE.md
122
- - Check milestone requirements: 02_REQUIREMENTS/[milestone]/
123
- - Start first task: /project:aiwf:create_general_task
120
+ 다음 단계:
121
+ - 아키텍처 검토: 01_PROJECT_DOCS/ARCHITECTURE.md
122
+ - 마일스톤 요구사항 확인: 02_REQUIREMENTS/[마일스톤]/
123
+ - 첫 번째 태스크 시작: /project:aiwf:create_general_task
124
124
 
125
- Ready to begin development!
125
+ 개발을 시작할 준비가 완료되었습니다!
126
126
  ```
127
127
 
128
- ## ADAPTIVE PROCESS NOTES
128
+ ## 적응형 프로세스 노트
129
129
 
130
- - **Stay conversational** - Ask questions naturally, not like a form
131
- - **Be smart** - Use AI to understand context and make intelligent suggestions
132
- - **Allow flexibility** - User can skip, cancel, or modify at any point
133
- - **Focus on value** - Only create what's useful for the specific project
134
- - **Keep it simple** - Don't overwhelm with options or details
130
+ - **대화형 유지** - 양식처럼이 아닌 자연스럽게 질문하기
131
+ - **스마트하게** - AI를 사용하여 맥락을 이해하고 지능적인 제안 만들기
132
+ - **유연성 허용** - 사용자가 언제든지 건너뛰기, 취소, 수정 가능
133
+ - **가치에 집중** - 특정 프로젝트에 유용한 것만 생성
134
+ - **단순하게 유지** - 옵션이나 세부사항으로 압도하지 않기