aiwf 0.1.0 → 0.3.0

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 (145) hide show
  1. package/CHANGELOG.md +44 -0
  2. package/CLAUDE.md +220 -0
  3. package/LICENSE +1 -1
  4. package/README.ko.md +90 -62
  5. package/README.md +89 -62
  6. package/claude-code/{simone/.simone → aiwf/en/.aiwf}/01_PROJECT_DOCS/ARCHITECTURE.md +1 -1
  7. package/claude-code/{simone/.simone → aiwf/en/.aiwf}/02_REQUIREMENTS/M01_Backend_Setup/M01_milestone_meta.md +5 -1
  8. package/claude-code/{simone/.simone → aiwf/en/.aiwf}/02_REQUIREMENTS/M01_Backend_Setup/PRD_AMEND_01_Auth_Flow_Update.md +5 -1
  9. package/claude-code/{simone/.simone/03_SPRINTS/CLAUDE.MD → aiwf/en/.aiwf/03_SPRINTS/CLAUDE.md} +28 -7
  10. package/claude-code/{simone/.simone → aiwf/en/.aiwf}/03_SPRINTS/S01_M01_Initial_API/S01_sprint_meta.md +8 -1
  11. package/claude-code/{simone/.simone → aiwf/en/.aiwf}/03_SPRINTS/S01_M01_Initial_API/T01_S01_Setup_Project_Structure.md +5 -1
  12. package/claude-code/aiwf/en/.aiwf/04_GENERAL_TASKS/CLAUDE.md +96 -0
  13. package/claude-code/{simone/.simone → aiwf/en/.aiwf}/04_GENERAL_TASKS/T002_API_Rate_Limiting.md +7 -2
  14. package/claude-code/{simone/.simone → aiwf/en/.aiwf}/04_GENERAL_TASKS/TX001_Refactor_Logging_Module.md +7 -2
  15. package/claude-code/{simone/.simone → aiwf/en/.aiwf}/05_ARCHITECTURAL_DECISIONS/ADR001_Chosen_Database_System.md +7 -1
  16. package/claude-code/{simone/.simone → aiwf/en/.aiwf}/05_ARCHITECTURAL_DECISIONS/ADR002_API_Authentication_Method.md +7 -1
  17. package/claude-code/aiwf/en/.aiwf/10_STATE_OF_PROJECT/2025-06-12-12-00-needs-focus.md +139 -0
  18. package/claude-code/aiwf/en/.aiwf/10_STATE_OF_PROJECT/2025-06-12-12-00-test-alignment.md +155 -0
  19. package/claude-code/aiwf/en/.aiwf/10_STATE_OF_PROJECT/2025-06-13-00-50-solid-progress.md +122 -0
  20. package/claude-code/aiwf/en/.aiwf/10_STATE_OF_PROJECT/2025-06-14-08-30-infrastructure-challenges.md +141 -0
  21. package/claude-code/aiwf/en/.aiwf/10_STATE_OF_PROJECT/2025-06-16-21-48-critical-foundation-issues.md +177 -0
  22. package/claude-code/aiwf/en/.aiwf/10_STATE_OF_PROJECT/2025-06-17-15-08-solid-progress.md +149 -0
  23. package/claude-code/aiwf/en/.aiwf/10_STATE_OF_PROJECT/index.json +5 -0
  24. package/claude-code/aiwf/en/.aiwf/10_STATE_OF_PROJECT/sync-index.js +78 -0
  25. package/claude-code/aiwf/en/.aiwf/98_PROMPTS/github_integration.md +130 -0
  26. package/claude-code/aiwf/en/.aiwf/98_PROMPTS/useful-prompts.md +31 -0
  27. package/claude-code/aiwf/en/.aiwf/98_PROMPTS/vibe-front-prompts.md +89 -0
  28. package/claude-code/{simone/.simone → aiwf/en/.aiwf}/99_TEMPLATES/task_template.md +1 -0
  29. package/claude-code/{simone/.simone/CLAUDE.MD → aiwf/en/.aiwf/CLAUDE.md} +13 -4
  30. package/claude-code/{simone/.simone → aiwf/en/.aiwf}/README.md +6 -6
  31. package/claude-code/aiwf/en/.claude/CLAUDE_BE.md +276 -0
  32. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_changelog.md +82 -0
  33. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_code_review.md +88 -0
  34. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_commit.md +160 -0
  35. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_create_general_task.md +147 -0
  36. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_create_milestone_plan.md +194 -0
  37. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_create_prd.md +272 -0
  38. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_create_sprint_tasks.md +189 -0
  39. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_create_sprints_from_milestone.md +121 -0
  40. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_discuss_review.md +29 -0
  41. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_do_task.md +109 -0
  42. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_infinite.md +202 -0
  43. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_initialize.md +134 -0
  44. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_issue_create.md +65 -0
  45. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_mermaid.md +272 -0
  46. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_pr_create.md +76 -0
  47. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_prime.md +9 -0
  48. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_prime_context.md +5 -0
  49. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_project_review.md +261 -0
  50. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_test.md +125 -0
  51. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_testing_review.md +198 -0
  52. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_tm-run-all-subtask.md +206 -0
  53. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_ultrathink_code_advanced.md +460 -0
  54. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_ultrathink_code_basic.md +165 -0
  55. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_ultrathink_general.md +362 -0
  56. package/claude-code/aiwf/en/.claude/commands/aiwf/aiwf_yolo.md +300 -0
  57. package/claude-code/aiwf/en/.claude/mcp.json +31 -0
  58. package/claude-code/aiwf/en/.claude/settings.json +102 -0
  59. package/claude-code/aiwf/ko/.aiwf/00_PROJECT_MANIFEST.md +49 -0
  60. package/claude-code/aiwf/ko/.aiwf/01_PROJECT_DOCS/ARCHITECTURE.md +55 -0
  61. package/claude-code/aiwf/ko/.aiwf/02_REQUIREMENTS/CLAUDE.md +78 -0
  62. package/claude-code/aiwf/ko/.aiwf/02_REQUIREMENTS/M01_Backend_Setup/M01_milestone_meta.md +42 -0
  63. package/claude-code/aiwf/ko/.aiwf/02_REQUIREMENTS/M01_Backend_Setup/PRD_AMEND_01_Auth_Flow_Update.md +73 -0
  64. package/claude-code/aiwf/ko/.aiwf/02_REQUIREMENTS/M01_Backend_Setup/PRD_Backend_Setup.md +98 -0
  65. package/claude-code/aiwf/ko/.aiwf/02_REQUIREMENTS/M01_Backend_Setup/SPECS_API_V1.md +232 -0
  66. package/claude-code/aiwf/ko/.aiwf/03_SPRINTS/CLAUDE.md +83 -0
  67. package/claude-code/aiwf/ko/.aiwf/03_SPRINTS/S01_M01_Initial_API/S01_sprint_meta.md +49 -0
  68. package/claude-code/aiwf/ko/.aiwf/03_SPRINTS/S01_M01_Initial_API/T01_S01_Setup_Project_Structure.md +60 -0
  69. package/claude-code/aiwf/ko/.aiwf/04_GENERAL_TASKS/CLAUDE.md +96 -0
  70. package/claude-code/aiwf/ko/.aiwf/04_GENERAL_TASKS/T002_API_Rate_Limiting.md +54 -0
  71. package/claude-code/aiwf/ko/.aiwf/04_GENERAL_TASKS/TX001_Refactor_Logging_Module.md +58 -0
  72. package/claude-code/aiwf/ko/.aiwf/05_ARCHITECTURAL_DECISIONS/ADR001_Chosen_Database_System.md +119 -0
  73. package/claude-code/aiwf/ko/.aiwf/05_ARCHITECTURAL_DECISIONS/ADR002_API_Authentication_Method.md +124 -0
  74. package/claude-code/aiwf/ko/.aiwf/10_STATE_OF_PROJECT/2025-06-12-12-00-needs-focus.md +139 -0
  75. package/claude-code/aiwf/ko/.aiwf/10_STATE_OF_PROJECT/2025-06-12-12-00-test-alignment.md +155 -0
  76. package/claude-code/aiwf/ko/.aiwf/10_STATE_OF_PROJECT/2025-06-13-00-50-solid-progress.md +122 -0
  77. package/claude-code/aiwf/ko/.aiwf/10_STATE_OF_PROJECT/2025-06-14-08-30-infrastructure-challenges.md +141 -0
  78. package/claude-code/aiwf/ko/.aiwf/10_STATE_OF_PROJECT/2025-06-16-21-48-critical-foundation-issues.md +177 -0
  79. package/claude-code/aiwf/ko/.aiwf/10_STATE_OF_PROJECT/2025-06-17-15-08-solid-progress.md +149 -0
  80. package/claude-code/aiwf/ko/.aiwf/10_STATE_OF_PROJECT/index.json +5 -0
  81. package/claude-code/aiwf/ko/.aiwf/10_STATE_OF_PROJECT/sync-index.js +78 -0
  82. package/claude-code/aiwf/ko/.aiwf/98_PROMPTS/github_integration.md +130 -0
  83. package/claude-code/aiwf/ko/.aiwf/98_PROMPTS/useful-prompts.md +31 -0
  84. package/claude-code/aiwf/ko/.aiwf/98_PROMPTS/vibe-front-prompts.md +89 -0
  85. package/claude-code/aiwf/ko/.aiwf/99_TEMPLATES/adr_template.md +49 -0
  86. package/claude-code/aiwf/ko/.aiwf/99_TEMPLATES/milestone_meta_template.md +25 -0
  87. package/claude-code/aiwf/ko/.aiwf/99_TEMPLATES/project_manifest_template.md +39 -0
  88. package/claude-code/aiwf/ko/.aiwf/99_TEMPLATES/sprint_meta_template.md +23 -0
  89. package/claude-code/aiwf/ko/.aiwf/99_TEMPLATES/task_template.md +36 -0
  90. package/claude-code/aiwf/ko/.aiwf/CLAUDE.md +76 -0
  91. package/claude-code/aiwf/ko/.aiwf/README.md +97 -0
  92. package/claude-code/aiwf/ko/.claude/CLAUDE_BE.md +276 -0
  93. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_changelog.md +82 -0
  94. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_code_review.md +88 -0
  95. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_commit.md +160 -0
  96. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_create_general_task.md +147 -0
  97. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_create_milestone_plan.md +194 -0
  98. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_create_prd.md +280 -0
  99. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_create_sprint_tasks.md +189 -0
  100. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_create_sprints_from_milestone.md +121 -0
  101. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_discuss_review.md +29 -0
  102. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_do_task.md +109 -0
  103. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_infinite.md +202 -0
  104. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_initialize.md +134 -0
  105. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_issue_create.md +65 -0
  106. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_mermaid.md +272 -0
  107. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_pr_create.md +76 -0
  108. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_prime.md +9 -0
  109. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_prime_context.md +8 -0
  110. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_project_review.md +261 -0
  111. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_test.md +125 -0
  112. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_testing_review.md +198 -0
  113. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_tm-run-all-subtask.md +210 -0
  114. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_ultrathink_code_advanced.md +460 -0
  115. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_ultrathink_code_basic.md +165 -0
  116. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_ultrathink_general.md +362 -0
  117. package/claude-code/aiwf/ko/.claude/commands/aiwf/aiwf_yolo.md +300 -0
  118. package/claude-code/aiwf/ko/.claude/mcp.json +31 -0
  119. package/claude-code/aiwf/ko/.claude/settings.json +102 -0
  120. package/{AI-WORKFLOW.md → docs/AI-WORKFLOW.ko.md} +31 -24
  121. package/docs/AI-WORKFLOW.md +292 -0
  122. package/docs/COMMANDS_GUIDE.ko.md +637 -0
  123. package/docs/COMMANDS_GUIDE.md +636 -0
  124. package/docs/CONTRIBUTING.md +406 -0
  125. package/docs/DEVELOPMENT_GUIDE.md +727 -0
  126. package/{PRD.ko.md → docs/PRD.ko.md} +9 -9
  127. package/{PRD.md → docs/PRD.md} +9 -9
  128. package/docs/moonklabs-metadata-system-prd.md +127 -0
  129. package/index.js +272 -121
  130. package/package.json +12 -7
  131. package/COMMANDS_GUIDE.md +0 -462
  132. package/claude-code/simone/.simone/04_GENERAL_TASKS/CLAUDE.MD +0 -51
  133. package/claude-code/simone/CHANGELOG.md +0 -71
  134. package/claude-code/simone/LICENSE +0 -21
  135. package/claude-code/simone/README.md +0 -219
  136. package/claude-code/simone/SYNC_GUIDE.md +0 -172
  137. package/claude-code/simone/sync-simone.sh +0 -138
  138. /package/claude-code/{simone/.simone → aiwf/en/.aiwf}/00_PROJECT_MANIFEST.md +0 -0
  139. /package/claude-code/{simone/.simone → aiwf/en/.aiwf}/02_REQUIREMENTS/CLAUDE.md +0 -0
  140. /package/claude-code/{simone/.simone → aiwf/en/.aiwf}/02_REQUIREMENTS/M01_Backend_Setup/PRD_Backend_Setup.md +0 -0
  141. /package/claude-code/{simone/.simone → aiwf/en/.aiwf}/02_REQUIREMENTS/M01_Backend_Setup/SPECS_API_V1.md +0 -0
  142. /package/claude-code/{simone/.simone → aiwf/en/.aiwf}/99_TEMPLATES/adr_template.md +0 -0
  143. /package/claude-code/{simone/.simone → aiwf/en/.aiwf}/99_TEMPLATES/milestone_meta_template.md +0 -0
  144. /package/claude-code/{simone/.simone → aiwf/en/.aiwf}/99_TEMPLATES/project_manifest_template.md +0 -0
  145. /package/claude-code/{simone/.simone → aiwf/en/.aiwf}/99_TEMPLATES/sprint_meta_template.md +0 -0
@@ -0,0 +1,189 @@
1
+ # 스프린트를 위한 Task 생성 - 탑 다운 실행
2
+
3
+ Create detailed tasks for an existing sprint with integrated implementation guidance.
4
+
5
+ ## Create a TODO with EXACTLY these 8 Items
6
+
7
+ 1. Identify target sprint and verify it exists
8
+ 2. Load sprint context and related documentation
9
+ 3. Check for existing ADRs and technical guidance
10
+ 4. Analyze sprint deliverables for task breakdown
11
+ 5. Create individual task files with implementation guidance
12
+ 6. Link ADRs to relevant tasks
13
+ 7. Update sprint meta with task references
14
+ 8. Check quality of your work
15
+
16
+ Follow step by step and adhere closely to the following instructions for each step.
17
+
18
+ ## DETAILS on every TODO item
19
+
20
+ ### 1. Identify target sprint and verify it exists
21
+
22
+ Check: <$ARGUMENTS>
23
+
24
+ **REQUIRED:** Sprint ID must be provided (e.g., S02). If empty, ask user to specify which sprint to detail.
25
+
26
+ - VERIFY sprint directory exists in `.aiwf/03_SPRINTS/`
27
+ - CHECK sprint meta file exists (e.g., `S02_sprint_meta.md`)
28
+ - VERIFY sprint status is not already "completed"
29
+ - If tasks already exist, ask user if they want to recreate them or any other guidance
30
+
31
+ ### 2. Load sprint context and related documentation
32
+
33
+ Use PARALLEL SUBAGENTS to READ and UNDERSTAND the project's context:
34
+
35
+ - READ `.aiwf/00_PROJECT_MANIFEST.md` for project context
36
+ - READ sprint meta file completely to understand goals and deliverables
37
+ - READ parent milestone requirements from `.aiwf/02_REQUIREMENTS/`
38
+ - READ `.aiwf/01_PROJECT_DOCS/ARCHITECTURE.md` for technical context
39
+ - READ `.aiwf/01_PROJECT_DOCS/LONG_TERM_VISION.md` to understand architectural decisions
40
+
41
+ **IMPORTANT:** Sprint tasks must align with documented sprint goals, not expand scope.
42
+
43
+ ### 3. Check for existing ADRs and technical guidance
44
+
45
+ **USE PARALLEL SUBAGENTS** to execute these commands:
46
+
47
+ - SEARCH `.aiwf/05_ARCHITECTURE_DECISIONS/` for ADRs matching sprint ID (e.g., `ADR*_S02_*.md`)
48
+ - READ all found ADRs to understand technical decisions
49
+ - CHECK sprint meta for ADR references section
50
+ - NOTE which technical decisions will affect task implementation
51
+ - BUILD RELATIONSHIP in task and subtasks and make clear what to implement
52
+
53
+ **If conflict in Scope** Between ADR and Sprint goal, try to think about it and ask the user to resolve the conflict.
54
+
55
+ **If no ADRs found:** Proceed but note that tasks may need clarification during implementation.
56
+
57
+ ### 4. Analyze sprint deliverables for task breakdown
58
+
59
+ Based on sprint goals and deliverables (execute in Parallel Subagents):
60
+
61
+ - BREAK DOWN high-level deliverables into concrete, implementable tasks
62
+ - ENSURE each task represents a coherent feature or component
63
+ - CONSIDER logical dependencies between tasks
64
+ - MAP tasks to relevant ADRs for technical guidance
65
+ - DEFER complexity assessment until after tasks are fully created with subtasks
66
+
67
+ ### 5. Create individual task files with implementation guidance
68
+
69
+ **NOW** For each identified Task spin up a Parallel Subagent with these Instructions:
70
+
71
+ #### Create a TODO for EACH task
72
+
73
+ 1. Create basic task structure
74
+ 2. Research codebase interfaces
75
+ 3. Add technical guidance
76
+ 4. Validate task completeness
77
+
78
+ ### 1. Create basic task structure
79
+
80
+ - ALL TASK FILES must to be created in the Sprint Directory (where the sprint meta file is)
81
+ - CREATE file with naming: `T<NN>_S<NN>_<Descriptive_Name>.md`
82
+ - USE sequential numbering starting from T01
83
+ - FOLLOW task template structure exactly from `.aiwf/99_TEMPLATES/task_template.md`
84
+ - ADD basic description and objectives from sprint goals
85
+
86
+ ### 2. Research codebase interfaces
87
+
88
+ - EXAMINE existing codebase for similar patterns and interfaces
89
+ - IDENTIFY specific classes, functions, and imports that will be needed
90
+ - FIND integration points with existing modules
91
+ - NOTE database models, API endpoints, or services to interface with
92
+ - CHECK existing error handling and logging patterns
93
+
94
+ ### 3. Add technical guidance
95
+
96
+ Add these sections to the task file (add to template if not present):
97
+
98
+ **Technical Guidance section:**
99
+
100
+ - Key interfaces and integration points in the codebase
101
+ - Specific imports and module references
102
+ - Existing patterns to follow
103
+ - Database models or API contracts to work with
104
+ - Error handling approach used in similar code
105
+
106
+ **Implementation Notes section:**
107
+
108
+ - Step-by-step implementation approach
109
+ - Key architectural decisions to respect
110
+ - Testing approach based on existing test patterns
111
+ - Performance considerations if relevant
112
+
113
+ **IMPORTANT:** Do NOT include code examples. Provide structural guidance and references only.
114
+
115
+ #### 4. Validate task completeness
116
+
117
+ - ENSURE task has clear implementation path
118
+ - VERIFY all integration points are documented
119
+ - CHECK that guidance references actual codebase elements
120
+ - CONFIRM task is self-contained and actionable
121
+
122
+ **REPEAT** `### 5. Create individual task files with implementation guidance` for every Task
123
+
124
+ ### 6. Link ADRs to relevant tasks
125
+
126
+ - IF relevant ADRs exist
127
+ - REFERENCE ADRs that are related
128
+ - ADD explanation in Technical Guidance section for how each ADR applies
129
+ - ENSURE tasks ONLY reference ADRs that affect their implementation
130
+
131
+ ### 7. Update sprint meta with task references
132
+
133
+ - EDIT sprint meta file to add/update task list
134
+ - ORGANIZE tasks by logical grouping or dependency order
135
+ - ADD brief description for each task
136
+
137
+ ### 8. Check quality of your work
138
+
139
+ Review all created tasks for complexity and split any High complexity tasks:
140
+
141
+ **Complexity Assessment Process:**
142
+
143
+ - READ each task file completely including description, goals, acceptance criteria, and subtasks
144
+ - ASSESS complexity using your judgment about the overall scope and challenge
145
+ - DO NOT base complexity on simple metrics like file counts or estimated hours
146
+ - CONSIDER the conceptual difficulty, integration challenges, and unknowns
147
+ - MARK complexity as Low, Medium, or High in the task frontmatter
148
+
149
+ **If ANY task is marked as High complexity:**
150
+
151
+ - SPLIT the task into 2-3 smaller tasks of Low or Medium complexity
152
+ - CREATE new task files with proper sequential numbering
153
+ - UPDATE the original high-complexity task file or DELETE it
154
+ - ENSURE the split tasks together achieve the original goal
155
+ - MAINTAIN logical grouping and dependencies
156
+
157
+ **After all tasks are finalized:**
158
+
159
+ - VERIFY all tasks are Low or Medium complexity only
160
+ - CHECK task numbering is sequential (T01, T02, T03...)
161
+ - UPDATE sprint meta file with final task list
162
+ - UPDATE project manifest sprint section to reflect actual tasks created
163
+ - GENERATE completion report
164
+
165
+ **Output format:**
166
+
167
+ ```Markdown
168
+ ## Sprint Detailed - [YYYY-MM-DD HH:MM]
169
+
170
+ **Sprint:** [Sprint ID] - [Sprint Name]
171
+ **Status:** Planning Complete
172
+
173
+ **Tasks Created:** [final count after any splits]
174
+ - Medium Complexity: [count]
175
+ - Low Complexity: [count]
176
+
177
+ **Task Splitting Summary:**
178
+ - [Original T03 split into T03 and T04 due to scope]
179
+ - [No other splits needed]
180
+
181
+ **Final Task List:**
182
+ 1. T01_S02 - [Title] (Complexity: [Level])
183
+ 2. T02_S02 - [Title] (Complexity: [Level])
184
+ [Continue for all tasks]
185
+
186
+ **Next Steps:**
187
+ - Review tasks for completeness
188
+ - Run `/do_task [FIRST_TASK_IN_SPRINT]` to begin implementation
189
+ ```
@@ -0,0 +1,121 @@
1
+ # 마일스톤에서 스프린트 계획하기 - 탑 다운 실행
2
+
3
+ Follow these instructions to sprint the scope of a Milestone into Sprints
4
+
5
+ ## Create a TODO with EXACTLY these 8 items
6
+
7
+ 1. Analyze current milestone state
8
+ 2. Assess completed work vs milestone requirements
9
+ 3. Identify remaining work and dependencies
10
+ 4. Design logical sprint boundaries
11
+ 5. Create sprint directories and meta files
12
+ 6. Update PROJECT_MANIFEST with sprint roadmap
13
+ 7. Validate sprint coherence and dependencies
14
+ 8. Report milestone plan
15
+
16
+ ---
17
+
18
+ ## 1 · Analyze current milestone state
19
+
20
+ **CRITICAL:** You are given additional Arguments: <$ARGUMENTS>
21
+
22
+ **USE PARALLEL SUBAGENTS** to do these tasks:
23
+
24
+ - Parse arguments for milestone ID (defaults to current milestone from PROJECT_MANIFEST)
25
+ - Read `.aiwf/00_PROJECT_MANIFEST.md` to understand current progress
26
+ - Scan `.aiwf/03_SPRINTS/` to identify existing sprints for the target milestone
27
+ - For each existing sprint, read its sprint meta file to determine status from YAML frontmatter
28
+ - Analyze the Tasks in Sprints to understand that work that has been done (from Subtasks)
29
+
30
+ ## 2 · Assess completed work vs milestone requirements
31
+
32
+ - Read milestone meta file from `.aiwf/02_REQUIREMENTS/$MILESTONE_ID/`
33
+ - **CRITICAL:** Follow and read ALL linked documents in the milestone meta:
34
+ - Product Requirements (PRD.md)
35
+ - Database Specifications (SPECS_DB.md)
36
+ - API Specifications (SPECS_API.md)
37
+ - Tool Specifications (SPECS_TOOLS.md)
38
+ - Any other linked specifications
39
+ - Study the milestone's Definition of Done (DoD) carefully and **think deeply** about what each DoD criterion actually requires in terms of specific deliverables
40
+ - For each existing sprint, analyze what deliverables have been completed by reading sprint meta and task files
41
+ - **Think more carefully** about the gap analysis: map each completed deliverable against specific DoD requirements and identify what's genuinely missing vs what might already be covered
42
+ - Create clear picture: "What's done vs what's required for milestone completion" with specific justification for each gap identified
43
+
44
+ ## 3 · Identify remaining work and dependencies
45
+
46
+ - Based on gap analysis, identify remaining deliverables for milestone completion
47
+ - Group related deliverables that have natural dependencies
48
+ - **CRITICAL:** Each deliverable group should be:
49
+ - **Independently valuable** (shippable increment)
50
+ - **Completable in ~1 week** by one person
51
+ - **Has clear validation criteria**
52
+ - Consider technical dependencies (e.g., auth before UI, LLM integration before tools)
53
+
54
+ ## 4 · Design logical sprint boundaries
55
+
56
+ - Design sprint structure to complete the milestone
57
+ - Each sprint should have:
58
+ - **Clear focus**: One main deliverable theme
59
+ - **Natural boundaries**: Minimal dependencies between sprints
60
+ - **Incremental value**: Each sprint advances toward milestone DoD
61
+ - Sprint naming: `S<nn>_$milestone_id_$focus_slug`
62
+ - **IMPORTANT:** Don't create sprints for work that's already completed
63
+
64
+ ## 5 · Create sprint directories and meta files
65
+
66
+ - For each planned sprint that doesn't exist:
67
+ - Create directory `.aiwf/03_SPRINTS/$FULL_SPRINT_NAME/` (using complete sprint name like "S02_M01_LLM_Integration")
68
+ - Use template from `.aiwf/99_TEMPLATES/sprint_meta_template.md`
69
+ - Fill in sprint meta with:
70
+ - High-level goal and scope
71
+ - Key deliverables (bullet points, not detailed tasks)
72
+ - Clear Definition of Done for the sprint
73
+ - Status: "planned"
74
+
75
+ ## 6 · Update PROJECT_MANIFEST with sprint roadmap
76
+
77
+ - Update `.aiwf/00_PROJECT_MANIFEST.md`:
78
+ - Set `highest_sprint_in_milestone` to the highest planned sprint
79
+ - Update sprint summary section with overview of remaining sprints
80
+ - Mark completed sprints as ✅ COMPLETED
81
+ - Show planned sprints with their focus areas
82
+ - Update `last_updated` timestamp
83
+
84
+ ## 7 · Validate sprint coherence and dependencies
85
+
86
+ - Review the planned sprint sequence for logical flow
87
+ - Ensure each sprint builds naturally on previous work
88
+ - Verify no sprint has impossible dependencies
89
+ - Check that sprint sequence leads to milestone DoD completion
90
+ - **Think about** whether each sprint is independently testable and valuable
91
+
92
+ ## 8 · Report milestone plan
93
+
94
+ Provide comprehensive summary:
95
+
96
+ **Milestone Status:**
97
+
98
+ - Target milestone: $milestone_id
99
+ - Sprints completed: $count
100
+ - Sprints planned: $count
101
+ - Estimated completion: $sprint_sequence
102
+
103
+ **Sprint Roadmap:**
104
+
105
+ For each sprint (existing and planned):
106
+
107
+ - **$Sprint_ID**: $status - $focus_description
108
+ - Key deliverables: $bullet_list
109
+ - Dependencies: $if_any
110
+
111
+ **Next Steps:**
112
+
113
+ - Immediate next sprint to detail: $sprint_id
114
+
115
+ **Validation:**
116
+
117
+ Summarize your validation analysis covering:
118
+
119
+ - All milestone DoD items are covered by sprint plan
120
+ - Sprint dependencies are logical and minimal
121
+ - Each sprint delivers independent value
@@ -0,0 +1,29 @@
1
+ # 리뷰 결과 논의
2
+
3
+ Engage in technical discussion about recent review findings based on discussion starter.
4
+
5
+ Discussion Starter: <$ARGUMENTS>
6
+
7
+ ## Discussion Primer
8
+
9
+ **IMPORTANT:** Maintain John Carmack perspective - brutally honest, practical, focused on shipping working software.
10
+
11
+ ### Discussion Tone
12
+
13
+ - **Be conversational** but maintain technical depth
14
+ - **Challenge assumptions** - question if issues are real problems for current development stage
15
+ - **Explore trade-offs** - suggest multiple approaches with pros/cons
16
+ - **Focus on decisions** - what to do next, not just analysis
17
+ - **Consider context** - balance technical perfection vs delivery timeline
18
+
19
+ ### Potential Discussion Outcomes
20
+
21
+ Based on the conversation, you may suggest:
22
+
23
+ - **Amending review findings** if new context changes severity/priority
24
+ - **Updating documentation** in `.aiwf/01_PROJECT_DOCS/` if architectural decisions need clarification
25
+ - **Revising requirements** in `.aiwf/02_REQUIREMENTS/` if scope understanding was incorrect
26
+ - **Creating tasks** for specific technical debt items that need addressing
27
+ - **Adjusting sprint priorities** based on refined understanding
28
+
29
+ **IMPORTANT:** Help make practical engineering decisions. Be John Carmack: direct, experienced, and focused on what actually matters for shipping.
@@ -0,0 +1,109 @@
1
+ # $Argument 기반 AIWF 태스크 처리
2
+
3
+ **IMPORTANT:** Follow from Top to Bottom - don't skip anything!
4
+
5
+ **CREATE A TODO LIST** with exactly these 8 items
6
+
7
+ 1. Analyse scope from argument
8
+ 2. Identify task file
9
+ 3. Analyse the task
10
+ 4. Set status to in_progress
11
+ 5. Execute task work
12
+ 6. Placeholder
13
+ 7. Execute Code review
14
+ 8. Finalize Task status
15
+
16
+ ## 1 · Analyse scope from argument
17
+
18
+ <$ARGUMENTS> ⇒ Task ID, Sprint ID, or empty (select next open task in current sprint).
19
+
20
+ ## 2 · Identify task file
21
+
22
+ Search .aiwf/03_SPRINTS/ and .aiwf/04_GENERAL_TASKS/.
23
+ If no open task matches, pause and ask the user how to proceed.
24
+
25
+ ## 3 · Analyse the task
26
+
27
+ Read the task description. If anything is unclear, ask clarifying questions before continuing.
28
+
29
+ **CRITICAL CONTEXT VALIDATION:** Before executing any task spin up Parallel Subagents for these tasks:
30
+
31
+ 1. **Sprint Context:** Confirm task belongs to current sprint scope
32
+ 2. **Dependencies:** Check if any dependent tasks need to be completed first
33
+ 3. **Requirements:** Read relevant requirements docs in `.aiwf/02_REQUIREMENTS/`
34
+ 4. **Scope Verification:** Ensure task aligns with current sprint objectives
35
+ 5. **GitHub Issue Check:** Check if task file has a `github_issue` field
36
+
37
+ **IMPORTANT:** If task references functionality from future sprints or has unmet dependencies, pause and ask for clarification.
38
+
39
+ **GitHub Issue Creation (Optional):**
40
+
41
+ - If task doesn't have a GitHub issue and user wants issue tracking
42
+ - Suggest using `/project:aiwf:issue_create {task_id}` command
43
+
44
+ ## 4 · Set status to in_progress
45
+
46
+ - Find out the current local timestamp (YYYY-MM-DD HH:MM).
47
+ - Update front-matter to **status: in_progress** and set Updated time
48
+ - Update ./aiwf/00_PROJECT_MANIFEST.md to set task in progress, updated time and current Sprint Status.
49
+ - **GitHub Issue Update (if exists):**
50
+ ```bash
51
+ gh issue comment {issue_number} --body "🚀 Task work has started."
52
+ gh issue edit {issue_number} --add-label "in-progress"
53
+ ```
54
+
55
+ ## 5 · Execute task work
56
+
57
+ - Follow Description, Goal and Acceptance Criteria.
58
+ - Consult supporting docs in .aiwf/01_PROJECT_DOCS/ and .aiwf/02_REQUIREMENTS/.
59
+ - Iterate over subtasks:
60
+ 1. Pick the next incomplete subtask.
61
+ 2. Implement the required changes, consulting docs as needed.
62
+ 3. Mark the subtask done.
63
+ 4. Append a log entry to **## Output Log** using the format `[YYYY-MM-DD HH:MM]: <message>`.
64
+ 5. Repeat until all subtasks are complete.
65
+
66
+ ## 6 · Placeholder
67
+
68
+ Placeholder - just move on to the next step
69
+
70
+ ## 7 · Execute Code Review
71
+
72
+ Follow these steps for a Code Review (in order)
73
+
74
+ - include @.claude/commands/aiwf/aiwf_code_review.md and use the Task ID as Scope.
75
+ - Follow the instructions in the file to run a code review in **PARALLEL SUBAGENTS**
76
+ - When done continue acting on the results accordingly
77
+ - Understand and think about the results
78
+ - on **FAIL**
79
+ - thoroughly understand the problem
80
+ - extend the Current Task with the Subtasks identified by the review
81
+ - go back to "5 · Execute task work"
82
+ - on **PASS**
83
+ - move on to next step
84
+
85
+ ## 8 · Finalize task status
86
+
87
+ - set the Task status to **completed**
88
+ - Rename the Task file accordingly to enable proper Completed recognition from the filename (TX[TASK_ID]...)
89
+ - Update .aiwf/00_PROJECT_MANIFEST.md to reflect the new status
90
+ - **GitHub Issue Update (if exists):**
91
+ ```bash
92
+ gh issue comment {issue_number} --body "✅ Task has been completed."
93
+ gh issue edit {issue_number} --remove-label "in-progress" --add-label "completed"
94
+ ```
95
+ - **Report** the result to the user
96
+
97
+ ✅ **Result**: Quick statement of success
98
+
99
+ 🔎 **Scope**: Identified task or reason none was processed
100
+
101
+ 💬 **Summary**: One-paragraph recap of what was done or why blocked
102
+
103
+ ⏭️ **Next steps**: Recommended follow-up actions
104
+
105
+ - **Suggestions** for the User:
106
+
107
+ - 🛠️ Use /project:aiwf:commit `TASK_ID` to commit the changes to git
108
+ - 🔀 Use /project:aiwf:pr_create `TASK_ID` to create a Pull Request
109
+ - 🧹 Use /clear to clear the context before starting the next Task
@@ -0,0 +1,202 @@
1
+ # 무한 에이전틱 루프 명령
2
+
3
+ 이 무한 생성 작업에 대해 깊이 생각하세요. 당신은 정교한 반복 생성 프로세스를 시작하려고 합니다. deep think
4
+
5
+ **변수:**
6
+
7
+ spec_file: $ARGUMENTS
8
+ output_dir: $ARGUMENTS
9
+ count: $ARGUMENTS
10
+
11
+ **인자 파싱:**
12
+ "$ARGUMENTS"에서 다음 인자들을 파싱합니다:
13
+
14
+ 1. `spec_file` - 마크다운 명세 파일 경로
15
+ 2. `output_dir` - 반복 결과가 저장될 디렉토리
16
+ 3. `count` - 반복 횟수 (1-N 또는 "infinite")
17
+
18
+ **1단계: 명세 분석**
19
+ `spec_file`의 명세 파일을 읽고 깊이 이해합니다. 이 파일은 다음을 정의합니다:
20
+
21
+ - 생성할 콘텐츠 유형
22
+ - 형식과 구조 요구사항
23
+ - 특정 매개변수나 제약사항
24
+ - 반복 간의 의도된 진화 패턴
25
+
26
+ 명세의 의도와 각 반복이 이전 작업을 어떻게 기반으로 해야 하는지 신중히 생각하세요.
27
+
28
+ **2단계: 출력 디렉토리 탐색**
29
+ 현재 상태를 이해하기 위해 `output_dir`을 철저히 분석합니다:
30
+
31
+ - 모든 기존 파일과 명명 패턴 나열
32
+ - 현재 존재하는 가장 높은 반복 번호 식별
33
+ - 기존 반복들 간의 콘텐츠 진화 분석
34
+ - 이전 생성의 궤적 이해
35
+ - 새로운 반복을 위한 격차나 기회 파악
36
+
37
+ **3단계: 반복 전략**
38
+ 명세 분석과 기존 반복을 기반으로:
39
+
40
+ - 시작 반복 번호 결정 (최고 기존 번호 + 1)
41
+ - 각 새로운 반복이 독특하고 진화적일 방법 계획
42
+ - 새로움을 유지하면서 이전 반복을 기반으로 구축하는 방법 고려
43
+ - count가 "infinite"인 경우, 컨텍스트 제한까지 지속적 생성 준비
44
+
45
+ **4단계: 병렬 에이전트 조율**
46
+ 최대 효율성과 창의적 다양성을 위해 여러 서브 에이전트를 병렬로 배포합니다:
47
+
48
+ **서브 에이전트 배포 전략:**
49
+
50
+ - count 1-5: 모든 에이전트 동시 실행
51
+ - count 6-20: 5개 에이전트씩 배치로 실행하여 조율 관리
52
+ - "infinite": 3-5개 에이전트의 웨이브를 실행하고, 컨텍스트를 모니터링하며 새로운 웨이브 생성
53
+
54
+ **에이전트 할당 프로토콜:**
55
+ 각 서브 에이전트는 다음을 받습니다:
56
+
57
+ 1. **명세 컨텍스트**: 완전한 명세 파일 분석
58
+ 2. **디렉토리 스냅샷**: 실행 시점의 output_dir 현재 상태
59
+ 3. **반복 할당**: 특정 반복 번호 (시작*번호 + 에이전트*인덱스)
60
+ 4. **독특성 지시**: 기존 반복의 개념을 중복하지 않도록 명시적 지시
61
+ 5. **품질 기준**: 명세의 상세 요구사항
62
+
63
+ **에이전트 작업 명세:**
64
+
65
+ ```
66
+ 작업: [OUTPUT_DIR]에 [SPEC_FILE]의 반복 [NUMBER] 생성
67
+
68
+ 당신은 반복 [NUMBER]를 생성하는 서브 에이전트 [X]입니다.
69
+
70
+ 컨텍스트:
71
+ - 명세: [전체 명세 분석]
72
+ - 기존 반복: [현재 output_dir 내용 요약]
73
+ - 당신의 반복 번호: [NUMBER]
74
+ - 할당된 창의적 방향: [탐색할 특정 혁신 차원]
75
+
76
+ 요구사항:
77
+ 1. 명세를 완전히 읽고 이해
78
+ 2. 기존 반복을 분석하여 출력이 독특한지 확인
79
+ 3. 명세 형식을 정확히 따라 콘텐츠 생성
80
+ 4. 명세 준수를 유지하면서 [할당된 혁신 차원]에 집중
81
+ 5. 지정된 정확한 이름 패턴으로 파일 생성
82
+ 6. 반복이 진정한 가치와 새로움을 추가하는지 확인
83
+
84
+ 산출물: 명세에 따른 단일 파일, 독특하고 혁신적인 콘텐츠 포함
85
+ ```
86
+
87
+ **병렬 실행 관리:**
88
+
89
+ - Task 도구를 사용하여 모든 할당된 서브 에이전트를 동시에 실행
90
+ - 에이전트 진행과 완료 모니터링
91
+ - 에이전트 실패 시 반복 번호 재할당으로 처리
92
+ - 중복 반복 번호가 생성되지 않도록 보장
93
+ - 완료된 모든 반복 수집 및 검증
94
+
95
+ **5단계: 무한 모드 오케스트레이션**
96
+ 무한 생성 모드의 경우, 지속적인 병렬 웨이브를 조율합니다:
97
+
98
+ **웨이브 기반 생성:**
99
+
100
+ 1. **웨이브 계획**: 컨텍스트 용량에 따라 다음 웨이브 크기(3-5 에이전트) 결정
101
+ 2. **에이전트 준비**: 각 새로운 웨이브를 위한 신선한 컨텍스트 스냅샷 준비
102
+ 3. **점진적 정교화**: 각 웨이브는 더 발전된 혁신 차원을 탐색해야 함
103
+ 4. **컨텍스트 모니터링**: 모든 에이전트와 메인 오케스트레이터의 총 컨텍스트 사용량 추적
104
+ 5. **우아한 종료**: 컨텍스트 한계에 접근하면 현재 웨이브를 완료하고 요약
105
+
106
+ **무한 실행 사이클:**
107
+
108
+ ```
109
+ WHILE 컨텍스트_용량 > 임계값:
110
+ 1. 현재 output_dir 상태 평가
111
+ 2. 다음 에이전트 웨이브 계획 (남은 컨텍스트에 따른 크기)
112
+ 3. 점점 정교한 창의적 방향 할당
113
+ 4. 병렬 서브 에이전트 웨이브 실행
114
+ 5. 웨이브 완료 모니터링
115
+ 6. 디렉토리 상태 스냅샷 업데이트
116
+ 7. 남은 컨텍스트 용량 평가
117
+ 8. 충분한 용량 있으면: 다음 웨이브로 계속
118
+ 9. 한계에 접근하면: 최종 웨이브 완료하고 요약
119
+ ```
120
+
121
+ **점진적 정교화 전략:**
122
+
123
+ - **웨이브 1**: 단일 혁신 차원의 기본 기능 대체
124
+ - **웨이브 2**: 향상된 상호작용이 있는 다차원 혁신
125
+ - **웨이브 3**: 적응형 행동이 있는 복잡한 패러다임 조합
126
+ - **웨이브 N**: 명세의 경계를 확장하는 혁명적 개념
127
+
128
+ **컨텍스트 최적화:**
129
+
130
+ - 각 웨이브는 컨텍스트 누적을 피하기 위해 신선한 에이전트 인스턴스 사용
131
+ - 메인 오케스트레이터는 경량 상태 추적 유지
132
+ - 컨텍스트 관리를 위한 완료된 반복의 점진적 요약
133
+ - 후반 웨이브에서 덜 필수적인 세부사항의 전략적 제거
134
+
135
+ **실행 원칙:**
136
+
137
+ **품질 & 독특성:**
138
+
139
+ - 각 반복은 진정으로 독특하고 가치있어야 함
140
+ - 새로운 요소를 도입하면서 이전 작업을 기반으로 구축
141
+ - 원래 명세와의 일관성 유지
142
+ - 적절한 파일 구성과 명명 보장
143
+
144
+ **병렬 조율:**
145
+
146
+ - 창의적 다양성을 극대화하기 위해 서브 에이전트를 전략적으로 배포
147
+ - 중복을 피하기 위해 각 에이전트에 독특한 혁신 차원 할당
148
+ - 파일 명명 충돌을 방지하기 위한 타이밍 조정
149
+ - 성공적인 완료와 품질을 위한 모든 에이전트 모니터링
150
+
151
+ **확장성 & 효율성:**
152
+
153
+ - 병렬 스트림 전체의 진화 궤적에 대해 깊이 생각 deep think
154
+ - 무한 모드의 경우, 컨텍스트 소진 전 최대 가치있는 출력 최적화
155
+ - 컨텍스트 한계를 지능적으로 관리하기 위한 웨이브 기반 생성 사용
156
+ - 병렬 속도와 품질 및 조율 오버헤드의 균형
157
+
158
+ **에이전트 관리:**
159
+
160
+ - 각 서브 에이전트에 완전한 컨텍스트와 명확한 할당 제공
161
+ - 반복 재할당으로 에이전트 실패를 우아하게 처리
162
+ - 모든 병렬 출력이 전체 진행과 일관되게 통합되도록 보장
163
+
164
+ **울트라 씽킹 지시:**
165
+ 생성을 시작하기 전에, 다음에 대해 확장된 사고를 수행하세요:
166
+
167
+ **명세 & 진화:**
168
+
169
+ - 명세의 더 깊은 의미
170
+ - 반복 간 의미있는 진행을 만드는 방법
171
+ - 각 반복을 가치있고 독특하게 만드는 것
172
+ - 일관성과 혁신의 균형을 맞추는 방법
173
+
174
+ **병렬 전략:**
175
+
176
+ - 요청된 수에 대한 최적의 서브 에이전트 배포
177
+ - 다양성을 극대화하기 위해 독특한 창의적 방향을 할당하는 방법
178
+ - 무한 모드의 웨이브 크기와 타이밍
179
+ - 여러 병렬 에이전트 간의 컨텍스트 관리
180
+
181
+ **조율 과제:**
182
+
183
+ - 병렬 스트림 간 중복 개념 방지 방법
184
+ - 각 에이전트가 진정으로 독특한 출력을 생산하도록 보장하는 전략
185
+ - 동시 쓰기가 있는 파일 명명과 디렉토리 구성 관리
186
+ - 병렬 출력의 품질 관리 메커니즘
187
+
188
+ **무한 모드 최적화:**
189
+
190
+ - 지속적인 출력을 위한 웨이브 기반 생성 패턴
191
+ - 여러 웨이브에 걸친 점진적 정교화 전략
192
+ - 컨텍스트 용량 모니터링과 우아한 종료 계획
193
+ - 병렬 생성 속도와 혁신 깊이의 균형
194
+
195
+ **위험 완화:**
196
+
197
+ - 에이전트 실패와 반복 재할당 처리
198
+ - 병렬 실행에도 불구하고 일관된 전체 진행 보장
199
+ - 전체 시스템의 컨텍스트 창 한계 관리
200
+ - 모든 병렬 출력의 명세 준수 유지
201
+
202
+ 이러한 병렬 조율 과제에 대한 깊은 분석으로 실행을 시작하고, 최대 창의적 출력과 효율성을 위해 서브 에이전트를 활용하여 각 단계를 체계적으로 진행하세요.