ai-flow-dev 2.1.9 → 2.2.0

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

@@ -5,7 +5,7 @@
 **Duration:** 10-15 minutes
 
 **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,11 +16,16 @@ 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
 
 ```
 🔍 Detecting current project state...
+
+**⚠️ 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:**
@@ -51,7 +56,7 @@ Found:
 
 Recommendation: [Next action based on state]
 ```
----
+---
 ## 8.2: Framework Initialization (Optional)
 
 **Only if:** Project state = "New Project"
@@ -216,7 +221,7 @@ You can initialize manually later with:
 
 Proceeding to documentation generation...
 ```
----
+---
 ## 8.3: Generate Final Documentation
 
 ```
@@ -297,7 +302,7 @@ 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.
@@ -444,7 +449,7 @@ dist/
 ✅ Generated: .gitignore
    Patterns included: [Framework] + [Bundler] + Base JavaScript patterns
 ```
----
+---
 ## 8.4: Generate AGENT.md (Master Index)
 
 - **Template:** `.ai-flow/templates/AGENT.template.md`
@@ -529,7 +534,7 @@ dist/
 ```
 ✅ Generated: .ai-flow/AGENT.md (Master Index)
 ```
----
+---
 ## 8.5: Generate README.md (Intelligent Merge)
 
 - **Template:** `.ai-flow/templates/README.template.md`
@@ -569,7 +574,7 @@ 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:**
@@ -682,7 +687,7 @@ Master index: `.ai-flow/AGENT.md`
 ✅ Generated tool-specific configs:
    [List generated files based on selection]
 ```
----
+---
 ## 8.7: Final Validation & Success Message
 
 ```
@@ -741,7 +746,7 @@ Phase 8:
 
 Tool-specific configs:
 ✅ [List generated configs]
----
+---
 📁 Project Structure:
 
 your-project/
@@ -767,7 +772,7 @@ your-project/
 ├── .env.example
 ├── .gitignore
 └── [tool configs]               # .clauderules, .cursorrules, etc.
----
+---
 Next steps:
 
 1. ⭐ **Read `.ai-flow/AGENT.md`** - Master index of all documentation
@@ -779,7 +784,7 @@ Next steps:
 4. 🚀 **Install dependencies** - Run: `npm install` / `yarn install`
 5. 💾 **Initialize git** (if not done) - `git init && git add . && git commit -m "Initial commit with AI Flow docs"`
 6. 🧪 **Start developing!** - Your AI assistant now has complete project context
----
+---
 💡 **Remember:**
 - Documents are **living artifacts** - update them as project evolves
 - All AI assistants will reference these docs for future work
@@ -796,7 +801,7 @@ Your AI assistant (Claude, Cursor, Copilot) will now:
 
 Happy building! 🎉
 ```
----
+---
 ## EXECUTION CHECKLIST FOR AI ASSISTANT
 
 When executing Phase 8:
@@ -852,10 +857,16 @@ When executing Phase 8:
 - [ ] Show success message
 
 **ESTIMATED TIME:** 10-15 minutes
----
-**CONTINUE TO:** End (Phase 8 is final phase)
+---
+**Next Phase:** Phase 9 - Project Roadmap (Post-Documentation)
+
+Read: `.ai-flow/prompts/frontend/flow-build-phase-9.md`
+
+---
+
+**Last Updated:** 2025-12-21
+**Version:** 2.1.9
 
-**SUCCESS:** Project fully documented and ready for development! 🚀
 
 
 

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

@@ -0,0 +1,80 @@
+## PHASE 9: Implementation Roadmap (Frontend) (5-10 min)
+
+> **Order for this phase:** OPTIONAL. Executed after Phase 8 or on demand.
+
+### Objective
+Translate all UX/UI and architectural specifications into a prioritized, actionable implementation plan (Roadmap) with clear milestones and tasks focused on Frontend development.
+
+## Context Variables (Extract from docs)
+
+// turbo
+**Before generating tasks, extract these from project documentation:**
+
+```
+From ai-instructions.md:
+├── LANG: {{LANGUAGE}}           # e.g., TypeScript, JavaScript
+├── FRAMEWORK: {{FRAMEWORK}}     # e.g., React, Next.js, Vue, Nuxt, Svelte, Angular
+├── SRC: {{SOURCE_DIR}}          # e.g., src/, app/, lib/
+├── TESTS: {{TESTS_DIR}}         # e.g., tests/, __tests__/, spec/
+└── STYLE: {{STYLING_APPROACH}}  # e.g., Tailwind, CSS Modules, Styled Components
+
+From docs/architecture.md & ui-structure.md:
+├── COMP_DIR: {{COMPONENTS_PATH}} # e.g., components/, src/components/
+├── PAGE_DIR: {{PAGES_PATH}}      # e.g., pages/, app/, src/views/
+├── STORE_DIR: {{STORE_PATH}}     # e.g., store/, state/, context/
+├── HOOKS_DIR: {{HOOKS_PATH}}     # e.g., hooks/, composables/
+└── ASSETS_DIR: {{ASSETS_PATH}}   # e.g., assets/, public/
+```
+
+---
+
+## Task Format (MANDATORY)
+
+```
+- [ ] TXXX [CAT] Description • 1 SP → {{path}} | deps: TXXX
+```
+
+---
+
+## Categories [CAT]
+
+| Cat | Name       | Description                        | SP Range |
+|-----|------------|------------------------------------|----------|
+| [U] | UI/Comp    | Atoms, Molecules, Organisms        | 1 SP     |
+| [P] | Page       | Page layout, route implementation  | 1-2 SP   |
+| [L] | Logic/Hook | Custom hooks, business logic       | 1 SP     |
+| [S] | State      | Store actions, reducers, context   | 1 SP     |
+| [A] | API/Data   | Fetching, services, transformers   | 1-2 SP   |
+| [T] | Test       | Unit, component, e2e tests         | 1-2 SP   |
+| [D] | Docs       | Documentation updates              | 1 SP     |
+
+---
+
+## Workflow: 6 Steps
+
+// turbo
+### Step 9.1: Extract Context & Inventory
+
+**1. Extract context variables from documentation.**
+**2. Extract inventory (Components, Pages, API endpoints).**
+
+### Step 9.2: Coverage Matrix
+Ensure every Page/Feature has: [U], [L], [S], [A], [T], [D] as needed.
+
+### Step 9.3: Epic Definition
+EP-000: Foundation (Layout, Theme, Store config)
+EP-001: Component Library / Atoms
+EP-002: Core Features (Login, Dashboard, etc.)
+EP-ZZZ: Operations & PWA
+
+### Step 9.4: Task Generation
+Generate atomic tasks using the `{{VARIABLE}}` paths.
+
+### Step 9.5: Validate Coverage
+Check for gaps.
+
+### Step 9.6: Generate Document (docs/roadmap.md)
+
+---
+_Version: 4.2 (Antigravity Optimized)_
+_Last Updated: 2025-12-21_