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.
- package/LICENSE +21 -21
- package/README.md +573 -570
- package/package.json +74 -74
- package/prompts/backend/flow-build-phase-0.md +535 -535
- package/prompts/backend/flow-build-phase-1.md +626 -626
- package/prompts/backend/flow-build-phase-10.md +340 -340
- package/prompts/backend/flow-build-phase-2.md +573 -573
- package/prompts/backend/flow-build-phase-3.md +834 -834
- package/prompts/backend/flow-build-phase-4.md +554 -554
- package/prompts/backend/flow-build-phase-5.md +703 -703
- package/prompts/backend/flow-build-phase-6.md +524 -524
- package/prompts/backend/flow-build-phase-7.md +1001 -1001
- package/prompts/backend/flow-build-phase-8.md +1407 -1407
- package/prompts/backend/flow-build-phase-9.md +477 -477
- package/prompts/backend/flow-build.md +137 -137
- package/prompts/backend/flow-check-review.md +656 -20
- package/prompts/backend/flow-check-test.md +526 -14
- package/prompts/backend/flow-check.md +717 -67
- package/prompts/backend/flow-commit.md +88 -119
- package/prompts/backend/flow-docs-sync.md +354 -354
- package/prompts/backend/flow-finish.md +919 -0
- package/prompts/backend/flow-release.md +949 -0
- package/prompts/backend/flow-work-feature.md +61 -61
- package/prompts/backend/flow-work-fix.md +46 -46
- package/prompts/backend/flow-work-refactor.md +48 -48
- package/prompts/backend/flow-work-resume.md +34 -34
- package/prompts/backend/flow-work.md +1098 -1286
- package/prompts/desktop/flow-build-phase-0.md +359 -359
- package/prompts/desktop/flow-build-phase-1.md +295 -295
- package/prompts/desktop/flow-build-phase-10.md +357 -357
- package/prompts/desktop/flow-build-phase-2.md +282 -282
- package/prompts/desktop/flow-build-phase-3.md +291 -291
- package/prompts/desktop/flow-build-phase-4.md +308 -308
- package/prompts/desktop/flow-build-phase-5.md +269 -269
- package/prompts/desktop/flow-build-phase-6.md +350 -350
- package/prompts/desktop/flow-build-phase-7.md +297 -297
- package/prompts/desktop/flow-build-phase-8.md +541 -541
- package/prompts/desktop/flow-build-phase-9.md +439 -439
- package/prompts/desktop/flow-build.md +156 -156
- package/prompts/desktop/flow-check-review.md +656 -20
- package/prompts/desktop/flow-check-test.md +526 -14
- package/prompts/desktop/flow-check.md +717 -67
- package/prompts/desktop/flow-commit.md +88 -119
- package/prompts/desktop/flow-docs-sync.md +354 -354
- package/prompts/desktop/flow-finish.md +919 -0
- package/prompts/desktop/flow-release.md +662 -0
- package/prompts/desktop/flow-work-feature.md +61 -61
- package/prompts/desktop/flow-work-fix.md +46 -46
- package/prompts/desktop/flow-work-refactor.md +48 -48
- package/prompts/desktop/flow-work-resume.md +34 -34
- package/prompts/desktop/flow-work.md +1202 -1390
- package/prompts/frontend/flow-build-phase-0.md +425 -425
- package/prompts/frontend/flow-build-phase-1.md +626 -626
- package/prompts/frontend/flow-build-phase-10.md +33 -33
- package/prompts/frontend/flow-build-phase-2.md +573 -573
- package/prompts/frontend/flow-build-phase-3.md +782 -782
- package/prompts/frontend/flow-build-phase-4.md +554 -554
- package/prompts/frontend/flow-build-phase-5.md +703 -703
- package/prompts/frontend/flow-build-phase-6.md +524 -524
- package/prompts/frontend/flow-build-phase-7.md +1001 -1001
- package/prompts/frontend/flow-build-phase-8.md +872 -872
- package/prompts/frontend/flow-build-phase-9.md +94 -94
- package/prompts/frontend/flow-build.md +137 -137
- package/prompts/frontend/flow-check-review.md +656 -20
- package/prompts/frontend/flow-check-test.md +526 -14
- package/prompts/frontend/flow-check.md +717 -67
- package/prompts/frontend/flow-commit.md +88 -119
- package/prompts/frontend/flow-docs-sync.md +550 -550
- package/prompts/frontend/flow-finish.md +919 -0
- package/prompts/frontend/flow-release.md +519 -0
- package/prompts/frontend/flow-work-api.md +1547 -0
- package/prompts/frontend/flow-work-feature.md +61 -61
- package/prompts/frontend/flow-work-fix.md +38 -38
- package/prompts/frontend/flow-work-refactor.md +48 -48
- package/prompts/frontend/flow-work-resume.md +34 -34
- package/prompts/frontend/flow-work.md +1595 -1320
- package/prompts/mobile/flow-build-phase-0.md +425 -425
- package/prompts/mobile/flow-build-phase-1.md +626 -626
- package/prompts/mobile/flow-build-phase-10.md +32 -32
- package/prompts/mobile/flow-build-phase-2.md +573 -573
- package/prompts/mobile/flow-build-phase-3.md +782 -782
- package/prompts/mobile/flow-build-phase-4.md +554 -554
- package/prompts/mobile/flow-build-phase-5.md +703 -703
- package/prompts/mobile/flow-build-phase-6.md +524 -524
- package/prompts/mobile/flow-build-phase-7.md +1001 -1001
- package/prompts/mobile/flow-build-phase-8.md +888 -888
- package/prompts/mobile/flow-build-phase-9.md +90 -90
- package/prompts/mobile/flow-build.md +135 -135
- package/prompts/mobile/flow-check-review.md +656 -20
- package/prompts/mobile/flow-check-test.md +526 -14
- package/prompts/mobile/flow-check.md +717 -67
- package/prompts/mobile/flow-commit.md +88 -119
- package/prompts/mobile/flow-docs-sync.md +620 -620
- package/prompts/mobile/flow-finish.md +919 -0
- package/prompts/mobile/flow-release.md +751 -0
- package/prompts/mobile/flow-work-api.md +1500 -0
- package/prompts/mobile/flow-work-feature.md +61 -61
- package/prompts/mobile/flow-work-fix.md +46 -46
- package/prompts/mobile/flow-work-refactor.md +48 -48
- package/prompts/mobile/flow-work-resume.md +34 -34
- package/prompts/mobile/flow-work.md +1605 -1329
- package/prompts/shared/mermaid-guidelines.md +102 -102
- package/prompts/shared/scope-levels.md +114 -114
- package/prompts/shared/smart-skip-preflight.md +214 -214
- package/prompts/shared/story-points.md +55 -55
- package/prompts/shared/task-format.md +74 -74
- package/prompts/shared/task-summary-template.md +277 -277
- package/templates/AGENT.template.md +443 -443
- package/templates/backend/.clauderules.template +112 -112
- package/templates/backend/.cursorrules.template +102 -102
- package/templates/backend/README.template.md +2 -2
- package/templates/backend/ai-instructions.template.md +2 -2
- package/templates/backend/copilot-instructions.template.md +2 -2
- package/templates/backend/docs/api.template.md +320 -320
- package/templates/backend/docs/business-flows.template.md +97 -97
- package/templates/backend/docs/code-standards.template.md +2 -2
- package/templates/backend/docs/contributing.template.md +3 -3
- package/templates/backend/docs/data-model.template.md +520 -520
- package/templates/backend/docs/testing.template.md +2 -2
- package/templates/backend/project-brief.template.md +2 -2
- package/templates/backend/specs/configuration.template.md +2 -2
- package/templates/backend/specs/security.template.md +2 -2
- package/templates/desktop/.clauderules.template +112 -112
- package/templates/desktop/.cursorrules.template +102 -102
- package/templates/desktop/README.template.md +170 -170
- package/templates/desktop/ai-instructions.template.md +366 -366
- package/templates/desktop/copilot-instructions.template.md +140 -140
- package/templates/desktop/docs/docs/api.template.md +320 -320
- package/templates/desktop/docs/docs/architecture.template.md +724 -724
- package/templates/desktop/docs/docs/business-flows.template.md +102 -102
- package/templates/desktop/docs/docs/code-standards.template.md +792 -792
- package/templates/desktop/docs/docs/contributing.template.md +149 -149
- package/templates/desktop/docs/docs/data-model.template.md +520 -520
- package/templates/desktop/docs/docs/operations.template.md +720 -720
- package/templates/desktop/docs/docs/testing.template.md +722 -722
- package/templates/desktop/project-brief.template.md +150 -150
- package/templates/desktop/specs/specs/configuration.template.md +121 -121
- package/templates/desktop/specs/specs/security.template.md +392 -392
- package/templates/frontend/README.template.md +2 -2
- package/templates/frontend/ai-instructions.template.md +2 -2
- package/templates/frontend/docs/api-integration.template.md +362 -362
- package/templates/frontend/docs/components.template.md +2 -2
- package/templates/frontend/docs/error-handling.template.md +360 -360
- package/templates/frontend/docs/operations.template.md +107 -107
- package/templates/frontend/docs/performance.template.md +124 -124
- package/templates/frontend/docs/pwa.template.md +119 -119
- package/templates/frontend/docs/state-management.template.md +2 -2
- package/templates/frontend/docs/styling.template.md +2 -2
- package/templates/frontend/docs/testing.template.md +2 -2
- package/templates/frontend/project-brief.template.md +2 -2
- package/templates/frontend/specs/accessibility.template.md +95 -95
- package/templates/frontend/specs/configuration.template.md +2 -2
- package/templates/frontend/specs/security.template.md +175 -175
- package/templates/fullstack/README.template.md +252 -252
- package/templates/fullstack/ai-instructions.template.md +444 -444
- package/templates/fullstack/project-brief.template.md +157 -157
- package/templates/fullstack/specs/configuration.template.md +340 -340
- package/templates/mobile/README.template.md +167 -167
- package/templates/mobile/ai-instructions.template.md +196 -196
- package/templates/mobile/docs/app-store.template.md +135 -135
- package/templates/mobile/docs/architecture.template.md +63 -63
- package/templates/mobile/docs/native-features.template.md +94 -94
- package/templates/mobile/docs/navigation.template.md +59 -59
- package/templates/mobile/docs/offline-strategy.template.md +65 -65
- package/templates/mobile/docs/permissions.template.md +56 -56
- package/templates/mobile/docs/state-management.template.md +85 -85
- package/templates/mobile/docs/testing.template.md +109 -109
- package/templates/mobile/project-brief.template.md +69 -69
- package/templates/mobile/specs/build-configuration.template.md +91 -91
- package/templates/mobile/specs/deployment.template.md +92 -92
- 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
|
+
```
|