ai-flow-dev 2.1.7 → 2.1.9

package/prompts/backend/flow-build-phase-9.md

@@ -1,17 +1,12 @@
-# AI Flow - Phase 9: Implementation Roadmap
+## PHASE 9: Implementation Roadmap (5-10 min)
 
-**YOU ARE AN EXPERT PROJECT MANAGER AND TECHNICAL ARCHITECT.**
+> **Order for this phase:** OPTIONAL. Executed after Phase 8 or on demand.
 
-Generate a complete `docs/roadmap.md` with atomic, executable tasks derived from project documentation.
+> **📌 Scope-based behavior:**
+> - **All Scopes:** Generate a complete Implementation Roadmap with atomic tasks.
 
-## Prerequisites
-
-- Phase 8 completed (all documentation generated)
-- Files exist: `docs/data-model.md`, `docs/api.md`, `docs/architecture.md`, `specs/security.md`
-
-## Duration: 60-90 minutes
-
----
+### Objective
+Translate all architectural and business specifications into a prioritized, actionable implementation plan (Roadmap) with clear milestones and tasks.
 
 ## Context Variables (Extract from docs)
 
@@ -409,5 +404,59 @@ PHASE 9 COMPLETE
 ├── Coverage: 100% (all components have [E][R][S][C][T][D])
 └── Ready for: /flow-dev-feature
 
-Next: Open docs/roadmap.md and start with EP-000
+Next: Open docs/roadmap.md and start with EP-000, or continue to Phase 10 for detailed User Stories.
+
+**OFFER PHASE 10:**
+
+```
+---
+✅ PHASE 9 COMPLETE: IMPLEMENTATION ROADMAP GENERATED
+---
+🎯 Roadmap created in docs/roadmap.md
+📊 Total Story Points: {{SP}}
+🏗️ Epics defined: {{EPICS_COUNT}}
+---
+🚀 Optional: Generate Detailed User Stories?
+---
+Phase 10 will convert your roadmap features into detailed User Stories with:
+
+✅ Gherkin-style Acceptance Criteria (Given/When/Then)
+✅ Functional, Error, Edge, and Security scenarios
+✅ Technical details inherited from patterns
+✅ Ready-to-use QA Test Cases with data
+✅ Definition of Done (DoD) checklist
+
+⏱️ Estimated time: 30-60 minutes
+
+Would you like to continue to Phase 10?
+
+A) ✅ Yes, generate User Stories now (recommended)
+   → Best for Sprint planning and QA alignment
+   → Will generate {{FEATURES_COUNT}} User Stories
+
+B) ⏭️ Skip for now (you can run Phase 10 later)
+   → You can start coding directly from roadmap
+   → Run Phase 10 anytime: /flow-build fase 10
+
+Your choice (A/B): __
 ```
+
+---
+
+## 📝 Generated Documents
+
+After Phase 9, generate/update:
+
+- `docs/roadmap.md` - Technical implementation plan
+
+---
+
+**Next Phase:** Phase 10 - Agile Planning (User Stories)
+
+Read: `.ai-flow/prompts/backend/flow-build-phase-10.md`
+
+---
+
+**Last Updated:** 2025-12-20
+**Version:** 2.1.8
+

package/prompts/backend/flow-build.md

@@ -16,14 +16,14 @@ Your mission is to guide the user through creating **comprehensive, production-r
 
 Buscar en el mensaje del usuario patrones como:
 
-- "fase 0", "fase 1", "fase 2", ..., "fase 9"
+- "fase 0", "fase 1", "fase 2", ..., "fase 10"
 - "phase 0", "phase 1", etc.
 - "ejecutar fase N"
 - "run phase N"
 
 ### Comportamiento
 
-**Si se detecta "fase N" (donde N = 0-9):**
+**Si se detecta "fase N" (donde N = 0-10):**
 
 1. **Validar que la fase existe para backend:**
    - Fase 0: Context Discovery (opcional, solo proyectos existentes)
@@ -36,6 +36,7 @@ Buscar en el mensaje del usuario patrones como:
    - Fase 7: Operations & Deployment
    - Fase 8: Project Setup & Final Documentation
    - Fase 9: Implementation Roadmap (opcional)
+   - Fase 10: User Stories Generation (opcional)
 
 2. **Si la fase es válida:**
    - Leer el archivo: `.ai-flow/prompts/backend/flow-build-phase-N.md`
@@ -45,14 +46,14 @@ Buscar en el mensaje del usuario patrones como:
 
 3. **Si la fase es inválida:**
    - Mostrar mensaje de error amigable
-   - Listar las fases válidas (0-9) con descripción de una línea
+   - Listar las fases válidas (0-10) con descripción de una línea
 
 **Si NO se detecta "fase N":**
 
 - Ejecutar el flujo completo normal (todas las fases en orden)
 - Comenzar con Mode Selection (Interactive vs Smart Auto-Suggest)
 - Continuar con Scope Selection (MVP/Production-Ready/Enterprise)
-- Ejecutar Phases 0-9 según corresponda
+- Ejecutar Phases 0-10 según corresponda
 
 ### Ejemplo de Lista de Fases Válidas
 
@@ -73,6 +74,7 @@ Si el usuario especifica una fase inválida, mostrar:
   /flow-build fase 7  - Operations & Deployment (deployment, monitoreo, logging)
   /flow-build fase 8  - Project Setup & Final Documentation (inicializar proyecto)
   /flow-build fase 9  - Implementation Roadmap (plan con Story Points - opcional)
+  /flow-build fase 10 - User Stories Generation (Gherkin AC & Test Cases - opcional)
 ---
 💡 Tip: Usa /flow-build sin argumentos para ejecutar todas las fases en orden.
 ```
@@ -368,6 +370,8 @@ Execute phases sequentially by reading each file in order:
 7. **Phase 6 (Testing Strategy):** Read `.ai-flow/prompts/backend/flow-build-phase-6-testing.md`
 8. **Phase 7 (Operations & Deployment):** Read `.ai-flow/prompts/backend/flow-build-phase-7-operations.md`
 9. **Phase 8 (Project Setup & Final Documentation):** Read `.ai-flow/prompts/backend/flow-build-phase-8.md`
+10. **Phase 9 (Implementation Roadmap):** Read `.ai-flow/prompts/backend/flow-build-phase-9.md`
+11. **Phase 10 (User Stories Generation):** Read `.ai-flow/prompts/backend/flow-build-phase-10.md`
 
 ### For Individual Phases
 
@@ -565,6 +569,26 @@ Read .ai-flow/prompts/backend/flow-build-phase-4-security.md and execute only Ph
 
 **Skip if:** You prefer to start coding immediately without a detailed roadmap
 ---
+### Phase 10: User Stories Generation (Optional)
+
+**File:** `backend/flow-build-phase-10.md`
+**Duration:** 30-60 minutes
+**Key Steps:**
+
+- Load context from Phase 9 roadmap
+- Generate detailed User Stories for selected Epics/Features
+- Create Gherkin-style Acceptance Criteria (Given/When/Then)
+- Inherit technical tasks from roadmap
+- Generate QA Test Cases with specific data
+- Update roadmap with links to User Stories
+
+**Generates:**
+
+- `docs/user-stories/EP-XXX/HU-XXX-YYY.md` (User Story)
+- `docs/user-stories/EP-XXX/tests/TC-XXX-YYY.md` (Test Cases)
+
+**Skip if:** You don't need detailed user stories or Gherkin AC for your workflow
+---
 ## 🚀 Quick Start Guide
 
 ### For New Projects
@@ -842,7 +866,7 @@ Continue with Phase 8?
 
 A) ✅ Yes, continue to Phase 8 (recommended) - 10-15 min
    → Initialize project + Generate final docs
-   → Then option to continue to Phase 9 (roadmap)
+   → Then option to continue to Phase 9 (roadmap) and Phase 10 (user stories)
 
 B) No, I'll review documentation first
 
@@ -868,15 +892,18 @@ Your choice (A): __
 3. (Optional) Continue to Phase 9: Implementation Roadmap (15-30 min)
    → Generates complete implementation plan with Story Points
    → Includes Epics, Features, Tasks, and execution order
-4. Start implementing: /feature <feature-name>
+4. (Optional) Continue to Phase 10: User Stories Generation (30-60 min)
+   → Generates Gherkin AC, technical details, and QA test cases
+5. Start implementing: /feature <feature-name>
    → Implements features following your architecture
 
 💡 Tip: All phases are independent and re-executable.
 ---
 ```
 ---
+_Version: 4.1 (Phase 10 integrated - User Stories Generation with Gherkin AC)_
+_Last Updated: 2025-12-20_
 _Version: 4.0 (Phase 9 integrated - Implementation Roadmap with Story Points)_
-_Last Updated: 2025-12-09_
 _Version: 3.0 (Unified workflow: Phase 8 integrates project setup + final docs generation)_
 _AI Flow - Transform your idea into production-ready code in minutes_
 

package/prompts/frontend/flow-build-phase-1.md

@@ -1,22 +1,131 @@
 # Phase 1: Discovery & UX Requirements
 
 **Duration:** 15-20 minutes
-**Questions:** ~10 questions
+**Questions:** ~11 questions
 **Output:** project-brief.md, parts of AGENT.md
----
+---
 ## 🎯 Objective
 
-Understand the **user-facing aspects** of the application:
+Understand the **user-facing aspects** and core goal of the application:
 
-1. What type of application is being built?
-2. Who are the target users?
-3. What are the key user journeys?
-4. What devices and browsers must be supported?
-5. What are the UX priorities?
----
+1. What is the core goal and purpose of the project?
+2. What type of application is being built?
+3. Who are the target users?
+4. What are the key user journeys?
+5. What devices and browsers must be supported?
+6. What are the UX priorities?
+---
 ## 📋 Questions
 
-### Question 1.1: Application Type
+### Question 1.1: Project Name & Description (with Smart Refinement)
+
+> **🧠 Intelligent Refinement System**: This question detects vague descriptions and guides the developer to enrich them. It only asks what's missing and responds in the developer's language.
+
+```
+What is the project name?
+
+Provide an initial description of your project.
+(Don't worry about perfection - we'll refine it together if needed!)
+
+Example: "A frontend dashboard for managing inventory in real-time"
+```
+
+**🔍 AI Internal: Ambiguity Analysis**
+
+After receiving the description, silently analyze for these criteria:
+
+| Criterion | Check For | Score +1 if present |
+|-----------|-----------|---------------------|
+| **WHO** | Specific user type mentioned (not just "users") | "store managers", "traders", "students" |
+| **WHAT** | Specific action/function (not just "view", "show") | "compare prices", "edit profiles", "visualize data" |
+| **WHY** | Purpose or value mentioned | "to increase conversion", "to save time", "to improve UX" |
+| **DOMAIN** | Industry/vertical indicated | "fintech", "e-commerce", "social media" |
+| **DETAIL** | Description has 10+ meaningful words | Not counting articles |
+
+**Scoring Rules:**
+- Score 4-5: ✅ Accept immediately → Proceed to 1.2
+- Score 0-3: ⚠️ Enter refinement loop → Ask ONLY missing criteria
+
+---
+
+**🔄 Conditional Refinement Loop (only if score < 4)**
+
+> **CRITICAL**: Only ask about criteria that are MISSING. Do NOT repeat questions already answered. Respond in the SAME LANGUAGE the developer used.
+
+```
+[LANGUAGE: Match the developer's language]
+
+🔍 I'd like to understand your project better.
+
+Your description: "[original description]"
+
+[ONLY show questions for MISSING criteria:]
+
+[If WHO is missing:]
+1️⃣ WHO will use this application?
+   A) End consumers (B2C)
+   B) Business users (B2B)
+   C) Internal team / Admin
+   D) Other: __
+
+[If WHAT is missing:]
+2️⃣ WHAT is the core UX action users will perform?
+   A) Browse & Shop
+   B) Manage & Configure
+   C) Read & Consume
+   D) Create & Publish
+   E) Analyze & Visualize
+   F) Other: __
+
+[If WHY is missing:]
+3️⃣ WHY is this project needed?
+   A) Launch new product
+   B) Replace legacy UI
+   C) Better mobile experience
+   D) Specific new feature
+   E) Other: __
+
+[If DOMAIN is missing:]
+4️⃣ What INDUSTRY/DOMAIN is this for?
+   A) E-commerce/Retail
+   B) Fitness/Health
+   C) Finance/Payments
+   D) Education
+   E) Social/Community
+   F) Business tools (CRM, ERP)
+   G) Other: __
+
+Your answers: __
+```
+
+---
+
+**✨ Generate Professional Description Options**
+
+After gathering missing info, generate 3 polished versions:
+
+```
+[LANGUAGE: Match the developer's language]
+
+✨ Based on your input, here are 3 professional descriptions:
+
+A) Concise (for package.json):
+   "[Generated 1-line description]"
+
+B) Descriptive (for README.md):
+   "[Generated 2-3 line description with UX focus]"
+
+C) Creative (for Marketing/Landing):
+   "[Generated catchy description]"
+
+Which do you prefer? (1-3, or 4 to edit, 5 to start over)
+```
+
+**Your choice:**
+
+---
+
+### Question 1.2: Application Type
 
 **What type of frontend application are you building?**
 
@@ -51,10 +160,26 @@ E) **Static Site (SSG)**
 - Best for: Blogs, documentation, landing pages
 
 **Your answer:**
----
-### Question 1.2: Target Users
+---
+### Question 1.3: Target Users (Confirmation + Expansion)
+
+```
+[If WHO was captured in 1.1, show:]
+
+✅ Based on your description, your target users are: [WHO from 1.1]
+
+Describe your user personas more deeply (3-5 bullet points):
+
+- Demographics (age, tech-savviness, etc.)
+- Use cases / goals
+- Device preferences
+- Accessibility needs
 
-**Who are your primary target users?**
+---
+
+[If WHO was NOT captured in 1.1, ask normally:]
+
+Who are your primary target users?
 
 Describe your user personas (3-5 bullet points):
 
@@ -62,6 +187,7 @@ Describe your user personas (3-5 bullet points):
 - Use cases / goals
 - Device preferences
 - Accessibility needs
+```
 
 **Example:**
 
@@ -73,12 +199,22 @@ Describe your user personas (3-5 bullet points):
 ```
 
 **Your answer:**
----
-### Question 1.3: Key User Journeys
+---
+### Question 1.4: Key User Journeys (Confirmation + Expansion)
+
+```
+[If WHAT was captured in 1.1, show:]
+
+✅ Based on your description, a core journey is: [WHAT from 1.1]
+
+What are the 3-5 most critical user flows?
 
-**What are the 3-5 most critical user flows?**
+---
 
-List the core journeys users will take through your app.
+[If WHAT was NOT captured in 1.1, ask normally:]
+
+What are the 3-5 most critical user flows?
+```
 
 **Example:**
 
@@ -90,8 +226,8 @@ List the core journeys users will take through your app.
 ```
 
 **Your answer:**
----
-### Question 1.4: Device & Browser Support
+---
+### Question 1.5: Device & Browser Support
 
 **What devices and browsers must you support?**
 
@@ -122,8 +258,8 @@ D) **Desktop-First**
 - Best for: Admin panels, dashboards, B2B tools
 
 **Your answer:**
----
-### Question 1.5: Responsive Strategy
+---
+### Question 1.6: Responsive Strategy
 
 **How will you handle different screen sizes?**
 
@@ -150,8 +286,8 @@ D) **Fixed Width (Desktop Only)**
 - Best for: Internal tools, admin panels (desktop-only users)
 
 **Your answer:**
----
-### Question 1.6: Internationalization (i18n)
+---
+### Question 1.7: Internationalization (i18n)
 
 **Do you need multi-language support?**
 
@@ -180,8 +316,8 @@ D) **Right-to-Left (RTL) Support**
 **Your answer:**
 
 **If multi-language selected, list target languages:**
----
-### Question 1.7: Authentication Requirements
+---
+### Question 1.8: Authentication Requirements
 
 **What authentication method will you use?**
 
@@ -219,8 +355,8 @@ F) **No Authentication**
 - Best for: Marketing sites, public tools
 
 **Your answer:**
----
-### Question 1.8: Data Privacy & Compliance
+---
+### Question 1.9: Data Privacy & Compliance
 
 **What data privacy requirements do you have?**
 
@@ -257,8 +393,8 @@ F) **Multiple Regulations**
 - Most restrictive controls apply
 
 **Your answer:**
----
-### Question 1.9: Offline Support
+---
+### Question 1.10: Offline Support
 
 **Do users need offline access?**
 
@@ -287,8 +423,8 @@ D) **Offline-First**
 - Best for: Mobile apps, unreliable networks
 
 **Your answer:**
----
-### Question 1.10: Performance Priorities
+---
+### Question 1.11: Performance Priorities
 
 **What are your performance priorities?** (Select top 3)
 
@@ -327,25 +463,27 @@ F) **Perceived Performance**
 - Best for: User experience
 
 **Your answer (top 3):**
----
+---
 ## 📊 Phase 1 Summary
 
 Before proceeding to Phase 2, confirm the following:
 
 ```
----
+---
 📋 PHASE 1 SUMMARY: DISCOVERY & UX
----
-Application Type: [Answer from 1.1]
-Target Users: [Answer from 1.2]
-Key User Journeys: [Answer from 1.3]
-Device/Browser Support: [Answer from 1.4]
-Responsive Strategy: [Answer from 1.5]
-Internationalization: [Answer from 1.6]
-Authentication: [Answer from 1.7]
-Data Privacy: [Answer from 1.8]
-Offline Support: [Answer from 1.9]
-Performance Priorities: [Answer from 1.10]
+---
+Project Name: [Answer from 1.1]
+Project Description: [Answer from 1.1]
+Application Type: [Answer from 1.2]
+Target Users: [Answer from 1.3]
+Key User Journeys: [Answer from 1.4]
+Device/Browser Support: [Answer from 1.5]
+Responsive Strategy: [Answer from 1.6]
+Internationalization: [Answer from 1.7]
+Authentication: [Answer from 1.8]
+Data Privacy: [Answer from 1.9]
+Offline Support: [Answer from 1.10]
+Performance Priorities: [Answer from 1.11]
 
 Is this correct? (Y/n)
 ```
@@ -353,7 +491,7 @@ Is this correct? (Y/n)
 If **Yes:** Proceed to Phase 2
 
 If **No:** Allow user to correct specific answers
----
+---
 ## 📝 Document Generation (Partial)
 
 At the end of Phase 1, generate or update:
@@ -439,7 +577,7 @@ At the end of Phase 1, generate or update:
 - Authentication: {{AUTH_METHOD}}
 - Compliance: {{DATA_PRIVACY_COMPLIANCE}}
 ```
----
+---
 ## 🚀 Next Steps
 
 ```
@@ -453,11 +591,7 @@ Next: Phase 2 - Components & Framework
 
 Read: .ai-flow/prompts/frontend/flow-build-phase-2-components.md
 ```
----
-**Last Updated:** 2025-01-XX
-
-**Version:** 1.2.0
-
-
-
+---
+**Last Updated:** 2025-12-XX
 
+**Version:** 1.3.0