# User Flows

## AI-Powered Task Creation Flow

**User Goal:** Create comprehensive task breakdown from natural language description using AI assistance

**Entry Points:** Global AI prompt field in header, AI Center > AI Task Creation, Project Details > Add Tasks via AI

**Success Criteria:** Task created with proper metadata, dependencies, and subtasks; integrated with existing project structure; synced to Task Master CLI automatically

### Enhanced Flow Diagram

```mermaid
graph TD
    A[User enters prompt + selects context] --> B[AI analyzes with BMad/TaskMaster context]
    B --> C[AI generates tiered suggestions]
    C --> D{Task complexity?}
    D -->|Simple| E[Auto-create with 3-second undo]
    D -->|Complex| F[Show structured preview]
    F --> G{User action?}
    G -->|Approve| H[Create tasks batch]
    G -->|Edit| I[Switch to guided editor]
    G -->|Retry| J[Enhanced prompt interface]
    I --> H
    J --> B
    E --> K[Background sync to Task Master]
    H --> K
    K --> L[Contextual success feedback]
    L --> M[Smart next action suggestions]
```

### Key Flow Features

**Context Selection Upfront:** User chooses context (Current Project, BMad Workflow, Task Master Import, Global) - AI suggestions adapt to selected context for better relevance

**Complexity-Based Branching:** Simple tasks auto-create with undo option; complex tasks show structured preview; reduces friction for power users while maintaining control

**Enhanced Error Recovery:** Three recovery paths (Approve, Edit via guided form, Retry with better prompt); guided editor provides structure for users who struggle with natural language

### Edge Cases & Error Handling
- AI context failures: Missing project context prompts user selection; BMad workflow mismatch suggests closest match
- User intent ambiguity: Multiple interpretations shown as quick buttons; scope uncertainty triggers inline clarifying questions
- Integration failures: Duplicate detection with similarity scores; dependency conflicts show visual impact; permission issues with graceful degradation
