ai-flow-dev 2.7.0 → 2.8.0

package/prompts/shared/mermaid-guidelines.md

@@ -1,106 +1,106 @@
-# 🎨 Mermaid Diagram Guidelines
-
-Follow these critical rules for all Mermaid diagrams to ensure they render correctly in GitHub, VS Code, and other markdown viewers.
-
-## 🛠️ General Rules
-
-- **Code Fence:** ALWAYS use exactly ` ```mermaid ` (lowercase, no spaces).
-- **NO Indentation:** Do not indent the diagram code with spaces or tabs.
-- **Closing Fence:** Always close with ` ``` `.
-- **Validation:** Preview at [mermaid.live](https://mermaid.live/) if unsure.
+# 🎨 Mermaid Diagram Guidelines
+
+Follow these critical rules for all Mermaid diagrams to ensure they render correctly in GitHub, VS Code, and other markdown viewers.
+
+## 🛠️ General Rules
+
+- **Code Fence:** ALWAYS use exactly ` ```mermaid ` (lowercase, no spaces).
+- **NO Indentation:** Do not indent the diagram code with spaces or tabs.
+- **Closing Fence:** Always close with ` ``` `.
+- **Validation:** Preview at [mermaid.live](https://mermaid.live/) if unsure.
 ---
-## 📊 Entity Relationship (ER) Diagrams
-
-**Type:** `erDiagram`
-
-### Relationship Notation
-
-- `||--o{` : One-to-Many (one to zero or more)
-- `||--||` : One-to-One (one to exactly one)
-- `}o--o{` : Many-to-Many (requires junction table)
-- `||--|{` : One-to-Many (one to one or more)
-
-### Field Notation
-
-- `PK` : Primary Key
-- `FK` : Foreign Key
-- `UK` : Unique Key
-- Add descriptions in quotes: `string email "User email address"`
-
-### Example
-
-```mermaid
-erDiagram
-    USER ||--o{ ORDER : places
-    USER {
-        string id PK
-        string email UK
-        string name
-    }
-    ORDER {
-        string id PK
-        string userId FK
-        decimal total
-    }
-```
+## 📊 Entity Relationship (ER) Diagrams
+
+**Type:** `erDiagram`
+
+### Relationship Notation
+
+- `||--o{` : One-to-Many (one to zero or more)
+- `||--||` : One-to-One (one to exactly one)
+- `}o--o{` : Many-to-Many (requires junction table)
+- `||--|{` : One-to-Many (one to one or more)
+
+### Field Notation
+
+- `PK` : Primary Key
+- `FK` : Foreign Key
+- `UK` : Unique Key
+- Add descriptions in quotes: `string email "User email address"`
+
+### Example
+
+```mermaid
+erDiagram
+    USER ||--o{ ORDER : places
+    USER {
+        string id PK
+        string email UK
+        string name
+    }
+    ORDER {
+        string id PK
+        string userId FK
+        decimal total
+    }
+```
 ---
-## 📐 Architecture & Flow Diagrams
-
-**Type:** `graph TD` (Top-Down) or `graph LR` (Left-Right)
-
-### Node Shapes
-
-- `[Square]` : Services, components, apps
-- `[(Cylinder)]` : Databases, storage
-- `([Rounded])` : Start/End points
-- `{Diamond}` : Decision points
-
-### Styling
-
-- Use `<br/>` for line breaks in labels.
-- Apply colors: `style NodeName fill:#e1f5ff`
-- Label connections: `A -->|HTTPS| B`
-
-### Example
-
-```mermaid
-graph TD
-    Client[Web App] -->|API Call| API[Node.js API]
-    API -->|Query| DB[(PostgreSQL)]
-    style Client fill:#e1f5ff
-    style API fill:#fff4e1
-    style DB fill:#e1ffe1
-```
+## 📐 Architecture & Flow Diagrams
+
+**Type:** `graph TD` (Top-Down) or `graph LR` (Left-Right)
+
+### Node Shapes
+
+- `[Square]` : Services, components, apps
+- `[(Cylinder)]` : Databases, storage
+- `([Rounded])` : Start/End points
+- `{Diamond}` : Decision points
+
+### Styling
+
+- Use `<br/>` for line breaks in labels.
+- Apply colors: `style NodeName fill:#e1f5ff`
+- Label connections: `A -->|HTTPS| B`
+
+### Example
+
+```mermaid
+graph TD
+    Client[Web App] -->|API Call| API[Node.js API]
+    API -->|Query| DB[(PostgreSQL)]
+    style Client fill:#e1f5ff
+    style API fill:#fff4e1
+    style DB fill:#e1ffe1
+```
 ---
-## 🔄 Business Flow Diagrams
-
-**Type:** `flowchart TD` (or `flowchart LR`)
-
-### Requirements
-
-- Start/End with `([Terminal Node])`.
-- Use `{Diamond}` for decision points.
-- Label branches: `-->|Yes|` or `-->|No|`.
-- Show error/failure paths.
-
-### Example
-
-```mermaid
-flowchart TD
-    Start([Start]) --> Action[Action]
-    Action --> Decision{Success?}
-    Decision -->|Yes| End([Success])
-    Decision -->|No| Fail([Failed])
-    style Start fill:#e1f5ff
-    style End fill:#e1ffe1
-    style Fail fill:#ffe1e1
-```
+## 🔄 Business Flow Diagrams
+
+**Type:** `flowchart TD` (or `flowchart LR`)
+
+### Requirements
+
+- Start/End with `([Terminal Node])`.
+- Use `{Diamond}` for decision points.
+- Label branches: `-->|Yes|` or `-->|No|`.
+- Show error/failure paths.
+
+### Example
+
+```mermaid
+flowchart TD
+    Start([Start]) --> Action[Action]
+    Action --> Decision{Success?}
+    Decision -->|Yes| End([Success])
+    Decision -->|No| Fail([Failed])
+    style Start fill:#e1f5ff
+    style End fill:#e1ffe1
+    style Fail fill:#ffe1e1
+```
 ---
-## ⚠️ Common Mistakes to Avoid
-
-- ❌ ` ```Mermaid ` (Capital M)
-- ❌ ` ``` mermaid ` (Extra space)
-- ❌ Using invalid characters in node IDs (use `NodeID[Label]` instead)
-- ❌ Circular dependencies without clear flow
-
-
+## ⚠️ Common Mistakes to Avoid
+
+- ❌ ` ```Mermaid ` (Capital M)
+- ❌ ` ``` mermaid ` (Extra space)
+- ❌ Using invalid characters in node IDs (use `NodeID[Label]` instead)
+- ❌ Circular dependencies without clear flow
+
+

package/prompts/shared/scope-levels.md

@@ -1,126 +1,126 @@
-# Project Scope Levels
-
-> **Canonical definition of MVP, Production-Ready, and Enterprise scope levels.**
->
-> This file defines how scope affects phase execution, question depth, and technology choices across all AI Flow workflows.
+# Project Scope Levels
+
+> **Canonical definition of MVP, Production-Ready, and Enterprise scope levels.**
+>
+> This file defines how scope affects phase execution, question depth, and technology choices across all AI Flow workflows.
 ---
-## Scope Level Summary
+## Scope Level Summary
 ---
-| Scope                | Symbol | Duration (Backend) | Phases    | Best For                           |
-| -------------------- | ------ | ------------------ | --------- | ---------------------------------- |
-| **MVP**              | 🚀     | 60-80 min          | Core only | Prototypes, proof of concept       |
-| **Production-Ready** | ⭐     | 90-120 min         | All       | Production apps, client projects   |
-| **Enterprise**       | 🏆     | 120-160 min        | Extended  | Large-scale, mission-critical apps |
+| Scope                | Symbol | Duration (Backend) | Phases    | Best For                           |
+| -------------------- | ------ | ------------------ | --------- | ---------------------------------- |
+| **MVP**              | 🚀     | 60-80 min          | Core only | Prototypes, proof of concept       |
+| **Production-Ready** | ⭐     | 90-120 min         | All       | Production apps, client projects   |
+| **Enterprise**       | 🏆     | 120-160 min        | Extended  | Large-scale, mission-critical apps |
 ---
-## MVP Scope 🚀
+## MVP Scope 🚀
 ---
-### Characteristics
-
-- **Phases included:** Core phases only (Phase 1-4 in backend)
-- **Question depth:** Simplified, essential questions only
-- **Technology choices:** Simple, proven defaults
-
-### Technology Defaults
-
-| Category       | MVP Choice                     |
-| -------------- | ------------------------------ |
-| Database       | PostgreSQL (single instance)   |
-| ORM            | Framework-idiomatic            |
-| Caching        | None or in-memory              |
-| Search         | Database LIKE queries          |
-| Architecture   | Monolith                       |
-| API Style      | REST only                      |
-| Authentication | JWT (basic)                    |
-| Authorization  | RBAC (simple roles)            |
-| Password       | bcrypt, 8+ chars               |
-| Git Workflow   | GitHub Flow                    |
-| Test Coverage  | 15-25%                         |
-| Test Types     | Unit tests only                |
-| Deployment     | PaaS (Heroku, Railway, Render) |
-| Monitoring     | Basic (health checks, logs)    |
+### Characteristics
+
+- **Phases included:** Core phases only (Phase 1-4 in backend)
+- **Question depth:** Simplified, essential questions only
+- **Technology choices:** Simple, proven defaults
+
+### Technology Defaults
+
+| Category       | MVP Choice                     |
+| -------------- | ------------------------------ |
+| Database       | PostgreSQL (single instance)   |
+| ORM            | Framework-idiomatic            |
+| Caching        | None or in-memory              |
+| Search         | Database LIKE queries          |
+| Architecture   | Monolith                       |
+| API Style      | REST only                      |
+| Authentication | JWT (basic)                    |
+| Authorization  | RBAC (simple roles)            |
+| Password       | bcrypt, 8+ chars               |
+| Git Workflow   | GitHub Flow                    |
+| Test Coverage  | 15-25%                         |
+| Test Types     | Unit tests only                |
+| Deployment     | PaaS (Heroku, Railway, Render) |
+| Monitoring     | Basic (health checks, logs)    |
 ---
-## Production-Ready Scope ⭐
+## Production-Ready Scope ⭐
 ---
-### Characteristics
-
-- **Phases included:** All phases (1-7/8)
-- **Question depth:** Complete professional coverage
-- **Technology choices:** Robust, scalable defaults
-
-### Technology Defaults
-
-| Category       | Production Choice                   |
-| -------------- | ----------------------------------- |
-| Database       | PostgreSQL (managed)                |
-| ORM            | Framework-idiomatic                 |
-| Caching        | Redis                               |
-| Search         | PostgreSQL Full-Text or Meilisearch |
-| Architecture   | Clean Architecture                  |
-| API Style      | REST + GraphQL (optional)           |
-| Authentication | JWT + Refresh Tokens                |
-| Authorization  | RBAC (granular permissions)         |
-| Password       | bcrypt 12 rounds, 12+ chars         |
-| Git Workflow   | Git Flow                            |
-| Test Coverage  | 70%                                 |
-| Test Types     | Unit, Integration, E2E              |
-| Deployment     | Cloud (AWS/GCP/Azure)               |
-| Monitoring     | APM (Datadog/New Relic) + Sentry    |
+### Characteristics
+
+- **Phases included:** All phases (1-7/8)
+- **Question depth:** Complete professional coverage
+- **Technology choices:** Robust, scalable defaults
+
+### Technology Defaults
+
+| Category       | Production Choice                   |
+| -------------- | ----------------------------------- |
+| Database       | PostgreSQL (managed)                |
+| ORM            | Framework-idiomatic                 |
+| Caching        | Redis                               |
+| Search         | PostgreSQL Full-Text or Meilisearch |
+| Architecture   | Clean Architecture                  |
+| API Style      | REST + GraphQL (optional)           |
+| Authentication | JWT + Refresh Tokens                |
+| Authorization  | RBAC (granular permissions)         |
+| Password       | bcrypt 12 rounds, 12+ chars         |
+| Git Workflow   | Git Flow                            |
+| Test Coverage  | 70%                                 |
+| Test Types     | Unit, Integration, E2E              |
+| Deployment     | Cloud (AWS/GCP/Azure)               |
+| Monitoring     | APM (Datadog/New Relic) + Sentry    |
 ---
-## Enterprise Scope 🏆
+## Enterprise Scope 🏆
 ---
-### Characteristics
-
-- **Phases included:** All phases with extended questions
-- **Question depth:** Advanced, comprehensive
-- **Technology choices:** Enterprise-grade, highly scalable
-
-### Technology Defaults
-
-| Category       | Enterprise Choice                      |
-| -------------- | -------------------------------------- |
-| Database       | PostgreSQL (multi-region/sharded)      |
-| ORM            | Framework-idiomatic                    |
-| Caching        | Redis Cluster                          |
-| Search         | Elasticsearch                          |
-| Architecture   | Microservices / Domain-Driven Design   |
-| API Style      | REST + GraphQL + gRPC                  |
-| Authentication | OAuth2 + SSO + MFA                     |
-| Authorization  | ABAC (Attribute-Based)                 |
-| Password       | bcrypt 14 rounds, 16+ chars, policies  |
-| Git Workflow   | Git Flow + Release branches            |
-| Test Coverage  | 85%+                                   |
-| Test Types     | Unit, Integration, E2E, Load, Security |
-| Deployment     | Multi-region, Kubernetes               |
-| Monitoring     | Full observability stack               |
+### Characteristics
+
+- **Phases included:** All phases with extended questions
+- **Question depth:** Advanced, comprehensive
+- **Technology choices:** Enterprise-grade, highly scalable
+
+### Technology Defaults
+
+| Category       | Enterprise Choice                      |
+| -------------- | -------------------------------------- |
+| Database       | PostgreSQL (multi-region/sharded)      |
+| ORM            | Framework-idiomatic                    |
+| Caching        | Redis Cluster                          |
+| Search         | Elasticsearch                          |
+| Architecture   | Microservices / Domain-Driven Design   |
+| API Style      | REST + GraphQL + gRPC                  |
+| Authentication | OAuth2 + SSO + MFA                     |
+| Authorization  | ABAC (Attribute-Based)                 |
+| Password       | bcrypt 14 rounds, 16+ chars, policies  |
+| Git Workflow   | Git Flow + Release branches            |
+| Test Coverage  | 85%+                                   |
+| Test Types     | Unit, Integration, E2E, Load, Security |
+| Deployment     | Multi-region, Kubernetes               |
+| Monitoring     | Full observability stack               |
 ---
-## Scope Selection Prompt
+## Scope Selection Prompt
 ---
-```
+```
 ---
-🎯 Project Scope Selection
+🎯 Project Scope Selection
 ---
-What scope level do you want for this documentation?
-
-A) 🚀 **MVP** (60-80 min) - Core features only, minimal setup
-   - Core phases only
-   - Simple architecture
-   - Basic testing
-   - Best for: Prototypes, proof of concept
-
-B) ⭐ **Production-Ready** (90-120 min) - Complete professional setup
-   - All phases
-   - Robust architecture
-   - Comprehensive testing + CI/CD
-   - Best for: Production apps, client projects
-
-C) 🏆 **Enterprise** (120-160 min) - Advanced features and scalability
-   - All phases with extended questions
-   - Enterprise architecture
-   - Full observability + compliance
-   - Best for: Large-scale, mission-critical apps
-
-Your choice (A/B/C):
-```
-
-
-
+What scope level do you want for this documentation?
+
+A) 🚀 **MVP** (60-80 min) - Core features only, minimal setup
+   - Core phases only
+   - Simple architecture
+   - Basic testing
+   - Best for: Prototypes, proof of concept
+
+B) ⭐ **Production-Ready** (90-120 min) - Complete professional setup
+   - All phases
+   - Robust architecture
+   - Comprehensive testing + CI/CD
+   - Best for: Production apps, client projects
+
+C) 🏆 **Enterprise** (120-160 min) - Advanced features and scalability
+   - All phases with extended questions
+   - Enterprise architecture
+   - Full observability + compliance
+   - Best for: Large-scale, mission-critical apps
+
+Your choice (A/B/C):
+```
+
+
+