ai-flow-dev 2.8.1 → 2.9.0

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

@@ -3,16 +3,20 @@
 > **Order for this phase:** ALWAYS executed FIRST if an existing project is detected. Skip ONLY for new projects.
 
 > **📌 Scope-based behavior:**
+>
 > - **Interactive Mode:** Ask user for permission to scan files layer by layer.
 > - **Autonomous Mode:** Scan all layers automatically and present the final report.
 
 ### Objective
+
 Efficiently analyze existing projects using a **layered, incremental approach**.
 
 ---
 
 ## 🚫 Critical Exclusion Rules
+
 To avoid false-positive detections, **IGNORE** the following folders and files during all detection steps:
+
 - `.ai-flow/work/` (contains active development tasks)
 - `.ai-flow/archive/` (contains completed tasks)
 - `.agent/` (contains AI workflows)
@@ -37,11 +41,13 @@ Proceed to Layer 1.
 ---
 
 // turbo
+
 ## ⚡ Layer 1: Fast Metadata Scan (10-20 seconds)
 
 **Purpose:** Detect framework, language, build tool, and existing AI configurations.
 
 ⭐ **Context Links:**
+
 - Node.js: [package.json](file:///package.json)
 - Python: [requirements.txt](file:///requirements.txt) | [pyproject.toml](file:///pyproject.toml)
 - PHP: [composer.json](file:///composer.json)
@@ -49,9 +55,11 @@ Proceed to Layer 1.
 - Java: [pom.xml](file:///pom.xml) | [build.gradle](file:///build.gradle)
 
 ### 0.1.1 Universal Tech Stack Detection
+
 **Action:** Use your internal knowledge to detect the language and framework by scanning the root configuration files (package.json, pyproject.toml, etc.).
 
 **Detect (but don't be limited to):**
+
 - **Node.js:** NestJS, Express, Fastify, etc.
 - **Python:** FastAPI, Django, Flask, etc.
 - **PHP:** Laravel, Symfony, etc.
@@ -60,10 +68,12 @@ Proceed to Layer 1.
 - **C#/.NET, Ruby, Rust, Elixir.**
 
 ### 0.1.2 Find AI & Documentation
+
 - Find existing AI configs (`AGENT.md`, `.cursorrules`, etc.)
 - Scan for `README.md` and existing `docs/`.
 
 ### Layer 1 Output
+
 Show a summary of detected Name, Language, Framework, ORM, and Documentation files.
 
 ---
@@ -73,11 +83,13 @@ Show a summary of detected Name, Language, Framework, ORM, and Documentation fil
 **Purpose:** Analyze directory organization and architecture patterns without reading code line-by-line.
 
 ### 0.2.1 Pattern Detection
+
 1. **Identify Pattern:** Feature-based, Layer-based, Modular Monolith, or Hybrid.
 2. **Entity Detection:** Scan for Schema/Entity files based on the detected ORM (Prisma, TypeORM, Django Models, etc.).
 3. **Maturity Check:** Assess documentation and test coverage ratio.
 
 ### Layer 2 Output
+
 Summary of Architecture Pattern, Code Structure counts (Controllers, Services, etc.), and Recommended Build Scope (MVP/Production/Enterprise).
 
 ---
@@ -87,11 +99,13 @@ Summary of Architecture Pattern, Code Structure counts (Controllers, Services, e
 **Purpose:** Read and parse representative code files for detailed insights into API endpoints, data relationships, and security patterns.
 
 ### 0.3.1 Areas of Analysis
+
 - **API Endpoints:** Parse routes/controllers.
 - **Data Model:** Map entity relationships.
 - **Security:** Detect auth patterns (JWT, OAuth), validation (Zod, Pydantic), and middleware.
 
 ### 0.3.2 Sampling Strategy
+
 Use stratified sampling to read only the most relevant files (e.g., core controllers and entities) to stay within context limits.
 
 ---
@@ -99,11 +113,13 @@ Use stratified sampling to read only the most relevant files (e.g., core control
 ## ✅ Validation & Synthesis
 
 ### Present Findings
+
 Show the final "🔍 BACKEND STACK DETECTED" report and ask for confirmation.
 
 ### 💾 Cache & Pre-populate
 
 **Create directory structure (if not exists):**
+
 ```bash
 mkdir -p .ai-flow/cache
 ```
@@ -136,22 +152,23 @@ B) No, skip audit (continue to Phase 1)
 ### 0.4.2 Parse Existing Documentation
 
 **Action:** Extract documented information from:
+
 - `docs/architecture.md` → Architecture patterns
 - `docs/data-model.md` → Entities and fields
 - `docs/api.md` → Endpoints and methods
 - `specs/requirements.md` → Business requirements
 
-**Save to:** `.ai-flow/cache/docs-snapshot.json`
-
 ### 0.4.3 Compare Code vs Documentation
 
 **Compare:**
+
 1. **Entities:** Schema files (Prisma, TypeORM, etc.) vs `docs/data-model.md`
 2. **Endpoints:** Controllers/Routes vs `docs/api.md`
 3. **Architecture:** Code structure vs `docs/architecture.md`
 4. **Tech Stack:** `package.json` vs documented stack
 
 **Detect:**
+
 - Items in code but not in docs (undocumented features)
 - Items in docs but not in code (missing implementations or obsolete docs)
 - Mismatches in fields, types, or patterns
@@ -161,14 +178,17 @@ B) No, skip audit (continue to Phase 1)
 **Severity Levels:**
 
 🔴 **CRITICAL** (Requires user decision):
+
 - Documented entity/endpoint not implemented
 - Major architectural mismatch
 
 🟡 **MEDIUM** (Auto-correctable with confirmation):
+
 - Implemented endpoint not documented
 - Missing fields in docs
 
 🟢 **LOW** (Auto-correctable):
+
 - Obsolete fields in docs
 - Outdated version numbers
 
@@ -216,10 +236,12 @@ C) Cancel /flow-build (fix manually first)
 ```
 
 **Option A (Recommended):** Continue to Phase 1
+
 - Save audit data for Phase 8
 - Phase 8 will offer to apply corrections
 
 **Option B:** Interactive review now
+
 ```
 🔴 Critical Issue 1/2: Entity 'Category'
    Documented in docs/data-model.md but NOT in schema
@@ -233,21 +255,24 @@ C) Cancel /flow-build (fix manually first)
 ```
 
 **Option C:** Cancel
+
 - User fixes issues manually
 - Re-run `/flow-build` later
 
 ### 0.4.7 Save Audit Data
 
 > **📌 IMPORTANT - Phases 9-10 for Existing Projects:**
-> 
+>
 > If the project has **substantial functional code already implemented** (detected in Layer 1-3):
+>
 > - Set `phase9.recommendation = "SKIP"` with reason: "Project already implemented - roadmap not needed"
 > - Set `phase10.recommendation = "SKIP"` with reason: "Project already implemented - user stories not needed"
-> 
+>
 > **Phases 9-10 are only useful for:**
+>
 > - New projects (no code yet)
 > - Projects in early development (< 30% features implemented)
-> 
+>
 > **For existing projects**, focus on Phases 1-8 (documentation sync) instead.
 
 **Save to:** `.ai-flow/cache/audit-data.json`
@@ -350,16 +375,19 @@ C) Cancel /flow-build (fix manually first)
 ```
 
 **Recommendation Logic:**
+
 - **SKIP** (≥95%): Phase can be skipped, use existing docs
 - **HYBRID** (80-94%): Ask only missing questions, merge with existing docs
 - **FULL** (<80% or file missing): Execute full phase with pre-filled answers
 
 This data will be used in Phases 1-7 to:
+
 1. Determine if phase can be skipped
 2. Identify specific gaps to ask about
 3. Merge new answers with existing documentation
 
 This data will be used in Phase 8 to:
+
 1. Generate detailed audit report
 2. Apply auto-corrections
 3. Update roadmap with "To Implement" items
@@ -371,6 +399,7 @@ This data will be used in Phase 8 to:
 ### Present Findings
 
 Show the final report including:
+
 1. **🔍 BACKEND STACK DETECTED** (from Layers 1-3)
 2. **📊 Documentation Audit Summary** (from Layer 4, if executed)
 
@@ -379,6 +408,7 @@ Ask for confirmation to proceed to Phase 1.
 ### 💾 Cache & Pre-populate
 
 **Create directory structure (if not exists):**
+
 ```bash
 mkdir -p .ai-flow/cache .ai-flow/work .ai-flow/archive
 ```
@@ -390,6 +420,7 @@ mkdir -p .ai-flow/cache .ai-flow/work .ai-flow/archive
 ### 🎯 Set Flags for Phase 8
 
 If documentation audit was performed:
+
 - Set flag: `auditPerformed: true`
 - Phase 8 will:
   - Generate detailed audit report (`docs/audit-report.md`)
@@ -403,6 +434,7 @@ If documentation audit was performed:
 ---
 
 ### Phase Summary
+
 - Pre-populated detected tech stack values.
 - Architectural patterns identified.
 - Context cached in `.ai-flow/cache/docs-analysis.json`.
@@ -414,6 +446,7 @@ If documentation audit was performed:
 **Next Phase:** Phase 1 - Discovery & Business Requirements
 
 **What happens next:**
+
 - Phase 1-7 will use pre-populated answers (40-60% filled)
 - You'll only answer questions that couldn't be auto-detected
 - Phase 8 will offer to resolve documentation inconsistencies
@@ -421,5 +454,6 @@ If documentation audit was performed:
 Read: `.ai-flow/prompts/backend/flow-build-phase-1.md`
 
 ---
+
 _Version: 4.3 (Antigravity Optimized - With Integrated Audit)_
 _Last Updated: 2025-12-22_

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

@@ -4,8 +4,8 @@
 
 **Duration:** 10-15 minutes
 
-**Goal:** Set up the project structure and create comprehensive documentation that consolidates all information from previous phases.
----
+## **Goal:** Set up the project structure and create comprehensive documentation that consolidates all information from previous phases.
+
 ## 📋 Phase 8 Overview
 
 This final phase will:
@@ -16,8 +16,11 @@ 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)
+
 ---
+
 // turbo
+
 ## 8.1: Project State Detection
 
 ```
@@ -56,7 +59,9 @@ Found:
 
 Recommendation: [Next action based on state]
 ```
+
 ---
+
 ## 8.2: Framework Initialization (Optional)
 
 **Only if:** Project state = "New Project"
@@ -221,7 +226,9 @@ You can initialize manually later with:
 
 Proceeding to documentation generation...
 ```
+
 ---
+
 ## 8.3: Generate Final Documentation
 
 ```
@@ -302,21 +309,25 @@ Generating...
 ```
 ✅ Generated: docs/contributing.md
 ```
+
 ---
+
 ## 8.3.4: Generate .gitignore
 
 **IMPORTANT:** Generate a comprehensive `.gitignore` file based on the framework, bundler, and tools selected in previous phases.
 
 ```
-📝 Generating .gitignore for your frontend stack...
+📝 Configuring .gitignore for your frontend stack...
 ```
 
 **Strategy:**
 
-1. **Detect framework from Phase 3** (React, Vue, Angular, etc.)
-2. **Detect bundler/meta-framework** (Vite, Next.js, Create React App, etc.)
-3. **Detect package manager** (npm, yarn, pnpm)
-4. **Combine relevant patterns**
+1. **Check if .gitignore exists**
+2. **Detect framework from Phase 3** (React, Vue, Angular, etc.)
+3. **Detect bundler/meta-framework** (Vite, Next.js, Create React App, etc.)
+4. **Detect package manager** (npm, yarn, pnpm)
+5. **Combine relevant patterns + AI Flow rules**
+6. **Merge intelligently** (append only missing rules)
 
 **Base patterns for JavaScript/TypeScript projects:**
 
@@ -385,6 +396,18 @@ npm-debug.log*
 
 # Storybook
 storybook-static/
+
+# ============================================================
+# AI Flow - Workspace Management
+# ============================================================
+# Ignore temporary cache (regenerable)
+.ai-flow/cache/
+
+# Ignore work-in-progress state (personal, deleted on completion)
+.ai-flow/work/
+
+# COMMIT .ai-flow/archive/ by default (contains team metrics)
+# ============================================================
 ```
 
 **Framework-specific additions:**
@@ -435,21 +458,77 @@ dist/
 .cache/
 ```
 
-**📝 Action:** Generate and write `.gitignore` to project root.
+**📝 Action: Intelligent Merge Strategy**
 
-**Selection logic:**
+**Step 1: Detect existing .gitignore**
+
+```bash
+if [ -f ".gitignore" ]; then
+  echo "📋 Existing .gitignore detected"
+  GITIGNORE_EXISTS=true
+else
+  echo "📄 Creating new .gitignore"
+  GITIGNORE_EXISTS=false
+fi
+```
+
+**Step 2: Select base patterns**
 
 - If React + Vite → Base + Vite patterns
 - If Next.js → Base + Next.js patterns
 - If Angular → Base + Angular patterns
 - If Vue + Vite → Base + Vite patterns
 - If Nuxt → Base + Nuxt patterns
+- **Always include AI Flow rules** (.ai-flow/cache/, .ai-flow/work/)
+
+**Step 3: Merge or Create**
+
+**If .gitignore exists (Existing Project):**
+
+```bash
+# Check if AI Flow rules already present
+if grep -q ".ai-flow/cache/" .gitignore; then
+  echo "✅ AI Flow rules already configured"
+else
+  echo "" >> .gitignore
+  echo "# ============================================================" >> .gitignore
+  echo "# AI Flow - Workspace Management" >> .gitignore
+  echo "# ============================================================" >> .gitignore
+  echo "# Ignore temporary cache (regenerable)" >> .gitignore
+  echo ".ai-flow/cache/" >> .gitignore
+  echo "" >> .gitignore
+  echo "# Ignore work-in-progress state (personal, deleted on completion)" >> .gitignore
+  echo ".ai-flow/work/" >> .gitignore
+  echo "" >> .gitignore
+  echo "# COMMIT .ai-flow/archive/ by default (contains team metrics)" >> .gitignore
+  echo "# ============================================================" >> .gitignore
+
+  echo "✅ Added AI Flow rules to existing .gitignore"
+fi
+```
+
+**If .gitignore does NOT exist (New Project):**
+
+```bash
+# Create complete .gitignore with all patterns
+cat > .gitignore << 'EOF'
+[Insert complete template based on framework]
+EOF
+
+echo "✅ Created new .gitignore"
+```
+
+**Output Summary:**
 
 ```
-✅ Generated: .gitignore
-   Patterns included: [Framework] + [Bundler] + Base JavaScript patterns
+✅ .gitignore configured successfully!
+   Base patterns: [Framework] + [Bundler]
+   AI Flow rules: ✅ Added (.ai-flow/cache/, .ai-flow/work/)
+   Status: [Created new | Updated existing]
 ```
+
 ---
+
 ## 8.4: Generate AGENT.md (Master Index)
 
 - **Template:** `.ai-flow/templates/AGENT.template.md`
@@ -534,7 +613,9 @@ dist/
 ```
 ✅ Generated: .ai-flow/AGENT.md (Master Index)
 ```
+
 ---
+
 ## 8.5: Generate README.md (Intelligent Merge)
 
 - **Template:** `.ai-flow/templates/README.template.md`
@@ -574,7 +655,9 @@ dist/
 ✅ Generated: .ai-flow/README.md
    [If merged] Merged with framework's setup instructions
 ```
+
 ---
+
 ## 8.6: Create Tool-Specific Configs
 
 **Based on AI tool selection from Phase 3:**
@@ -687,7 +770,9 @@ Master index: `.ai-flow/AGENT.md`
 ✅ Generated tool-specific configs:
    [List generated files based on selection]
 ```
+
 ---
+
 ## 8.7: Final Validation & Success Message
 
 ```
@@ -801,7 +886,9 @@ Your AI assistant (Claude, Cursor, Copilot) will now:
 
 Happy building! 🎉
 ```
+
 ---
+
 ## EXECUTION CHECKLIST FOR AI ASSISTANT
 
 When executing Phase 8:
@@ -856,8 +943,8 @@ When executing Phase 8:
 - [ ] Validate file references
 - [ ] Show success message
 
-**ESTIMATED TIME:** 10-15 minutes
----
+## **ESTIMATED TIME:** 10-15 minutes
+
 **Next Phase:** Phase 9 - Project Roadmap (Post-Documentation)
 
 Read: `.ai-flow/prompts/frontend/flow-build-phase-9.md`
@@ -866,7 +953,3 @@ Read: `.ai-flow/prompts/frontend/flow-build-phase-9.md`
 
 **Last Updated:** 2025-12-21
 **Version:** 2.1.9
-
-
-
-