ai-flow-dev 2.7.0 → 2.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (171) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +573 -570
  3. package/package.json +74 -74
  4. package/prompts/backend/flow-build-phase-0.md +535 -535
  5. package/prompts/backend/flow-build-phase-1.md +626 -626
  6. package/prompts/backend/flow-build-phase-10.md +340 -340
  7. package/prompts/backend/flow-build-phase-2.md +573 -573
  8. package/prompts/backend/flow-build-phase-3.md +834 -834
  9. package/prompts/backend/flow-build-phase-4.md +554 -554
  10. package/prompts/backend/flow-build-phase-5.md +703 -703
  11. package/prompts/backend/flow-build-phase-6.md +524 -524
  12. package/prompts/backend/flow-build-phase-7.md +1001 -1001
  13. package/prompts/backend/flow-build-phase-8.md +1407 -1407
  14. package/prompts/backend/flow-build-phase-9.md +477 -477
  15. package/prompts/backend/flow-build.md +137 -137
  16. package/prompts/backend/flow-check-review.md +656 -20
  17. package/prompts/backend/flow-check-test.md +526 -14
  18. package/prompts/backend/flow-check.md +717 -67
  19. package/prompts/backend/flow-commit.md +88 -119
  20. package/prompts/backend/flow-docs-sync.md +354 -354
  21. package/prompts/backend/flow-finish.md +919 -0
  22. package/prompts/backend/flow-release.md +949 -0
  23. package/prompts/backend/flow-work-feature.md +61 -61
  24. package/prompts/backend/flow-work-fix.md +46 -46
  25. package/prompts/backend/flow-work-refactor.md +48 -48
  26. package/prompts/backend/flow-work-resume.md +34 -34
  27. package/prompts/backend/flow-work.md +1098 -1286
  28. package/prompts/desktop/flow-build-phase-0.md +359 -359
  29. package/prompts/desktop/flow-build-phase-1.md +295 -295
  30. package/prompts/desktop/flow-build-phase-10.md +357 -357
  31. package/prompts/desktop/flow-build-phase-2.md +282 -282
  32. package/prompts/desktop/flow-build-phase-3.md +291 -291
  33. package/prompts/desktop/flow-build-phase-4.md +308 -308
  34. package/prompts/desktop/flow-build-phase-5.md +269 -269
  35. package/prompts/desktop/flow-build-phase-6.md +350 -350
  36. package/prompts/desktop/flow-build-phase-7.md +297 -297
  37. package/prompts/desktop/flow-build-phase-8.md +541 -541
  38. package/prompts/desktop/flow-build-phase-9.md +439 -439
  39. package/prompts/desktop/flow-build.md +156 -156
  40. package/prompts/desktop/flow-check-review.md +656 -20
  41. package/prompts/desktop/flow-check-test.md +526 -14
  42. package/prompts/desktop/flow-check.md +717 -67
  43. package/prompts/desktop/flow-commit.md +88 -119
  44. package/prompts/desktop/flow-docs-sync.md +354 -354
  45. package/prompts/desktop/flow-finish.md +919 -0
  46. package/prompts/desktop/flow-release.md +662 -0
  47. package/prompts/desktop/flow-work-feature.md +61 -61
  48. package/prompts/desktop/flow-work-fix.md +46 -46
  49. package/prompts/desktop/flow-work-refactor.md +48 -48
  50. package/prompts/desktop/flow-work-resume.md +34 -34
  51. package/prompts/desktop/flow-work.md +1202 -1390
  52. package/prompts/frontend/flow-build-phase-0.md +425 -425
  53. package/prompts/frontend/flow-build-phase-1.md +626 -626
  54. package/prompts/frontend/flow-build-phase-10.md +33 -33
  55. package/prompts/frontend/flow-build-phase-2.md +573 -573
  56. package/prompts/frontend/flow-build-phase-3.md +782 -782
  57. package/prompts/frontend/flow-build-phase-4.md +554 -554
  58. package/prompts/frontend/flow-build-phase-5.md +703 -703
  59. package/prompts/frontend/flow-build-phase-6.md +524 -524
  60. package/prompts/frontend/flow-build-phase-7.md +1001 -1001
  61. package/prompts/frontend/flow-build-phase-8.md +872 -872
  62. package/prompts/frontend/flow-build-phase-9.md +94 -94
  63. package/prompts/frontend/flow-build.md +137 -137
  64. package/prompts/frontend/flow-check-review.md +656 -20
  65. package/prompts/frontend/flow-check-test.md +526 -14
  66. package/prompts/frontend/flow-check.md +717 -67
  67. package/prompts/frontend/flow-commit.md +88 -119
  68. package/prompts/frontend/flow-docs-sync.md +550 -550
  69. package/prompts/frontend/flow-finish.md +919 -0
  70. package/prompts/frontend/flow-release.md +519 -0
  71. package/prompts/frontend/flow-work-api.md +1547 -0
  72. package/prompts/frontend/flow-work-feature.md +61 -61
  73. package/prompts/frontend/flow-work-fix.md +38 -38
  74. package/prompts/frontend/flow-work-refactor.md +48 -48
  75. package/prompts/frontend/flow-work-resume.md +34 -34
  76. package/prompts/frontend/flow-work.md +1595 -1320
  77. package/prompts/mobile/flow-build-phase-0.md +425 -425
  78. package/prompts/mobile/flow-build-phase-1.md +626 -626
  79. package/prompts/mobile/flow-build-phase-10.md +32 -32
  80. package/prompts/mobile/flow-build-phase-2.md +573 -573
  81. package/prompts/mobile/flow-build-phase-3.md +782 -782
  82. package/prompts/mobile/flow-build-phase-4.md +554 -554
  83. package/prompts/mobile/flow-build-phase-5.md +703 -703
  84. package/prompts/mobile/flow-build-phase-6.md +524 -524
  85. package/prompts/mobile/flow-build-phase-7.md +1001 -1001
  86. package/prompts/mobile/flow-build-phase-8.md +888 -888
  87. package/prompts/mobile/flow-build-phase-9.md +90 -90
  88. package/prompts/mobile/flow-build.md +135 -135
  89. package/prompts/mobile/flow-check-review.md +656 -20
  90. package/prompts/mobile/flow-check-test.md +526 -14
  91. package/prompts/mobile/flow-check.md +717 -67
  92. package/prompts/mobile/flow-commit.md +88 -119
  93. package/prompts/mobile/flow-docs-sync.md +620 -620
  94. package/prompts/mobile/flow-finish.md +919 -0
  95. package/prompts/mobile/flow-release.md +751 -0
  96. package/prompts/mobile/flow-work-api.md +1500 -0
  97. package/prompts/mobile/flow-work-feature.md +61 -61
  98. package/prompts/mobile/flow-work-fix.md +46 -46
  99. package/prompts/mobile/flow-work-refactor.md +48 -48
  100. package/prompts/mobile/flow-work-resume.md +34 -34
  101. package/prompts/mobile/flow-work.md +1605 -1329
  102. package/prompts/shared/mermaid-guidelines.md +102 -102
  103. package/prompts/shared/scope-levels.md +114 -114
  104. package/prompts/shared/smart-skip-preflight.md +214 -214
  105. package/prompts/shared/story-points.md +55 -55
  106. package/prompts/shared/task-format.md +74 -74
  107. package/prompts/shared/task-summary-template.md +277 -277
  108. package/templates/AGENT.template.md +443 -443
  109. package/templates/backend/.clauderules.template +112 -112
  110. package/templates/backend/.cursorrules.template +102 -102
  111. package/templates/backend/README.template.md +2 -2
  112. package/templates/backend/ai-instructions.template.md +2 -2
  113. package/templates/backend/copilot-instructions.template.md +2 -2
  114. package/templates/backend/docs/api.template.md +320 -320
  115. package/templates/backend/docs/business-flows.template.md +97 -97
  116. package/templates/backend/docs/code-standards.template.md +2 -2
  117. package/templates/backend/docs/contributing.template.md +3 -3
  118. package/templates/backend/docs/data-model.template.md +520 -520
  119. package/templates/backend/docs/testing.template.md +2 -2
  120. package/templates/backend/project-brief.template.md +2 -2
  121. package/templates/backend/specs/configuration.template.md +2 -2
  122. package/templates/backend/specs/security.template.md +2 -2
  123. package/templates/desktop/.clauderules.template +112 -112
  124. package/templates/desktop/.cursorrules.template +102 -102
  125. package/templates/desktop/README.template.md +170 -170
  126. package/templates/desktop/ai-instructions.template.md +366 -366
  127. package/templates/desktop/copilot-instructions.template.md +140 -140
  128. package/templates/desktop/docs/docs/api.template.md +320 -320
  129. package/templates/desktop/docs/docs/architecture.template.md +724 -724
  130. package/templates/desktop/docs/docs/business-flows.template.md +102 -102
  131. package/templates/desktop/docs/docs/code-standards.template.md +792 -792
  132. package/templates/desktop/docs/docs/contributing.template.md +149 -149
  133. package/templates/desktop/docs/docs/data-model.template.md +520 -520
  134. package/templates/desktop/docs/docs/operations.template.md +720 -720
  135. package/templates/desktop/docs/docs/testing.template.md +722 -722
  136. package/templates/desktop/project-brief.template.md +150 -150
  137. package/templates/desktop/specs/specs/configuration.template.md +121 -121
  138. package/templates/desktop/specs/specs/security.template.md +392 -392
  139. package/templates/frontend/README.template.md +2 -2
  140. package/templates/frontend/ai-instructions.template.md +2 -2
  141. package/templates/frontend/docs/api-integration.template.md +362 -362
  142. package/templates/frontend/docs/components.template.md +2 -2
  143. package/templates/frontend/docs/error-handling.template.md +360 -360
  144. package/templates/frontend/docs/operations.template.md +107 -107
  145. package/templates/frontend/docs/performance.template.md +124 -124
  146. package/templates/frontend/docs/pwa.template.md +119 -119
  147. package/templates/frontend/docs/state-management.template.md +2 -2
  148. package/templates/frontend/docs/styling.template.md +2 -2
  149. package/templates/frontend/docs/testing.template.md +2 -2
  150. package/templates/frontend/project-brief.template.md +2 -2
  151. package/templates/frontend/specs/accessibility.template.md +95 -95
  152. package/templates/frontend/specs/configuration.template.md +2 -2
  153. package/templates/frontend/specs/security.template.md +175 -175
  154. package/templates/fullstack/README.template.md +252 -252
  155. package/templates/fullstack/ai-instructions.template.md +444 -444
  156. package/templates/fullstack/project-brief.template.md +157 -157
  157. package/templates/fullstack/specs/configuration.template.md +340 -340
  158. package/templates/mobile/README.template.md +167 -167
  159. package/templates/mobile/ai-instructions.template.md +196 -196
  160. package/templates/mobile/docs/app-store.template.md +135 -135
  161. package/templates/mobile/docs/architecture.template.md +63 -63
  162. package/templates/mobile/docs/native-features.template.md +94 -94
  163. package/templates/mobile/docs/navigation.template.md +59 -59
  164. package/templates/mobile/docs/offline-strategy.template.md +65 -65
  165. package/templates/mobile/docs/permissions.template.md +56 -56
  166. package/templates/mobile/docs/state-management.template.md +85 -85
  167. package/templates/mobile/docs/testing.template.md +109 -109
  168. package/templates/mobile/project-brief.template.md +69 -69
  169. package/templates/mobile/specs/build-configuration.template.md +91 -91
  170. package/templates/mobile/specs/deployment.template.md +92 -92
  171. package/templates/work.template.md +61 -47
@@ -1,439 +1,439 @@
1
- ## PHASE 9: Implementation Roadmap (5-10 min)
2
-
3
- > **Order for this phase:** OPTIONAL. Executed after Phase 8 or on demand.
4
-
5
- ### Objective
6
-
7
- Translate all desktop application specifications into a prioritized, actionable implementation plan (Roadmap) with clear milestones and atomic tasks.
8
-
9
- ---
10
-
11
- ## Context Variables (Extract from docs)
12
-
13
- ```
14
- From ai-instructions.md:
15
- ├── LANG: Java
16
- ├── EXT: .java
17
- ├── SRC: src/main/java or src/
18
- ├── TESTS: src/test/java or test/
19
- ├── RESOURCES: src/main/resources or resources/
20
- └── ARCH: MVC / MVP / MVVM
21
-
22
- From docs/ARCHITECTURE.md:
23
- ├── MODEL_DIR: model/ or domain/
24
- ├── VIEW_DIR: view/ or ui/
25
- ├── CONTROLLER_DIR: controller/ or presenter/
26
- ├── SERVICE_DIR: service/
27
- ├── DAO_DIR: dao/ or repository/
28
- ├── UTIL_DIR: util/
29
- └── PKG_BASE: com.company.app
30
- ```
31
-
32
- ---
33
-
34
- ## Task Format (MANDATORY)
35
-
36
- ```
37
- - [ ] TXXX [CAT] Description • 1 SP → {{path}} | deps: TXXX
38
- ```
39
-
40
- **Components:**
41
-
42
- - `TXXX` - Sequential ID (T001, T002...)
43
- - `[CAT]` - Category (see below)
44
- - `Description` - Specific action
45
- - `1 SP` - Story Points (1 or 2 only)
46
- - `→ {{path}}` - Target file path
47
- - `deps: TXXX` - Dependencies
48
-
49
- ---
50
-
51
- ## Categories [CAT]
52
-
53
- | Cat | Name | Description | SP Range |
54
- | --- | ---------- | ------------------------------- | -------- |
55
- | [M] | Model | Entities, data classes | 1 SP |
56
- | [V] | View | UI components, windows, dialogs | 1-2 SP |
57
- | [C] | Controller | Event handlers, presenters | 1-2 SP |
58
- | [S] | Service | Business logic, services | 1-2 SP |
59
- | [D] | DAO | Data access, repositories | 1 SP |
60
- | [T] | Test | Unit, integration, UI tests | 1-2 SP |
61
- | [U] | UI/UX | Layouts, styling, resources | 1 SP |
62
- | [I] | Infra | Build, packaging, deployment | 1-2 SP |
63
- | [X] | Docs | Documentation updates | 1 SP |
64
-
65
- ---
66
-
67
- ## Atomic Task Rules
68
-
69
- **Maximum 1-2 SP per task:**
70
-
71
- **BAD:**
72
-
73
- ```
74
- - [ ] T001 [V] Create Main Window with all components • 5 SP
75
- ```
76
-
77
- **GOOD:**
78
-
79
- ```
80
- - [ ] T001 [V] Create MainWindow class skeleton • 1 SP → {{SRC}}/{{VIEW_DIR}}/MainWindow{{EXT}} | deps: none
81
- - [ ] T002 [U] Add MainWindow layout (BorderLayout) • 1 SP → {{SRC}}/{{VIEW_DIR}}/MainWindow{{EXT}} | deps: T001
82
- - [ ] T003 [U] Add MainWindow menu bar (File, Edit, Help) • 1 SP → {{SRC}}/{{VIEW_DIR}}/MainWindow{{EXT}} | deps: T002
83
- - [ ] T004 [U] Add MainWindow toolbar (New, Open, Save) • 1 SP → {{SRC}}/{{VIEW_DIR}}/MainWindow{{EXT}} | deps: T002
84
- - [ ] T005 [U] Add MainWindow status bar • 1 SP → {{SRC}}/{{VIEW_DIR}}/MainWindow{{EXT}} | deps: T002
85
- ```
86
-
87
- ---
88
-
89
- ## Workflow: 6 Steps
90
-
91
- ### Step 9.1: Extract Context & Inventory
92
-
93
- **1. Extract context variables:**
94
-
95
- ```
96
- CONTEXT EXTRACTED
97
- ├── Language: Java 17
98
- ├── Extension: .java
99
- ├── Source dir: src/main/java/
100
- ├── Tests dir: src/test/java/
101
- ├── Resources: src/main/resources/
102
- ├── Architecture: MVC
103
- ├── Model path: model/
104
- ├── View path: view/
105
- ├── Controller path: controller/
106
- ├── Service path: service/
107
- └── DAO path: dao/
108
- ```
109
-
110
- **2. Extract inventory from documentation:**
111
-
112
- **From Phase 1 (project-brief.md):**
113
-
114
- ```
115
- WINDOWS:
116
- | Window | Type | Complexity |
117
- |------------------|--------|------------|
118
- | MainWindow | Frame | Complex |
119
- | SettingsDialog | Dialog | Medium |
120
- | AboutDialog | Dialog | Simple |
121
- ```
122
-
123
- **From Phase 2 (docs/ARCHITECTURE.md):**
124
-
125
- ```
126
- MODELS:
127
- | Model | Fields | Relations | Complexity |
128
- |----------|--------|-----------|------------|
129
- | User | 5 | None | Simple |
130
- | Project | 8 | 1:N | Medium |
131
- | Task | 6 | N:1 | Medium |
132
- ```
133
-
134
- **From Phase 4:**
135
-
136
- ```
137
- DATA ACCESS:
138
- | Entity | CRUD | Search | Complexity |
139
- |---------|------|--------|------------|
140
- | User | Yes | Email | Simple |
141
- | Project | Yes | Name | Medium |
142
- | Task | Yes | Status | Medium |
143
- ```
144
-
145
- **Show summary:**
146
-
147
- ```
148
- INVENTORY COMPLETE
149
- ├── UI Framework: Swing / JavaFX / SWT
150
- ├── Windows: 3 (simple: 1, medium: 1, complex: 1)
151
- ├── Models: 3 (simple: 1, medium: 2)
152
- ├── Data Access: 3 entities with CRUD
153
- ├── Build: Maven / Gradle / Ant
154
- └── Estimated tasks: 150-200
155
- ```
156
-
157
- ---
158
-
159
- ### Step 9.2: Epic Definition
160
-
161
- **Standard Epic Structure for Desktop:**
162
-
163
- ```
164
- EP-001: Foundation (ALWAYS FIRST)
165
- ├── Build setup (Maven/Gradle/Ant)
166
- ├── Main class, application launcher
167
- ├── Logging, error handling
168
- ├── Database connection (if applicable)
169
- └── Priority: P0 | Duration: Week 1
170
-
171
- EP-002: Data Layer
172
- ├── Entity classes (models)
173
- ├── DAO/Repository interfaces
174
- ├── Database schema (if applicable)
175
- ├── Unit tests for data layer
176
- └── Priority: P0 | Duration: Week 1-2
177
-
178
- EP-003: Business Logic
179
- ├── Service classes
180
- ├── Business rules, validation
181
- ├── Unit tests for services
182
- └── Priority: P0 | Duration: Week 2-3
183
-
184
- EP-004: UI Foundation
185
- ├── Main window skeleton
186
- ├── Layout management
187
- ├── Menu bar, toolbar, status bar
188
- ├── Application theme/LAF
189
- └── Priority: P0 | Duration: Week 2-3
190
-
191
- EP-005: UI Components
192
- ├── Forms, dialogs
193
- ├── Tables, lists, trees
194
- ├── Custom components
195
- ├── UI event handling
196
- └── Priority: P1 | Duration: Week 3-4
197
-
198
- EP-006: Controllers/Presenters
199
- ├── UI controllers
200
- ├── Event handlers
201
- ├── Data binding (MVVM)
202
- ├── UI tests
203
- └── Priority: P1 | Duration: Week 4
204
-
205
- EP-007: Features
206
- ├── Specific features (search, export, etc.)
207
- ├── Integration with services
208
- ├── Feature tests
209
- └── Priority: P1 | Duration: Week 5
210
-
211
- EP-008: Packaging & Deployment
212
- ├── Executable JAR
213
- ├── Native packaging (jpackage)
214
- ├── Installers
215
- ├── Code signing
216
- └── Priority: P2 | Duration: Week 6
217
- ```
218
-
219
- ---
220
-
221
- ### Step 9.3: Task Generation
222
-
223
- **Example for EP-001 (Foundation):**
224
-
225
- ```markdown
226
- ## Epic 1: Foundation • 15 SP
227
-
228
- **Goal:** Set up build system, main class, and basic infrastructure.
229
-
230
- **Estimated Duration:** 3-5 days
231
-
232
- ### Tasks
233
-
234
- #### Build Setup (3 SP)
235
-
236
- - [ ] T001 [I] Create pom.xml with Java 17 config • 1 SP → pom.xml | deps: none
237
- - [ ] T002 [I] Add UI framework dependency (Swing/JavaFX/SWT) • 1 SP → pom.xml | deps: T001
238
- - [ ] T003 [I] Add database dependency (H2/Derby) if needed • 1 SP → pom.xml | deps: T001
239
-
240
- #### Application Launcher (4 SP)
241
-
242
- - [ ] T004 [C] Create Main class with main() method • 1 SP → {{SRC}}/{{PKG_BASE}}/Main{{EXT}} | deps: T002
243
- - [ ] T005 [C] Initialize UI thread (SwingUtilities/Platform.runLater) • 1 SP → {{SRC}}/{{PKG_BASE}}/Main{{EXT}} | deps: T004
244
- - [ ] T006 [C] Set Look and Feel (FlatLaf/Modena) • 1 SP → {{SRC}}/{{PKG_BASE}}/Main{{EXT}} | deps: T004
245
- - [ ] T007 [T] Add Main class unit test • 1 SP → {{TESTS}}/{{PKG_BASE}}/MainTest{{EXT}} | deps: T004
246
-
247
- #### Infrastructure (4 SP)
248
-
249
- - [ ] T008 [S] Create Logger utility class • 1 SP → {{SRC}}/{{PKG_BASE}}/{{UTIL_DIR}}/Logger{{EXT}} | deps: none
250
- - [ ] T009 [S] Create ConfigManager for properties • 1 SP → {{SRC}}/{{PKG_BASE}}/{{UTIL_DIR}}/ConfigManager{{EXT}} | deps: none
251
- - [ ] T010 [S] Create global exception handler • 1 SP → {{SRC}}/{{PKG_BASE}}/{{UTIL_DIR}}/ExceptionHandler{{EXT}} | deps: T008
252
- - [ ] T011 [T] Add utility tests • 1 SP → {{TESTS}}/{{PKG_BASE}}/util/ | deps: T008,T009,T010
253
-
254
- #### Database Setup (4 SP, if applicable)
255
-
256
- - [ ] T012 [D] Create DatabaseManager class • 1 SP → {{SRC}}/{{PKG_BASE}}/{{DAO_DIR}}/DatabaseManager{{EXT}} | deps: T003
257
- - [ ] T013 [D] Implement connection pooling • 1 SP → {{SRC}}/{{PKG_BASE}}/{{DAO_DIR}}/DatabaseManager{{EXT}} | deps: T012
258
- - [ ] T014 [D] Create schema.sql (DDL) • 1 SP → {{RESOURCES}}/schema.sql | deps: none
259
- - [ ] T015 [T] Add DatabaseManager tests • 1 SP → {{TESTS}}/{{PKG_BASE}}/dao/DatabaseManagerTest{{EXT}} | deps: T012
260
- ```
261
-
262
- ---
263
-
264
- ### Step 9.4: Generate planning/roadmap.md
265
-
266
- **File structure:**
267
-
268
- ````markdown
269
- # Implementation Roadmap
270
-
271
- **Project:** [Project Name]
272
- **Type:** Desktop Application (Java)
273
- **UI Framework:** [Swing / JavaFX / SWT]
274
- **Generated:** 2025-02-03
275
-
276
- ---
277
-
278
- ## Overview
279
-
280
- **Total Epics:** 8
281
- **Total Tasks:** ~180
282
- **Estimated Duration:** 6 weeks
283
- **Team Size:** 1-2 developers
284
-
285
- ---
286
-
287
- ## Priority Legend
288
-
289
- - **P0:** Critical - Must have (MVP blocker)
290
- - **P1:** High - Should have (MVP preferred)
291
- - **P2:** Medium - Nice to have (Post-MVP)
292
- - **P3:** Low - Future enhancement
293
-
294
- ---
295
-
296
- ## Roadmap Timeline
297
-
298
- ```mermaid
299
- gantt
300
- title Desktop App Implementation Timeline
301
- dateFormat YYYY-MM-DD
302
- section Foundation
303
- EP-001 Foundation :2025-02-03, 5d
304
- section Data Layer
305
- EP-002 Data Layer :2025-02-08, 7d
306
- section Business Logic
307
- EP-003 Business Logic :2025-02-15, 7d
308
- section UI
309
- EP-004 UI Foundation :2025-02-15, 7d
310
- EP-005 UI Components :2025-02-22, 7d
311
- EP-006 Controllers :2025-03-01, 5d
312
- section Features
313
- EP-007 Features :2025-03-06, 7d
314
- section Deployment
315
- EP-008 Packaging :2025-03-13, 5d
316
- ```
317
- ````
318
-
319
- ---
320
-
321
- ## Epic 1: Foundation • 15 SP
322
-
323
- [Tasks from Step 9.3]
324
-
325
- ## Epic 2: Data Layer • 25 SP
326
-
327
- [Generated tasks for models, DAOs, database]
328
-
329
- ## Epic 3: Business Logic • 20 SP
330
-
331
- [Generated tasks for services]
332
-
333
- ## Epic 4: UI Foundation • 20 SP
334
-
335
- [Generated tasks for main window, layouts]
336
-
337
- ## Epic 5: UI Components • 30 SP
338
-
339
- [Generated tasks for forms, dialogs]
340
-
341
- ## Epic 6: Controllers/Presenters • 25 SP
342
-
343
- [Generated tasks for event handlers]
344
-
345
- ## Epic 7: Features • 35 SP
346
-
347
- [Generated tasks for specific features]
348
-
349
- ## Epic 8: Packaging & Deployment • 10 SP
350
-
351
- [Generated tasks for packaging, installers]
352
-
353
- ---
354
-
355
- ## Story Points Summary
356
-
357
- | Epic | Tasks | SP | Priority | Duration |
358
- | --------- | ------- | ------- | -------- | ----------- |
359
- | EP-001 | 15 | 15 | P0 | Week 1 |
360
- | EP-002 | 25 | 25 | P0 | Week 1-2 |
361
- | EP-003 | 20 | 20 | P0 | Week 2-3 |
362
- | EP-004 | 20 | 20 | P0 | Week 2-3 |
363
- | EP-005 | 30 | 30 | P1 | Week 3-4 |
364
- | EP-006 | 25 | 25 | P1 | Week 4 |
365
- | EP-007 | 35 | 35 | P1 | Week 5 |
366
- | EP-008 | 10 | 10 | P2 | Week 6 |
367
- | **TOTAL** | **180** | **180** | | **6 weeks** |
368
-
369
- ---
370
-
371
- ## Task Dependencies Graph
372
-
373
- ```mermaid
374
- graph TD
375
- EP001[EP-001 Foundation] --> EP002[EP-002 Data Layer]
376
- EP001 --> EP004[EP-004 UI Foundation]
377
- EP002 --> EP003[EP-003 Business Logic]
378
- EP003 --> EP006[EP-006 Controllers]
379
- EP004 --> EP005[EP-005 UI Components]
380
- EP005 --> EP006
381
- EP006 --> EP007[EP-007 Features]
382
- EP007 --> EP008[EP-008 Packaging]
383
- ```
384
-
385
- ---
386
-
387
- ## Next Steps
388
-
389
- 1. **Start with EP-001 (Foundation)**
390
- 2. Run `/flow-work EP-001` to begin implementation
391
- 3. Complete tasks sequentially: T001 → T002 → ...
392
- 4. Run tests after each task
393
- 5. Commit frequently with descriptive messages
394
-
395
- ---
396
-
397
- **Last Updated:** 2025-02-03
398
-
399
- ```
400
-
401
- ---
402
-
403
- ### Phase 9 Output
404
-
405
- ```
406
-
407
- ✅ Implementation Roadmap generated!
408
-
409
- Created: planning/roadmap.md
410
-
411
- Summary:
412
-
413
- - 8 Epics defined
414
- - ~180 atomic tasks generated
415
- - 6 weeks estimated duration
416
- - Dependencies mapped
417
- - Gantt timeline included
418
-
419
- Next steps:
420
-
421
- 1. Review planning/roadmap.md
422
- 2. Optionally run Phase 10 for User Stories
423
- 3. Start implementation with /flow-work EP-001
424
-
425
- Type "continue" for Phase 10, or "done" to finish.
426
-
427
- ```
428
-
429
- ---
430
-
431
- **Next Phase:** Phase 10 - User Stories Generation (optional)
432
-
433
- Read: `.ai-flow/prompts/desktop/flow-build-phase-10.md`
434
-
435
- ---
436
-
437
- **Last Updated:** 2025-02-03
438
- **Version:** 1.0.0
439
- ```
1
+ ## PHASE 9: Implementation Roadmap (5-10 min)
2
+
3
+ > **Order for this phase:** OPTIONAL. Executed after Phase 8 or on demand.
4
+
5
+ ### Objective
6
+
7
+ Translate all desktop application specifications into a prioritized, actionable implementation plan (Roadmap) with clear milestones and atomic tasks.
8
+
9
+ ---
10
+
11
+ ## Context Variables (Extract from docs)
12
+
13
+ ```
14
+ From ai-instructions.md:
15
+ ├── LANG: Java
16
+ ├── EXT: .java
17
+ ├── SRC: src/main/java or src/
18
+ ├── TESTS: src/test/java or test/
19
+ ├── RESOURCES: src/main/resources or resources/
20
+ └── ARCH: MVC / MVP / MVVM
21
+
22
+ From docs/ARCHITECTURE.md:
23
+ ├── MODEL_DIR: model/ or domain/
24
+ ├── VIEW_DIR: view/ or ui/
25
+ ├── CONTROLLER_DIR: controller/ or presenter/
26
+ ├── SERVICE_DIR: service/
27
+ ├── DAO_DIR: dao/ or repository/
28
+ ├── UTIL_DIR: util/
29
+ └── PKG_BASE: com.company.app
30
+ ```
31
+
32
+ ---
33
+
34
+ ## Task Format (MANDATORY)
35
+
36
+ ```
37
+ - [ ] TXXX [CAT] Description • 1 SP → {{path}} | deps: TXXX
38
+ ```
39
+
40
+ **Components:**
41
+
42
+ - `TXXX` - Sequential ID (T001, T002...)
43
+ - `[CAT]` - Category (see below)
44
+ - `Description` - Specific action
45
+ - `1 SP` - Story Points (1 or 2 only)
46
+ - `→ {{path}}` - Target file path
47
+ - `deps: TXXX` - Dependencies
48
+
49
+ ---
50
+
51
+ ## Categories [CAT]
52
+
53
+ | Cat | Name | Description | SP Range |
54
+ | --- | ---------- | ------------------------------- | -------- |
55
+ | [M] | Model | Entities, data classes | 1 SP |
56
+ | [V] | View | UI components, windows, dialogs | 1-2 SP |
57
+ | [C] | Controller | Event handlers, presenters | 1-2 SP |
58
+ | [S] | Service | Business logic, services | 1-2 SP |
59
+ | [D] | DAO | Data access, repositories | 1 SP |
60
+ | [T] | Test | Unit, integration, UI tests | 1-2 SP |
61
+ | [U] | UI/UX | Layouts, styling, resources | 1 SP |
62
+ | [I] | Infra | Build, packaging, deployment | 1-2 SP |
63
+ | [X] | Docs | Documentation updates | 1 SP |
64
+
65
+ ---
66
+
67
+ ## Atomic Task Rules
68
+
69
+ **Maximum 1-2 SP per task:**
70
+
71
+ **BAD:**
72
+
73
+ ```
74
+ - [ ] T001 [V] Create Main Window with all components • 5 SP
75
+ ```
76
+
77
+ **GOOD:**
78
+
79
+ ```
80
+ - [ ] T001 [V] Create MainWindow class skeleton • 1 SP → {{SRC}}/{{VIEW_DIR}}/MainWindow{{EXT}} | deps: none
81
+ - [ ] T002 [U] Add MainWindow layout (BorderLayout) • 1 SP → {{SRC}}/{{VIEW_DIR}}/MainWindow{{EXT}} | deps: T001
82
+ - [ ] T003 [U] Add MainWindow menu bar (File, Edit, Help) • 1 SP → {{SRC}}/{{VIEW_DIR}}/MainWindow{{EXT}} | deps: T002
83
+ - [ ] T004 [U] Add MainWindow toolbar (New, Open, Save) • 1 SP → {{SRC}}/{{VIEW_DIR}}/MainWindow{{EXT}} | deps: T002
84
+ - [ ] T005 [U] Add MainWindow status bar • 1 SP → {{SRC}}/{{VIEW_DIR}}/MainWindow{{EXT}} | deps: T002
85
+ ```
86
+
87
+ ---
88
+
89
+ ## Workflow: 6 Steps
90
+
91
+ ### Step 9.1: Extract Context & Inventory
92
+
93
+ **1. Extract context variables:**
94
+
95
+ ```
96
+ CONTEXT EXTRACTED
97
+ ├── Language: Java 17
98
+ ├── Extension: .java
99
+ ├── Source dir: src/main/java/
100
+ ├── Tests dir: src/test/java/
101
+ ├── Resources: src/main/resources/
102
+ ├── Architecture: MVC
103
+ ├── Model path: model/
104
+ ├── View path: view/
105
+ ├── Controller path: controller/
106
+ ├── Service path: service/
107
+ └── DAO path: dao/
108
+ ```
109
+
110
+ **2. Extract inventory from documentation:**
111
+
112
+ **From Phase 1 (project-brief.md):**
113
+
114
+ ```
115
+ WINDOWS:
116
+ | Window | Type | Complexity |
117
+ |------------------|--------|------------|
118
+ | MainWindow | Frame | Complex |
119
+ | SettingsDialog | Dialog | Medium |
120
+ | AboutDialog | Dialog | Simple |
121
+ ```
122
+
123
+ **From Phase 2 (docs/ARCHITECTURE.md):**
124
+
125
+ ```
126
+ MODELS:
127
+ | Model | Fields | Relations | Complexity |
128
+ |----------|--------|-----------|------------|
129
+ | User | 5 | None | Simple |
130
+ | Project | 8 | 1:N | Medium |
131
+ | Task | 6 | N:1 | Medium |
132
+ ```
133
+
134
+ **From Phase 4:**
135
+
136
+ ```
137
+ DATA ACCESS:
138
+ | Entity | CRUD | Search | Complexity |
139
+ |---------|------|--------|------------|
140
+ | User | Yes | Email | Simple |
141
+ | Project | Yes | Name | Medium |
142
+ | Task | Yes | Status | Medium |
143
+ ```
144
+
145
+ **Show summary:**
146
+
147
+ ```
148
+ INVENTORY COMPLETE
149
+ ├── UI Framework: Swing / JavaFX / SWT
150
+ ├── Windows: 3 (simple: 1, medium: 1, complex: 1)
151
+ ├── Models: 3 (simple: 1, medium: 2)
152
+ ├── Data Access: 3 entities with CRUD
153
+ ├── Build: Maven / Gradle / Ant
154
+ └── Estimated tasks: 150-200
155
+ ```
156
+
157
+ ---
158
+
159
+ ### Step 9.2: Epic Definition
160
+
161
+ **Standard Epic Structure for Desktop:**
162
+
163
+ ```
164
+ EP-001: Foundation (ALWAYS FIRST)
165
+ ├── Build setup (Maven/Gradle/Ant)
166
+ ├── Main class, application launcher
167
+ ├── Logging, error handling
168
+ ├── Database connection (if applicable)
169
+ └── Priority: P0 | Duration: Week 1
170
+
171
+ EP-002: Data Layer
172
+ ├── Entity classes (models)
173
+ ├── DAO/Repository interfaces
174
+ ├── Database schema (if applicable)
175
+ ├── Unit tests for data layer
176
+ └── Priority: P0 | Duration: Week 1-2
177
+
178
+ EP-003: Business Logic
179
+ ├── Service classes
180
+ ├── Business rules, validation
181
+ ├── Unit tests for services
182
+ └── Priority: P0 | Duration: Week 2-3
183
+
184
+ EP-004: UI Foundation
185
+ ├── Main window skeleton
186
+ ├── Layout management
187
+ ├── Menu bar, toolbar, status bar
188
+ ├── Application theme/LAF
189
+ └── Priority: P0 | Duration: Week 2-3
190
+
191
+ EP-005: UI Components
192
+ ├── Forms, dialogs
193
+ ├── Tables, lists, trees
194
+ ├── Custom components
195
+ ├── UI event handling
196
+ └── Priority: P1 | Duration: Week 3-4
197
+
198
+ EP-006: Controllers/Presenters
199
+ ├── UI controllers
200
+ ├── Event handlers
201
+ ├── Data binding (MVVM)
202
+ ├── UI tests
203
+ └── Priority: P1 | Duration: Week 4
204
+
205
+ EP-007: Features
206
+ ├── Specific features (search, export, etc.)
207
+ ├── Integration with services
208
+ ├── Feature tests
209
+ └── Priority: P1 | Duration: Week 5
210
+
211
+ EP-008: Packaging & Deployment
212
+ ├── Executable JAR
213
+ ├── Native packaging (jpackage)
214
+ ├── Installers
215
+ ├── Code signing
216
+ └── Priority: P2 | Duration: Week 6
217
+ ```
218
+
219
+ ---
220
+
221
+ ### Step 9.3: Task Generation
222
+
223
+ **Example for EP-001 (Foundation):**
224
+
225
+ ```markdown
226
+ ## Epic 1: Foundation • 15 SP
227
+
228
+ **Goal:** Set up build system, main class, and basic infrastructure.
229
+
230
+ **Estimated Duration:** 3-5 days
231
+
232
+ ### Tasks
233
+
234
+ #### Build Setup (3 SP)
235
+
236
+ - [ ] T001 [I] Create pom.xml with Java 17 config • 1 SP → pom.xml | deps: none
237
+ - [ ] T002 [I] Add UI framework dependency (Swing/JavaFX/SWT) • 1 SP → pom.xml | deps: T001
238
+ - [ ] T003 [I] Add database dependency (H2/Derby) if needed • 1 SP → pom.xml | deps: T001
239
+
240
+ #### Application Launcher (4 SP)
241
+
242
+ - [ ] T004 [C] Create Main class with main() method • 1 SP → {{SRC}}/{{PKG_BASE}}/Main{{EXT}} | deps: T002
243
+ - [ ] T005 [C] Initialize UI thread (SwingUtilities/Platform.runLater) • 1 SP → {{SRC}}/{{PKG_BASE}}/Main{{EXT}} | deps: T004
244
+ - [ ] T006 [C] Set Look and Feel (FlatLaf/Modena) • 1 SP → {{SRC}}/{{PKG_BASE}}/Main{{EXT}} | deps: T004
245
+ - [ ] T007 [T] Add Main class unit test • 1 SP → {{TESTS}}/{{PKG_BASE}}/MainTest{{EXT}} | deps: T004
246
+
247
+ #### Infrastructure (4 SP)
248
+
249
+ - [ ] T008 [S] Create Logger utility class • 1 SP → {{SRC}}/{{PKG_BASE}}/{{UTIL_DIR}}/Logger{{EXT}} | deps: none
250
+ - [ ] T009 [S] Create ConfigManager for properties • 1 SP → {{SRC}}/{{PKG_BASE}}/{{UTIL_DIR}}/ConfigManager{{EXT}} | deps: none
251
+ - [ ] T010 [S] Create global exception handler • 1 SP → {{SRC}}/{{PKG_BASE}}/{{UTIL_DIR}}/ExceptionHandler{{EXT}} | deps: T008
252
+ - [ ] T011 [T] Add utility tests • 1 SP → {{TESTS}}/{{PKG_BASE}}/util/ | deps: T008,T009,T010
253
+
254
+ #### Database Setup (4 SP, if applicable)
255
+
256
+ - [ ] T012 [D] Create DatabaseManager class • 1 SP → {{SRC}}/{{PKG_BASE}}/{{DAO_DIR}}/DatabaseManager{{EXT}} | deps: T003
257
+ - [ ] T013 [D] Implement connection pooling • 1 SP → {{SRC}}/{{PKG_BASE}}/{{DAO_DIR}}/DatabaseManager{{EXT}} | deps: T012
258
+ - [ ] T014 [D] Create schema.sql (DDL) • 1 SP → {{RESOURCES}}/schema.sql | deps: none
259
+ - [ ] T015 [T] Add DatabaseManager tests • 1 SP → {{TESTS}}/{{PKG_BASE}}/dao/DatabaseManagerTest{{EXT}} | deps: T012
260
+ ```
261
+
262
+ ---
263
+
264
+ ### Step 9.4: Generate planning/roadmap.md
265
+
266
+ **File structure:**
267
+
268
+ ````markdown
269
+ # Implementation Roadmap
270
+
271
+ **Project:** [Project Name]
272
+ **Type:** Desktop Application (Java)
273
+ **UI Framework:** [Swing / JavaFX / SWT]
274
+ **Generated:** 2025-02-03
275
+
276
+ ---
277
+
278
+ ## Overview
279
+
280
+ **Total Epics:** 8
281
+ **Total Tasks:** ~180
282
+ **Estimated Duration:** 6 weeks
283
+ **Team Size:** 1-2 developers
284
+
285
+ ---
286
+
287
+ ## Priority Legend
288
+
289
+ - **P0:** Critical - Must have (MVP blocker)
290
+ - **P1:** High - Should have (MVP preferred)
291
+ - **P2:** Medium - Nice to have (Post-MVP)
292
+ - **P3:** Low - Future enhancement
293
+
294
+ ---
295
+
296
+ ## Roadmap Timeline
297
+
298
+ ```mermaid
299
+ gantt
300
+ title Desktop App Implementation Timeline
301
+ dateFormat YYYY-MM-DD
302
+ section Foundation
303
+ EP-001 Foundation :2025-02-03, 5d
304
+ section Data Layer
305
+ EP-002 Data Layer :2025-02-08, 7d
306
+ section Business Logic
307
+ EP-003 Business Logic :2025-02-15, 7d
308
+ section UI
309
+ EP-004 UI Foundation :2025-02-15, 7d
310
+ EP-005 UI Components :2025-02-22, 7d
311
+ EP-006 Controllers :2025-03-01, 5d
312
+ section Features
313
+ EP-007 Features :2025-03-06, 7d
314
+ section Deployment
315
+ EP-008 Packaging :2025-03-13, 5d
316
+ ```
317
+ ````
318
+
319
+ ---
320
+
321
+ ## Epic 1: Foundation • 15 SP
322
+
323
+ [Tasks from Step 9.3]
324
+
325
+ ## Epic 2: Data Layer • 25 SP
326
+
327
+ [Generated tasks for models, DAOs, database]
328
+
329
+ ## Epic 3: Business Logic • 20 SP
330
+
331
+ [Generated tasks for services]
332
+
333
+ ## Epic 4: UI Foundation • 20 SP
334
+
335
+ [Generated tasks for main window, layouts]
336
+
337
+ ## Epic 5: UI Components • 30 SP
338
+
339
+ [Generated tasks for forms, dialogs]
340
+
341
+ ## Epic 6: Controllers/Presenters • 25 SP
342
+
343
+ [Generated tasks for event handlers]
344
+
345
+ ## Epic 7: Features • 35 SP
346
+
347
+ [Generated tasks for specific features]
348
+
349
+ ## Epic 8: Packaging & Deployment • 10 SP
350
+
351
+ [Generated tasks for packaging, installers]
352
+
353
+ ---
354
+
355
+ ## Story Points Summary
356
+
357
+ | Epic | Tasks | SP | Priority | Duration |
358
+ | --------- | ------- | ------- | -------- | ----------- |
359
+ | EP-001 | 15 | 15 | P0 | Week 1 |
360
+ | EP-002 | 25 | 25 | P0 | Week 1-2 |
361
+ | EP-003 | 20 | 20 | P0 | Week 2-3 |
362
+ | EP-004 | 20 | 20 | P0 | Week 2-3 |
363
+ | EP-005 | 30 | 30 | P1 | Week 3-4 |
364
+ | EP-006 | 25 | 25 | P1 | Week 4 |
365
+ | EP-007 | 35 | 35 | P1 | Week 5 |
366
+ | EP-008 | 10 | 10 | P2 | Week 6 |
367
+ | **TOTAL** | **180** | **180** | | **6 weeks** |
368
+
369
+ ---
370
+
371
+ ## Task Dependencies Graph
372
+
373
+ ```mermaid
374
+ graph TD
375
+ EP001[EP-001 Foundation] --> EP002[EP-002 Data Layer]
376
+ EP001 --> EP004[EP-004 UI Foundation]
377
+ EP002 --> EP003[EP-003 Business Logic]
378
+ EP003 --> EP006[EP-006 Controllers]
379
+ EP004 --> EP005[EP-005 UI Components]
380
+ EP005 --> EP006
381
+ EP006 --> EP007[EP-007 Features]
382
+ EP007 --> EP008[EP-008 Packaging]
383
+ ```
384
+
385
+ ---
386
+
387
+ ## Next Steps
388
+
389
+ 1. **Start with EP-001 (Foundation)**
390
+ 2. Run `/flow-work EP-001` to begin implementation
391
+ 3. Complete tasks sequentially: T001 → T002 → ...
392
+ 4. Run tests after each task
393
+ 5. Commit frequently with descriptive messages
394
+
395
+ ---
396
+
397
+ **Last Updated:** 2025-02-03
398
+
399
+ ```
400
+
401
+ ---
402
+
403
+ ### Phase 9 Output
404
+
405
+ ```
406
+
407
+ ✅ Implementation Roadmap generated!
408
+
409
+ Created: planning/roadmap.md
410
+
411
+ Summary:
412
+
413
+ - 8 Epics defined
414
+ - ~180 atomic tasks generated
415
+ - 6 weeks estimated duration
416
+ - Dependencies mapped
417
+ - Gantt timeline included
418
+
419
+ Next steps:
420
+
421
+ 1. Review planning/roadmap.md
422
+ 2. Optionally run Phase 10 for User Stories
423
+ 3. Start implementation with /flow-work EP-001
424
+
425
+ Type "continue" for Phase 10, or "done" to finish.
426
+
427
+ ```
428
+
429
+ ---
430
+
431
+ **Next Phase:** Phase 10 - User Stories Generation (optional)
432
+
433
+ Read: `.ai-flow/prompts/desktop/flow-build-phase-10.md`
434
+
435
+ ---
436
+
437
+ **Last Updated:** 2025-02-03
438
+ **Version:** 1.0.0
439
+ ```