ai-flow-dev 2.1.8 → 2.1.9

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

@@ -1,11 +1,12 @@
-# 🏆 Phase 8: Project Setup & Final Documentation
+## PHASE 8: Project Setup & Final Documentation (10-15 min)
 
-**Context:** Phases 1-7 have collected all project information. Now we'll initialize the framework (if needed) and generate all final documentation.
+> **Order for this phase:** MUST be executed after Phase 7.
 
-**Duration:** 10-15 minutes
+> **📌 Scope-based behavior:**
+> - **All Scopes:** Detect project state, initialize optional framework, and generate final documentation.
 
-**Goal:** Set up the project structure and create comprehensive documentation that consolidates all information from previous phases.
----
+### Objective
+Initialize the project structure (if starting from scratch) and consolidate all collected information into comprehensive documentation (README, API specs, contributing guides).
 ## 📋 Phase 8 Overview
 
 This final phase will:
@@ -16,7 +17,7 @@ This final phase will:
 4. **Generate master index** (AGENT.md)
 5. **Generate README.md** (with intelligent merge if needed)
 6. **Create tool-specific configs** (based on AI tool selection)
----
+---
 ## 8.1: Project State Detection
 
 > ⚠️ **PRE-REQUISITE CHECK:** Before proceeding, verify that README.md does NOT exist yet (unless it's a framework-generated one from previous initialization). If README.md exists and was NOT generated by a framework, this indicates an error in previous phases.
@@ -25,18 +26,26 @@ This final phase will:
 🔍 Detecting current project state...
 ```
 
-**Auto-detect:**
+**⚠️ CRITICAL: Ignore AI Flow documentation files during detection:**
+- Files: `project-brief.md`, `ai-instructions.md`, `.env.example`
+- Directories: `.ai-flow/`, `docs/`, `specs/`
 
-- [ ] Check for existing source code (`src/`, `app/`, `lib/`, etc.)
-- [ ] Check for framework files (`nest-cli.json`, `manage.py`, `go.mod`, etc.)
-- [ ] Check for package managers (`package.json`, `requirements.txt`, `go.mod`, etc.)
-- [ ] Check for existing README.md (framework-generated or custom)
+**Auto-detect Checklist:**
 
-**Classification:**
+- [ ] **Functional Source Code:** Check for business logic files (`.ts`, `.py`, `.go`, `.js`, etc.) in `src/`, `app/`, `internal/` or root.
+- [ ] **Framework Configuration:** Check for `nest-cli.json`, `manage.py`, `go.mod`, `pom.xml`, `package.json`, etc.
+- [ ] **Package Manager Lockfiles:** Check for `package-lock.json`, `pnpm-lock.yaml`, `poetry.lock`, etc.
+- [ ] **Existing README.md:** Is there a README.md that was NOT created by AI Flow?
 
-- **New Project**: No source code, no framework files
-- **Initialized Framework**: Has framework files, has source code
-- **Existing Project**: Has source code but AI Flow docs were just created
+**Classification Rules (Strict Order):**
+
+1.  **New Project** (Offer Initialization): 
+    - root contains ONLY AI Flow docs and/or hidden folders like `.git`, `.github`, `.vscode`.
+    - NO `package.json`, NO `src/`, NO functional code files.
+2.  **Initialized Framework** (Skip Initialization):
+    - Root contains framework configs (`package.json`, `go.mod`, etc.) but `src/` is empty or only contains framework boilerplate.
+3.  **Existing Project** (Skip Initialization):
+    - Substantial functional source code already exists in the project.
 
 **Present Detection Results:**
 
@@ -46,14 +55,14 @@ This final phase will:
 Type: [New Project | Initialized Framework | Existing Project]
 
 Found:
-- Source directories: [list or none]
+- Functional code: [list non-AI Flow source files or none]
 - Framework files: [list or none]
 - Package manager: [npm/pip/go/etc. or none]
 - README.md: [exists: yes/no]
 
 Recommendation: [Next action based on state]
 ```
----
+---
 ## 8.2: Framework Initialization (Optional)
 
 **Only if:** Project state = "New Project"
@@ -465,7 +474,7 @@ Next steps:
 - ✅ **ONLY** create .env.example, .gitignore, docker-compose (optional), ORM init
 - ✅ **LET** framework CLI handle structure, configs, dependencies
 - ✅ **REFER** to official docs for starter code when needed
----
+---
 ## 8.2.7: Generate .gitignore (Always)
 
 **IMPORTANT:** This step runs for ALL projects, regardless of framework initialization choice.
@@ -619,7 +628,7 @@ docker-compose.override.yml
 ✅ Generated: .gitignore
    Patterns included: [Node.js | Python | Go] + [Prisma] + [Docker]
 ```
----
+---
 ## 8.3: Generate Final Documentation
 
 ```
@@ -686,7 +695,7 @@ Generating...
 ```
 ✅ Generated: docs/business-flows.md
 ```
----
+---
 ### 8.3.2: Generate docs/api.md
 
 - **Template:** `.ai-flow/templates/docs/api.template.md`
@@ -768,7 +777,7 @@ We use [workflow from Phase 5]
 ```
 ✅ Generated: docs/contributing.md
 ```
----
+---
 ## 8.4: Generate AGENT.md (Master Index)
 
 - **Template:** `.ai-flow/templates/AGENT.template.md`
@@ -829,7 +838,7 @@ We use [workflow from Phase 5]
 
 [From operations.md and contributing.md]
 ```
----
+---
 ## 8.5: Generate README.md (Intelligent Merge)
 
 - **Template:** `.ai-flow/templates/README.template.md`
@@ -916,13 +925,13 @@ The API will be available at `http://localhost:3000`
 
 ````
 
-**📝 Action:** Write the complete file to `.ai-flow/README.md`
+**📝 Action:** Write the complete file to `README.md` (project root)
 
 ```
-✅ Generated: .ai-flow/README.md
+✅ Generated: README.md
    [If merged] Merged with framework's setup instructions
 ```
----
+---
 ## 8.6: Generate AGENT.md (Master Index)
 
 **CRITICAL:** Before generating AGENT.md, re-read ALL previously generated documents to have complete context.
@@ -955,7 +964,7 @@ Now generate AGENT.md with complete information from all documents.
 ```
 ✅ Generated: .ai-flow/AGENT.md (Master Index)
 ```
----
+---
 ## 8.7: Create Tool-Specific Configs
 
 **Based on AI tool selection from Phase 3 (question 3.8):**
@@ -1062,18 +1071,55 @@ Master index: `.ai-flow/AGENT.md`
 [Extract from code-standards.md]
 ```
 
+### If Antigravity selected:
+
+**Create `.antigravityrules`:**
+
+```markdown
+# Antigravity AI Configuration
+
+Project uses AI Flow documentation in `.ai-flow/` directory.
+
+## Documentation Index
+
+See `.ai-flow/AGENT.md` for complete document list.
+
+## Quick Reference
+
+- Tech Stack: [from Phase 3]
+- Architecture: `docs/architecture.md`
+- Code Standards: `docs/code-standards.md`
+- API Conventions: `docs/api.md`
+
+## Workflow Commands
+
+- `/flow-build` - Generate documentation
+- `/flow-dev-feature` - Create new features
+- `/flow-dev-fix` - Fix bugs
+- `/flow-dev-commit` - Automate commits
+
+## Code Generation Rules
+
+[Extract key rules from ai-instructions.md]
+
+## Testing Requirements
+
+[Extract from docs/testing.md]
+```
+
 **📝 Action:** Generate the tool-specific config files based on selection:
 
 - If Claude → Write `.clauderules`
 - If Cursor → Write `.cursorrules`
 - If Copilot → Write `.github/copilot-instructions.md`
-- If "All" → Write all three files
+- If Antigravity → Write `.antigravityrules`
+- If "All" → Write all four files
 
 ```
 ✅ Generated tool-specific configs:
    [List generated files based on selection]
 ```
----
+---
 ## 8.8: Final Validation & Success Message
 
 ```
@@ -1133,8 +1179,8 @@ Phase 8:
 ✅ README.md merged with framework's setup instructions
 
 Tool-specific configs:
-✅ [List generated configs: .clauderules, .cursorrules, .github/copilot-instructions.md]
----
+✅ [List generated configs: .clauderules, .cursorrules, .github/copilot-instructions.md, .antigravityrules]
+---
 📁 Project Structure:
 ```
 
@@ -1163,7 +1209,7 @@ your-project/
 └── [tool configs] # .clauderules, .cursorrules, etc.
 
 ````
----
+---
 Next steps:
 
 1. ⭐ **Read `.ai-flow/AGENT.md`** - Master index of all documentation
@@ -1175,7 +1221,7 @@ Next steps:
 5. 🚀 **Install dependencies** - Run: `[show command from Phase 7]`
 6. 💾 **Initialize git** (if not done) - `git init && git add . && git commit -m "Initial commit with AI Flow docs"`
 7. 🧪 **Start building!** - Your AI assistant now has complete project context
----
+---
 💡 **Remember:**
 
 - Documents are **living artifacts** - update them as project evolves
@@ -1183,7 +1229,7 @@ Next steps:
 - AGENT.md is the **single source of truth** for AI context
 
 🤖 **AI Assistant Usage:**
-Your AI assistant (Claude, Cursor, Copilot) will now:
+Your AI assistant (Claude, Cursor, Copilot, Antigravity) will now:
 
 - ✅ Understand complete project context
 - ✅ Follow your architecture patterns
@@ -1195,7 +1241,7 @@ Your AI assistant (Claude, Cursor, Copilot) will now:
 Happy building! 🎉
 
 ```
----
+---
 ## EXECUTION CHECKLIST FOR AI ASSISTANT
 
 When executing Phase 8:
@@ -1248,7 +1294,8 @@ When executing Phase 8:
 - [ ] Create .clauderules (if Claude)
 - [ ] Create .cursorrules (if Cursor)
 - [ ] Create .github/copilot-instructions.md (if Copilot)
-- [ ] Create all three (if "All")
+- [ ] Create .antigravityrules (if Antigravity)
+- [ ] Create all four (if "All")
 
 **8.7 Final Validation:**
 
@@ -1278,20 +1325,20 @@ When executing Phase 8:
 - 8.6: Tool configs - 1 min
 - 8.7: Validation - 1 min
 - **Total: 10-15 minutes**
----
+---
 **FINAL STEP: Offer Phase 9 (Implementation Roadmap)**
 
 ```
----
+---
 ✅ PHASE 8 COMPLETE: PROJECT READY FOR DEVELOPMENT
----
+---
 🎯 All documentation generated and validated!
 📁 Project initialized and ready
 📖 AGENT.md and README.md created
 ⚙️ AI tool configurations in place
----
+---
 🗺️ Optional: Generate Implementation Roadmap?
----
+---
 Phase 9 will analyze all your documentation and generate a complete
 implementation roadmap with:
 
@@ -1324,9 +1371,9 @@ Your choice (A/B): \_\_
 **If choice B:** Show completion message:
 
 ```
----
+---
 ✅ DOCUMENTATION COMPLETE - READY TO BUILD
----
+---
 Your project is fully documented and initialized! 🎉
 
 📖 Next steps:
@@ -1336,14 +1383,26 @@ Your project is fully documented and initialized! 🎉
 3. Generate roadmap anytime by asking "Continue to Phase 9"
 
 Happy coding! 🚀
----
+---
 ```
----
-**CONTINUE TO:** Phase 9 (optional) or End
+---
 
-**SUCCESS:** Project fully documented and ready for development! 🚀
-```
+## 📝 Generated Documents
+
+After Phase 8, generate/update:
+
+- `README.md` - Main project documentation
+- `docs/api.md` - API reference
+- `docs/contributing.md` - Contribution guidelines
+- `docs/business-flows.md` - Visualized business logic
+
+---
 
+**Next Phase:** Phase 9 - Project Roadmap (Post-Documentation)
 
+Read: `.ai-flow/prompts/backend/flow-build-phase-9.md`
 
+---
 
+**Last Updated:** 2025-12-20
+**Version:** 2.1.8

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/templates/AGENT.template.md

@@ -412,4 +412,4 @@ See `README.md` for installation and setup instructions.
 
 **Last Updated:** {{GENERATION_DATE}}
 
-**Generated by:** AI Flow v2.1.8
+**Generated by:** AI Flow v2.1.9