ai-flow-dev 2.7.0 → 2.8.0

package/prompts/desktop/flow-build-phase-10.md

@@ -1,357 +1,357 @@
-## PHASE 10: User Stories Generation (5-10 min)
-
-> **Order for this phase:** OPTIONAL. Executed after Phase 9 or on demand.
-
-### Objective
-
-Generate comprehensive User Stories from the Implementation Roadmap, mapping features to user needs.
-
----
-
-## User Story Format
-
-```
-# HU-XXX-XXX: [User Story Title]
-
-**Epic:** EP-XXX - [Epic Name]
-**Priority:** P0 / P1 / P2 / P3
-**Story Points:** X SP
-**Status:** Not Started
-
----
-
-## User Story
-
-**As a** [user type],
-**I want** [goal/desire],
-**So that** [benefit/value].
-
----
-
-## Acceptance Criteria
-
-- [ ] Given [context], when [action], then [expected result]
-- [ ] Given [context], when [action], then [expected result]
-- [ ] Given [context], when [action], then [expected result]
-
----
-
-## Technical Tasks
-
-From planning/roadmap.md:
-
-- [ ] TXXX [CAT] Description • 1 SP → {{path}} | deps: TXXX
-- [ ] TXXX [CAT] Description • 1 SP → {{path}} | deps: TXXX
-
----
-
-## Definition of Done
-
-- [ ] All technical tasks completed
-- [ ] All acceptance criteria met
-- [ ] Unit tests passing
-- [ ] UI tests passing (if applicable)
-- [ ] Code reviewed
-- [ ] Documentation updated
-
----
-
-## Notes
-
-[Additional context, dependencies, or considerations]
-
----
-
-**Created:** 2025-02-03
-**Updated:** 2025-02-03
-```
-
----
-
-## Workflow: 4 Steps
-
-### Step 10.1: Extract Epics and Features
-
-**Read planning/roadmap.md and extract:**
-
-```
-EPICS FOUND:
-├── EP-001: Foundation (15 SP)
-├── EP-002: Data Layer (25 SP)
-├── EP-003: Business Logic (20 SP)
-├── EP-004: UI Foundation (20 SP)
-├── EP-005: UI Components (30 SP)
-├── EP-006: Controllers (25 SP)
-├── EP-007: Features (35 SP)
-└── EP-008: Packaging (10 SP)
-
-FEATURES EXTRACTED (from project-brief.md + docs):
-├── User Authentication
-├── Project Management
-├── Task Management
-├── File Operations
-├── Search & Filter
-├── Reports & Export
-└── Settings & Preferences
-```
-
----
-
-### Step 10.2: Map Features to User Stories
-
-**Generate User Story for each feature:**
-
-**Example: User Authentication**
-
-```markdown
-# HU-001-001: User Login
-
-**Epic:** EP-001 - Foundation
-**Priority:** P0
-**Story Points:** 8 SP
-**Status:** Not Started
-
----
-
-## User Story
-
-**As a** registered user,
-**I want** to log into the application with my credentials,
-**So that** I can access my personalized data and settings.
-
----
-
-## Acceptance Criteria
-
-- [ ] Given I am on the login screen, when I enter valid credentials, then I am redirected to the main window
-- [ ] Given I am on the login screen, when I enter invalid credentials, then I see an error message "Invalid username or password"
-- [ ] Given I am on the login screen, when I leave fields empty, then the Login button is disabled
-- [ ] Given I am logged in, when I close the application, then my session is saved (if "Remember me" is checked)
-- [ ] Given I exceed 5 failed login attempts, when I try again, then my account is locked for 15 minutes
-
----
-
-## Technical Tasks
-
-From planning/roadmap.md:
-
-- [ ] T025 [M] Create User entity (id, username, password, email) • 1 SP → {{SRC}}/{{MODEL_DIR}}/User{{EXT}} | deps: T012
-- [ ] T026 [D] Create UserDAO interface • 1 SP → {{SRC}}/{{DAO_DIR}}/UserDAO{{EXT}} | deps: T025
-- [ ] T027 [D] Implement UserDAO.findByUsername() • 1 SP → {{SRC}}/{{DAO_DIR}}/UserDAOImpl{{EXT}} | deps: T026
-- [ ] T028 [S] Create AuthService • 1 SP → {{SRC}}/{{SERVICE_DIR}}/AuthService{{EXT}} | deps: T027
-- [ ] T029 [S] Implement AuthService.login(username, password) • 2 SP → {{SRC}}/{{SERVICE_DIR}}/AuthService{{EXT}} | deps: T028
-- [ ] T030 [V] Create LoginDialog UI • 2 SP → {{SRC}}/{{VIEW_DIR}}/LoginDialog{{EXT}} | deps: none
-- [ ] T031 [C] Create LoginController • 1 SP → {{SRC}}/{{CONTROLLER_DIR}}/LoginController{{EXT}} | deps: T029,T030
-
----
-
-## Definition of Done
-
-- [ ] All technical tasks completed (T025-T031)
-- [ ] All acceptance criteria met
-- [ ] Unit tests for AuthService passing
-- [ ] UI tests for LoginDialog passing
-- [ ] Code reviewed and merged
-- [ ] Documentation updated (docs/FEATURES.md)
-
----
-
-## Notes
-
-- Password must be hashed (BCrypt) before storing
-- Session token stored securely (Preferences API or Keychain)
-- Lock mechanism uses timestamp in database
-- "Remember me" stores encrypted token
-
----
-
-**Created:** 2025-02-03
-**Updated:** 2025-02-03
-```
-
----
-
-### Step 10.3: Generate Remaining User Stories
-
-**Generate User Stories for all features:**
-
-```
-USER STORIES TO GENERATE:
-
-EP-001: Foundation
-├── HU-001-001: User Login (P0, 8 SP)
-└── HU-001-002: User Registration (P0, 8 SP)
-
-EP-002: Data Layer
-├── HU-002-001: Persist User Data (P0, 5 SP)
-├── HU-002-002: Persist Project Data (P0, 5 SP)
-└── HU-002-003: Persist Task Data (P0, 5 SP)
-
-EP-003: Business Logic
-├── HU-003-001: Validate User Input (P0, 3 SP)
-├── HU-003-002: Calculate Project Progress (P1, 5 SP)
-└── HU-003-003: Manage Task Status (P1, 5 SP)
-
-EP-004: UI Foundation
-├── HU-004-001: Navigate Main Window (P0, 8 SP)
-├── HU-004-002: Access Menu Bar (P0, 5 SP)
-└── HU-004-003: Use Toolbar (P1, 3 SP)
-
-EP-005: UI Components
-├── HU-005-001: Create New Project (P0, 8 SP)
-├── HU-005-002: Edit Project Details (P1, 5 SP)
-├── HU-005-003: Delete Project (P1, 3 SP)
-├── HU-005-004: Create New Task (P0, 8 SP)
-├── HU-005-005: Edit Task Details (P1, 5 SP)
-└── HU-005-006: Delete Task (P1, 3 SP)
-
-EP-006: Controllers
-├── HU-006-001: Handle Button Clicks (P0, 3 SP)
-├── HU-006-002: Handle Keyboard Shortcuts (P1, 5 SP)
-└── HU-006-003: Handle Drag & Drop (P1, 5 SP)
-
-EP-007: Features
-├── HU-007-001: Search Projects (P1, 8 SP)
-├── HU-007-002: Filter Tasks (P1, 5 SP)
-├── HU-007-003: Export to PDF (P1, 8 SP)
-├── HU-007-004: Import from CSV (P2, 8 SP)
-└── HU-007-005: Generate Reports (P1, 8 SP)
-
-EP-008: Packaging
-├── HU-008-001: Install Application (P0, 3 SP)
-└── HU-008-002: Auto-Update Application (P2, 8 SP)
-
-TOTAL: 30 User Stories
-```
-
----
-
-### Step 10.4: Generate planning/user-stories/ structure
-
-**Create directory structure:**
-
-```
-planning/
-├── roadmap.md (already exists from Phase 9)
-└── user-stories/
-    ├── EP-001-Foundation/
-    │   ├── HU-001-001.md (User Login)
-    │   └── HU-001-002.md (User Registration)
-    ├── EP-002-Data-Layer/
-    │   ├── HU-002-001.md (Persist User Data)
-    │   ├── HU-002-002.md (Persist Project Data)
-    │   └── HU-002-003.md (Persist Task Data)
-    ├── EP-003-Business-Logic/
-    │   ├── HU-003-001.md
-    │   ├── HU-003-002.md
-    │   └── HU-003-003.md
-    ├── EP-004-UI-Foundation/
-    │   ├── HU-004-001.md
-    │   ├── HU-004-002.md
-    │   └── HU-004-003.md
-    ├── EP-005-UI-Components/
-    │   ├── HU-005-001.md
-    │   ├── HU-005-002.md
-    │   ├── HU-005-003.md
-    │   ├── HU-005-004.md
-    │   ├── HU-005-005.md
-    │   └── HU-005-006.md
-    ├── EP-006-Controllers/
-    │   ├── HU-006-001.md
-    │   ├── HU-006-002.md
-    │   └── HU-006-003.md
-    ├── EP-007-Features/
-    │   ├── HU-007-001.md
-    │   ├── HU-007-002.md
-    │   ├── HU-007-003.md
-    │   ├── HU-007-004.md
-    │   └── HU-007-005.md
-    └── EP-008-Packaging/
-        ├── HU-008-001.md
-        └── HU-008-002.md
-```
-
----
-
-### Phase 10 Output
-
-```
-✅ User Stories generated!
-
-Created: planning/user-stories/
-
-Summary:
-- 30 User Stories created
-- 8 Epic directories
-- All stories linked to roadmap tasks
-- Acceptance criteria defined
-- Definition of Done included
-
-File structure:
-planning/
-├── roadmap.md (180 tasks)
-└── user-stories/
-    ├── EP-001-Foundation/ (2 stories, 16 SP)
-    ├── EP-002-Data-Layer/ (3 stories, 15 SP)
-    ├── EP-003-Business-Logic/ (3 stories, 13 SP)
-    ├── EP-004-UI-Foundation/ (3 stories, 16 SP)
-    ├── EP-005-UI-Components/ (6 stories, 32 SP)
-    ├── EP-006-Controllers/ (3 stories, 13 SP)
-    ├── EP-007-Features/ (5 stories, 37 SP)
-    └── EP-008-Packaging/ (2 stories, 11 SP)
-
-Next steps:
-1. Review planning/user-stories/
-2. Start implementation with /flow-work HU-001-001
-3. Or continue by Epic: /flow-work EP-001
-
-Documentation complete! 🎉
-```
-
----
-
-## Final Summary
-
-```
-🎉 ALL PHASES COMPLETE!
-
-You now have:
-✅ Phase 0: Project Discovery (existing projects)
-✅ Phase 1: Desktop UX & Requirements
-✅ Phase 2: UI Components (Swing/JavaFX/SWT)
-✅ Phase 3: Architecture (MVC/MVP/MVVM)
-✅ Phase 4: Data & Storage
-✅ Phase 5: Code Standards
-✅ Phase 6: Testing Strategy
-✅ Phase 7: Packaging & Deployment
-✅ Phase 8: Project Setup & Docs
-✅ Phase 9: Implementation Roadmap (180 tasks)
-✅ Phase 10: User Stories (30 stories)
-
-Generated files:
-📄 project-brief.md
-📄 docs/ARCHITECTURE.md
-📄 docs/DATABASE.md
-📄 docs/DEVELOPMENT.md
-📄 docs/DEPLOYMENT.md
-📄 planning/roadmap.md
-📁 planning/user-stories/ (30 files)
-📄 README.md
-📄 .gitignore
-
-Ready to start development!
-
-Commands:
-- /flow-work HU-001-001 → Implement User Login
-- /flow-work EP-001 → Implement Foundation Epic
-- /flow-work T001 → Implement specific task
-- /flow-check → Review code quality
-- /flow-commit → Commit changes
-
-Happy coding! 🚀
-```
-
----
-
-**Last Updated:** 2025-02-03
-**Version:** 1.0.0
+## PHASE 10: User Stories Generation (5-10 min)
+
+> **Order for this phase:** OPTIONAL. Executed after Phase 9 or on demand.
+
+### Objective
+
+Generate comprehensive User Stories from the Implementation Roadmap, mapping features to user needs.
+
+---
+
+## User Story Format
+
+```
+# HU-XXX-XXX: [User Story Title]
+
+**Epic:** EP-XXX - [Epic Name]
+**Priority:** P0 / P1 / P2 / P3
+**Story Points:** X SP
+**Status:** Not Started
+
+---
+
+## User Story
+
+**As a** [user type],
+**I want** [goal/desire],
+**So that** [benefit/value].
+
+---
+
+## Acceptance Criteria
+
+- [ ] Given [context], when [action], then [expected result]
+- [ ] Given [context], when [action], then [expected result]
+- [ ] Given [context], when [action], then [expected result]
+
+---
+
+## Technical Tasks
+
+From planning/roadmap.md:
+
+- [ ] TXXX [CAT] Description • 1 SP → {{path}} | deps: TXXX
+- [ ] TXXX [CAT] Description • 1 SP → {{path}} | deps: TXXX
+
+---
+
+## Definition of Done
+
+- [ ] All technical tasks completed
+- [ ] All acceptance criteria met
+- [ ] Unit tests passing
+- [ ] UI tests passing (if applicable)
+- [ ] Code reviewed
+- [ ] Documentation updated
+
+---
+
+## Notes
+
+[Additional context, dependencies, or considerations]
+
+---
+
+**Created:** 2025-02-03
+**Updated:** 2025-02-03
+```
+
+---
+
+## Workflow: 4 Steps
+
+### Step 10.1: Extract Epics and Features
+
+**Read planning/roadmap.md and extract:**
+
+```
+EPICS FOUND:
+├── EP-001: Foundation (15 SP)
+├── EP-002: Data Layer (25 SP)
+├── EP-003: Business Logic (20 SP)
+├── EP-004: UI Foundation (20 SP)
+├── EP-005: UI Components (30 SP)
+├── EP-006: Controllers (25 SP)
+├── EP-007: Features (35 SP)
+└── EP-008: Packaging (10 SP)
+
+FEATURES EXTRACTED (from project-brief.md + docs):
+├── User Authentication
+├── Project Management
+├── Task Management
+├── File Operations
+├── Search & Filter
+├── Reports & Export
+└── Settings & Preferences
+```
+
+---
+
+### Step 10.2: Map Features to User Stories
+
+**Generate User Story for each feature:**
+
+**Example: User Authentication**
+
+```markdown
+# HU-001-001: User Login
+
+**Epic:** EP-001 - Foundation
+**Priority:** P0
+**Story Points:** 8 SP
+**Status:** Not Started
+
+---
+
+## User Story
+
+**As a** registered user,
+**I want** to log into the application with my credentials,
+**So that** I can access my personalized data and settings.
+
+---
+
+## Acceptance Criteria
+
+- [ ] Given I am on the login screen, when I enter valid credentials, then I am redirected to the main window
+- [ ] Given I am on the login screen, when I enter invalid credentials, then I see an error message "Invalid username or password"
+- [ ] Given I am on the login screen, when I leave fields empty, then the Login button is disabled
+- [ ] Given I am logged in, when I close the application, then my session is saved (if "Remember me" is checked)
+- [ ] Given I exceed 5 failed login attempts, when I try again, then my account is locked for 15 minutes
+
+---
+
+## Technical Tasks
+
+From planning/roadmap.md:
+
+- [ ] T025 [M] Create User entity (id, username, password, email) • 1 SP → {{SRC}}/{{MODEL_DIR}}/User{{EXT}} | deps: T012
+- [ ] T026 [D] Create UserDAO interface • 1 SP → {{SRC}}/{{DAO_DIR}}/UserDAO{{EXT}} | deps: T025
+- [ ] T027 [D] Implement UserDAO.findByUsername() • 1 SP → {{SRC}}/{{DAO_DIR}}/UserDAOImpl{{EXT}} | deps: T026
+- [ ] T028 [S] Create AuthService • 1 SP → {{SRC}}/{{SERVICE_DIR}}/AuthService{{EXT}} | deps: T027
+- [ ] T029 [S] Implement AuthService.login(username, password) • 2 SP → {{SRC}}/{{SERVICE_DIR}}/AuthService{{EXT}} | deps: T028
+- [ ] T030 [V] Create LoginDialog UI • 2 SP → {{SRC}}/{{VIEW_DIR}}/LoginDialog{{EXT}} | deps: none
+- [ ] T031 [C] Create LoginController • 1 SP → {{SRC}}/{{CONTROLLER_DIR}}/LoginController{{EXT}} | deps: T029,T030
+
+---
+
+## Definition of Done
+
+- [ ] All technical tasks completed (T025-T031)
+- [ ] All acceptance criteria met
+- [ ] Unit tests for AuthService passing
+- [ ] UI tests for LoginDialog passing
+- [ ] Code reviewed and merged
+- [ ] Documentation updated (docs/FEATURES.md)
+
+---
+
+## Notes
+
+- Password must be hashed (BCrypt) before storing
+- Session token stored securely (Preferences API or Keychain)
+- Lock mechanism uses timestamp in database
+- "Remember me" stores encrypted token
+
+---
+
+**Created:** 2025-02-03
+**Updated:** 2025-02-03
+```
+
+---
+
+### Step 10.3: Generate Remaining User Stories
+
+**Generate User Stories for all features:**
+
+```
+USER STORIES TO GENERATE:
+
+EP-001: Foundation
+├── HU-001-001: User Login (P0, 8 SP)
+└── HU-001-002: User Registration (P0, 8 SP)
+
+EP-002: Data Layer
+├── HU-002-001: Persist User Data (P0, 5 SP)
+├── HU-002-002: Persist Project Data (P0, 5 SP)
+└── HU-002-003: Persist Task Data (P0, 5 SP)
+
+EP-003: Business Logic
+├── HU-003-001: Validate User Input (P0, 3 SP)
+├── HU-003-002: Calculate Project Progress (P1, 5 SP)
+└── HU-003-003: Manage Task Status (P1, 5 SP)
+
+EP-004: UI Foundation
+├── HU-004-001: Navigate Main Window (P0, 8 SP)
+├── HU-004-002: Access Menu Bar (P0, 5 SP)
+└── HU-004-003: Use Toolbar (P1, 3 SP)
+
+EP-005: UI Components
+├── HU-005-001: Create New Project (P0, 8 SP)
+├── HU-005-002: Edit Project Details (P1, 5 SP)
+├── HU-005-003: Delete Project (P1, 3 SP)
+├── HU-005-004: Create New Task (P0, 8 SP)
+├── HU-005-005: Edit Task Details (P1, 5 SP)
+└── HU-005-006: Delete Task (P1, 3 SP)
+
+EP-006: Controllers
+├── HU-006-001: Handle Button Clicks (P0, 3 SP)
+├── HU-006-002: Handle Keyboard Shortcuts (P1, 5 SP)
+└── HU-006-003: Handle Drag & Drop (P1, 5 SP)
+
+EP-007: Features
+├── HU-007-001: Search Projects (P1, 8 SP)
+├── HU-007-002: Filter Tasks (P1, 5 SP)
+├── HU-007-003: Export to PDF (P1, 8 SP)
+├── HU-007-004: Import from CSV (P2, 8 SP)
+└── HU-007-005: Generate Reports (P1, 8 SP)
+
+EP-008: Packaging
+├── HU-008-001: Install Application (P0, 3 SP)
+└── HU-008-002: Auto-Update Application (P2, 8 SP)
+
+TOTAL: 30 User Stories
+```
+
+---
+
+### Step 10.4: Generate planning/user-stories/ structure
+
+**Create directory structure:**
+
+```
+planning/
+├── roadmap.md (already exists from Phase 9)
+└── user-stories/
+    ├── EP-001-Foundation/
+    │   ├── HU-001-001.md (User Login)
+    │   └── HU-001-002.md (User Registration)
+    ├── EP-002-Data-Layer/
+    │   ├── HU-002-001.md (Persist User Data)
+    │   ├── HU-002-002.md (Persist Project Data)
+    │   └── HU-002-003.md (Persist Task Data)
+    ├── EP-003-Business-Logic/
+    │   ├── HU-003-001.md
+    │   ├── HU-003-002.md
+    │   └── HU-003-003.md
+    ├── EP-004-UI-Foundation/
+    │   ├── HU-004-001.md
+    │   ├── HU-004-002.md
+    │   └── HU-004-003.md
+    ├── EP-005-UI-Components/
+    │   ├── HU-005-001.md
+    │   ├── HU-005-002.md
+    │   ├── HU-005-003.md
+    │   ├── HU-005-004.md
+    │   ├── HU-005-005.md
+    │   └── HU-005-006.md
+    ├── EP-006-Controllers/
+    │   ├── HU-006-001.md
+    │   ├── HU-006-002.md
+    │   └── HU-006-003.md
+    ├── EP-007-Features/
+    │   ├── HU-007-001.md
+    │   ├── HU-007-002.md
+    │   ├── HU-007-003.md
+    │   ├── HU-007-004.md
+    │   └── HU-007-005.md
+    └── EP-008-Packaging/
+        ├── HU-008-001.md
+        └── HU-008-002.md
+```
+
+---
+
+### Phase 10 Output
+
+```
+✅ User Stories generated!
+
+Created: planning/user-stories/
+
+Summary:
+- 30 User Stories created
+- 8 Epic directories
+- All stories linked to roadmap tasks
+- Acceptance criteria defined
+- Definition of Done included
+
+File structure:
+planning/
+├── roadmap.md (180 tasks)
+└── user-stories/
+    ├── EP-001-Foundation/ (2 stories, 16 SP)
+    ├── EP-002-Data-Layer/ (3 stories, 15 SP)
+    ├── EP-003-Business-Logic/ (3 stories, 13 SP)
+    ├── EP-004-UI-Foundation/ (3 stories, 16 SP)
+    ├── EP-005-UI-Components/ (6 stories, 32 SP)
+    ├── EP-006-Controllers/ (3 stories, 13 SP)
+    ├── EP-007-Features/ (5 stories, 37 SP)
+    └── EP-008-Packaging/ (2 stories, 11 SP)
+
+Next steps:
+1. Review planning/user-stories/
+2. Start implementation with /flow-work HU-001-001
+3. Or continue by Epic: /flow-work EP-001
+
+Documentation complete! 🎉
+```
+
+---
+
+## Final Summary
+
+```
+🎉 ALL PHASES COMPLETE!
+
+You now have:
+✅ Phase 0: Project Discovery (existing projects)
+✅ Phase 1: Desktop UX & Requirements
+✅ Phase 2: UI Components (Swing/JavaFX/SWT)
+✅ Phase 3: Architecture (MVC/MVP/MVVM)
+✅ Phase 4: Data & Storage
+✅ Phase 5: Code Standards
+✅ Phase 6: Testing Strategy
+✅ Phase 7: Packaging & Deployment
+✅ Phase 8: Project Setup & Docs
+✅ Phase 9: Implementation Roadmap (180 tasks)
+✅ Phase 10: User Stories (30 stories)
+
+Generated files:
+📄 project-brief.md
+📄 docs/ARCHITECTURE.md
+📄 docs/DATABASE.md
+📄 docs/DEVELOPMENT.md
+📄 docs/DEPLOYMENT.md
+📄 planning/roadmap.md
+📁 planning/user-stories/ (30 files)
+📄 README.md
+📄 .gitignore
+
+Ready to start development!
+
+Commands:
+- /flow-work HU-001-001 → Implement User Login
+- /flow-work EP-001 → Implement Foundation Epic
+- /flow-work T001 → Implement specific task
+- /flow-check → Review code quality
+- /flow-commit → Commit changes
+
+Happy coding! 🚀
+```
+
+---
+
+**Last Updated:** 2025-02-03
+**Version:** 1.0.0