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