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,109 +1,109 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 인수 기반 AIWF 태스크 처리
|
|
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
|
-
## 1 ·
|
|
16
|
+
## 1 · 인수에서 범위 분석
|
|
17
17
|
|
|
18
|
-
<$ARGUMENTS> ⇒
|
|
18
|
+
<$ARGUMENTS> ⇒ 태스크 ID, 스프린트 ID, 또는 빈 값 (현재 스프린트에서 다음 열린 태스크 선택).
|
|
19
19
|
|
|
20
|
-
## 2 ·
|
|
20
|
+
## 2 · 태스크 파일 식별
|
|
21
21
|
|
|
22
|
-
|
|
23
|
-
|
|
22
|
+
.aiwf/03_SPRINTS/와 .aiwf/04_GENERAL_TASKS/에서 검색합니다.
|
|
23
|
+
일치하는 열린 태스크가 없으면 일시정지하고 사용자에게 진행 방법을 문의합니다.
|
|
24
24
|
|
|
25
|
-
## 3 ·
|
|
25
|
+
## 3 · 태스크 분석
|
|
26
26
|
|
|
27
|
-
|
|
27
|
+
태스크 설명을 읽습니다. 불분명한 점이 있으면 계속하기 전에 명확화 질문을 합니다.
|
|
28
28
|
|
|
29
|
-
|
|
29
|
+
**중요한 맥락 검증:** 태스크를 실행하기 전에 다음 작업들을 위한 병렬 서브에이전트를 실행합니다:
|
|
30
30
|
|
|
31
|
-
1.
|
|
32
|
-
2.
|
|
33
|
-
3.
|
|
34
|
-
4.
|
|
35
|
-
5. **GitHub
|
|
31
|
+
1. **스프린트 맥락:** 태스크가 현재 스프린트 범위에 속하는지 확인
|
|
32
|
+
2. **의존성:** 먼저 완료해야 할 의존 태스크가 있는지 확인
|
|
33
|
+
3. **요구사항:** `.aiwf/02_REQUIREMENTS/`에서 관련 요구사항 문서 읽기
|
|
34
|
+
4. **범위 검증:** 태스크가 현재 스프린트 목표와 일치하는지 확인
|
|
35
|
+
5. **GitHub 이슈 확인:** 태스크 파일에 `github_issue` 필드가 있는지 확인
|
|
36
36
|
|
|
37
|
-
|
|
37
|
+
**중요:** 태스크가 미래 스프린트의 기능을 참조하거나 충족되지 않은 의존성이 있으면 일시정지하고 명확화를 요청합니다.
|
|
38
38
|
|
|
39
|
-
**GitHub
|
|
39
|
+
**GitHub 이슈 생성 (선택사항):**
|
|
40
40
|
|
|
41
|
-
-
|
|
42
|
-
-
|
|
41
|
+
- 태스크에 GitHub 이슈가 없고 사용자가 이슈 추적을 원하는 경우
|
|
42
|
+
- `/project:aiwf:issue_create {task_id}` 명령어 사용을 제안합니다
|
|
43
43
|
|
|
44
|
-
## 4 ·
|
|
44
|
+
## 4 · 상태를 진행 중으로 설정
|
|
45
45
|
|
|
46
|
-
-
|
|
47
|
-
-
|
|
48
|
-
-
|
|
49
|
-
- **GitHub
|
|
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 "🚀
|
|
51
|
+
gh issue comment {issue_number} --body "🚀 태스크 작업이 시작되었습니다."
|
|
52
52
|
gh issue edit {issue_number} --add-label "in-progress"
|
|
53
53
|
```
|
|
54
54
|
|
|
55
|
-
## 5 ·
|
|
55
|
+
## 5 · 태스크 작업 실행
|
|
56
56
|
|
|
57
|
-
-
|
|
58
|
-
-
|
|
59
|
-
-
|
|
60
|
-
1.
|
|
61
|
-
2.
|
|
62
|
-
3.
|
|
63
|
-
4.
|
|
64
|
-
5.
|
|
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 ·
|
|
66
|
+
## 6 · 플레이스홀더
|
|
67
67
|
|
|
68
|
-
|
|
68
|
+
플레이스홀더 - 다음 단계로 진행하세요
|
|
69
69
|
|
|
70
|
-
## 7 ·
|
|
70
|
+
## 7 · 코드 리뷰 실행
|
|
71
71
|
|
|
72
|
-
|
|
72
|
+
코드 리뷰를 위해 다음 단계를 순서대로 수행합니다
|
|
73
73
|
|
|
74
|
-
-
|
|
75
|
-
-
|
|
76
|
-
-
|
|
77
|
-
-
|
|
78
|
-
-
|
|
79
|
-
-
|
|
80
|
-
-
|
|
81
|
-
-
|
|
82
|
-
-
|
|
83
|
-
-
|
|
74
|
+
- @.claude/commands/aiwf/aiwf_code_review.md를 포함하고 태스크 ID를 범위로 사용합니다
|
|
75
|
+
- 파일의 지침에 따라 **병렬 서브에이전트**에서 코드 리뷰를 실행합니다
|
|
76
|
+
- 완료되면 결과에 따라 적절히 조치합니다
|
|
77
|
+
- 결과를 이해하고 분석합니다
|
|
78
|
+
- **실패** 시:
|
|
79
|
+
- 문제를 철저히 이해합니다
|
|
80
|
+
- 리뷰에서 식별된 하위 태스크로 현재 태스크를 확장합니다
|
|
81
|
+
- "5 · 태스크 작업 실행"으로 돌아갑니다
|
|
82
|
+
- **통과** 시:
|
|
83
|
+
- 다음 단계로 진행합니다
|
|
84
84
|
|
|
85
|
-
## 8 ·
|
|
85
|
+
## 8 · 태스크 상태 완료 처리
|
|
86
86
|
|
|
87
|
-
-
|
|
88
|
-
-
|
|
89
|
-
-
|
|
90
|
-
- **GitHub
|
|
87
|
+
- 태스크 상태를 **completed**로 설정합니다
|
|
88
|
+
- 파일명에서 완료 인식이 가능하도록 태스크 파일명을 적절히 변경합니다 (TX[TASK_ID]...)
|
|
89
|
+
- .aiwf/00_PROJECT_MANIFEST.md를 업데이트하여 새 상태를 반영합니다
|
|
90
|
+
- **GitHub 이슈 업데이트 (존재하는 경우):**
|
|
91
91
|
```bash
|
|
92
|
-
gh issue comment {issue_number} --body "✅
|
|
92
|
+
gh issue comment {issue_number} --body "✅ 태스크가 완료되었습니다."
|
|
93
93
|
gh issue edit {issue_number} --remove-label "in-progress" --add-label "completed"
|
|
94
94
|
```
|
|
95
|
-
-
|
|
95
|
+
- 사용자에게 **결과 보고**
|
|
96
96
|
|
|
97
|
-
✅
|
|
97
|
+
✅ **결과**: 성공에 대한 간단한 설명
|
|
98
98
|
|
|
99
|
-
🔎
|
|
99
|
+
🔎 **범위**: 식별된 태스크 또는 처리되지 않은 이유
|
|
100
100
|
|
|
101
|
-
💬
|
|
101
|
+
💬 **요약**: 수행된 작업 또는 차단된 이유에 대한 한 문단 요약
|
|
102
102
|
|
|
103
|
-
⏭️
|
|
103
|
+
⏭️ **다음 단계**: 권장 후속 조치
|
|
104
104
|
|
|
105
|
-
-
|
|
105
|
+
- 사용자를 위한 **제안**:
|
|
106
106
|
|
|
107
|
-
- 🛠️
|
|
108
|
-
- 🔀
|
|
109
|
-
- 🧹
|
|
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
|
-
|
|
3
|
+
적응형, 상호작용적 프로세스를 통해 AIWF 프로젝트 관리 프레임워크를 초기화합니다.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## 정확히 다음 항목들로 TODO 생성
|
|
6
6
|
|
|
7
|
-
1.
|
|
8
|
-
2.
|
|
9
|
-
3.
|
|
10
|
-
4.
|
|
11
|
-
5.
|
|
12
|
-
6.
|
|
13
|
-
7.
|
|
7
|
+
1. 프로젝트 스캔 및 분석
|
|
8
|
+
2. 사용자와 상호작용적 확인
|
|
9
|
+
3. 기존 AIWF 문서 확인
|
|
10
|
+
4. 문서 생성 프로세스 안내
|
|
11
|
+
5. AIWF를 위한 첫 번째 마일스톤 생성
|
|
12
|
+
6. 프로젝트 매니페스트 생성
|
|
13
|
+
7. 다음 단계 제공
|
|
14
14
|
|
|
15
|
-
##
|
|
15
|
+
## 모든 TODO 항목에 대한 세부사항
|
|
16
16
|
|
|
17
|
-
### 1.
|
|
17
|
+
### 1. 프로젝트 스캔 및 분석
|
|
18
18
|
|
|
19
|
-
|
|
19
|
+
**프로젝트 특성 탐지:**
|
|
20
20
|
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
-
|
|
21
|
+
- package.json, requirements.txt, composer.json 등 확인
|
|
22
|
+
- 프로젝트 유형 식별 (Node.js, Python, PHP 등)
|
|
23
|
+
- 전체 프로젝트 구조 스캔
|
|
24
|
+
- 새 프로젝트인지 기존 프로젝트인지 확인
|
|
25
|
+
- 기존 문서 찾기 (README, docs/ 등)
|
|
26
26
|
|
|
27
|
-
|
|
27
|
+
**발견사항을 간단히 정리** - 필수 사항만 식별
|
|
28
28
|
|
|
29
|
-
### 2.
|
|
29
|
+
### 2. 사용자와 상호작용적 확인
|
|
30
30
|
|
|
31
|
-
|
|
31
|
+
**발견사항을 대화형으로 제시:**
|
|
32
32
|
|
|
33
33
|
```
|
|
34
|
-
|
|
35
|
-
|
|
34
|
+
이것은 [프로젝트 이름]이라는 [프로젝트 유형] 프로젝트인 것으로 확인됩니다.
|
|
35
|
+
맞습니까? AIWF 설정을 계속 진행해도 될까요?
|
|
36
36
|
```
|
|
37
37
|
|
|
38
|
-
|
|
38
|
+
**계속하기 전에 사용자 확인 받기**
|
|
39
39
|
|
|
40
|
-
### 3.
|
|
40
|
+
### 3. 기존 AIWF 문서 확인
|
|
41
41
|
|
|
42
|
-
|
|
42
|
+
**.aiwf/ 디렉토리에서 스캔:**
|
|
43
43
|
|
|
44
|
-
-
|
|
45
|
-
-
|
|
46
|
-
-
|
|
47
|
-
-
|
|
44
|
+
- 01_PROJECT_DOCS/의 모든 문서
|
|
45
|
+
- 02_REQUIREMENTS/의 모든 마일스톤
|
|
46
|
+
- 기존 스프린트나 태스크
|
|
47
|
+
- 현재 매니페스트 상태
|
|
48
48
|
|
|
49
|
-
|
|
49
|
+
**상호작용적 결정:**
|
|
50
50
|
|
|
51
|
-
-
|
|
52
|
-
-
|
|
51
|
+
- 문서가 발견된 경우: "기존 문서를 발견했습니다: [목록]. 이것들을 사용하거나 확장할까요?"
|
|
52
|
+
- 문서가 없는 경우: "아직 AIWF 문서가 없습니다. 계속하기 전에 복사하고 싶은 기존 프로젝트 문서가 있나요?"
|
|
53
53
|
|
|
54
|
-
|
|
54
|
+
**사용자가 선택할 수 있는 옵션:**
|
|
55
55
|
|
|
56
|
-
-
|
|
57
|
-
-
|
|
58
|
-
-
|
|
59
|
-
-
|
|
56
|
+
- 기존 문서 사용
|
|
57
|
+
- 새 문서 추가
|
|
58
|
+
- 새로 시작
|
|
59
|
+
- 먼저 수동으로 문서 추가하기 위해 취소
|
|
60
60
|
|
|
61
|
-
### 4.
|
|
61
|
+
### 4. 문서 생성 프로세스 안내
|
|
62
62
|
|
|
63
|
-
|
|
63
|
+
**사용자 선택에 따라:**
|
|
64
64
|
|
|
65
|
-
|
|
65
|
+
**새로 시작하거나 확장하는 경우:**
|
|
66
66
|
|
|
67
|
-
-
|
|
68
|
-
-
|
|
69
|
-
-
|
|
70
|
-
-
|
|
71
|
-
- "
|
|
72
|
-
- "
|
|
73
|
-
- "
|
|
67
|
+
- 코드베이스의 심층 분석 수행
|
|
68
|
+
- 주요 구성요소와 아키텍처 패턴 식별
|
|
69
|
+
- 분석을 바탕으로 ARCHITECTURE.md 초안 생성
|
|
70
|
+
- Q&A 스타일로 정제하고 완성:
|
|
71
|
+
- "이 프로젝트의 주요 목적은 무엇인가요?"
|
|
72
|
+
- "핵심 기술적 결정사항은 무엇인가요?"
|
|
73
|
+
- "중요한 제약사항이나 요구사항이 있나요?"
|
|
74
74
|
|
|
75
|
-
|
|
75
|
+
**기존 문서를 사용하는 경우:**
|
|
76
76
|
|
|
77
|
-
-
|
|
78
|
-
-
|
|
79
|
-
-
|
|
77
|
+
- 기존 문서를 가져와서 적응
|
|
78
|
+
- AIWF 관련 섹션 작성
|
|
79
|
+
- 프레임워크 구조와의 호환성 보장
|
|
80
80
|
|
|
81
|
-
|
|
81
|
+
**대화형이고 적응적으로 유지**
|
|
82
82
|
|
|
83
|
-
### 5.
|
|
83
|
+
### 5. AIWF를 위한 첫 번째 마일스톤 생성
|
|
84
84
|
|
|
85
|
-
|
|
85
|
+
**적절한 첫 번째 마일스톤 결정:**
|
|
86
86
|
|
|
87
|
-
-
|
|
88
|
-
-
|
|
87
|
+
- 새 프로젝트인 경우: 설정/기반 마일스톤으로 시작
|
|
88
|
+
- 기존 프로젝트인 경우: 현재 단계를 식별하고 적절한 마일스톤 생성
|
|
89
89
|
|
|
90
|
-
|
|
90
|
+
**상호작용적 마일스톤 생성:**
|
|
91
91
|
|
|
92
|
-
- "
|
|
93
|
-
- "
|
|
94
|
-
-
|
|
95
|
-
-
|
|
92
|
+
- "프로젝트 상태를 바탕으로 다음 마일스톤 생성을 제안합니다: [이름]"
|
|
93
|
+
- "이 마일스톤에서 무엇에 집중하고 싶으신가요?"
|
|
94
|
+
- 초기 요구사항이 포함된 마일스톤 구조 생성
|
|
95
|
+
- 범위를 현실적이고 집중적으로 유지
|
|
96
96
|
|
|
97
|
-
### 6.
|
|
97
|
+
### 6. 프로젝트 매니페스트 생성
|
|
98
98
|
|
|
99
|
-
|
|
99
|
+
**다음을 사용하여 매니페스트 자동 생성:**
|
|
100
100
|
|
|
101
|
-
-
|
|
102
|
-
-
|
|
103
|
-
-
|
|
104
|
-
-
|
|
101
|
+
- 설정 중에 수집된 정보
|
|
102
|
+
- 생성/가져온 문서
|
|
103
|
+
- 현재 마일스톤 세부사항
|
|
104
|
+
- 프로젝트 메타데이터
|
|
105
105
|
|
|
106
|
-
|
|
106
|
+
**사용자 상호작용 불필요** - 완료될 때 알리기만 하세요
|
|
107
107
|
|
|
108
|
-
### 7.
|
|
108
|
+
### 7. 다음 단계 제공
|
|
109
109
|
|
|
110
|
-
|
|
110
|
+
**설정을 바탕으로 맞춤형 안내:**
|
|
111
111
|
|
|
112
112
|
```
|
|
113
|
-
✅
|
|
113
|
+
✅ [프로젝트 이름]에 대한 AIWF 초기화 완료!
|
|
114
114
|
|
|
115
|
-
|
|
116
|
-
-
|
|
117
|
-
-
|
|
118
|
-
-
|
|
115
|
+
현재 설정:
|
|
116
|
+
- 프로젝트 유형: [유형]
|
|
117
|
+
- 현재 마일스톤: [마일스톤]
|
|
118
|
+
- 문서: [생성/가져온 항목]
|
|
119
119
|
|
|
120
|
-
|
|
121
|
-
-
|
|
122
|
-
-
|
|
123
|
-
-
|
|
120
|
+
다음 단계:
|
|
121
|
+
- 아키텍처 검토: 01_PROJECT_DOCS/ARCHITECTURE.md
|
|
122
|
+
- 마일스톤 요구사항 확인: 02_REQUIREMENTS/[마일스톤]/
|
|
123
|
+
- 첫 번째 태스크 시작: /project:aiwf:create_general_task
|
|
124
124
|
|
|
125
|
-
|
|
125
|
+
개발을 시작할 준비가 완료되었습니다!
|
|
126
126
|
```
|
|
127
127
|
|
|
128
|
-
##
|
|
128
|
+
## 적응형 프로세스 노트
|
|
129
129
|
|
|
130
|
-
-
|
|
131
|
-
-
|
|
132
|
-
-
|
|
133
|
-
-
|
|
134
|
-
-
|
|
130
|
+
- **대화형 유지** - 양식처럼이 아닌 자연스럽게 질문하기
|
|
131
|
+
- **스마트하게** - AI를 사용하여 맥락을 이해하고 지능적인 제안 만들기
|
|
132
|
+
- **유연성 허용** - 사용자가 언제든지 건너뛰기, 취소, 수정 가능
|
|
133
|
+
- **가치에 집중** - 특정 프로젝트에 유용한 것만 생성
|
|
134
|
+
- **단순하게 유지** - 옵션이나 세부사항으로 압도하지 않기
|