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.
- package/CHANGELOG.md +38 -36
- package/CLAUDE.md +8 -209
- package/README.md +25 -5
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_docs.md +225 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_language_manager.md +287 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_language_status.md +246 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_switch_language.md +160 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_code_review.md +62 -62
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_commit.md +111 -111
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_create_general_task.md +106 -106
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_create_milestone_plan.md +127 -127
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_create_sprint_tasks.md +130 -130
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_create_sprints_from_milestone.md +87 -87
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_do_task.md +72 -72
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_docs.md +225 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_initialize.md +86 -86
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_issue_create.md +3 -3
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_language_manager.md +287 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_language_status.md +246 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_pr_create.md +14 -14
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_prime.md +5 -5
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_project_review.md +39 -39
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_switch_language.md +160 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_test.md +76 -77
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_testing_review.md +120 -120
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_ultrathink_general.md +209 -266
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_yolo.md +226 -226
- package/docs/AI-WORKFLOW.ko.md +9 -2
- package/docs/AI-WORKFLOW.md +9 -2
- package/docs/COMMANDS_GUIDE.ko.md +93 -3
- package/docs/COMMANDS_GUIDE.md +94 -4
- package/docs/Enhanced_Installation_Flow_Design.md +498 -0
- package/docs/PRD.ko.md +110 -58
- package/docs/PRD.md +110 -58
- package/index.js +1240 -20
- package/jest.config.js +4 -0
- package/language-cli.js +279 -0
- package/language-utils.js +330 -0
- package/package.json +12 -4
- package/scripts/validate-commands.cjs +338 -0
- package/scripts/validate-commands.js +254 -0
- package/tests/basic.test.js +62 -0
- package/tests/commands.test.js +127 -0
- package/tests/installer.test.js +129 -0
- package/tests/language-utils.test.js +271 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_prime_context.md +0 -5
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_prime_context.md +0 -8
|
@@ -1,147 +1,147 @@
|
|
|
1
|
-
# 일반
|
|
1
|
+
# 일반 태스크 생성
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
프로젝트 문서화 표준을 따라 `.aiwf/04_GENERAL_TASKS/`에 새로운 일반 태스크를 생성합니다.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## 정확히 다음 10개 항목으로 할 일 목록을 생성하세요
|
|
6
6
|
|
|
7
|
-
1.
|
|
8
|
-
2.
|
|
9
|
-
3.
|
|
10
|
-
4.
|
|
11
|
-
5.
|
|
12
|
-
6.
|
|
13
|
-
7.
|
|
14
|
-
8.
|
|
15
|
-
9.
|
|
16
|
-
10.
|
|
7
|
+
1. 태스크 인수 분석 및 태스크 ID 결정
|
|
8
|
+
2. 프로젝트 컨텍스트 및 문서화 요구사항 로드
|
|
9
|
+
3. 중복 작업이 없는지 확인
|
|
10
|
+
4. 구현 컨텍스트를 위한 코드베이스 연구
|
|
11
|
+
5. 표준 템플릿을 사용하여 태스크 파일 생성
|
|
12
|
+
6. 적절한 컨텍스트로 태스크 세부사항 작성
|
|
13
|
+
7. 기술 가이드라인 및 코드베이스 참조 추가
|
|
14
|
+
8. 새 태스크로 프로젝트 매니페스트 업데이트
|
|
15
|
+
9. 아키텍처와의 태스크 정렬 검증
|
|
16
|
+
10. 최종 품질 검사 및 보고 수행
|
|
17
17
|
|
|
18
|
-
##
|
|
18
|
+
## 모든 할 일 항목에 대한 세부사항
|
|
19
19
|
|
|
20
|
-
### 1.
|
|
20
|
+
### 1. 태스크 인수 분석 및 태스크 ID 결정
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
인수 형식: `<태스크 제목 또는 설명>`
|
|
23
23
|
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
27
|
-
-
|
|
28
|
-
-
|
|
24
|
+
- 인수가 비어있는 경우, 사용자에게 태스크 세부사항을 요청합니다
|
|
25
|
+
- `.aiwf/04_GENERAL_TASKS/`의 기존 태스크를 확인하여 순차적 태스크 ID를 생성합니다
|
|
26
|
+
- 가장 높은 태스크 번호(T###)를 찾아 1을 증가시킵니다
|
|
27
|
+
- 형식: `T###_<태스크_제목_스네이크_케이스>.md`
|
|
28
|
+
- **중요**: 태스크 ID는 빈 공간 없이 순차적이어야 합니다
|
|
29
29
|
|
|
30
|
-
### 2.
|
|
30
|
+
### 2. 프로젝트 컨텍스트 및 문서화 요구사항 로드
|
|
31
31
|
|
|
32
|
-
|
|
32
|
+
**병렬 서브에이전트**를 사용하여 프로젝트 컨텍스트를 읽고 이해하세요:
|
|
33
33
|
|
|
34
|
-
-
|
|
35
|
-
-
|
|
36
|
-
-
|
|
37
|
-
-
|
|
38
|
-
-
|
|
39
|
-
-
|
|
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.
|
|
41
|
+
### 3. 중복 작업이 없는지 확인
|
|
42
42
|
|
|
43
|
-
|
|
43
|
+
**포괄적으로 검색**하여 중복 가능성을 찾으세요:
|
|
44
44
|
|
|
45
|
-
-
|
|
46
|
-
-
|
|
47
|
-
-
|
|
48
|
-
-
|
|
45
|
+
- `.aiwf/04_GENERAL_TASKS/`의 모든 파일 확인
|
|
46
|
+
- `.aiwf/03_SPRINTS/*/T*.md`의 스프린트 태스크 검색
|
|
47
|
+
- 완료된 마일스톤에서 유사한 기능 찾기
|
|
48
|
+
- **중요**: 중복이 발견되면 중단하고 파일 참조와 함께 사용자에게 보고
|
|
49
49
|
|
|
50
|
-
### 4.
|
|
50
|
+
### 4. 구현 컨텍스트를 위한 코드베이스 연구
|
|
51
51
|
|
|
52
|
-
|
|
52
|
+
태스크 설명을 바탕으로 **병렬 서브에이전트**를 사용하여:
|
|
53
53
|
|
|
54
|
-
-
|
|
55
|
-
-
|
|
56
|
-
-
|
|
57
|
-
-
|
|
58
|
-
-
|
|
59
|
-
-
|
|
60
|
-
-
|
|
54
|
+
- 태스크가 요구하는 것과 유사한 기존 패턴 검색
|
|
55
|
+
- 영향을 받을 주요 인터페이스, 클래스 또는 모듈 식별
|
|
56
|
+
- 코드베이스에서 유사한 구현 예제 찾기
|
|
57
|
+
- 관련 테스트 패턴 및 기존 테스트 파일 위치 파악
|
|
58
|
+
- 사용되는 오류 처리 및 로깅 패턴 발견
|
|
59
|
+
- 기존 코드와의 통합 지점 매핑
|
|
60
|
+
- **문서화**: 태스크에 포함할 모든 발견사항 기록
|
|
61
61
|
|
|
62
|
-
### 5.
|
|
62
|
+
### 5. 표준 템플릿을 사용하여 태스크 파일 생성
|
|
63
63
|
|
|
64
|
-
|
|
64
|
+
`.aiwf/99_TEMPLATES/task_template.md`의 태스크 템플릿을 기본 구조로 **사용**하세요:
|
|
65
65
|
|
|
66
|
-
-
|
|
67
|
-
-
|
|
68
|
-
-
|
|
69
|
-
-
|
|
66
|
+
- 템플릿 구조를 정확히 복사
|
|
67
|
+
- 파일을 `.aiwf/04_GENERAL_TASKS/T###_<제목>.md`에 배치
|
|
68
|
+
- 타임스탬프 포함: 생성 시간을 위해 `date '+%Y-%m-%d %H:%M:%S'` 실행
|
|
69
|
+
- **중요**: 템플릿 구조를 정확히 따르세요 - 변경 없음
|
|
70
70
|
|
|
71
|
-
### 6.
|
|
71
|
+
### 6. 적절한 컨텍스트로 태스크 세부사항 작성
|
|
72
72
|
|
|
73
|
-
|
|
73
|
+
태스크 파일을 다음 내용으로 채우세요:
|
|
74
74
|
|
|
75
|
-
-
|
|
76
|
-
-
|
|
77
|
-
-
|
|
78
|
-
-
|
|
79
|
-
-
|
|
80
|
-
-
|
|
81
|
-
-
|
|
75
|
+
- **제목**: 명확하고 실행 가능한 태스크 이름
|
|
76
|
+
- **컨텍스트**: 아키텍처 문서 및 프로젝트 상태에 연결
|
|
77
|
+
- **요구사항**: 구체적이고 측정 가능한 결과
|
|
78
|
+
- **승인 기준**: 완료에 대한 명확한 정의
|
|
79
|
+
- **종속성**: 관련 스프린트/마일스톤 참조
|
|
80
|
+
- **구현 노트**: 아키텍처와 일치하는 기술적 접근법
|
|
81
|
+
- **중요**: 모든 내용은 기존 문서를 참조해야 합니다
|
|
82
82
|
|
|
83
|
-
### 7.
|
|
83
|
+
### 7. 기술 가이드라인 및 코드베이스 참조 추가
|
|
84
84
|
|
|
85
|
-
|
|
85
|
+
**기술 가이드라인 섹션:**
|
|
86
86
|
|
|
87
|
-
-
|
|
88
|
-
-
|
|
89
|
-
-
|
|
90
|
-
-
|
|
91
|
-
-
|
|
92
|
-
-
|
|
87
|
+
- 4단계에서 발견한 주요 인터페이스 및 통합 지점
|
|
88
|
+
- 코드베이스의 구체적인 import 및 모듈 참조
|
|
89
|
+
- 따라야 할 기존 패턴 (파일 참조 포함)
|
|
90
|
+
- 작업할 데이터베이스 모델 또는 API 계약
|
|
91
|
+
- 유사한 코드에서 사용되는 오류 처리 접근법
|
|
92
|
+
- 코드베이스에서 발견된 테스트 패턴
|
|
93
93
|
|
|
94
|
-
|
|
94
|
+
**구현 노트 섹션:**
|
|
95
95
|
|
|
96
|
-
-
|
|
97
|
-
-
|
|
98
|
-
-
|
|
99
|
-
-
|
|
100
|
-
-
|
|
96
|
+
- 연구를 바탕으로 한 단계별 구현 접근법
|
|
97
|
+
- 존중해야 할 주요 아키텍처 결정사항 (ADR 참조)
|
|
98
|
+
- 수정하거나 확장할 구체적인 파일 및 함수
|
|
99
|
+
- 기존 테스트 패턴을 바탕으로 한 테스트 접근법
|
|
100
|
+
- 관련성이 있는 경우 성능 고려사항
|
|
101
101
|
|
|
102
|
-
|
|
102
|
+
**중요**: 코드 예제를 포함하지 마세요. 구조적 가이드라인과 파일 참조만 제공하세요.
|
|
103
103
|
|
|
104
|
-
### 8.
|
|
104
|
+
### 8. 새 태스크로 프로젝트 매니페스트 업데이트
|
|
105
105
|
|
|
106
|
-
|
|
106
|
+
`.aiwf/00_PROJECT_MANIFEST.md` **업데이트**:
|
|
107
107
|
|
|
108
|
-
-
|
|
109
|
-
-
|
|
110
|
-
-
|
|
111
|
-
-
|
|
112
|
-
-
|
|
108
|
+
- "## 일반 태스크" 섹션에 태스크 추가
|
|
109
|
+
- 형식: `- [ ] T###: [태스크 제목] - 상태: 시작되지 않음`
|
|
110
|
+
- 알파벳/숫자 순서 유지
|
|
111
|
+
- 태스크 파일에 링크: `[T###](04_GENERAL_TASKS/T###_제목.md)`
|
|
112
|
+
- **중요**: 기존 내용을 모두 보존하세요
|
|
113
113
|
|
|
114
|
-
### 9.
|
|
114
|
+
### 9. 아키텍처와의 태스크 정렬 검증
|
|
115
115
|
|
|
116
|
-
|
|
116
|
+
태스크 준수사항 **확인**:
|
|
117
117
|
|
|
118
|
-
-
|
|
119
|
-
-
|
|
120
|
-
-
|
|
121
|
-
-
|
|
122
|
-
-
|
|
123
|
-
-
|
|
118
|
+
- 태스크가 아키텍처 원칙과 모순되지 않는지 확인
|
|
119
|
+
- 구현 접근법이 확립된 패턴을 사용하는지 보장
|
|
120
|
+
- 종속성이 존재하고 올바른지 검증
|
|
121
|
+
- 태스크 범위가 적절한지 확인 (너무 광범위하거나 좁지 않게)
|
|
122
|
+
- 기술 가이드라인이 기존 코드베이스 패턴과 일치하는지 확인
|
|
123
|
+
- **중요**: 문서가 진실의 원천입니다 - 어떤 편차든 정당화가 필요합니다
|
|
124
124
|
|
|
125
|
-
### 10.
|
|
125
|
+
### 10. 최종 품질 검사 및 보고 수행
|
|
126
126
|
|
|
127
|
-
|
|
127
|
+
**품질 검사**:
|
|
128
128
|
|
|
129
|
-
-
|
|
130
|
-
-
|
|
131
|
-
-
|
|
132
|
-
-
|
|
133
|
-
-
|
|
134
|
-
-
|
|
135
|
-
-
|
|
129
|
+
- 태스크 파일이 템플릿을 완전히 따르는지 확인
|
|
130
|
+
- 새로운 기술 가이드라인을 포함한 모든 섹션이 적절히 작성되었는지 확인
|
|
131
|
+
- 문서 및 코드베이스에 대한 참조가 유효한지 확인
|
|
132
|
+
- 태스크 ID가 순차적이고 고유한지 확인
|
|
133
|
+
- 매니페스트가 올바르게 업데이트되었는지 확인
|
|
134
|
+
- 기술 가이드라인이 실제 파일과 패턴을 참조하는지 확인
|
|
135
|
+
- 범위 확장이나 아키텍처 위반이 없는지 확인
|
|
136
136
|
|
|
137
|
-
|
|
137
|
+
**출력 형식**:
|
|
138
138
|
|
|
139
139
|
```markdown
|
|
140
|
-
✅
|
|
141
|
-
📋
|
|
142
|
-
🎯
|
|
143
|
-
📚
|
|
144
|
-
🔧
|
|
145
|
-
🧪
|
|
146
|
-
⏭️
|
|
140
|
+
✅ **생성**: T###\_<제목>.md
|
|
141
|
+
📋 **유형**: 일반 태스크
|
|
142
|
+
🎯 **목적**: [한 줄 요약]
|
|
143
|
+
📚 **참조**: [주요 문서 링크]
|
|
144
|
+
🔧 **주요 통합 지점**: [수정할 주요 파일/모듈]
|
|
145
|
+
🧪 **테스트 접근법**: [따를 테스트 패턴]
|
|
146
|
+
⏭️ **다음 단계**: 태스크 세부사항을 검토하고 `/do_task T###`를 실행하여 시작하세요
|
|
147
147
|
```
|
|
@@ -1,194 +1,194 @@
|
|
|
1
|
-
# 신규 마일스톤 계획 및 생성
|
|
1
|
+
# 신규 마일스톤 계획 및 생성
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
상호작용적이고 적응적인 프로세스를 통해 적절한 구조, 문서화, 프로젝트 통합을 갖춘 새로운 마일스톤을 생성합니다.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## 정확히 다음 8개 항목으로 할 일 목록을 생성하세요
|
|
6
6
|
|
|
7
|
-
1.
|
|
8
|
-
2.
|
|
9
|
-
3.
|
|
10
|
-
4.
|
|
11
|
-
5.
|
|
12
|
-
6.
|
|
13
|
-
7.
|
|
14
|
-
8.
|
|
7
|
+
1. 인수 분석 및 프로젝트 컨텍스트 파악
|
|
8
|
+
2. 상호작용적 마일스톤 범위 및 정의
|
|
9
|
+
3. 마일스톤 구조 및 명명 결정
|
|
10
|
+
4. 마일스톤 디렉토리 및 메타 파일 생성
|
|
11
|
+
5. 지원 문서 생성 가이드
|
|
12
|
+
6. 마일스톤으로 프로젝트 매니페스트 업데이트
|
|
13
|
+
7. 마일스톤 일관성 및 정렬 검증
|
|
14
|
+
8. 마일스톤 생성 및 다음 단계 보고
|
|
15
15
|
|
|
16
16
|
---
|
|
17
17
|
|
|
18
|
-
## 1
|
|
18
|
+
## 1. 인수 분석 및 프로젝트 컨텍스트 파악
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
**중요**: 추가 인수가 제공됩니다: <$ARGUMENTS>
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
**병렬 서브에이전트**를 사용하여 다음 작업을 수행하세요:
|
|
23
23
|
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
27
|
-
-
|
|
28
|
-
-
|
|
29
|
-
-
|
|
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
|
|
31
|
+
## 2. 상호작용적 마일스톤 범위 및 정의
|
|
32
32
|
|
|
33
|
-
|
|
33
|
+
**대화형 마일스톤 정의:**
|
|
34
34
|
|
|
35
|
-
|
|
35
|
+
인수가 제공된 경우:
|
|
36
36
|
|
|
37
|
-
- "
|
|
38
|
-
- "
|
|
37
|
+
- "다음을 위한 마일스톤을 생성하고자 하시는군요: [인수]"
|
|
38
|
+
- "범위를 더 잘 이해해보겠습니다..."
|
|
39
39
|
|
|
40
|
-
|
|
40
|
+
인수가 없는 경우:
|
|
41
41
|
|
|
42
|
-
- "
|
|
43
|
-
- "
|
|
42
|
+
- "현재 프로젝트 상태를 바탕으로 다음 마일스톤을 정의해보겠습니다"
|
|
43
|
+
- "현재 [현재 마일스톤]에 있는 것으로 보입니다 - 다음에는 무엇에 집중해야 할까요?"
|
|
44
44
|
|
|
45
|
-
|
|
45
|
+
**상호작용 질문 (컨텍스트에 따라 조정):**
|
|
46
46
|
|
|
47
|
-
- "
|
|
48
|
-
- "
|
|
49
|
-
- "
|
|
50
|
-
- "
|
|
51
|
-
- "
|
|
47
|
+
- "이 마일스톤의 주요 목표는 무엇인가요?"
|
|
48
|
+
- "완료되어야 할 핵심 결과물은 무엇인가요?"
|
|
49
|
+
- "특정한 기술적 도전이나 요구사항이 있나요?"
|
|
50
|
+
- "이 마일스톤이 프로젝트를 장기 비전으로 어떻게 발전시킬까요?"
|
|
51
|
+
- "이 마일스톤의 '완료'는 어떤 모습일까요?"
|
|
52
52
|
|
|
53
|
-
|
|
53
|
+
**대화형이고 적응적으로 유지** - 심문하지 말고 필요한 것만 수집하세요
|
|
54
54
|
|
|
55
|
-
## 3
|
|
55
|
+
## 3. 마일스톤 구조 및 명명 결정
|
|
56
56
|
|
|
57
|
-
|
|
57
|
+
**마일스톤 세부사항 생성:**
|
|
58
58
|
|
|
59
|
-
-
|
|
60
|
-
-
|
|
61
|
-
-
|
|
62
|
-
-
|
|
63
|
-
-
|
|
59
|
+
- 기존 마일스톤을 스캔하여 다음 마일스톤 번호 (M##) 결정
|
|
60
|
+
- 사용자 입력에서 설명적 마일스톤 이름 생성
|
|
61
|
+
- 형식: `M##_마일스톤_이름_스네이크_케이스`
|
|
62
|
+
- **중요**: 중복된 마일스톤 번호가 없도록 보장
|
|
63
|
+
- AIWF 규칙을 따르는 명명 검증 (밑줄, 공백 없음)
|
|
64
64
|
|
|
65
|
-
|
|
65
|
+
**사용자와 확인:**
|
|
66
66
|
|
|
67
|
-
- "
|
|
68
|
-
-
|
|
67
|
+
- "마일스톤을 생성하겠습니다: M##\_[이름] - 괜찮으신가요?"
|
|
68
|
+
- 필요시 사용자가 이름이나 번호를 조정할 수 있도록 허용
|
|
69
69
|
|
|
70
|
-
## 4
|
|
70
|
+
## 4. 마일스톤 디렉토리 및 메타 파일 생성
|
|
71
71
|
|
|
72
|
-
|
|
72
|
+
**마일스톤 구조 생성:**
|
|
73
73
|
|
|
74
|
-
-
|
|
75
|
-
-
|
|
76
|
-
-
|
|
74
|
+
- 디렉토리 생성: `.aiwf/02_REQUIREMENTS/M##_마일스톤_이름/`
|
|
75
|
+
- `.aiwf/99_TEMPLATES/milestone_meta_template.md`에서 템플릿 복사
|
|
76
|
+
- 마일스톤 메타 파일 생성: `M##_milestone_meta.md`
|
|
77
77
|
|
|
78
|
-
|
|
78
|
+
**마일스톤 메타 파일 채우기:**
|
|
79
79
|
|
|
80
|
-
-
|
|
80
|
+
- YAML 프론트매터 작성:
|
|
81
81
|
- `milestone_id: M##`
|
|
82
|
-
- `title: [
|
|
82
|
+
- `title: [마일스톤 이름]`
|
|
83
83
|
- `status: pending`
|
|
84
|
-
- `last_updated: [
|
|
85
|
-
-
|
|
86
|
-
-
|
|
87
|
-
-
|
|
88
|
-
-
|
|
89
|
-
-
|
|
84
|
+
- `last_updated: [현재 타임스탬프 YYYY-MM-DD HH:MM]`
|
|
85
|
+
- 사용자 입력을 구조화된 섹션으로 변환:
|
|
86
|
+
- **목표**: 사용자 논의에서 명확한 목적
|
|
87
|
+
- **핵심 문서**: PRD 및 SPECS 파일 플레이스홀더
|
|
88
|
+
- **완료 정의**: 사용자 입력에서 구체적이고 측정 가능한 기준
|
|
89
|
+
- **노트/컨텍스트**: 사용자 논의에서 추가 컨텍스트
|
|
90
90
|
|
|
91
|
-
## 5
|
|
91
|
+
## 5. 지원 문서 생성 가이드
|
|
92
92
|
|
|
93
|
-
|
|
93
|
+
**상호작용적 문서 계획:**
|
|
94
94
|
|
|
95
|
-
|
|
95
|
+
마일스톤 범위를 기반으로 필요한 문서 제안:
|
|
96
96
|
|
|
97
|
-
- "
|
|
98
|
-
- "□ PRD\_[
|
|
99
|
-
- "□ SPECS\_[
|
|
100
|
-
- "□
|
|
97
|
+
- "이 마일스톤에는 다음이 필요할 것 같습니다:"
|
|
98
|
+
- "□ PRD\_[마일스톤_이름].md - 제품 요구사항"
|
|
99
|
+
- "□ SPECS\_[기술_영역].md - 기술 사양"
|
|
100
|
+
- "□ 도메인별 문서"
|
|
101
101
|
|
|
102
|
-
|
|
102
|
+
**사용자에게 문의:**
|
|
103
103
|
|
|
104
|
-
- "
|
|
105
|
-
- "
|
|
104
|
+
- "지금 이 문서들의 시작 템플릿을 만들어드릴까요?"
|
|
105
|
+
- "아니면 필요에 따라 수동으로 만드시겠어요?"
|
|
106
106
|
|
|
107
|
-
|
|
107
|
+
**사용자가 템플릿 생성을 원하는 경우:**
|
|
108
108
|
|
|
109
|
-
-
|
|
110
|
-
-
|
|
111
|
-
-
|
|
112
|
-
-
|
|
109
|
+
- 마일스톤별 섹션이 포함된 기본 PRD 템플릿 생성
|
|
110
|
+
- 기술 마일스톤인 경우 SPECS 템플릿 생성
|
|
111
|
+
- 문서 간 적절한 상호참조 포함
|
|
112
|
+
- **중요**: 과도하게 엔지니어링하지 말고 유용한 시작점 생성
|
|
113
113
|
|
|
114
|
-
|
|
114
|
+
**사용자가 수동을 선호하는 경우:**
|
|
115
115
|
|
|
116
|
-
-
|
|
117
|
-
-
|
|
116
|
+
- 마일스톤 메타에 예상되는 문서 기록
|
|
117
|
+
- 언제/어떻게 생성할지에 대한 가이드 제공
|
|
118
118
|
|
|
119
|
-
## 6
|
|
119
|
+
## 6. 마일스톤으로 프로젝트 매니페스트 업데이트
|
|
120
120
|
|
|
121
|
-
|
|
121
|
+
`.aiwf/00_PROJECT_MANIFEST.md` **업데이트**:
|
|
122
122
|
|
|
123
|
-
-
|
|
124
|
-
-
|
|
125
|
-
-
|
|
126
|
-
-
|
|
127
|
-
-
|
|
128
|
-
-
|
|
129
|
-
-
|
|
130
|
-
-
|
|
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
|
|
132
|
+
## 7. 마일스톤 일관성 및 정렬 검증
|
|
133
133
|
|
|
134
|
-
|
|
134
|
+
마일스톤 품질 **확인**:
|
|
135
135
|
|
|
136
|
-
-
|
|
137
|
-
-
|
|
138
|
-
-
|
|
139
|
-
-
|
|
140
|
-
-
|
|
141
|
-
-
|
|
142
|
-
-
|
|
136
|
+
- 마일스톤이 프로젝트 아키텍처 및 비전과 일치하는지 확인
|
|
137
|
+
- 완료 정의가 구체적이고 측정 가능한지 보장
|
|
138
|
+
- 마일스톤 범위가 적절한지 검증 (너무 광범위하거나 좁지 않게)
|
|
139
|
+
- 마일스톤이 명시된 목표를 향해 프로젝트를 발전시키는지 확인
|
|
140
|
+
- 마일스톤 번호 및 명명이 규칙을 따르는지 확인
|
|
141
|
+
- 생성된 모든 파일이 템플릿 구조를 따르는지 검증
|
|
142
|
+
- **중요**: 마일스톤은 독립적으로 가치 있고 달성 가능해야 함
|
|
143
143
|
|
|
144
|
-
|
|
144
|
+
**고려사항**:
|
|
145
145
|
|
|
146
|
-
-
|
|
147
|
-
-
|
|
148
|
-
-
|
|
149
|
-
-
|
|
146
|
+
- 현재 프로젝트 상태를 고려할 때 이 마일스톤이 의미가 있는가?
|
|
147
|
+
- 목표가 현실적이고 잘 범위가 정해져 있는가?
|
|
148
|
+
- 완료 정의가 언제 완료되었는지 알 수 있을 만큼 명확한가?
|
|
149
|
+
- 이 마일스톤이 향후 마일스톤을 논리적으로 설정하는가?
|
|
150
150
|
|
|
151
|
-
## 8
|
|
151
|
+
## 8. 마일스톤 생성 및 다음 단계 보고
|
|
152
152
|
|
|
153
|
-
|
|
153
|
+
**출력 형식**:
|
|
154
154
|
|
|
155
155
|
```markdown
|
|
156
|
-
✅
|
|
156
|
+
✅ **마일스톤 생성됨**: M##\_[마일스톤_이름]
|
|
157
157
|
|
|
158
|
-
📋
|
|
158
|
+
📋 **마일스톤 세부사항**:
|
|
159
159
|
|
|
160
160
|
- ID: M##
|
|
161
|
-
-
|
|
162
|
-
-
|
|
163
|
-
-
|
|
161
|
+
- 제목: [마일스톤 이름]
|
|
162
|
+
- 상태: 계획 중
|
|
163
|
+
- 초점: [주요 목표의 한 줄 요약]
|
|
164
164
|
|
|
165
|
-
📚
|
|
165
|
+
📚 **생성된 문서**:
|
|
166
166
|
|
|
167
|
-
-
|
|
168
|
-
- [
|
|
167
|
+
- 마일스톤 메타: `02_REQUIREMENTS/M##_[이름]/M##_milestone_meta.md`
|
|
168
|
+
- [생성된 추가 문서들]
|
|
169
169
|
|
|
170
|
-
🎯
|
|
170
|
+
🎯 **완료 정의**:
|
|
171
171
|
|
|
172
|
-
- [
|
|
172
|
+
- [마일스톤의 핵심 DoD 기준]
|
|
173
173
|
|
|
174
|
-
📈
|
|
174
|
+
📈 **프로젝트 영향**:
|
|
175
175
|
|
|
176
|
-
-
|
|
177
|
-
-
|
|
176
|
+
- 프로젝트를 M[이전]에서 M##로 업데이트
|
|
177
|
+
- 다음을 향한 발전: [프로젝트 비전 정렬]
|
|
178
178
|
|
|
179
|
-
⏭️
|
|
179
|
+
⏭️ **권장 다음 단계**:
|
|
180
180
|
|
|
181
|
-
-
|
|
182
|
-
-
|
|
183
|
-
-
|
|
184
|
-
-
|
|
181
|
+
- 마일스톤 세부사항 검토: `02_REQUIREMENTS/M##_[이름]/M##_milestone_meta.md`
|
|
182
|
+
- 계획된 대로 지원 문서 생성
|
|
183
|
+
- 스프린트로 분해: `/project:aiwf:create_sprints_from_milestone M##`
|
|
184
|
+
- 명확해지는 대로 구체적인 요구사항으로 업데이트
|
|
185
185
|
|
|
186
|
-
🎯
|
|
186
|
+
🎯 **개발 준비**: 구현 계획을 시작할 준비가 되면 `/project:aiwf:create_sprints_from_milestone M##` 사용
|
|
187
187
|
```
|
|
188
188
|
|
|
189
|
-
|
|
189
|
+
**중요 참고사항**:
|
|
190
190
|
|
|
191
|
-
-
|
|
192
|
-
-
|
|
193
|
-
-
|
|
194
|
-
-
|
|
191
|
+
- 마일스톤 범위는 집중되고 달성 가능하게 유지
|
|
192
|
+
- 완료 정의는 측정 가능해야 함
|
|
193
|
+
- 지원 문서는 필요에 따라 생성 가능
|
|
194
|
+
- 마일스톤 계획은 반복적 - 더 많이 배우면서 개선
|