directus-task-management/docs/front-end-spec/user-flows.md

2.0 KiB

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

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