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,147 +1,147 @@
1
- # 일반 Task 생성 - 탑 다운 실행
1
+ # 일반 태스크 생성
2
2
 
3
- Creates a new general task in `.aiwf/04_GENERAL_TASKS/` following project documentation standards.
3
+ 프로젝트 문서화 표준을 따라 `.aiwf/04_GENERAL_TASKS/`에 새로운 일반 태스크를 생성합니다.
4
4
 
5
- ## Create a TODO with EXACTLY these 10 Items
5
+ ## 정확히 다음 10개 항목으로 할 일 목록을 생성하세요
6
6
 
7
- 1. Parse task arguments and determine task ID
8
- 2. Load project context and documentation requirements
9
- 3. Verify task doesn't duplicate existing work
10
- 4. Research codebase for implementation context
11
- 5. Create task file using standard template
12
- 6. Fill in task details with proper context
13
- 7. Add technical guidance and codebase references
14
- 8. Update project manifest with new task
15
- 9. Validate task alignment with architecture
16
- 10. Perform final quality check and report
7
+ 1. 태스크 인수 분석 및 태스크 ID 결정
8
+ 2. 프로젝트 컨텍스트 및 문서화 요구사항 로드
9
+ 3. 중복 작업이 없는지 확인
10
+ 4. 구현 컨텍스트를 위한 코드베이스 연구
11
+ 5. 표준 템플릿을 사용하여 태스크 파일 생성
12
+ 6. 적절한 컨텍스트로 태스크 세부사항 작성
13
+ 7. 기술 가이드라인 및 코드베이스 참조 추가
14
+ 8. 새 태스크로 프로젝트 매니페스트 업데이트
15
+ 9. 아키텍처와의 태스크 정렬 검증
16
+ 10. 최종 품질 검사 및 보고 수행
17
17
 
18
- ## DETAILS on every TODO item
18
+ ## 모든 할 일 항목에 대한 세부사항
19
19
 
20
- ### 1. Parse task arguments and determine task ID
20
+ ### 1. 태스크 인수 분석 및 태스크 ID 결정
21
21
 
22
- The argument format is: `<Task Title or Description>`
22
+ 인수 형식: `<태스크 제목 또는 설명>`
23
23
 
24
- - If arguments are empty, prompt user for task details
25
- - Generate sequential task ID by examining existing tasks in `.aiwf/04_GENERAL_TASKS/`
26
- - Find highest task number (T###) and increment by 1
27
- - Format: `T###_<Task_Title_Snake_Case>.md`
28
- - **IMPORTANT:** Task IDs must be sequential with no gaps
24
+ - 인수가 비어있는 경우, 사용자에게 태스크 세부사항을 요청합니다
25
+ - `.aiwf/04_GENERAL_TASKS/`의 기존 태스크를 확인하여 순차적 태스크 ID를 생성합니다
26
+ - 가장 높은 태스크 번호(T###)를 찾아 1을 증가시킵니다
27
+ - 형식: `T###_<태스크_제목_스네이크_케이스>.md`
28
+ - **중요**: 태스크 ID는 빈 공간 없이 순차적이어야 합니다
29
29
 
30
- ### 2. Load project context and documentation requirements
30
+ ### 2. 프로젝트 컨텍스트 및 문서화 요구사항 로드
31
31
 
32
- Use PARALLEL SUBAGENTS to READ and UNDERSTAND the project's context:
32
+ **병렬 서브에이전트**를 사용하여 프로젝트 컨텍스트를 읽고 이해하세요:
33
33
 
34
- - READ `.aiwf/00_PROJECT_MANIFEST.md` - Get current project state
35
- - READ `.aiwf/01_PROJECT_DOCS/ARCHITECTURE.md` - Understand system constraints
36
- - READ `.aiwf/01_PROJECT_DOCS/LONG_TERM_VISION.md` - Understand future direction
37
- - READ latest files in `.aiwf/10_STATE_OF_PROJECT/` - Review current state
38
- - SCAN `.aiwf/05_ARCHITECTURE_DECISIONS/` for relevant ADRs
39
- - **IMPORTANT:** General tasks must align with documented architecture
34
+ - `.aiwf/00_PROJECT_MANIFEST.md` 읽기 - 현재 프로젝트 상태 파악
35
+ - `.aiwf/01_PROJECT_DOCS/ARCHITECTURE.md` 읽기 - 시스템 제약사항 이해
36
+ - `.aiwf/01_PROJECT_DOCS/LONG_TERM_VISION.md` 읽기 - 미래 방향성 이해
37
+ - `.aiwf/10_STATE_OF_PROJECT/`의 최신 파일들 읽기 - 현재 상태 검토
38
+ - `.aiwf/05_ARCHITECTURE_DECISIONS/`에서 관련 ADR 스캔
39
+ - **중요**: 일반 태스크는 문서화된 아키텍처와 일치해야 합니다
40
40
 
41
- ### 3. Verify task doesn't duplicate existing work
41
+ ### 3. 중복 작업이 없는지 확인
42
42
 
43
- **SEARCH** comprehensively for potential duplicates:
43
+ **포괄적으로 검색**하여 중복 가능성을 찾으세요:
44
44
 
45
- - Check all files in `.aiwf/04_GENERAL_TASKS/`
46
- - Search sprint tasks in `.aiwf/03_SPRINTS/*/T*.md`
47
- - Look for similar functionality in completed milestones
48
- - **CRITICAL:** If duplicate found, stop and report to user with file reference
45
+ - `.aiwf/04_GENERAL_TASKS/`의 모든 파일 확인
46
+ - `.aiwf/03_SPRINTS/*/T*.md`의 스프린트 태스크 검색
47
+ - 완료된 마일스톤에서 유사한 기능 찾기
48
+ - **중요**: 중복이 발견되면 중단하고 파일 참조와 함께 사용자에게 보고
49
49
 
50
- ### 4. Research codebase for implementation context
50
+ ### 4. 구현 컨텍스트를 위한 코드베이스 연구
51
51
 
52
- Based on the task description, use PARALLEL SUBAGENTS to:
52
+ 태스크 설명을 바탕으로 **병렬 서브에이전트**를 사용하여:
53
53
 
54
- - SEARCH for existing patterns similar to what the task requires
55
- - IDENTIFY key interfaces, classes, or modules that will be affected
56
- - FIND examples of similar implementations in the codebase
57
- - LOCATE relevant test patterns and existing test files
58
- - DISCOVER error handling and logging patterns used
59
- - MAP OUT integration points with existing code
60
- - **DOCUMENT** all findings for inclusion in task
54
+ - 태스크가 요구하는 것과 유사한 기존 패턴 검색
55
+ - 영향을 받을 주요 인터페이스, 클래스 또는 모듈 식별
56
+ - 코드베이스에서 유사한 구현 예제 찾기
57
+ - 관련 테스트 패턴 및 기존 테스트 파일 위치 파악
58
+ - 사용되는 오류 처리 및 로깅 패턴 발견
59
+ - 기존 코드와의 통합 지점 매핑
60
+ - **문서화**: 태스크에 포함할 모든 발견사항 기록
61
61
 
62
- ### 5. Create task file using standard template
62
+ ### 5. 표준 템플릿을 사용하여 태스크 파일 생성
63
63
 
64
- **USE** the task template in `.aiwf/99_TEMPLATES/task_template.md` as base structure:
64
+ `.aiwf/99_TEMPLATES/task_template.md`의 태스크 템플릿을 기본 구조로 **사용**하세요:
65
65
 
66
- - Copy template structure exactly
67
- - Place file in `.aiwf/04_GENERAL_TASKS/T###_<Title>.md`
68
- - Include timestamp: Execute `date '+%Y-%m-%d %H:%M:%S'` for creation time
69
- - **IMPORTANT:** Follow template structure precisely - no deviations
66
+ - 템플릿 구조를 정확히 복사
67
+ - 파일을 `.aiwf/04_GENERAL_TASKS/T###_<제목>.md`에 배치
68
+ - 타임스탬프 포함: 생성 시간을 위해 `date '+%Y-%m-%d %H:%M:%S'` 실행
69
+ - **중요**: 템플릿 구조를 정확히 따르세요 - 변경 없음
70
70
 
71
- ### 6. Fill in task details with proper context
71
+ ### 6. 적절한 컨텍스트로 태스크 세부사항 작성
72
72
 
73
- Populate the task file with:
73
+ 태스크 파일을 다음 내용으로 채우세요:
74
74
 
75
- - **Title**: Clear, actionable task name
76
- - **Context**: Link to architecture docs and project state
77
- - **Requirements**: Specific, measurable outcomes
78
- - **Acceptance Criteria**: Clear definition of done
79
- - **Dependencies**: Reference relevant sprints/milestones
80
- - **Implementation Notes**: Technical approach aligned with architecture
81
- - **CRITICAL:** All content must reference existing documentation
75
+ - **제목**: 명확하고 실행 가능한 태스크 이름
76
+ - **컨텍스트**: 아키텍처 문서 및 프로젝트 상태에 연결
77
+ - **요구사항**: 구체적이고 측정 가능한 결과
78
+ - **승인 기준**: 완료에 대한 명확한 정의
79
+ - **종속성**: 관련 스프린트/마일스톤 참조
80
+ - **구현 노트**: 아키텍처와 일치하는 기술적 접근법
81
+ - **중요**: 모든 내용은 기존 문서를 참조해야 합니다
82
82
 
83
- ### 7. Add technical guidance and codebase references
83
+ ### 7. 기술 가이드라인 및 코드베이스 참조 추가
84
84
 
85
- **Technical Guidance section:**
85
+ **기술 가이드라인 섹션:**
86
86
 
87
- - Key interfaces and integration points discovered in step 4
88
- - Specific imports and module references from codebase
89
- - Existing patterns to follow (with file references)
90
- - Database models or API contracts to work with
91
- - Error handling approach used in similar code
92
- - Testing patterns found in the codebase
87
+ - 4단계에서 발견한 주요 인터페이스 및 통합 지점
88
+ - 코드베이스의 구체적인 import 및 모듈 참조
89
+ - 따라야 할 기존 패턴 (파일 참조 포함)
90
+ - 작업할 데이터베이스 모델 또는 API 계약
91
+ - 유사한 코드에서 사용되는 오류 처리 접근법
92
+ - 코드베이스에서 발견된 테스트 패턴
93
93
 
94
- **Implementation Notes section:**
94
+ **구현 노트 섹션:**
95
95
 
96
- - Step-by-step implementation approach based on research
97
- - Key architectural decisions to respect (reference ADRs)
98
- - Specific files and functions to modify or extend
99
- - Testing approach based on existing test patterns
100
- - Performance considerations if relevant
96
+ - 연구를 바탕으로 한 단계별 구현 접근법
97
+ - 존중해야 할 주요 아키텍처 결정사항 (ADR 참조)
98
+ - 수정하거나 확장할 구체적인 파일 및 함수
99
+ - 기존 테스트 패턴을 바탕으로 한 테스트 접근법
100
+ - 관련성이 있는 경우 성능 고려사항
101
101
 
102
- **IMPORTANT:** Do NOT include code examples. Provide structural guidance and file references only.
102
+ **중요**: 코드 예제를 포함하지 마세요. 구조적 가이드라인과 파일 참조만 제공하세요.
103
103
 
104
- ### 8. Update project manifest with new task
104
+ ### 8. 새 태스크로 프로젝트 매니페스트 업데이트
105
105
 
106
- **UPDATE** `.aiwf/00_PROJECT_MANIFEST.md`:
106
+ `.aiwf/00_PROJECT_MANIFEST.md` **업데이트**:
107
107
 
108
- - Add task to "## General Tasks" section
109
- - Format: `- [ ] T###: [Task Title] - Status: Not Started`
110
- - Maintain alphabetical/numerical ordering
111
- - Link to task file: `[T###](04_GENERAL_TASKS/T###_Title.md)`
112
- - **IMPORTANT:** Preserve all existing content
108
+ - "## 일반 태스크" 섹션에 태스크 추가
109
+ - 형식: `- [ ] T###: [태스크 제목] - 상태: 시작되지 않음`
110
+ - 알파벳/숫자 순서 유지
111
+ - 태스크 파일에 링크: `[T###](04_GENERAL_TASKS/T###_제목.md)`
112
+ - **중요**: 기존 내용을 모두 보존하세요
113
113
 
114
- ### 9. Validate task alignment with architecture
114
+ ### 9. 아키텍처와의 태스크 정렬 검증
115
115
 
116
- **VERIFY** task compliance:
116
+ 태스크 준수사항 **확인**:
117
117
 
118
- - Check task doesn't contradict architecture principles
119
- - Ensure implementation approach uses established patterns
120
- - Validate dependencies exist and are correct
121
- - Confirm task scope is appropriate (not too broad/narrow)
122
- - Technical guidance aligns with existing codebase patterns
123
- - **CRITICAL:** Documentation is source of truth - any deviation needs justification
118
+ - 태스크가 아키텍처 원칙과 모순되지 않는지 확인
119
+ - 구현 접근법이 확립된 패턴을 사용하는지 보장
120
+ - 종속성이 존재하고 올바른지 검증
121
+ - 태스크 범위가 적절한지 확인 (너무 광범위하거나 좁지 않게)
122
+ - 기술 가이드라인이 기존 코드베이스 패턴과 일치하는지 확인
123
+ - **중요**: 문서가 진실의 원천입니다 - 어떤 편차든 정당화가 필요합니다
124
124
 
125
- ### 10. Perform final quality check and report
125
+ ### 10. 최종 품질 검사 및 보고 수행
126
126
 
127
- **QUALITY CHECK**:
127
+ **품질 검사**:
128
128
 
129
- - Task file follows template completely
130
- - All sections properly filled including new technical guidance
131
- - References to documentation and codebase are valid
132
- - Task ID is sequential and unique
133
- - Manifest updated correctly
134
- - Technical guidance references actual files and patterns
135
- - No scope creep or architecture violations
129
+ - 태스크 파일이 템플릿을 완전히 따르는지 확인
130
+ - 새로운 기술 가이드라인을 포함한 모든 섹션이 적절히 작성되었는지 확인
131
+ - 문서 및 코드베이스에 대한 참조가 유효한지 확인
132
+ - 태스크 ID가 순차적이고 고유한지 확인
133
+ - 매니페스트가 올바르게 업데이트되었는지 확인
134
+ - 기술 가이드라인이 실제 파일과 패턴을 참조하는지 확인
135
+ - 범위 확장이나 아키텍처 위반이 없는지 확인
136
136
 
137
- **OUTPUT FORMAT**:
137
+ **출력 형식**:
138
138
 
139
139
  ```markdown
140
- ✅ **Created**: T###\_<Title>.md
141
- 📋 **Type**: General Task
142
- 🎯 **Purpose**: [One-line summary]
143
- 📚 **References**: [Key documentation links]
144
- 🔧 **Key Integration Points**: [Main files/modules to modify]
145
- 🧪 **Test Approach**: [Testing pattern to follow]
146
- ⏭️ **Next Step**: Review task details and run `/do_task T###` to begin
140
+ ✅ **생성**: T###\_<제목>.md
141
+ 📋 **유형**: 일반 태스크
142
+ 🎯 **목적**: [한 줄 요약]
143
+ 📚 **참조**: [주요 문서 링크]
144
+ 🔧 **주요 통합 지점**: [수정할 주요 파일/모듈]
145
+ 🧪 **테스트 접근법**: [따를 테스트 패턴]
146
+ ⏭️ **다음 단계**: 태스크 세부사항을 검토하고 `/do_task T###`를 실행하여 시작하세요
147
147
  ```
@@ -1,194 +1,194 @@
1
- # 신규 마일스톤 계획 및 생성 - (탑 다운 실행)
1
+ # 신규 마일스톤 계획 및 생성
2
2
 
3
- Creates a new milestone with proper structure, documentation, and project integration through an interactive, adaptive process.
3
+ 상호작용적이고 적응적인 프로세스를 통해 적절한 구조, 문서화, 프로젝트 통합을 갖춘 새로운 마일스톤을 생성합니다.
4
4
 
5
- ## Create a TODO with EXACTLY these 8 items
5
+ ## 정확히 다음 8개 항목으로 할 일 목록을 생성하세요
6
6
 
7
- 1. Parse arguments and analyze project context
8
- 2. Interactive milestone scoping and definition
9
- 3. Determine milestone structure and naming
10
- 4. Create milestone directory and meta file
11
- 5. Guide supporting documentation creation
12
- 6. Update project manifest with milestone
13
- 7. Validate milestone coherence and alignment
14
- 8. Report milestone creation and next steps
7
+ 1. 인수 분석 및 프로젝트 컨텍스트 파악
8
+ 2. 상호작용적 마일스톤 범위 및 정의
9
+ 3. 마일스톤 구조 및 명명 결정
10
+ 4. 마일스톤 디렉토리 및 메타 파일 생성
11
+ 5. 지원 문서 생성 가이드
12
+ 6. 마일스톤으로 프로젝트 매니페스트 업데이트
13
+ 7. 마일스톤 일관성 및 정렬 검증
14
+ 8. 마일스톤 생성 및 다음 단계 보고
15
15
 
16
16
  ---
17
17
 
18
- ## 1 · Parse arguments and analyze project context
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 suggested milestone name/focus (defaults to interactive creation)
25
- - Read `.aiwf/00_PROJECT_MANIFEST.md` to understand current project state
26
- - Scan `.aiwf/02_REQUIREMENTS/` to identify existing milestones and numbering
27
- - Read `.aiwf/01_PROJECT_DOCS/ARCHITECTURE.md` to understand project scope
28
- - Check latest project review in `.aiwf/10_STATE_OF_PROJECT/` for current status
29
- - **IMPORTANT:** Understand project phase and what logical next milestone should be
24
+ - 제안된 마일스톤 이름/초점에 대한 인수 분석 (기본값은 대화형 생성)
25
+ - `.aiwf/00_PROJECT_MANIFEST.md`를 읽어 현재 프로젝트 상태 파악
26
+ - `.aiwf/02_REQUIREMENTS/`를 스캔하여 기존 마일스톤과 번호 체계 식별
27
+ - `.aiwf/01_PROJECT_DOCS/ARCHITECTURE.md`를 읽어 프로젝트 범위 이해
28
+ - `.aiwf/10_STATE_OF_PROJECT/`의 최신 프로젝트 리뷰를 확인하여 현재 상태 파악
29
+ - **중요**: 프로젝트 단계를 이해하고 논리적으로 다음에 와야 할 마일스톤 파악
30
30
 
31
- ## 2 · Interactive milestone scoping and definition
31
+ ## 2. 상호작용적 마일스톤 범위 및 정의
32
32
 
33
- **Conversational milestone definition:**
33
+ **대화형 마일스톤 정의:**
34
34
 
35
- If arguments provided:
35
+ 인수가 제공된 경우:
36
36
 
37
- - "I see you want to create a milestone for: [arguments]"
38
- - "Let me understand the scope better..."
37
+ - "다음을 위한 마일스톤을 생성하고자 하시는군요: [인수]"
38
+ - "범위를 더 잘 이해해보겠습니다..."
39
39
 
40
- If no arguments:
40
+ 인수가 없는 경우:
41
41
 
42
- - "Let's define your next milestone based on the current project state"
43
- - "I see you're currently on [current milestone] - what should we focus on next?"
42
+ - "현재 프로젝트 상태를 바탕으로 다음 마일스톤을 정의해보겠습니다"
43
+ - "현재 [현재 마일스톤]에 있는 것으로 보입니다 - 다음에는 무엇에 집중해야 할까요?"
44
44
 
45
- **Interactive questions (adapt based on context):**
45
+ **상호작용 질문 (컨텍스트에 따라 조정):**
46
46
 
47
- - "What's the main goal of this milestone?"
48
- - "What key deliverables should be completed?"
49
- - "Are there any specific technical challenges or requirements?"
50
- - "How does this milestone advance the project toward its long-term vision?"
51
- - "What would 'done' look like for this milestone?"
47
+ - "이 마일스톤의 주요 목표는 무엇인가요?"
48
+ - "완료되어야 할 핵심 결과물은 무엇인가요?"
49
+ - "특정한 기술적 도전이나 요구사항이 있나요?"
50
+ - "이 마일스톤이 프로젝트를 장기 비전으로 어떻게 발전시킬까요?"
51
+ - "이 마일스톤의 '완료'는 어떤 모습일까요?"
52
52
 
53
- **Keep conversational and adaptive** - don't interrogate, just gather what's needed
53
+ **대화형이고 적응적으로 유지** - 심문하지 말고 필요한 것만 수집하세요
54
54
 
55
- ## 3 · Determine milestone structure and naming
55
+ ## 3. 마일스톤 구조 및 명명 결정
56
56
 
57
- **Generate milestone details:**
57
+ **마일스톤 세부사항 생성:**
58
58
 
59
- - Determine next milestone number (M##) by scanning existing milestones
60
- - Create descriptive milestone name from user input
61
- - Format: `M##_Milestone_Name_Snake_Case`
62
- - **CRITICAL:** Ensure no duplicate milestone numbers
63
- - Validate naming follows AIWF conventions (underscores, no spaces)
59
+ - 기존 마일스톤을 스캔하여 다음 마일스톤 번호 (M##) 결정
60
+ - 사용자 입력에서 설명적 마일스톤 이름 생성
61
+ - 형식: `M##_마일스톤_이름_스네이크_케이스`
62
+ - **중요**: 중복된 마일스톤 번호가 없도록 보장
63
+ - AIWF 규칙을 따르는 명명 검증 (밑줄, 공백 없음)
64
64
 
65
- **Confirm with user:**
65
+ **사용자와 확인:**
66
66
 
67
- - "I'll create milestone: M##\_[Name] - does this sound right?"
68
- - Allow user to adjust name or numbering if needed
67
+ - "마일스톤을 생성하겠습니다: M##\_[이름] - 괜찮으신가요?"
68
+ - 필요시 사용자가 이름이나 번호를 조정할 수 있도록 허용
69
69
 
70
- ## 4 · Create milestone directory and meta file
70
+ ## 4. 마일스톤 디렉토리 및 메타 파일 생성
71
71
 
72
- **Create milestone structure:**
72
+ **마일스톤 구조 생성:**
73
73
 
74
- - Create directory: `.aiwf/02_REQUIREMENTS/M##_Milestone_Name/`
75
- - Copy template from `.aiwf/99_TEMPLATES/milestone_meta_template.md`
76
- - Create milestone meta file: `M##_milestone_meta.md`
74
+ - 디렉토리 생성: `.aiwf/02_REQUIREMENTS/M##_마일스톤_이름/`
75
+ - `.aiwf/99_TEMPLATES/milestone_meta_template.md`에서 템플릿 복사
76
+ - 마일스톤 메타 파일 생성: `M##_milestone_meta.md`
77
77
 
78
- **Populate milestone meta file:**
78
+ **마일스톤 메타 파일 채우기:**
79
79
 
80
- - Fill in YAML frontmatter:
80
+ - YAML 프론트매터 작성:
81
81
  - `milestone_id: M##`
82
- - `title: [Milestone Name]`
82
+ - `title: [마일스톤 이름]`
83
83
  - `status: pending`
84
- - `last_updated: [current timestamp YYYY-MM-DD HH:MM]`
85
- - Convert user input into structured sections:
86
- - **Goals**: Clear objectives from user discussion
87
- - **Key Documents**: Placeholder for PRD and SPECS files
88
- - **Definition of Done**: Specific, measurable criteria from user input
89
- - **Notes/Context**: Additional context from user discussion
84
+ - `last_updated: [현재 타임스탬프 YYYY-MM-DD HH:MM]`
85
+ - 사용자 입력을 구조화된 섹션으로 변환:
86
+ - **목표**: 사용자 논의에서 명확한 목적
87
+ - **핵심 문서**: PRD 및 SPECS 파일 플레이스홀더
88
+ - **완료 정의**: 사용자 입력에서 구체적이고 측정 가능한 기준
89
+ - **노트/컨텍스트**: 사용자 논의에서 추가 컨텍스트
90
90
 
91
- ## 5 · Guide supporting documentation creation
91
+ ## 5. 지원 문서 생성 가이드
92
92
 
93
- **Interactive document planning:**
93
+ **상호작용적 문서 계획:**
94
94
 
95
- Based on milestone scope, suggest needed documents:
95
+ 마일스톤 범위를 기반으로 필요한 문서 제안:
96
96
 
97
- - "For this milestone, you'll likely need:"
98
- - "□ PRD\_[Milestone_Name].md - Product requirements"
99
- - "□ SPECS\_[Technical_Area].md - Technical specifications"
100
- - "□ Any domain-specific documentation"
97
+ - "이 마일스톤에는 다음이 필요할 것 같습니다:"
98
+ - "□ PRD\_[마일스톤_이름].md - 제품 요구사항"
99
+ - "□ SPECS\_[기술_영역].md - 기술 사양"
100
+ - "□ 도메인별 문서"
101
101
 
102
- **Ask user:**
102
+ **사용자에게 문의:**
103
103
 
104
- - "Would you like me to create starter templates for these documents now?"
105
- - "Or would you prefer to create them manually as needed?"
104
+ - "지금 이 문서들의 시작 템플릿을 만들어드릴까요?"
105
+ - "아니면 필요에 따라 수동으로 만드시겠어요?"
106
106
 
107
- **If user wants templates created:**
107
+ **사용자가 템플릿 생성을 원하는 경우:**
108
108
 
109
- - Create basic PRD template with milestone-specific sections
110
- - Create SPECS template if technical milestone
111
- - Include proper cross-references between documents
112
- - **IMPORTANT:** Don't over-engineer - create useful starting points
109
+ - 마일스톤별 섹션이 포함된 기본 PRD 템플릿 생성
110
+ - 기술 마일스톤인 경우 SPECS 템플릿 생성
111
+ - 문서 간 적절한 상호참조 포함
112
+ - **중요**: 과도하게 엔지니어링하지 말고 유용한 시작점 생성
113
113
 
114
- **If user prefers manual:**
114
+ **사용자가 수동을 선호하는 경우:**
115
115
 
116
- - Note in milestone meta what documents are expected
117
- - Provide guidance on when/how to create them
116
+ - 마일스톤 메타에 예상되는 문서 기록
117
+ - 언제/어떻게 생성할지에 대한 가이드 제공
118
118
 
119
- ## 6 · Update project manifest with milestone
119
+ ## 6. 마일스톤으로 프로젝트 매니페스트 업데이트
120
120
 
121
- **UPDATE** `.aiwf/00_PROJECT_MANIFEST.md`:
121
+ `.aiwf/00_PROJECT_MANIFEST.md` **업데이트**:
122
122
 
123
- - Add milestone to milestones section:
124
- - Format: `- [ ] M##: [Milestone Name] - Status: Planning`
125
- - Link: `[M##](02_REQUIREMENTS/M##_Milestone_Name/M##_milestone_meta.md)`
126
- - Update project metadata:
127
- - Set `current_milestone` if this is the active milestone
128
- - Update `highest_milestone` number
129
- - Update `last_updated` timestamp
130
- - **IMPORTANT:** Preserve all existing content and formatting
123
+ - 마일스톤 섹션에 마일스톤 추가:
124
+ - 형식: `- [ ] M##: [마일스톤 이름] - 상태: 계획 중`
125
+ - 링크: `[M##](02_REQUIREMENTS/M##_마일스톤_이름/M##_milestone_meta.md)`
126
+ - 프로젝트 메타데이터 업데이트:
127
+ - 활성 마일스톤인 경우 `current_milestone` 설정
128
+ - `highest_milestone` 번호 업데이트
129
+ - `last_updated` 타임스탬프 업데이트
130
+ - **중요**: 모든 기존 내용과 형식 보존
131
131
 
132
- ## 7 · Validate milestone coherence and alignment
132
+ ## 7. 마일스톤 일관성 및 정렬 검증
133
133
 
134
- **VERIFY** milestone quality:
134
+ 마일스톤 품질 **확인**:
135
135
 
136
- - Check milestone aligns with project architecture and vision
137
- - Ensure Definition of Done is specific and measurable
138
- - Validate milestone scope is appropriate (not too broad/narrow)
139
- - Confirm milestone advances project toward stated goals
140
- - Check milestone numbering and naming follows conventions
141
- - Verify all created files follow template structure
142
- - **CRITICAL:** Milestone should be independently valuable and achievable
136
+ - 마일스톤이 프로젝트 아키텍처 및 비전과 일치하는지 확인
137
+ - 완료 정의가 구체적이고 측정 가능한지 보장
138
+ - 마일스톤 범위가 적절한지 검증 (너무 광범위하거나 좁지 않게)
139
+ - 마일스톤이 명시된 목표를 향해 프로젝트를 발전시키는지 확인
140
+ - 마일스톤 번호 및 명명이 규칙을 따르는지 확인
141
+ - 생성된 모든 파일이 템플릿 구조를 따르는지 검증
142
+ - **중요**: 마일스톤은 독립적으로 가치 있고 달성 가능해야 함
143
143
 
144
- **THINK ABOUT**:
144
+ **고려사항**:
145
145
 
146
- - Does this milestone make sense given the current project state?
147
- - Are the goals realistic and well-scoped?
148
- - Is the Definition of Done clear enough to know when it's complete?
149
- - Does this milestone set up future milestones logically?
146
+ - 현재 프로젝트 상태를 고려할 때 이 마일스톤이 의미가 있는가?
147
+ - 목표가 현실적이고 잘 범위가 정해져 있는가?
148
+ - 완료 정의가 언제 완료되었는지 알 수 있을 만큼 명확한가?
149
+ - 이 마일스톤이 향후 마일스톤을 논리적으로 설정하는가?
150
150
 
151
- ## 8 · Report milestone creation and next steps
151
+ ## 8. 마일스톤 생성 및 다음 단계 보고
152
152
 
153
- **OUTPUT FORMAT**:
153
+ **출력 형식**:
154
154
 
155
155
  ```markdown
156
- ✅ **Milestone Created**: M##\_[Milestone_Name]
156
+ ✅ **마일스톤 생성됨**: M##\_[마일스톤_이름]
157
157
 
158
- 📋 **Milestone Details**:
158
+ 📋 **마일스톤 세부사항**:
159
159
 
160
160
  - ID: M##
161
- - Title: [Milestone Name]
162
- - Status: Planning
163
- - Focus: [One-line summary of main goal]
161
+ - 제목: [마일스톤 이름]
162
+ - 상태: 계획 중
163
+ - 초점: [주요 목표의 한 줄 요약]
164
164
 
165
- 📚 **Created Documents**:
165
+ 📚 **생성된 문서**:
166
166
 
167
- - Milestone meta: `02_REQUIREMENTS/M##_[Name]/M##_milestone_meta.md`
168
- - [Any additional documents created]
167
+ - 마일스톤 메타: `02_REQUIREMENTS/M##_[이름]/M##_milestone_meta.md`
168
+ - [생성된 추가 문서들]
169
169
 
170
- 🎯 **Definition of Done**:
170
+ 🎯 **완료 정의**:
171
171
 
172
- - [Key DoD criteria from milestone]
172
+ - [마일스톤의 핵심 DoD 기준]
173
173
 
174
- 📈 **Project Impact**:
174
+ 📈 **프로젝트 영향**:
175
175
 
176
- - Updates project from M[previous] to M##
177
- - Advances toward: [project vision alignment]
176
+ - 프로젝트를 M[이전]에서 M##로 업데이트
177
+ - 다음을 향한 발전: [프로젝트 비전 정렬]
178
178
 
179
- ⏭️ **Recommended Next Steps**:
179
+ ⏭️ **권장 다음 단계**:
180
180
 
181
- - Review milestone details: `02_REQUIREMENTS/M##_[Name]/M##_milestone_meta.md`
182
- - Create supporting documentation as planned
183
- - Break down into sprints: `/project:aiwf:create_sprints_from_milestone M##`
184
- - Update with specific requirements as they become clear
181
+ - 마일스톤 세부사항 검토: `02_REQUIREMENTS/M##_[이름]/M##_milestone_meta.md`
182
+ - 계획된 대로 지원 문서 생성
183
+ - 스프린트로 분해: `/project:aiwf:create_sprints_from_milestone M##`
184
+ - 명확해지는 대로 구체적인 요구사항으로 업데이트
185
185
 
186
- 🎯 **Ready for Development**: Use `/project:aiwf:create_sprints_from_milestone M##` when ready to start implementation planning
186
+ 🎯 **개발 준비**: 구현 계획을 시작할 준비가 되면 `/project:aiwf:create_sprints_from_milestone M##` 사용
187
187
  ```
188
188
 
189
- **IMPORTANT NOTES**:
189
+ **중요 참고사항**:
190
190
 
191
- - Keep milestone scope focused and achievable
192
- - Definition of Done should be measurable
193
- - Supporting documents can be created as needed
194
- - Milestone planning is iterative - refine as you learn more
191
+ - 마일스톤 범위는 집중되고 달성 가능하게 유지
192
+ - 완료 정의는 측정 가능해야 함
193
+ - 지원 문서는 필요에 따라 생성 가능
194
+ - 마일스톤 계획은 반복적 - 더 많이 배우면서 개선