ai-flow-dev 2.1.8 → 2.2.0

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,27 +17,34 @@ 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.
 
-```
+// turbo
 🔍 Detecting current project state...
-```
 
-**Auto-detect:**
+**⚠️ CRITICAL: Ignore AI Flow documentation and Meta files during detection:**
+- Files: `project-brief.md`, `ai-instructions.md`, `AGENT.md`, `.env.example`, `.cursorrules`, `.clauderules`, `.geminirules`
+- Directories: `.ai-flow/`, `.agent/`, `docs/`, `specs/`
+
+**Auto-detect Checklist:**
 
-- [ ] 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)
+- [ ] **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?
 
-**Classification:**
+**Classification Rules (Strict Order):**
 
-- **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
+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 +54,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 +473,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 +627,7 @@ docker-compose.override.yml
 ✅ Generated: .gitignore
    Patterns included: [Node.js | Python | Go] + [Prisma] + [Docker]
 ```
----
+---
 ## 8.3: Generate Final Documentation
 
 ```
@@ -686,7 +694,7 @@ Generating...
 ```
 ✅ Generated: docs/business-flows.md
 ```
----
+---
 ### 8.3.2: Generate docs/api.md
 
 - **Template:** `.ai-flow/templates/docs/api.template.md`
@@ -768,7 +776,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 +837,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 +924,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 +963,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 +1070,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 +1178,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 +1208,7 @@ your-project/
 └── [tool configs] # .clauderules, .cursorrules, etc.
 
 ````
----
+---
 Next steps:
 
 1. ⭐ **Read `.ai-flow/AGENT.md`** - Master index of all documentation
@@ -1175,7 +1220,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 +1228,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 +1240,7 @@ Your AI assistant (Claude, Cursor, Copilot) will now:
 Happy building! 🎉
 
 ```
----
+---
 ## EXECUTION CHECKLIST FOR AI ASSISTANT
 
 When executing Phase 8:
@@ -1248,7 +1293,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 +1324,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 +1370,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 +1382,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-21
+**Version:** 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)
 
@@ -94,6 +89,7 @@ From docs/architecture.md:
 
 ## Workflow: 6 Steps
 
+// turbo
 ### Step 9.1: Extract Context & Inventory (10-15 min)
 
 **1. Extract context variables from `ai-instructions.md`:**
@@ -409,5 +405,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
+