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,189 +1,189 @@
1
- # 스프린트를 위한 Task 생성 - 탑 다운 실행
1
+ # 스프린트 태스크 생성 - 탑 다운 실행
2
2
 
3
- Create detailed tasks for an existing sprint with integrated implementation guidance.
3
+ 통합된 구현 가이드와 함께 기존 스프린트에 대한 상세한 태스크를 생성합니다.
4
4
 
5
- ## Create a TODO with EXACTLY these 8 Items
5
+ ## 정확히 다음 8개 항목으로 TODO 생성
6
6
 
7
- 1. Identify target sprint and verify it exists
8
- 2. Load sprint context and related documentation
9
- 3. Check for existing ADRs and technical guidance
10
- 4. Analyze sprint deliverables for task breakdown
11
- 5. Create individual task files with implementation guidance
12
- 6. Link ADRs to relevant tasks
13
- 7. Update sprint meta with task references
14
- 8. Check quality of your work
7
+ 1. 대상 스프린트 식별 및 존재 확인
8
+ 2. 스프린트 컨텍스트 및 관련 문서 로드
9
+ 3. 기존 ADR 및 기술 가이드 확인
10
+ 4. 태스크 분할을 위한 스프린트 결과물 분석
11
+ 5. 구현 가이드와 함께 개별 태스크 파일 생성
12
+ 6. 관련 태스크에 ADR 연결
13
+ 7. 태스크 참조로 스프린트 메타 업데이트
14
+ 8. 작업 품질 확인
15
15
 
16
- Follow step by step and adhere closely to the following instructions for each step.
16
+ 단계별로 따라가며 각 단계에 대한 다음 지침을 엄격히 준수하세요.
17
17
 
18
- ## DETAILS on every TODO item
18
+ ## 모든 TODO 항목에 대한 세부사항
19
19
 
20
- ### 1. Identify target sprint and verify it exists
20
+ ### 1. 대상 스프린트 식별 및 존재 확인
21
21
 
22
- Check: <$ARGUMENTS>
22
+ 확인: <$ARGUMENTS>
23
23
 
24
- **REQUIRED:** Sprint ID must be provided (e.g., S02). If empty, ask user to specify which sprint to detail.
24
+ **필수:** 스프린트 ID가 제공되어야 함 (예: S02). 비어있다면 사용자에게 상세화할 스프린트를 지정하도록 요청.
25
25
 
26
- - VERIFY sprint directory exists in `.aiwf/03_SPRINTS/`
27
- - CHECK sprint meta file exists (e.g., `S02_sprint_meta.md`)
28
- - VERIFY sprint status is not already "completed"
29
- - If tasks already exist, ask user if they want to recreate them or any other guidance
26
+ - `.aiwf/03_SPRINTS/`에 스프린트 디렉토리 존재 확인
27
+ - 스프린트 메타 파일 존재 확인 (예: `S02_sprint_meta.md`)
28
+ - 스프린트 상태가 이미 "completed"가 아닌지 확인
29
+ - 태스크가 이미 존재한다면, 사용자에게 재생성할지 또는 다른 가이드가 필요한지 문의
30
30
 
31
- ### 2. Load sprint context and related documentation
31
+ ### 2. 스프린트 컨텍스트 및 관련 문서 로드
32
32
 
33
- Use PARALLEL SUBAGENTS to READ and UNDERSTAND the project's context:
33
+ 병렬 서브에이전트를 사용하여 프로젝트 컨텍스트를 읽고 이해:
34
34
 
35
- - READ `.aiwf/00_PROJECT_MANIFEST.md` for project context
36
- - READ sprint meta file completely to understand goals and deliverables
37
- - READ parent milestone requirements from `.aiwf/02_REQUIREMENTS/`
38
- - READ `.aiwf/01_PROJECT_DOCS/ARCHITECTURE.md` for technical context
39
- - READ `.aiwf/01_PROJECT_DOCS/LONG_TERM_VISION.md` to understand architectural decisions
35
+ - 프로젝트 컨텍스트를 위해 `.aiwf/00_PROJECT_MANIFEST.md` 읽기
36
+ - 목표와 결과물을 이해하기 위해 스프린트 메타 파일 완전히 읽기
37
+ - `.aiwf/02_REQUIREMENTS/`에서 상위 마일스톤 요구사항 읽기
38
+ - 기술적 컨텍스트를 위해 `.aiwf/01_PROJECT_DOCS/ARCHITECTURE.md` 읽기
39
+ - 아키텍처 결정을 이해하기 위해 `.aiwf/01_PROJECT_DOCS/LONG_TERM_VISION.md` 읽기
40
40
 
41
- **IMPORTANT:** Sprint tasks must align with documented sprint goals, not expand scope.
41
+ **중요:** 스프린트 태스크는 문서화된 스프린트 목표와 일치해야 하며, 범위를 확장하면 안 됨.
42
42
 
43
- ### 3. Check for existing ADRs and technical guidance
43
+ ### 3. 기존 ADR 및 기술 가이드 확인
44
44
 
45
- **USE PARALLEL SUBAGENTS** to execute these commands:
45
+ **병렬 서브에이전트 사용**하여 다음 명령 실행:
46
46
 
47
- - SEARCH `.aiwf/05_ARCHITECTURE_DECISIONS/` for ADRs matching sprint ID (e.g., `ADR*_S02_*.md`)
48
- - READ all found ADRs to understand technical decisions
49
- - CHECK sprint meta for ADR references section
50
- - NOTE which technical decisions will affect task implementation
51
- - BUILD RELATIONSHIP in task and subtasks and make clear what to implement
47
+ - 스프린트 ID와 일치하는 ADR을 위해 `.aiwf/05_ARCHITECTURE_DECISIONS/` 검색 (예: `ADR*_S02_*.md`)
48
+ - 기술적 결정을 이해하기 위해 발견된 모든 ADR 읽기
49
+ - ADR 참조 섹션에 대한 스프린트 메타 확인
50
+ - 태스크 구현에 영향을 줄 기술적 결정 주목
51
+ - 태스크와 서브태스크에서 관계 구축하고 구현할 내용을 명확히 하기
52
52
 
53
- **If conflict in Scope** Between ADR and Sprint goal, try to think about it and ask the user to resolve the conflict.
53
+ **범위에서 충돌**이 ADR과 스프린트 목표 사이에 있다면, 고민해보고 사용자에게 충돌 해결을 요청.
54
54
 
55
- **If no ADRs found:** Proceed but note that tasks may need clarification during implementation.
55
+ **ADR이 발견되지 않은 경우:** 진행하되 구현 중에 태스크가 명확화가 필요할 수 있음을 주목.
56
56
 
57
- ### 4. Analyze sprint deliverables for task breakdown
57
+ ### 4. 태스크 분할을 위한 스프린트 결과물 분석
58
58
 
59
- Based on sprint goals and deliverables (execute in Parallel Subagents):
59
+ 스프린트 목표와 결과물을 바탕으로 (병렬 서브에이전트에서 실행):
60
60
 
61
- - BREAK DOWN high-level deliverables into concrete, implementable tasks
62
- - ENSURE each task represents a coherent feature or component
63
- - CONSIDER logical dependencies between tasks
64
- - MAP tasks to relevant ADRs for technical guidance
65
- - DEFER complexity assessment until after tasks are fully created with subtasks
61
+ - 고수준 결과물을 구체적이고 구현 가능한 태스크로 분할
62
+ - 각 태스크가 일관된 기능이나 구성요소를 나타내도록 보장
63
+ - 태스크 간의 논리적 종속성 고려
64
+ - 기술 가이드를 위해 태스크를 관련 ADR에 매핑
65
+ - 서브태스크와 함께 태스크가 완전히 생성된 후까지 복잡성 평가 연기
66
66
 
67
- ### 5. Create individual task files with implementation guidance
67
+ ### 5. 구현 가이드와 함께 개별 태스크 파일 생성
68
68
 
69
- **NOW** For each identified Task spin up a Parallel Subagent with these Instructions:
69
+ **이제** 식별된 각 태스크에 대해 다음 지침과 함께 병렬 서브에이전트를 시작:
70
70
 
71
- #### Create a TODO for EACH task
71
+ #### 각 태스크에 대한 TODO 생성
72
72
 
73
- 1. Create basic task structure
74
- 2. Research codebase interfaces
75
- 3. Add technical guidance
76
- 4. Validate task completeness
73
+ 1. 기본 태스크 구조 생성
74
+ 2. 코드베이스 인터페이스 조사
75
+ 3. 기술 가이드 추가
76
+ 4. 태스크 완전성 검증
77
77
 
78
- ### 1. Create basic task structure
78
+ ### 1. 기본 태스크 구조 생성
79
79
 
80
- - ALL TASK FILES must to be created in the Sprint Directory (where the sprint meta file is)
81
- - CREATE file with naming: `T<NN>_S<NN>_<Descriptive_Name>.md`
82
- - USE sequential numbering starting from T01
83
- - FOLLOW task template structure exactly from `.aiwf/99_TEMPLATES/task_template.md`
84
- - ADD basic description and objectives from sprint goals
80
+ - 모든 태스크 파일은 스프린트 디렉토리(스프린트 메타 파일이 있는 곳)에 생성되어야 함
81
+ - `T<NN>_S<NN>_<설명적_이름>.md` 명명으로 파일 생성
82
+ - T01부터 시작하는 순차적 번호 사용
83
+ - `.aiwf/99_TEMPLATES/task_template.md`의 태스크 템플릿 구조를 정확히 따름
84
+ - 스프린트 목표에서 기본 설명과 목표 추가
85
85
 
86
- ### 2. Research codebase interfaces
86
+ ### 2. 코드베이스 인터페이스 조사
87
87
 
88
- - EXAMINE existing codebase for similar patterns and interfaces
89
- - IDENTIFY specific classes, functions, and imports that will be needed
90
- - FIND integration points with existing modules
91
- - NOTE database models, API endpoints, or services to interface with
92
- - CHECK existing error handling and logging patterns
88
+ - 유사한 패턴과 인터페이스를 위해 기존 코드베이스 검토
89
+ - 필요한 특정 클래스, 함수, 임포트 식별
90
+ - 기존 모듈과의 통합 지점 찾기
91
+ - 인터페이스할 데이터베이스 모델, API 엔드포인트 또는 서비스 주목
92
+ - 기존 오류 처리 및 로깅 패턴 확인
93
93
 
94
- ### 3. Add technical guidance
94
+ ### 3. 기술 가이드 추가
95
95
 
96
- Add these sections to the task file (add to template if not present):
96
+ 태스크 파일에 다음 섹션 추가 (템플릿에 없으면 추가):
97
97
 
98
- **Technical Guidance section:**
98
+ **기술 가이드 섹션:**
99
99
 
100
- - Key interfaces and integration points in the codebase
101
- - Specific imports and module references
102
- - Existing patterns to follow
103
- - Database models or API contracts to work with
104
- - Error handling approach used in similar code
100
+ - 코드베이스의 주요 인터페이스 및 통합 지점
101
+ - 특정 임포트 및 모듈 참조
102
+ - 따라야 할 기존 패턴
103
+ - 작업할 데이터베이스 모델 또는 API 계약
104
+ - 유사한 코드에서 사용되는 오류 처리 접근법
105
105
 
106
- **Implementation Notes section:**
106
+ **구현 노트 섹션:**
107
107
 
108
- - Step-by-step implementation approach
109
- - Key architectural decisions to respect
110
- - Testing approach based on existing test patterns
111
- - Performance considerations if relevant
108
+ - 단계별 구현 접근법
109
+ - 존중해야 할 주요 아키텍처 결정
110
+ - 기존 테스트 패턴을 바탕으로 한 테스트 접근법
111
+ - 관련된 경우 성능 고려사항
112
112
 
113
- **IMPORTANT:** Do NOT include code examples. Provide structural guidance and references only.
113
+ **중요:** 코드 예제를 포함하지 마세요. 구조적 가이드와 참조만 제공.
114
114
 
115
- #### 4. Validate task completeness
115
+ #### 4. 태스크 완전성 검증
116
116
 
117
- - ENSURE task has clear implementation path
118
- - VERIFY all integration points are documented
119
- - CHECK that guidance references actual codebase elements
120
- - CONFIRM task is self-contained and actionable
117
+ - 태스크가 명확한 구현 경로를 가지는지 확인
118
+ - 모든 통합 지점이 문서화되었는지 확인
119
+ - 가이드가 실제 코드베이스 요소를 참조하는지 확인
120
+ - 태스크가 자체 완결적이고 실행 가능한지 확인
121
121
 
122
- **REPEAT** `### 5. Create individual task files with implementation guidance` for every Task
122
+ **반복** `### 5. 구현 가이드와 함께 개별 태스크 파일 생성`을 모든 태스크에 대해
123
123
 
124
- ### 6. Link ADRs to relevant tasks
124
+ ### 6. 관련 태스크에 ADR 연결
125
125
 
126
- - IF relevant ADRs exist
127
- - REFERENCE ADRs that are related
128
- - ADD explanation in Technical Guidance section for how each ADR applies
129
- - ENSURE tasks ONLY reference ADRs that affect their implementation
126
+ - 관련 ADR이 존재하는 경우
127
+ - 관련된 ADR 참조
128
+ - 각 ADR이 어떻게 적용되는지에 대한 설명을 기술 가이드 섹션에 추가
129
+ - 태스크가 구현에 영향을 주는 ADR만 참조하도록 보장
130
130
 
131
- ### 7. Update sprint meta with task references
131
+ ### 7. 태스크 참조로 스프린트 메타 업데이트
132
132
 
133
- - EDIT sprint meta file to add/update task list
134
- - ORGANIZE tasks by logical grouping or dependency order
135
- - ADD brief description for each task
133
+ - 태스크 목록을 추가/업데이트하기 위해 스프린트 메타 파일 편집
134
+ - 논리적 그룹화 또는 종속성 순서로 태스크 구성
135
+ - 각 태스크에 대한 간단한 설명 추가
136
136
 
137
- ### 8. Check quality of your work
137
+ ### 8. 작업 품질 확인
138
138
 
139
- Review all created tasks for complexity and split any High complexity tasks:
139
+ 복잡성에 대해 생성된 모든 태스크를 검토하고 높은 복잡성 태스크를 분할:
140
140
 
141
- **Complexity Assessment Process:**
141
+ **복잡성 평가 프로세스:**
142
142
 
143
- - READ each task file completely including description, goals, acceptance criteria, and subtasks
144
- - ASSESS complexity using your judgment about the overall scope and challenge
145
- - DO NOT base complexity on simple metrics like file counts or estimated hours
146
- - CONSIDER the conceptual difficulty, integration challenges, and unknowns
147
- - MARK complexity as Low, Medium, or High in the task frontmatter
143
+ - 설명, 목표, 수용 기준, 서브태스크를 포함하여 각 태스크 파일을 완전히 읽기
144
+ - 전체 범위와 도전에 대한 판단을 사용하여 복잡성 평가
145
+ - 파일 수나 예상 시간과 같은 단순한 지표를 기반으로 복잡성을 평가하지 마세요
146
+ - 개념적 어려움, 통합 도전, 미지수 고려
147
+ - 태스크 프론트매터에서 복잡성을 낮음, 보통, 높음으로 표시
148
148
 
149
- **If ANY task is marked as High complexity:**
149
+ **어떤 태스크든 높은 복잡성으로 표시된 경우:**
150
150
 
151
- - SPLIT the task into 2-3 smaller tasks of Low or Medium complexity
152
- - CREATE new task files with proper sequential numbering
153
- - UPDATE the original high-complexity task file or DELETE it
154
- - ENSURE the split tasks together achieve the original goal
155
- - MAINTAIN logical grouping and dependencies
151
+ - 태스크를 낮음 또는 보통 복잡성의 2-3개 작은 태스크로 분할
152
+ - 적절한 순차적 번호로 새 태스크 파일 생성
153
+ - 원래 높은 복잡성 태스크 파일을 업데이트하거나 삭제
154
+ - 분할된 태스크들이 함께 원래 목표를 달성하도록 보장
155
+ - 논리적 그룹화와 종속성 유지
156
156
 
157
- **After all tasks are finalized:**
157
+ **모든 태스크가 완료된 후:**
158
158
 
159
- - VERIFY all tasks are Low or Medium complexity only
160
- - CHECK task numbering is sequential (T01, T02, T03...)
161
- - UPDATE sprint meta file with final task list
162
- - UPDATE project manifest sprint section to reflect actual tasks created
163
- - GENERATE completion report
159
+ - 모든 태스크가 낮음 또는 보통 복잡성만 있는지 확인
160
+ - 태스크 번호가 순차적인지 확인 (T01, T02, T03...)
161
+ - 최종 태스크 목록으로 스프린트 메타 파일 업데이트
162
+ - 실제로 생성된 태스크를 반영하도록 프로젝트 매니페스트 스프린트 섹션 업데이트
163
+ - 완료 보고서 생성
164
164
 
165
- **Output format:**
165
+ **출력 형식:**
166
166
 
167
167
  ```Markdown
168
- ## Sprint Detailed - [YYYY-MM-DD HH:MM]
168
+ ## 스프린트 상세화 완료 - [YYYY-MM-DD HH:MM]
169
169
 
170
- **Sprint:** [Sprint ID] - [Sprint Name]
171
- **Status:** Planning Complete
170
+ **스프린트:** [스프린트 ID] - [스프린트 이름]
171
+ **상태:** 계획 완료
172
172
 
173
- **Tasks Created:** [final count after any splits]
174
- - Medium Complexity: [count]
175
- - Low Complexity: [count]
173
+ **생성된 태스크:** [분할 후 최종 개수]
174
+ - 보통 복잡성: [개수]
175
+ - 낮은 복잡성: [개수]
176
176
 
177
- **Task Splitting Summary:**
178
- - [Original T03 split into T03 and T04 due to scope]
179
- - [No other splits needed]
177
+ **태스크 분할 요약:**
178
+ - [원래 T03이 범위로 인해 T03과 T04로 분할됨]
179
+ - [다른 분할 필요 없음]
180
180
 
181
- **Final Task List:**
182
- 1. T01_S02 - [Title] (Complexity: [Level])
183
- 2. T02_S02 - [Title] (Complexity: [Level])
184
- [Continue for all tasks]
181
+ **최종 태스크 목록:**
182
+ 1. T01_S02 - [제목] (복잡성: [수준])
183
+ 2. T02_S02 - [제목] (복잡성: [수준])
184
+ [모든 태스크에 대해 계속]
185
185
 
186
- **Next Steps:**
187
- - Review tasks for completeness
188
- - Run `/do_task [FIRST_TASK_IN_SPRINT]` to begin implementation
189
- ```
186
+ **다음 단계:**
187
+ - 완전성에 대한 태스크 검토
188
+ - 구현을 시작하기 위해 `/do_task [스프린트의_첫_번째_태스크]` 실행
189
+ ```
@@ -1,121 +1,121 @@
1
- # 마일스톤에서 스프린트 계획하기 - 탑 다운 실행
1
+ # 마일스톤에서 스프린트 생성 - 탑 다운 실행
2
2
 
3
- Follow these instructions to sprint the scope of a Milestone into Sprints
3
+ 마일스톤의 범위를 스프린트로 분할하기 위해 다음 지침을 따르세요
4
4
 
5
- ## Create a TODO with EXACTLY these 8 items
5
+ ## 정확히 다음 8개 항목으로 TODO 생성
6
6
 
7
- 1. Analyze current milestone state
8
- 2. Assess completed work vs milestone requirements
9
- 3. Identify remaining work and dependencies
10
- 4. Design logical sprint boundaries
11
- 5. Create sprint directories and meta files
12
- 6. Update PROJECT_MANIFEST with sprint roadmap
13
- 7. Validate sprint coherence and dependencies
14
- 8. Report milestone plan
7
+ 1. 현재 마일스톤 상태 분석
8
+ 2. 완료된 작업과 마일스톤 요구사항 평가
9
+ 3. 남은 작업과 종속성 식별
10
+ 4. 논리적 스프린트 경계 설계
11
+ 5. 스프린트 디렉토리와 메타 파일 생성
12
+ 6. 스프린트 로드맵으로 PROJECT_MANIFEST 업데이트
13
+ 7. 스프린트 일관성과 종속성 검증
14
+ 8. 마일스톤 계획 보고
15
15
 
16
16
  ---
17
17
 
18
- ## 1 · Analyze current milestone state
18
+ ## 1 · 현재 마일스톤 상태 분석
19
19
 
20
- **CRITICAL:** You are given additional Arguments: <$ARGUMENTS>
20
+ **치명적:** 추가 인수가 제공됩니다: <$ARGUMENTS>
21
21
 
22
- **USE PARALLEL SUBAGENTS** to do these tasks:
22
+ **병렬 서브에이전트 사용**하여 다음 태스크 수행:
23
23
 
24
- - Parse arguments for milestone ID (defaults to current milestone from PROJECT_MANIFEST)
25
- - Read `.aiwf/00_PROJECT_MANIFEST.md` to understand current progress
26
- - Scan `.aiwf/03_SPRINTS/` to identify existing sprints for the target milestone
27
- - For each existing sprint, read its sprint meta file to determine status from YAML frontmatter
28
- - Analyze the Tasks in Sprints to understand that work that has been done (from Subtasks)
24
+ - 마일스톤 ID에 대한 인수 파싱 (PROJECT_MANIFEST의 현재 마일스톤이 기본값)
25
+ - 현재 진행 상황을 이해하기 위해 `.aiwf/00_PROJECT_MANIFEST.md` 읽기
26
+ - 대상 마일스톤의 기존 스프린트를 식별하기 위해 `.aiwf/03_SPRINTS/` 스캔
27
+ - 각 기존 스프린트에 대해, YAML 프론트매터에서 상태를 확인하기 위해 스프린트 메타 파일 읽기
28
+ - 완료된 작업을 이해하기 위해 스프린트의 태스크를 분석 (서브태스크에서)
29
29
 
30
- ## 2 · Assess completed work vs milestone requirements
30
+ ## 2 · 완료된 작업과 마일스톤 요구사항 평가
31
31
 
32
- - Read milestone meta file from `.aiwf/02_REQUIREMENTS/$MILESTONE_ID/`
33
- - **CRITICAL:** Follow and read ALL linked documents in the milestone meta:
34
- - Product Requirements (PRD.md)
35
- - Database Specifications (SPECS_DB.md)
36
- - API Specifications (SPECS_API.md)
37
- - Tool Specifications (SPECS_TOOLS.md)
38
- - Any other linked specifications
39
- - Study the milestone's Definition of Done (DoD) carefully and **think deeply** about what each DoD criterion actually requires in terms of specific deliverables
40
- - For each existing sprint, analyze what deliverables have been completed by reading sprint meta and task files
41
- - **Think more carefully** about the gap analysis: map each completed deliverable against specific DoD requirements and identify what's genuinely missing vs what might already be covered
42
- - Create clear picture: "What's done vs what's required for milestone completion" with specific justification for each gap identified
32
+ - `.aiwf/02_REQUIREMENTS/$MILESTONE_ID/`에서 마일스톤 메타 파일 읽기
33
+ - **치명적:** 마일스톤 메타에서 연결된 모든 문서를 따라가며 읽기:
34
+ - 제품 요구사항 (PRD.md)
35
+ - 데이터베이스 사양 (SPECS_DB.md)
36
+ - API 사양 (SPECS_API.md)
37
+ - 도구 사양 (SPECS_TOOLS.md)
38
+ - 기타 연결된 사양들
39
+ - 마일스톤의 완료 정의(DoD)를 신중히 학습하고 각 DoD 기준이 실제로 특정 결과물 측면에서 무엇을 요구하는지 **깊이 생각**하기
40
+ - 각 기존 스프린트에 대해, 스프린트 메타와 태스크 파일을 읽어 완료된 결과물 분석
41
+ - 격차 분석에 대해 **더 신중히 생각하기**: 완료된 각 결과물을 특정 DoD 요구사항에 대응시키고 진정으로 누락된 것과 이미 다뤄진 것을 식별
42
+ - 명확한 그림 생성: "완료된 것 vs 마일스톤 완성을 위해 필요한 것"에 대해 식별된 각 격차에 대한 구체적 근거 제시
43
43
 
44
- ## 3 · Identify remaining work and dependencies
44
+ ## 3 · 남은 작업과 종속성 식별
45
45
 
46
- - Based on gap analysis, identify remaining deliverables for milestone completion
47
- - Group related deliverables that have natural dependencies
48
- - **CRITICAL:** Each deliverable group should be:
49
- - **Independently valuable** (shippable increment)
50
- - **Completable in ~1 week** by one person
51
- - **Has clear validation criteria**
52
- - Consider technical dependencies (e.g., auth before UI, LLM integration before tools)
46
+ - 격차 분석을 바탕으로, 마일스톤 완성을 위한 남은 결과물 식별
47
+ - 자연스러운 종속성을 가진 관련 결과물을 그룹화
48
+ - **치명적:** 각 결과물 그룹은 다음과 같아야 함:
49
+ - **독립적으로 가치 있음** (배포 가능한 증분)
50
+ - **한 사람이 ~1주일 내에 완료 가능**
51
+ - **명확한 검증 기준 보유**
52
+ - 기술적 종속성 고려 (예: UI 전에 인증, 도구 전에 LLM 통합)
53
53
 
54
- ## 4 · Design logical sprint boundaries
54
+ ## 4 · 논리적 스프린트 경계 설계
55
55
 
56
- - Design sprint structure to complete the milestone
57
- - Each sprint should have:
58
- - **Clear focus**: One main deliverable theme
59
- - **Natural boundaries**: Minimal dependencies between sprints
60
- - **Incremental value**: Each sprint advances toward milestone DoD
61
- - Sprint naming: `S<nn>_$milestone_id_$focus_slug`
62
- - **IMPORTANT:** Don't create sprints for work that's already completed
56
+ - 마일스톤을 완성하기 위한 스프린트 구조 설계
57
+ - 각 스프린트는 다음을 보유해야 함:
58
+ - **명확한 집중점**: 하나의 주요 결과물 테마
59
+ - **자연스러운 경계**: 스프린트 간 최소한의 종속성
60
+ - **점진적 가치**: 각 스프린트가 마일스톤 DoD를 향해 전진
61
+ - 스프린트 명명: `S<nn>_$milestone_id_$focus_slug`
62
+ - **중요:** 이미 완료된 작업에 대한 스프린트를 생성하지 마세요
63
63
 
64
- ## 5 · Create sprint directories and meta files
64
+ ## 5 · 스프린트 디렉토리와 메타 파일 생성
65
65
 
66
- - For each planned sprint that doesn't exist:
67
- - Create directory `.aiwf/03_SPRINTS/$FULL_SPRINT_NAME/` (using complete sprint name like "S02_M01_LLM_Integration")
68
- - Use template from `.aiwf/99_TEMPLATES/sprint_meta_template.md`
69
- - Fill in sprint meta with:
70
- - High-level goal and scope
71
- - Key deliverables (bullet points, not detailed tasks)
72
- - Clear Definition of Done for the sprint
73
- - Status: "planned"
66
+ - 존재하지 않는 각 계획된 스프린트에 대해:
67
+ - 디렉토리 생성 `.aiwf/03_SPRINTS/$FULL_SPRINT_NAME/` ("S02_M01_LLM_Integration"과 같은 완전한 스프린트 이름 사용)
68
+ - `.aiwf/99_TEMPLATES/sprint_meta_template.md`에서 템플릿 사용
69
+ - 스프린트 메타를 다음으로 채우기:
70
+ - 고수준 목표와 범위
71
+ - 주요 결과물 (자세한 태스크가 아닌 불릿 포인트)
72
+ - 스프린트에 대한 명확한 완료 정의
73
+ - 상태: "planned"
74
74
 
75
- ## 6 · Update PROJECT_MANIFEST with sprint roadmap
75
+ ## 6 · 스프린트 로드맵으로 PROJECT_MANIFEST 업데이트
76
76
 
77
- - Update `.aiwf/00_PROJECT_MANIFEST.md`:
78
- - Set `highest_sprint_in_milestone` to the highest planned sprint
79
- - Update sprint summary section with overview of remaining sprints
80
- - Mark completed sprints as ✅ COMPLETED
81
- - Show planned sprints with their focus areas
82
- - Update `last_updated` timestamp
77
+ - `.aiwf/00_PROJECT_MANIFEST.md` 업데이트:
78
+ - `highest_sprint_in_milestone`을 계획된 가장 높은 스프린트로 설정
79
+ - 남은 스프린트의 개요로 스프린트 요약 섹션 업데이트
80
+ - 완료된 스프린트를 ✅ COMPLETED로 표시
81
+ - 계획된 스프린트를 그들의 집중 영역과 함께 표시
82
+ - `last_updated` 타임스탬프 업데이트
83
83
 
84
- ## 7 · Validate sprint coherence and dependencies
84
+ ## 7 · 스프린트 일관성과 종속성 검증
85
85
 
86
- - Review the planned sprint sequence for logical flow
87
- - Ensure each sprint builds naturally on previous work
88
- - Verify no sprint has impossible dependencies
89
- - Check that sprint sequence leads to milestone DoD completion
90
- - **Think about** whether each sprint is independently testable and valuable
86
+ - 논리적 흐름을 위해 계획된 스프린트 순서 검토
87
+ - 각 스프린트가 이전 작업을 자연스럽게 구축하는지 확인
88
+ - 불가능한 종속성을 가진 스프린트가 없는지 확인
89
+ - 스프린트 순서가 마일스톤 DoD 완성으로 이어지는지 확인
90
+ - 각 스프린트가 독립적으로 테스트 가능하고 가치 있는지 **생각하기**
91
91
 
92
- ## 8 · Report milestone plan
92
+ ## 8 · 마일스톤 계획 보고
93
93
 
94
- Provide comprehensive summary:
94
+ 포괄적인 요약 제공:
95
95
 
96
- **Milestone Status:**
96
+ **마일스톤 상태:**
97
97
 
98
- - Target milestone: $milestone_id
99
- - Sprints completed: $count
100
- - Sprints planned: $count
101
- - Estimated completion: $sprint_sequence
98
+ - 대상 마일스톤: $milestone_id
99
+ - 완료된 스프린트: $count
100
+ - 계획된 스프린트: $count
101
+ - 예상 완료: $sprint_sequence
102
102
 
103
- **Sprint Roadmap:**
103
+ **스프린트 로드맵:**
104
104
 
105
- For each sprint (existing and planned):
105
+ 각 스프린트에 대해 (기존 및 계획된):
106
106
 
107
107
  - **$Sprint_ID**: $status - $focus_description
108
- - Key deliverables: $bullet_list
109
- - Dependencies: $if_any
108
+ - 주요 결과물: $bullet_list
109
+ - 종속성: $if_any
110
110
 
111
- **Next Steps:**
111
+ **다음 단계:**
112
112
 
113
- - Immediate next sprint to detail: $sprint_id
113
+ - 상세화할 즉시 다음 스프린트: $sprint_id
114
114
 
115
- **Validation:**
115
+ **검증:**
116
116
 
117
- Summarize your validation analysis covering:
117
+ 다음을 포함한 검증 분석 요약:
118
118
 
119
- - All milestone DoD items are covered by sprint plan
120
- - Sprint dependencies are logical and minimal
121
- - Each sprint delivers independent value
119
+ - 모든 마일스톤 DoD 항목이 스프린트 계획에 포함됨
120
+ - 스프린트 종속성이 논리적이고 최소한임
121
+ - 각 스프린트가 독립적인 가치를 제공함