aiwf 0.1.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 +46 -0
- package/CLAUDE.md +19 -0
- package/LICENSE +1 -1
- package/README.ko.md +90 -62
- package/README.md +109 -62
- package/claude-code/{simone/.simone → aiwf/en/.aiwf}/01_PROJECT_DOCS/ARCHITECTURE.md +1 -1
- package/claude-code/{simone/.simone → aiwf/en/.aiwf}/02_REQUIREMENTS/M01_Backend_Setup/M01_milestone_meta.md +5 -1
- package/claude-code/{simone/.simone → aiwf/en/.aiwf}/02_REQUIREMENTS/M01_Backend_Setup/PRD_AMEND_01_Auth_Flow_Update.md +5 -1
- package/claude-code/{simone/.simone/03_SPRINTS/CLAUDE.MD → aiwf/en/.aiwf/03_SPRINTS/CLAUDE.md} +28 -7
- package/claude-code/{simone/.simone → aiwf/en/.aiwf}/03_SPRINTS/S01_M01_Initial_API/S01_sprint_meta.md +8 -1
- package/claude-code/{simone/.simone → aiwf/en/.aiwf}/03_SPRINTS/S01_M01_Initial_API/T01_S01_Setup_Project_Structure.md +5 -1
- package/claude-code/aiwf/en/.aiwf/04_GENERAL_TASKS/CLAUDE.md +96 -0
- package/claude-code/{simone/.simone → aiwf/en/.aiwf}/04_GENERAL_TASKS/T002_API_Rate_Limiting.md +7 -2
- package/claude-code/{simone/.simone → aiwf/en/.aiwf}/04_GENERAL_TASKS/TX001_Refactor_Logging_Module.md +7 -2
- package/claude-code/{simone/.simone → aiwf/en/.aiwf}/05_ARCHITECTURAL_DECISIONS/ADR001_Chosen_Database_System.md +7 -1
- package/claude-code/{simone/.simone → aiwf/en/.aiwf}/05_ARCHITECTURAL_DECISIONS/ADR002_API_Authentication_Method.md +7 -1
- package/claude-code/aiwf/en/.aiwf/10_STATE_OF_PROJECT/2025-06-12-12-00-needs-focus.md +139 -0
- package/claude-code/aiwf/en/.aiwf/10_STATE_OF_PROJECT/2025-06-12-12-00-test-alignment.md +155 -0
- package/claude-code/aiwf/en/.aiwf/10_STATE_OF_PROJECT/2025-06-13-00-50-solid-progress.md +122 -0
- package/claude-code/aiwf/en/.aiwf/10_STATE_OF_PROJECT/2025-06-14-08-30-infrastructure-challenges.md +141 -0
- package/claude-code/aiwf/en/.aiwf/10_STATE_OF_PROJECT/2025-06-16-21-48-critical-foundation-issues.md +177 -0
- package/claude-code/aiwf/en/.aiwf/10_STATE_OF_PROJECT/2025-06-17-15-08-solid-progress.md +149 -0
- package/claude-code/aiwf/en/.aiwf/10_STATE_OF_PROJECT/index.json +5 -0
- package/claude-code/aiwf/en/.aiwf/10_STATE_OF_PROJECT/sync-index.js +78 -0
- package/claude-code/aiwf/en/.aiwf/98_PROMPTS/github_integration.md +130 -0
- package/claude-code/aiwf/en/.aiwf/98_PROMPTS/useful-prompts.md +31 -0
- package/claude-code/aiwf/en/.aiwf/98_PROMPTS/vibe-front-prompts.md +89 -0
- package/claude-code/{simone/.simone → aiwf/en/.aiwf}/99_TEMPLATES/task_template.md +1 -0
- package/claude-code/{simone/.simone/CLAUDE.MD → aiwf/en/.aiwf/CLAUDE.md} +13 -4
- package/claude-code/{simone/.simone → aiwf/en/.aiwf}/README.md +6 -6
- package/claude-code/aiwf/en/.claude/CLAUDE_BE.md +276 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_changelog.md +82 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_code_review.md +88 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_commit.md +160 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_create_general_task.md +147 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_create_milestone_plan.md +194 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_create_prd.md +272 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_create_sprint_tasks.md +189 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_create_sprints_from_milestone.md +121 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_discuss_review.md +29 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_do_task.md +109 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_docs.md +225 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_infinite.md +202 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_initialize.md +134 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_issue_create.md +65 -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_mermaid.md +272 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_pr_create.md +76 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_prime.md +9 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_project_review.md +261 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_switch_language.md +160 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_test.md +125 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_testing_review.md +198 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_tm-run-all-subtask.md +206 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_ultrathink_code_advanced.md +460 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_ultrathink_code_basic.md +165 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_ultrathink_general.md +362 -0
- package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_yolo.md +300 -0
- package/claude-code/aiwf/en/.claude/mcp.json +31 -0
- package/claude-code/aiwf/en/.claude/settings.json +102 -0
- package/claude-code/aiwf/ko/.aiwf/00_PROJECT_MANIFEST.md +49 -0
- package/claude-code/aiwf/ko/.aiwf/01_PROJECT_DOCS/ARCHITECTURE.md +55 -0
- package/claude-code/aiwf/ko/.aiwf/02_REQUIREMENTS/CLAUDE.md +78 -0
- package/claude-code/aiwf/ko/.aiwf/02_REQUIREMENTS/M01_Backend_Setup/M01_milestone_meta.md +42 -0
- package/claude-code/aiwf/ko/.aiwf/02_REQUIREMENTS/M01_Backend_Setup/PRD_AMEND_01_Auth_Flow_Update.md +73 -0
- package/claude-code/aiwf/ko/.aiwf/02_REQUIREMENTS/M01_Backend_Setup/PRD_Backend_Setup.md +98 -0
- package/claude-code/aiwf/ko/.aiwf/02_REQUIREMENTS/M01_Backend_Setup/SPECS_API_V1.md +232 -0
- package/claude-code/aiwf/ko/.aiwf/03_SPRINTS/CLAUDE.md +83 -0
- package/claude-code/aiwf/ko/.aiwf/03_SPRINTS/S01_M01_Initial_API/S01_sprint_meta.md +49 -0
- package/claude-code/aiwf/ko/.aiwf/03_SPRINTS/S01_M01_Initial_API/T01_S01_Setup_Project_Structure.md +60 -0
- package/claude-code/aiwf/ko/.aiwf/04_GENERAL_TASKS/CLAUDE.md +96 -0
- package/claude-code/aiwf/ko/.aiwf/04_GENERAL_TASKS/T002_API_Rate_Limiting.md +54 -0
- package/claude-code/aiwf/ko/.aiwf/04_GENERAL_TASKS/TX001_Refactor_Logging_Module.md +58 -0
- package/claude-code/aiwf/ko/.aiwf/05_ARCHITECTURAL_DECISIONS/ADR001_Chosen_Database_System.md +119 -0
- package/claude-code/aiwf/ko/.aiwf/05_ARCHITECTURAL_DECISIONS/ADR002_API_Authentication_Method.md +124 -0
- package/claude-code/aiwf/ko/.aiwf/10_STATE_OF_PROJECT/2025-06-12-12-00-needs-focus.md +139 -0
- package/claude-code/aiwf/ko/.aiwf/10_STATE_OF_PROJECT/2025-06-12-12-00-test-alignment.md +155 -0
- package/claude-code/aiwf/ko/.aiwf/10_STATE_OF_PROJECT/2025-06-13-00-50-solid-progress.md +122 -0
- package/claude-code/aiwf/ko/.aiwf/10_STATE_OF_PROJECT/2025-06-14-08-30-infrastructure-challenges.md +141 -0
- package/claude-code/aiwf/ko/.aiwf/10_STATE_OF_PROJECT/2025-06-16-21-48-critical-foundation-issues.md +177 -0
- package/claude-code/aiwf/ko/.aiwf/10_STATE_OF_PROJECT/2025-06-17-15-08-solid-progress.md +149 -0
- package/claude-code/aiwf/ko/.aiwf/10_STATE_OF_PROJECT/index.json +5 -0
- package/claude-code/aiwf/ko/.aiwf/10_STATE_OF_PROJECT/sync-index.js +78 -0
- package/claude-code/aiwf/ko/.aiwf/98_PROMPTS/github_integration.md +130 -0
- package/claude-code/aiwf/ko/.aiwf/98_PROMPTS/useful-prompts.md +31 -0
- package/claude-code/aiwf/ko/.aiwf/98_PROMPTS/vibe-front-prompts.md +89 -0
- package/claude-code/aiwf/ko/.aiwf/99_TEMPLATES/adr_template.md +49 -0
- package/claude-code/aiwf/ko/.aiwf/99_TEMPLATES/milestone_meta_template.md +25 -0
- package/claude-code/aiwf/ko/.aiwf/99_TEMPLATES/project_manifest_template.md +39 -0
- package/claude-code/aiwf/ko/.aiwf/99_TEMPLATES/sprint_meta_template.md +23 -0
- package/claude-code/aiwf/ko/.aiwf/99_TEMPLATES/task_template.md +36 -0
- package/claude-code/aiwf/ko/.aiwf/CLAUDE.md +76 -0
- package/claude-code/aiwf/ko/.aiwf/README.md +97 -0
- package/claude-code/aiwf/ko/.claude/CLAUDE_BE.md +276 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_changelog.md +82 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_code_review.md +88 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_commit.md +160 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_create_general_task.md +147 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_create_milestone_plan.md +194 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_create_prd.md +280 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_create_sprint_tasks.md +189 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_create_sprints_from_milestone.md +121 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_discuss_review.md +29 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_do_task.md +109 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_docs.md +225 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_infinite.md +202 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_initialize.md +134 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_issue_create.md +65 -0
- 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_mermaid.md +272 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_pr_create.md +76 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_prime.md +9 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_project_review.md +261 -0
- 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 +124 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_testing_review.md +198 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_tm-run-all-subtask.md +210 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_ultrathink_code_advanced.md +460 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_ultrathink_code_basic.md +165 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_ultrathink_general.md +305 -0
- package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_yolo.md +300 -0
- package/claude-code/aiwf/ko/.claude/mcp.json +31 -0
- package/claude-code/aiwf/ko/.claude/settings.json +102 -0
- package/{AI-WORKFLOW.md → docs/AI-WORKFLOW.ko.md} +38 -24
- package/docs/AI-WORKFLOW.md +299 -0
- package/docs/COMMANDS_GUIDE.ko.md +727 -0
- package/docs/COMMANDS_GUIDE.md +726 -0
- package/docs/CONTRIBUTING.md +406 -0
- package/docs/DEVELOPMENT_GUIDE.md +727 -0
- package/docs/Enhanced_Installation_Flow_Design.md +498 -0
- package/docs/PRD.ko.md +148 -0
- package/docs/PRD.md +150 -0
- package/docs/moonklabs-metadata-system-prd.md +127 -0
- package/index.js +1493 -122
- package/jest.config.js +4 -0
- package/language-cli.js +279 -0
- package/language-utils.js +330 -0
- package/package.json +23 -10
- 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/COMMANDS_GUIDE.md +0 -462
- package/PRD.ko.md +0 -96
- package/PRD.md +0 -98
- package/claude-code/simone/.simone/04_GENERAL_TASKS/CLAUDE.MD +0 -51
- package/claude-code/simone/CHANGELOG.md +0 -71
- package/claude-code/simone/LICENSE +0 -21
- package/claude-code/simone/README.md +0 -219
- package/claude-code/simone/SYNC_GUIDE.md +0 -172
- package/claude-code/simone/sync-simone.sh +0 -138
- /package/claude-code/{simone/.simone → aiwf/en/.aiwf}/00_PROJECT_MANIFEST.md +0 -0
- /package/claude-code/{simone/.simone → aiwf/en/.aiwf}/02_REQUIREMENTS/CLAUDE.md +0 -0
- /package/claude-code/{simone/.simone → aiwf/en/.aiwf}/02_REQUIREMENTS/M01_Backend_Setup/PRD_Backend_Setup.md +0 -0
- /package/claude-code/{simone/.simone → aiwf/en/.aiwf}/02_REQUIREMENTS/M01_Backend_Setup/SPECS_API_V1.md +0 -0
- /package/claude-code/{simone/.simone → aiwf/en/.aiwf}/99_TEMPLATES/adr_template.md +0 -0
- /package/claude-code/{simone/.simone → aiwf/en/.aiwf}/99_TEMPLATES/milestone_meta_template.md +0 -0
- /package/claude-code/{simone/.simone → aiwf/en/.aiwf}/99_TEMPLATES/project_manifest_template.md +0 -0
- /package/claude-code/{simone/.simone → aiwf/en/.aiwf}/99_TEMPLATES/sprint_meta_template.md +0 -0
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
# 일반 태스크 생성
|
|
2
|
+
|
|
3
|
+
프로젝트 문서화 표준을 따라 `.aiwf/04_GENERAL_TASKS/`에 새로운 일반 태스크를 생성합니다.
|
|
4
|
+
|
|
5
|
+
## 정확히 다음 10개 항목으로 할 일 목록을 생성하세요
|
|
6
|
+
|
|
7
|
+
1. 태스크 인수 분석 및 태스크 ID 결정
|
|
8
|
+
2. 프로젝트 컨텍스트 및 문서화 요구사항 로드
|
|
9
|
+
3. 중복 작업이 없는지 확인
|
|
10
|
+
4. 구현 컨텍스트를 위한 코드베이스 연구
|
|
11
|
+
5. 표준 템플릿을 사용하여 태스크 파일 생성
|
|
12
|
+
6. 적절한 컨텍스트로 태스크 세부사항 작성
|
|
13
|
+
7. 기술 가이드라인 및 코드베이스 참조 추가
|
|
14
|
+
8. 새 태스크로 프로젝트 매니페스트 업데이트
|
|
15
|
+
9. 아키텍처와의 태스크 정렬 검증
|
|
16
|
+
10. 최종 품질 검사 및 보고 수행
|
|
17
|
+
|
|
18
|
+
## 모든 할 일 항목에 대한 세부사항
|
|
19
|
+
|
|
20
|
+
### 1. 태스크 인수 분석 및 태스크 ID 결정
|
|
21
|
+
|
|
22
|
+
인수 형식: `<태스크 제목 또는 설명>`
|
|
23
|
+
|
|
24
|
+
- 인수가 비어있는 경우, 사용자에게 태스크 세부사항을 요청합니다
|
|
25
|
+
- `.aiwf/04_GENERAL_TASKS/`의 기존 태스크를 확인하여 순차적 태스크 ID를 생성합니다
|
|
26
|
+
- 가장 높은 태스크 번호(T###)를 찾아 1을 증가시킵니다
|
|
27
|
+
- 형식: `T###_<태스크_제목_스네이크_케이스>.md`
|
|
28
|
+
- **중요**: 태스크 ID는 빈 공간 없이 순차적이어야 합니다
|
|
29
|
+
|
|
30
|
+
### 2. 프로젝트 컨텍스트 및 문서화 요구사항 로드
|
|
31
|
+
|
|
32
|
+
**병렬 서브에이전트**를 사용하여 프로젝트 컨텍스트를 읽고 이해하세요:
|
|
33
|
+
|
|
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
|
+
|
|
41
|
+
### 3. 중복 작업이 없는지 확인
|
|
42
|
+
|
|
43
|
+
**포괄적으로 검색**하여 중복 가능성을 찾으세요:
|
|
44
|
+
|
|
45
|
+
- `.aiwf/04_GENERAL_TASKS/`의 모든 파일 확인
|
|
46
|
+
- `.aiwf/03_SPRINTS/*/T*.md`의 스프린트 태스크 검색
|
|
47
|
+
- 완료된 마일스톤에서 유사한 기능 찾기
|
|
48
|
+
- **중요**: 중복이 발견되면 중단하고 파일 참조와 함께 사용자에게 보고
|
|
49
|
+
|
|
50
|
+
### 4. 구현 컨텍스트를 위한 코드베이스 연구
|
|
51
|
+
|
|
52
|
+
태스크 설명을 바탕으로 **병렬 서브에이전트**를 사용하여:
|
|
53
|
+
|
|
54
|
+
- 태스크가 요구하는 것과 유사한 기존 패턴 검색
|
|
55
|
+
- 영향을 받을 주요 인터페이스, 클래스 또는 모듈 식별
|
|
56
|
+
- 코드베이스에서 유사한 구현 예제 찾기
|
|
57
|
+
- 관련 테스트 패턴 및 기존 테스트 파일 위치 파악
|
|
58
|
+
- 사용되는 오류 처리 및 로깅 패턴 발견
|
|
59
|
+
- 기존 코드와의 통합 지점 매핑
|
|
60
|
+
- **문서화**: 태스크에 포함할 모든 발견사항 기록
|
|
61
|
+
|
|
62
|
+
### 5. 표준 템플릿을 사용하여 태스크 파일 생성
|
|
63
|
+
|
|
64
|
+
`.aiwf/99_TEMPLATES/task_template.md`의 태스크 템플릿을 기본 구조로 **사용**하세요:
|
|
65
|
+
|
|
66
|
+
- 템플릿 구조를 정확히 복사
|
|
67
|
+
- 파일을 `.aiwf/04_GENERAL_TASKS/T###_<제목>.md`에 배치
|
|
68
|
+
- 타임스탬프 포함: 생성 시간을 위해 `date '+%Y-%m-%d %H:%M:%S'` 실행
|
|
69
|
+
- **중요**: 템플릿 구조를 정확히 따르세요 - 변경 없음
|
|
70
|
+
|
|
71
|
+
### 6. 적절한 컨텍스트로 태스크 세부사항 작성
|
|
72
|
+
|
|
73
|
+
태스크 파일을 다음 내용으로 채우세요:
|
|
74
|
+
|
|
75
|
+
- **제목**: 명확하고 실행 가능한 태스크 이름
|
|
76
|
+
- **컨텍스트**: 아키텍처 문서 및 프로젝트 상태에 연결
|
|
77
|
+
- **요구사항**: 구체적이고 측정 가능한 결과
|
|
78
|
+
- **승인 기준**: 완료에 대한 명확한 정의
|
|
79
|
+
- **종속성**: 관련 스프린트/마일스톤 참조
|
|
80
|
+
- **구현 노트**: 아키텍처와 일치하는 기술적 접근법
|
|
81
|
+
- **중요**: 모든 내용은 기존 문서를 참조해야 합니다
|
|
82
|
+
|
|
83
|
+
### 7. 기술 가이드라인 및 코드베이스 참조 추가
|
|
84
|
+
|
|
85
|
+
**기술 가이드라인 섹션:**
|
|
86
|
+
|
|
87
|
+
- 4단계에서 발견한 주요 인터페이스 및 통합 지점
|
|
88
|
+
- 코드베이스의 구체적인 import 및 모듈 참조
|
|
89
|
+
- 따라야 할 기존 패턴 (파일 참조 포함)
|
|
90
|
+
- 작업할 데이터베이스 모델 또는 API 계약
|
|
91
|
+
- 유사한 코드에서 사용되는 오류 처리 접근법
|
|
92
|
+
- 코드베이스에서 발견된 테스트 패턴
|
|
93
|
+
|
|
94
|
+
**구현 노트 섹션:**
|
|
95
|
+
|
|
96
|
+
- 연구를 바탕으로 한 단계별 구현 접근법
|
|
97
|
+
- 존중해야 할 주요 아키텍처 결정사항 (ADR 참조)
|
|
98
|
+
- 수정하거나 확장할 구체적인 파일 및 함수
|
|
99
|
+
- 기존 테스트 패턴을 바탕으로 한 테스트 접근법
|
|
100
|
+
- 관련성이 있는 경우 성능 고려사항
|
|
101
|
+
|
|
102
|
+
**중요**: 코드 예제를 포함하지 마세요. 구조적 가이드라인과 파일 참조만 제공하세요.
|
|
103
|
+
|
|
104
|
+
### 8. 새 태스크로 프로젝트 매니페스트 업데이트
|
|
105
|
+
|
|
106
|
+
`.aiwf/00_PROJECT_MANIFEST.md` **업데이트**:
|
|
107
|
+
|
|
108
|
+
- "## 일반 태스크" 섹션에 태스크 추가
|
|
109
|
+
- 형식: `- [ ] T###: [태스크 제목] - 상태: 시작되지 않음`
|
|
110
|
+
- 알파벳/숫자 순서 유지
|
|
111
|
+
- 태스크 파일에 링크: `[T###](04_GENERAL_TASKS/T###_제목.md)`
|
|
112
|
+
- **중요**: 기존 내용을 모두 보존하세요
|
|
113
|
+
|
|
114
|
+
### 9. 아키텍처와의 태스크 정렬 검증
|
|
115
|
+
|
|
116
|
+
태스크 준수사항 **확인**:
|
|
117
|
+
|
|
118
|
+
- 태스크가 아키텍처 원칙과 모순되지 않는지 확인
|
|
119
|
+
- 구현 접근법이 확립된 패턴을 사용하는지 보장
|
|
120
|
+
- 종속성이 존재하고 올바른지 검증
|
|
121
|
+
- 태스크 범위가 적절한지 확인 (너무 광범위하거나 좁지 않게)
|
|
122
|
+
- 기술 가이드라인이 기존 코드베이스 패턴과 일치하는지 확인
|
|
123
|
+
- **중요**: 문서가 진실의 원천입니다 - 어떤 편차든 정당화가 필요합니다
|
|
124
|
+
|
|
125
|
+
### 10. 최종 품질 검사 및 보고 수행
|
|
126
|
+
|
|
127
|
+
**품질 검사**:
|
|
128
|
+
|
|
129
|
+
- 태스크 파일이 템플릿을 완전히 따르는지 확인
|
|
130
|
+
- 새로운 기술 가이드라인을 포함한 모든 섹션이 적절히 작성되었는지 확인
|
|
131
|
+
- 문서 및 코드베이스에 대한 참조가 유효한지 확인
|
|
132
|
+
- 태스크 ID가 순차적이고 고유한지 확인
|
|
133
|
+
- 매니페스트가 올바르게 업데이트되었는지 확인
|
|
134
|
+
- 기술 가이드라인이 실제 파일과 패턴을 참조하는지 확인
|
|
135
|
+
- 범위 확장이나 아키텍처 위반이 없는지 확인
|
|
136
|
+
|
|
137
|
+
**출력 형식**:
|
|
138
|
+
|
|
139
|
+
```markdown
|
|
140
|
+
✅ **생성**: T###\_<제목>.md
|
|
141
|
+
📋 **유형**: 일반 태스크
|
|
142
|
+
🎯 **목적**: [한 줄 요약]
|
|
143
|
+
📚 **참조**: [주요 문서 링크]
|
|
144
|
+
🔧 **주요 통합 지점**: [수정할 주요 파일/모듈]
|
|
145
|
+
🧪 **테스트 접근법**: [따를 테스트 패턴]
|
|
146
|
+
⏭️ **다음 단계**: 태스크 세부사항을 검토하고 `/do_task T###`를 실행하여 시작하세요
|
|
147
|
+
```
|
|
@@ -0,0 +1,194 @@
|
|
|
1
|
+
# 신규 마일스톤 계획 및 생성
|
|
2
|
+
|
|
3
|
+
상호작용적이고 적응적인 프로세스를 통해 적절한 구조, 문서화, 프로젝트 통합을 갖춘 새로운 마일스톤을 생성합니다.
|
|
4
|
+
|
|
5
|
+
## 정확히 다음 8개 항목으로 할 일 목록을 생성하세요
|
|
6
|
+
|
|
7
|
+
1. 인수 분석 및 프로젝트 컨텍스트 파악
|
|
8
|
+
2. 상호작용적 마일스톤 범위 및 정의
|
|
9
|
+
3. 마일스톤 구조 및 명명 결정
|
|
10
|
+
4. 마일스톤 디렉토리 및 메타 파일 생성
|
|
11
|
+
5. 지원 문서 생성 가이드
|
|
12
|
+
6. 마일스톤으로 프로젝트 매니페스트 업데이트
|
|
13
|
+
7. 마일스톤 일관성 및 정렬 검증
|
|
14
|
+
8. 마일스톤 생성 및 다음 단계 보고
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## 1. 인수 분석 및 프로젝트 컨텍스트 파악
|
|
19
|
+
|
|
20
|
+
**중요**: 추가 인수가 제공됩니다: <$ARGUMENTS>
|
|
21
|
+
|
|
22
|
+
**병렬 서브에이전트**를 사용하여 다음 작업을 수행하세요:
|
|
23
|
+
|
|
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
|
+
|
|
31
|
+
## 2. 상호작용적 마일스톤 범위 및 정의
|
|
32
|
+
|
|
33
|
+
**대화형 마일스톤 정의:**
|
|
34
|
+
|
|
35
|
+
인수가 제공된 경우:
|
|
36
|
+
|
|
37
|
+
- "다음을 위한 마일스톤을 생성하고자 하시는군요: [인수]"
|
|
38
|
+
- "범위를 더 잘 이해해보겠습니다..."
|
|
39
|
+
|
|
40
|
+
인수가 없는 경우:
|
|
41
|
+
|
|
42
|
+
- "현재 프로젝트 상태를 바탕으로 다음 마일스톤을 정의해보겠습니다"
|
|
43
|
+
- "현재 [현재 마일스톤]에 있는 것으로 보입니다 - 다음에는 무엇에 집중해야 할까요?"
|
|
44
|
+
|
|
45
|
+
**상호작용 질문 (컨텍스트에 따라 조정):**
|
|
46
|
+
|
|
47
|
+
- "이 마일스톤의 주요 목표는 무엇인가요?"
|
|
48
|
+
- "완료되어야 할 핵심 결과물은 무엇인가요?"
|
|
49
|
+
- "특정한 기술적 도전이나 요구사항이 있나요?"
|
|
50
|
+
- "이 마일스톤이 프로젝트를 장기 비전으로 어떻게 발전시킬까요?"
|
|
51
|
+
- "이 마일스톤의 '완료'는 어떤 모습일까요?"
|
|
52
|
+
|
|
53
|
+
**대화형이고 적응적으로 유지** - 심문하지 말고 필요한 것만 수집하세요
|
|
54
|
+
|
|
55
|
+
## 3. 마일스톤 구조 및 명명 결정
|
|
56
|
+
|
|
57
|
+
**마일스톤 세부사항 생성:**
|
|
58
|
+
|
|
59
|
+
- 기존 마일스톤을 스캔하여 다음 마일스톤 번호 (M##) 결정
|
|
60
|
+
- 사용자 입력에서 설명적 마일스톤 이름 생성
|
|
61
|
+
- 형식: `M##_마일스톤_이름_스네이크_케이스`
|
|
62
|
+
- **중요**: 중복된 마일스톤 번호가 없도록 보장
|
|
63
|
+
- AIWF 규칙을 따르는 명명 검증 (밑줄, 공백 없음)
|
|
64
|
+
|
|
65
|
+
**사용자와 확인:**
|
|
66
|
+
|
|
67
|
+
- "마일스톤을 생성하겠습니다: M##\_[이름] - 괜찮으신가요?"
|
|
68
|
+
- 필요시 사용자가 이름이나 번호를 조정할 수 있도록 허용
|
|
69
|
+
|
|
70
|
+
## 4. 마일스톤 디렉토리 및 메타 파일 생성
|
|
71
|
+
|
|
72
|
+
**마일스톤 구조 생성:**
|
|
73
|
+
|
|
74
|
+
- 디렉토리 생성: `.aiwf/02_REQUIREMENTS/M##_마일스톤_이름/`
|
|
75
|
+
- `.aiwf/99_TEMPLATES/milestone_meta_template.md`에서 템플릿 복사
|
|
76
|
+
- 마일스톤 메타 파일 생성: `M##_milestone_meta.md`
|
|
77
|
+
|
|
78
|
+
**마일스톤 메타 파일 채우기:**
|
|
79
|
+
|
|
80
|
+
- YAML 프론트매터 작성:
|
|
81
|
+
- `milestone_id: M##`
|
|
82
|
+
- `title: [마일스톤 이름]`
|
|
83
|
+
- `status: pending`
|
|
84
|
+
- `last_updated: [현재 타임스탬프 YYYY-MM-DD HH:MM]`
|
|
85
|
+
- 사용자 입력을 구조화된 섹션으로 변환:
|
|
86
|
+
- **목표**: 사용자 논의에서 명확한 목적
|
|
87
|
+
- **핵심 문서**: PRD 및 SPECS 파일 플레이스홀더
|
|
88
|
+
- **완료 정의**: 사용자 입력에서 구체적이고 측정 가능한 기준
|
|
89
|
+
- **노트/컨텍스트**: 사용자 논의에서 추가 컨텍스트
|
|
90
|
+
|
|
91
|
+
## 5. 지원 문서 생성 가이드
|
|
92
|
+
|
|
93
|
+
**상호작용적 문서 계획:**
|
|
94
|
+
|
|
95
|
+
마일스톤 범위를 기반으로 필요한 문서 제안:
|
|
96
|
+
|
|
97
|
+
- "이 마일스톤에는 다음이 필요할 것 같습니다:"
|
|
98
|
+
- "□ PRD\_[마일스톤_이름].md - 제품 요구사항"
|
|
99
|
+
- "□ SPECS\_[기술_영역].md - 기술 사양"
|
|
100
|
+
- "□ 도메인별 문서"
|
|
101
|
+
|
|
102
|
+
**사용자에게 문의:**
|
|
103
|
+
|
|
104
|
+
- "지금 이 문서들의 시작 템플릿을 만들어드릴까요?"
|
|
105
|
+
- "아니면 필요에 따라 수동으로 만드시겠어요?"
|
|
106
|
+
|
|
107
|
+
**사용자가 템플릿 생성을 원하는 경우:**
|
|
108
|
+
|
|
109
|
+
- 마일스톤별 섹션이 포함된 기본 PRD 템플릿 생성
|
|
110
|
+
- 기술 마일스톤인 경우 SPECS 템플릿 생성
|
|
111
|
+
- 문서 간 적절한 상호참조 포함
|
|
112
|
+
- **중요**: 과도하게 엔지니어링하지 말고 유용한 시작점 생성
|
|
113
|
+
|
|
114
|
+
**사용자가 수동을 선호하는 경우:**
|
|
115
|
+
|
|
116
|
+
- 마일스톤 메타에 예상되는 문서 기록
|
|
117
|
+
- 언제/어떻게 생성할지에 대한 가이드 제공
|
|
118
|
+
|
|
119
|
+
## 6. 마일스톤으로 프로젝트 매니페스트 업데이트
|
|
120
|
+
|
|
121
|
+
`.aiwf/00_PROJECT_MANIFEST.md` **업데이트**:
|
|
122
|
+
|
|
123
|
+
- 마일스톤 섹션에 마일스톤 추가:
|
|
124
|
+
- 형식: `- [ ] M##: [마일스톤 이름] - 상태: 계획 중`
|
|
125
|
+
- 링크: `[M##](02_REQUIREMENTS/M##_마일스톤_이름/M##_milestone_meta.md)`
|
|
126
|
+
- 프로젝트 메타데이터 업데이트:
|
|
127
|
+
- 활성 마일스톤인 경우 `current_milestone` 설정
|
|
128
|
+
- `highest_milestone` 번호 업데이트
|
|
129
|
+
- `last_updated` 타임스탬프 업데이트
|
|
130
|
+
- **중요**: 모든 기존 내용과 형식 보존
|
|
131
|
+
|
|
132
|
+
## 7. 마일스톤 일관성 및 정렬 검증
|
|
133
|
+
|
|
134
|
+
마일스톤 품질 **확인**:
|
|
135
|
+
|
|
136
|
+
- 마일스톤이 프로젝트 아키텍처 및 비전과 일치하는지 확인
|
|
137
|
+
- 완료 정의가 구체적이고 측정 가능한지 보장
|
|
138
|
+
- 마일스톤 범위가 적절한지 검증 (너무 광범위하거나 좁지 않게)
|
|
139
|
+
- 마일스톤이 명시된 목표를 향해 프로젝트를 발전시키는지 확인
|
|
140
|
+
- 마일스톤 번호 및 명명이 규칙을 따르는지 확인
|
|
141
|
+
- 생성된 모든 파일이 템플릿 구조를 따르는지 검증
|
|
142
|
+
- **중요**: 마일스톤은 독립적으로 가치 있고 달성 가능해야 함
|
|
143
|
+
|
|
144
|
+
**고려사항**:
|
|
145
|
+
|
|
146
|
+
- 현재 프로젝트 상태를 고려할 때 이 마일스톤이 의미가 있는가?
|
|
147
|
+
- 목표가 현실적이고 잘 범위가 정해져 있는가?
|
|
148
|
+
- 완료 정의가 언제 완료되었는지 알 수 있을 만큼 명확한가?
|
|
149
|
+
- 이 마일스톤이 향후 마일스톤을 논리적으로 설정하는가?
|
|
150
|
+
|
|
151
|
+
## 8. 마일스톤 생성 및 다음 단계 보고
|
|
152
|
+
|
|
153
|
+
**출력 형식**:
|
|
154
|
+
|
|
155
|
+
```markdown
|
|
156
|
+
✅ **마일스톤 생성됨**: M##\_[마일스톤_이름]
|
|
157
|
+
|
|
158
|
+
📋 **마일스톤 세부사항**:
|
|
159
|
+
|
|
160
|
+
- ID: M##
|
|
161
|
+
- 제목: [마일스톤 이름]
|
|
162
|
+
- 상태: 계획 중
|
|
163
|
+
- 초점: [주요 목표의 한 줄 요약]
|
|
164
|
+
|
|
165
|
+
📚 **생성된 문서**:
|
|
166
|
+
|
|
167
|
+
- 마일스톤 메타: `02_REQUIREMENTS/M##_[이름]/M##_milestone_meta.md`
|
|
168
|
+
- [생성된 추가 문서들]
|
|
169
|
+
|
|
170
|
+
🎯 **완료 정의**:
|
|
171
|
+
|
|
172
|
+
- [마일스톤의 핵심 DoD 기준]
|
|
173
|
+
|
|
174
|
+
📈 **프로젝트 영향**:
|
|
175
|
+
|
|
176
|
+
- 프로젝트를 M[이전]에서 M##로 업데이트
|
|
177
|
+
- 다음을 향한 발전: [프로젝트 비전 정렬]
|
|
178
|
+
|
|
179
|
+
⏭️ **권장 다음 단계**:
|
|
180
|
+
|
|
181
|
+
- 마일스톤 세부사항 검토: `02_REQUIREMENTS/M##_[이름]/M##_milestone_meta.md`
|
|
182
|
+
- 계획된 대로 지원 문서 생성
|
|
183
|
+
- 스프린트로 분해: `/project:aiwf:create_sprints_from_milestone M##`
|
|
184
|
+
- 명확해지는 대로 구체적인 요구사항으로 업데이트
|
|
185
|
+
|
|
186
|
+
🎯 **개발 준비**: 구현 계획을 시작할 준비가 되면 `/project:aiwf:create_sprints_from_milestone M##` 사용
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
**중요 참고사항**:
|
|
190
|
+
|
|
191
|
+
- 마일스톤 범위는 집중되고 달성 가능하게 유지
|
|
192
|
+
- 완료 정의는 측정 가능해야 함
|
|
193
|
+
- 지원 문서는 필요에 따라 생성 가능
|
|
194
|
+
- 마일스톤 계획은 반복적 - 더 많이 배우면서 개선
|
|
@@ -0,0 +1,280 @@
|
|
|
1
|
+
# Generate Product Documentation Workflow
|
|
2
|
+
|
|
3
|
+
이 규칙은 AI가 몇 가지 핵심 질문을 통해 입력을 수집한 뒤, PRD → IA → UCD → UI/UX 문서를 **순차적으로** 생성하도록 안내합니다. 모든 출력은 **Markdown** 형식을 사용하며 **한국어**로 작성됩니다.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 1. 질문 단계
|
|
8
|
+
|
|
9
|
+
AI는 다음 정보를 **질문**을 통해 사용자에게서 수집합니다.
|
|
10
|
+
|
|
11
|
+
1. `<product-overview>`
|
|
12
|
+
2. `<references>` (URL 목록)
|
|
13
|
+
3. `<must-features>` (필수 기능 목록)
|
|
14
|
+
4. `<target-user-persona>`
|
|
15
|
+
5. `<target-platforms>`
|
|
16
|
+
6. `<storage-type>`
|
|
17
|
+
7. `<tech-stack>`
|
|
18
|
+
|
|
19
|
+
> ⚠️ 모든 질문은 한글로 하며, 필요 시 추가적인 참고 서비스·경쟁 제품 정보를 요청합니다.
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## 2. PRD 작성 단계
|
|
24
|
+
|
|
25
|
+
사용자로부터 모든 입력을 받은 뒤, 아래 **샘플 프롬프트** 구조를 참고하여 PRD를 생성합니다.
|
|
26
|
+
|
|
27
|
+
```prompt
|
|
28
|
+
Write a PRD document based on the following information:
|
|
29
|
+
<product-overview>
|
|
30
|
+
${productOverview}
|
|
31
|
+
</product-overview>
|
|
32
|
+
<references>
|
|
33
|
+
${references}
|
|
34
|
+
</references>
|
|
35
|
+
<must-features>
|
|
36
|
+
${mustFeatures}
|
|
37
|
+
</must-features>
|
|
38
|
+
<target-user-persona>
|
|
39
|
+
${persona}
|
|
40
|
+
</target-user-persona>
|
|
41
|
+
<target-platforms>
|
|
42
|
+
${platforms}
|
|
43
|
+
</target-platforms>
|
|
44
|
+
<storage-type>
|
|
45
|
+
${storageType}
|
|
46
|
+
</storage-type>
|
|
47
|
+
<tech-stack>
|
|
48
|
+
${techStack}
|
|
49
|
+
</tech-stack>
|
|
50
|
+
PRD must include the following contents:
|
|
51
|
+
<table-of-contents>
|
|
52
|
+
- Detailed product description
|
|
53
|
+
- Reference Services with detailed rationale
|
|
54
|
+
- Core features and specifications
|
|
55
|
+
- Suggested additional features
|
|
56
|
+
- User persona and scenarios
|
|
57
|
+
- Technical stack recommendations
|
|
58
|
+
</table-of-contents>
|
|
59
|
+
<response-format>
|
|
60
|
+
Use markdown format
|
|
61
|
+
</response-format>
|
|
62
|
+
<guidelines>
|
|
63
|
+
- Use tables or lists where appropriate to organize information systematically.
|
|
64
|
+
- All user interactions, including inputs and outputs, must be in Korean.
|
|
65
|
+
- Provide accurate answers with reliable references
|
|
66
|
+
- Write in Korean
|
|
67
|
+
- Clearly separate each section
|
|
68
|
+
- Collect additional reference services and provide detailed rationale
|
|
69
|
+
- Do not include detailed data structure and storage design
|
|
70
|
+
</guidelines>
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
문서에 포함해야 할 **추가 지침**:
|
|
74
|
+
|
|
75
|
+
- 표와 리스트를 활용해 정보를 구조화할 것.
|
|
76
|
+
- 참고 서비스는 최소 3개 이상, 각 서비스 사용 이유를 2~3줄로 기술.
|
|
77
|
+
|
|
78
|
+
PRD 작성을 완료하면 "✅ PRD 완료" 메시지와 함께 IA 단계 진행 여부를 묻는 **한글** 질문을 덧붙입니다.
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## 3. IA(Information Architecture) 작성 단계
|
|
83
|
+
|
|
84
|
+
사용자가 **계속**을 선택하면 IA 문서를 생성합니다.
|
|
85
|
+
|
|
86
|
+
IA 문서는 다음을 포함합니다:
|
|
87
|
+
|
|
88
|
+
1. **사이트맵** – 트리 형태로 표현
|
|
89
|
+
2. **콘텐츠 인벤토리** – 페이지별 주요 콘텐츠 표
|
|
90
|
+
3. **사용자 흐름** – 순서도(텍스트 기반)로 최소 2개 핵심 시나리오 제공
|
|
91
|
+
4. **내비게이션 구조 및 URL 패턴**
|
|
92
|
+
|
|
93
|
+
문서 형식: Markdown, 한국어
|
|
94
|
+
|
|
95
|
+
### IA 샘플 프롬프트
|
|
96
|
+
|
|
97
|
+
```prompt
|
|
98
|
+
Write an Information Architecture document based on PRD, and following information:
|
|
99
|
+
<navigation-type>
|
|
100
|
+
${navigationType}
|
|
101
|
+
</navigation-type>
|
|
102
|
+
<auth-type>
|
|
103
|
+
${authType}
|
|
104
|
+
</auth-type>
|
|
105
|
+
IA document must include the following contents:
|
|
106
|
+
<table-of-contents>
|
|
107
|
+
- Site Map
|
|
108
|
+
- User Flow
|
|
109
|
+
- Navigation Structure
|
|
110
|
+
- Page Hierarchy
|
|
111
|
+
- Content Organization
|
|
112
|
+
- Interaction Patterns
|
|
113
|
+
- URL Structure
|
|
114
|
+
- Component Hierarchy
|
|
115
|
+
</table-of-contents>
|
|
116
|
+
<response-format>
|
|
117
|
+
Use markdown format
|
|
118
|
+
</response-format>
|
|
119
|
+
<guidelines>
|
|
120
|
+
- Use tables or lists where appropriate to organize information systematically
|
|
121
|
+
- All user interactions, including inputs and outputs, must be in Korean
|
|
122
|
+
- Provide accurate answers with reliable references
|
|
123
|
+
- Write in Korean
|
|
124
|
+
- Clearly separate each section
|
|
125
|
+
- Consider user experience and accessibility
|
|
126
|
+
- Include responsive design considerations
|
|
127
|
+
- Consider SEO best practices
|
|
128
|
+
</guidelines>
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
IA 작성 후 "✅ IA 완료" 메시지와 함께 UCD 단계 진행 여부 질의.
|
|
132
|
+
|
|
133
|
+
---
|
|
134
|
+
|
|
135
|
+
## 4. UCD(User-Centered Design) 작성 단계
|
|
136
|
+
|
|
137
|
+
UCD 문서는 다음을 포함합니다:
|
|
138
|
+
|
|
139
|
+
1. **주요 페르소나 2–3개** – 표로 정리 (목표, 동기, pain point)
|
|
140
|
+
2. **시나리오** – 페르소나별 핵심 사용 시나리오 2개 이상
|
|
141
|
+
3. **요구사항 매트릭스** – 기능 ↔ 페르소나 매핑
|
|
142
|
+
|
|
143
|
+
문서 형식: Markdown, 한국어
|
|
144
|
+
|
|
145
|
+
### UCD 샘플 프롬프트
|
|
146
|
+
|
|
147
|
+
```prompt
|
|
148
|
+
Write a detailed use case document based on PRD, IA, and following information:
|
|
149
|
+
Use case document must include the following contents:
|
|
150
|
+
<table-of-contents>
|
|
151
|
+
- Actor Definitions
|
|
152
|
+
- Use Case Scenarios
|
|
153
|
+
- Main Steps
|
|
154
|
+
- Exception Handling
|
|
155
|
+
- Comprehensive Actor Definitions
|
|
156
|
+
- Detailed Use Case Scenarios
|
|
157
|
+
- Main Steps and Flow of Events
|
|
158
|
+
- Alternative Flows and Edge Cases
|
|
159
|
+
- Preconditions and Postconditions
|
|
160
|
+
- Business Rules and Constraints
|
|
161
|
+
- Exception Handling Procedures
|
|
162
|
+
- User Interface Considerations
|
|
163
|
+
- Data Requirements and Data Flow
|
|
164
|
+
- Security and Privacy Considerations
|
|
165
|
+
</table-of-contents>
|
|
166
|
+
<response-format>
|
|
167
|
+
Use markdown format
|
|
168
|
+
</response-format>
|
|
169
|
+
<guidelines>
|
|
170
|
+
- Use tables or lists where appropriate to organize information systematically
|
|
171
|
+
- All user interactions, including inputs and outputs, must be in Korean
|
|
172
|
+
- Provide accurate answers with reliable references
|
|
173
|
+
- Write in Korean
|
|
174
|
+
- Clearly separate each section
|
|
175
|
+
- Include detailed step-by-step descriptions
|
|
176
|
+
- Consider error cases and alternative flows
|
|
177
|
+
- Include technical considerations
|
|
178
|
+
</guidelines>
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
완료 후 "✅ UCD 완료" 메시지와 함께 UI/UX 단계 진행 여부 질의.
|
|
182
|
+
|
|
183
|
+
---
|
|
184
|
+
|
|
185
|
+
## 5. UI/UX 가이드 작성 단계
|
|
186
|
+
|
|
187
|
+
내용:
|
|
188
|
+
|
|
189
|
+
1. **와이어프레임 설명** – 각 핵심 화면의 레이아웃과 구성 요소(텍스트 설명)
|
|
190
|
+
2. **네비게이션 원칙** – 일관된 UI 패턴 설명
|
|
191
|
+
3. **스타일 가이드 초안** – 컬러 팔레트, 타이포그래피, 컴포넌트 규칙
|
|
192
|
+
4. **접근성 고려사항** – WCAG 2.1 준수 핵심 포인트
|
|
193
|
+
|
|
194
|
+
문서 형식: Markdown, 한국어
|
|
195
|
+
|
|
196
|
+
### UI/UX 샘플 프롬프트
|
|
197
|
+
|
|
198
|
+
```prompt
|
|
199
|
+
<role>
|
|
200
|
+
senior UI/UX designer.
|
|
201
|
+
</role>
|
|
202
|
+
<task>
|
|
203
|
+
Write a comprehensive UI/UX design guide based on the following information:
|
|
204
|
+
</task>
|
|
205
|
+
<design-preferences>
|
|
206
|
+
Theme details: Please analyze the reference service and suggest appropriate:
|
|
207
|
+
- Design style
|
|
208
|
+
- Color scheme
|
|
209
|
+
- Primary colors
|
|
210
|
+
</design-preferences>
|
|
211
|
+
<references>
|
|
212
|
+
${references}
|
|
213
|
+
</references>
|
|
214
|
+
<additional-instructions>
|
|
215
|
+
Please analyze the reference service's design system and suggest appropriate:
|
|
216
|
+
- Overall design style and patterns
|
|
217
|
+
- Color scheme and palette
|
|
218
|
+
- Primary colors
|
|
219
|
+
- Mood and atmosphere
|
|
220
|
+
</additional-instructions>
|
|
221
|
+
Design guide must include the following contents:
|
|
222
|
+
<table-of-contents>
|
|
223
|
+
- Design System Overview
|
|
224
|
+
- Color Palette for tailwindcss (primary, secondary, accent, neutral, etc.)
|
|
225
|
+
- Page Implementations
|
|
226
|
+
detailed design guide for each pages
|
|
227
|
+
- core purpose of the page
|
|
228
|
+
- key components
|
|
229
|
+
- layout structure
|
|
230
|
+
- Layout Components
|
|
231
|
+
- applicable routes
|
|
232
|
+
- core components
|
|
233
|
+
- responsive behavior
|
|
234
|
+
- Interaction Patterns
|
|
235
|
+
- Breakpoints
|
|
236
|
+
</table-of-contents>
|
|
237
|
+
<breakpoints>
|
|
238
|
+
$breakpoints: (
|
|
239
|
+
├── 'mobile': 320px,
|
|
240
|
+
├── 'tablet': 768px,
|
|
241
|
+
├── 'desktop': 1024px,
|
|
242
|
+
└── 'wide': 1440px
|
|
243
|
+
);
|
|
244
|
+
</breakpoints>
|
|
245
|
+
<response-format>
|
|
246
|
+
Use markdown format
|
|
247
|
+
</response-format>
|
|
248
|
+
<guidelines>
|
|
249
|
+
- Use tables or lists where appropriate to organize information systematically
|
|
250
|
+
- All descriptions must be in Korean
|
|
251
|
+
- Considering color scheme, select proper color for each color in tailwindcss palette
|
|
252
|
+
- Provide specific color codes
|
|
253
|
+
- Provide rationale for design decisions
|
|
254
|
+
- Always include responsive design considerations
|
|
255
|
+
- Include all text content in UI
|
|
256
|
+
- If needed, use enough images in each components
|
|
257
|
+
- provide each image's url. Use stock photos from picsum.photos where appropriate, only valid URLs you know exist
|
|
258
|
+
- Write in Korean
|
|
259
|
+
- must handle root route
|
|
260
|
+
- consider proper grid system for all components
|
|
261
|
+
</guidelines>
|
|
262
|
+
```
|
|
263
|
+
|
|
264
|
+
완료 후 "🎉 모든 문서 생성 완료" 메시지와 함께 다음 단계(스프린트/태스크 분해) 안내.
|
|
265
|
+
|
|
266
|
+
---
|
|
267
|
+
|
|
268
|
+
## 6. 스프린트/태스크 분해 준비
|
|
269
|
+
|
|
270
|
+
모든 문서가 완료되면, AI는 `yolo` 또는 `create_sprints_from_milestone` 명령을 사용해 개발 스프린트와 태스크를 자동으로 생성할 수 있음을 사용자에게 알립니다.
|
|
271
|
+
|
|
272
|
+
---
|
|
273
|
+
|
|
274
|
+
### 사용 예
|
|
275
|
+
|
|
276
|
+
1. AI → 질문 단계 진행
|
|
277
|
+
2. 사용자 → 정보 제공
|
|
278
|
+
3. AI → PRD 생성, IA 진행 여부 질문
|
|
279
|
+
4. 사용자 → "계속"
|
|
280
|
+
5. AI → IA 생성, UCD 진행 여부 질문 … 반복
|