44 lines
2.0 KiB
Markdown
44 lines
2.0 KiB
Markdown
# 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
|