rbin-task-flow 1.1.2 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,92 @@
1
+ ---
2
+ description: Task time estimation based on task complexity and developer experience level
3
+ globs: **/*
4
+ alwaysApply: true
5
+ ---
6
+
7
+ - **Task Estimation - Time Estimation for Tasks:**
8
+ - **FAST FORMAT**: `task-flow: estimate X` → Estimate time for task X (simplified - no "task" needed)
9
+ - **MULTIPLE TASKS**: `task-flow: estimate X,Y` → Estimate multiple tasks
10
+ - **ALL TASKS**: `task-flow: estimate all` → Estimate all tasks
11
+ - When user says "task-flow: estimate X", "estimate X", "estimate X,Y", "estimate all", or "how long will task X take":
12
+ - **READ**: `.task-flow/.internal/tasks.json` to get task details
13
+ - **CALCULATE**: Time estimate based on number of subtasks and developer experience level
14
+ - **DISPLAY**: Show time estimate with intervals for 3 experience levels (junior, mid, senior)
15
+ - **FORMAT**: Show estimates in hours with ranges (e.g., "10-14 hours" for mid-level)
16
+
17
+ - **Estimation Rules:**
18
+ 1. **Base Calculation**: Count total number of subtasks in the task
19
+ 2. **Experience Levels**:
20
+ - **Junior** (0-2 years): Base time × 1.5 multiplier
21
+ - **Mid-level** (3-5 years): Base time × 1.0 multiplier (baseline)
22
+ - **Senior** (6+ years): Base time × 0.7 multiplier
23
+ 3. **Time per Subtask**:
24
+ - Simple subtask: 1-2 hours (mid-level baseline)
25
+ - Medium subtask: 2-4 hours (mid-level baseline)
26
+ - Complex subtask: 4-6 hours (mid-level baseline)
27
+ 4. **Default Assumption**: Average 2-3 hours per subtask for mid-level (baseline)
28
+ 5. **Range Calculation**:
29
+ - Lower bound: (subtasks × 2) × multiplier
30
+ - Upper bound: (subtasks × 3) × multiplier
31
+ - Round to nearest hour
32
+
33
+ - **Estimation Formula:**
34
+ ```
35
+ Base hours per subtask: 2-3 hours (mid-level)
36
+
37
+ Junior (0-2 years):
38
+ Lower: (subtasks × 2) × 1.5
39
+ Upper: (subtasks × 3) × 1.5
40
+
41
+ Mid-level (3-5 years):
42
+ Lower: subtasks × 2
43
+ Upper: subtasks × 3
44
+
45
+ Senior (6+ years):
46
+ Lower: (subtasks × 2) × 0.7
47
+ Upper: (subtasks × 3) × 0.7
48
+ ```
49
+
50
+ - **Display Format:**
51
+ ```
52
+ 📊 Time Estimation for Task X: [Task Title]
53
+
54
+ Based on [N] subtasks:
55
+
56
+ 👶 Junior (0-2 years): [X-Y] hours
57
+ 👨‍💼 Mid-level (3-5 years): [X-Y] hours
58
+ 👴 Senior (6+ years): [X-Y] hours
59
+ ```
60
+
61
+ - **Natural Language Phrases:**
62
+ - **FAST FORMAT**: `task-flow: estimate X` or `task-flow estimate X` (simplified)
63
+ - **MULTIPLE**: `task-flow: estimate X,Y` or `task-flow: estimate all`
64
+ - "estimate task X" or "estimate X"
65
+ - "estimate tasks 10,11"
66
+ - "estimate all tasks"
67
+ - "how long will task X take"
68
+ - "time estimate for task X"
69
+ - Any variation asking for time estimation
70
+
71
+ - **Example:**
72
+ ```
73
+ User: "task-flow: estimate 1"
74
+
75
+ Task 1 has 5 subtasks:
76
+
77
+ 📊 Time Estimation for Task 1: Create authentication system
78
+
79
+ Based on 5 subtasks:
80
+
81
+ 👶 Junior (0-2 years): 15-23 hours
82
+ 👨‍💼 Mid-level (3-5 years): 10-15 hours
83
+ 👴 Senior (6+ years): 7-11 hours
84
+ ```
85
+
86
+ - **Integration:**
87
+ - Works with [task_execution.mdc](mdc:.cursor/rules/task_execution.mdc) workflow
88
+ - Uses task data from `.task-flow/.internal/tasks.json`
89
+ - Estimates are informational only (not stored)
90
+
91
+ - **Principle:**
92
+ > **Provide realistic time estimates based on task complexity (number of subtasks) and developer experience level. Show ranges to account for variability in implementation speed.**
@@ -21,10 +21,18 @@ alwaysApply: true
21
21
  - `task-flow: sync` - Sync new tasks from tasks.input.txt
22
22
  - `task-flow: think` - Analyze codebase and suggest new tasks
23
23
  - `task-flow: run next X` - Work on next X subtasks sequentially
24
- - `task-flow: run task X` - Work on all pending subtasks of task X
24
+ - `task-flow: run X` - Work on all pending subtasks of task X (simplified - no "task" needed)
25
+ - `task-flow: run X,Y` - Work on multiple tasks (comma-separated)
26
+ - `task-flow: run all` - Work on all tasks
25
27
  - `task-flow: status` - Show current task status
26
- - `task-flow: review` - Review completed tasks
27
- - `task-flow: refactor` - Refactor code from current commit
28
+ - `task-flow: review X` - Review specific task(s) (comma-separated or "all")
29
+ - `task-flow: refactor X` - Refactor specific task(s) (comma-separated or "all")
30
+ - `task-flow: estimate X` - Estimate time for task X (simplified - no "task" needed)
31
+ - `task-flow: estimate X,Y` - Estimate multiple tasks (comma-separated)
32
+ - `task-flow: estimate all` - Estimate all tasks
33
+ - `task-flow: report X` - Generate implementation report for task X (simplified - no "task" needed)
34
+ - `task-flow: report X,Y` - Generate reports for multiple tasks (comma-separated)
35
+ - `task-flow: report all` - Generate reports for all tasks
28
36
 
29
37
  - **Workflow Example:**
30
38
  ```markdown
@@ -80,7 +88,7 @@ alwaysApply: true
80
88
 
81
89
  - **Simplified Task Work:**
82
90
  - See [task_work.mdc](mdc:.cursor/rules/task_work.mdc) for simplified "do next X subtasks" commands
83
- - When user says "faça as próximas X subtasks", automatically find and implement them
91
+ - When user says "work on next X subtasks" or similar phrases, automatically find and implement them
84
92
 
85
93
  - **Task Review:**
86
94
  - See [task_review.mdc](mdc:.cursor/rules/task_review.mdc) for reviewing completed tasks
@@ -93,10 +101,10 @@ alwaysApply: true
93
101
  - **Task Flow Commands - Natural Language Interpretation:**
94
102
  - **CRITICAL**: When user mentions **"task flow"**, they **ALWAYS** refer to **RBIN Task Flow**
95
103
  - Common phrases that mean "work on RBIN Task Flow subtasks":
96
- - "trabalhe nas próximas x subtasks do task flow"
97
104
  - "work on next x subtasks from task flow"
98
- - "próximas subtasks do task flow"
105
+ - "next subtasks from task flow"
99
106
  - "task flow subtasks"
107
+ - "do next x subtasks"
100
108
  - Any variation mentioning "task flow" + "subtasks"
101
109
 
102
110
  - **When User Asks to Work on Subtasks:**
@@ -112,7 +120,7 @@ alwaysApply: true
112
120
  - **STEP 4**: If all subtasks of a task are done, update task status to "done" in both files
113
121
 
114
122
  - **Example:**
115
- - User: "trabalhe nas próximas 3 subtasks do task flow"
123
+ - User: "work on next 3 subtasks from task flow"
116
124
  - Interpretation: Work on next 3 pending subtasks from RBIN Task Flow
117
125
  - Action:
118
126
  1. Read `.task-flow/.internal/tasks.json` and `.task-flow/.internal/status.json`
@@ -18,7 +18,7 @@ alwaysApply: true
18
18
  - **AUTOMATIC MATCHING**: Automatically match screenshots to tasks based on keywords (e.g., "login" → `login_recover_signup.png`, "dashboard" → `dashboard.png`, "paciente" → `patient.png`)
19
19
  - **SPECIFIC REFERENCE**: If task contains `task-flow-screen nome_do_arquivo.png`, reference that specific screenshot from `.task-flow/screens/`
20
20
  - **PATH ALWAYS**: `task-flow-screen` always references files in `.task-flow/screens/` directory
21
- - **INCLUDE**: Add screenshot reference in instructions: "Referência visual: `.task-flow/screens/nome_do_arquivo.png`"
21
+ - **INCLUDE**: Add screenshot reference in instructions: "Visual reference: `.task-flow/screens/filename.png`"
22
22
 
23
23
  - **Required Actions:**
24
24
  1. Read `tasks.input.txt`:
@@ -79,17 +79,17 @@ alwaysApply: true
79
79
  ```markdown
80
80
  # Task Status
81
81
 
82
- <!-- ⚠️ AVISO: Este arquivo é atualizado automaticamente pela IA. NÃO edite manualmente. -->
82
+ <!-- ⚠️ WARNING: This file is automatically updated by AI. DO NOT edit manually. -->
83
83
 
84
- ## 📊 Resumo
84
+ ## 📊 Summary
85
85
 
86
- - ✅ **Tasks Completas**: 0
87
- - ⏳ **Tasks em Andamento**: 2
88
- - 📝 **Subtasks Restantes**: 8
86
+ - ✅ **Completed Tasks**: 0
87
+ - ⏳ **Tasks in Progress**: 2
88
+ - 📝 **Remaining Subtasks**: 8
89
89
 
90
90
  **Tasks:**
91
- - ✅ Task 1: First task (completa)
92
- - ⏳ Task 2: Second task (3 subtasks restantes de 5)
91
+ - ✅ Task 1: First task (complete)
92
+ - ⏳ Task 2: Second task (3 remaining subtasks out of 5)
93
93
 
94
94
  ---
95
95
 
@@ -107,10 +107,10 @@ alwaysApply: true
107
107
  - [ ] Subtask Title 3
108
108
  ```
109
109
  - **ALWAYS include summary section** at the top with:
110
- - ✅ Tasks completas (all subtasks done)
111
- - ⏳ Tasks em andamento (some subtasks done)
112
- - 📝 Total de subtasks restantes
113
- - Lista de tasks com status e quantas subtasks faltam
110
+ - ✅ Completed tasks (all subtasks done)
111
+ - ⏳ Tasks in progress (some subtasks done)
112
+ - 📝 Total remaining subtasks
113
+ - List of tasks with status and how many subtasks remain
114
114
  - All tasks and subtasks start as `- [ ]` (pending)
115
115
  - Format: Task title with `- [ ]` or `- [x]`, then subtasks indented with ` - [ ]` or ` - [x]`
116
116
  - **CRITICAL**: Always regenerate summary when updating tasks.status.md
@@ -120,15 +120,15 @@ alwaysApply: true
120
120
  - Screenshots available: `login_recover_signup.png`
121
121
  - Output: Task with ID 1, 5 subtasks with screenshot references:
122
122
  - Subtask 1: "Setup database schema" (no screenshot)
123
- - Subtask 2: "Create login form" → Instructions include: "Referência visual: `.task-flow/screens/login_recover_signup.png`"
123
+ - Subtask 2: "Create login form" → Instructions include: "Visual reference: `.task-flow/screens/login_recover_signup.png`"
124
124
  - Subtask 3: "Implement registration" → Instructions include screenshot reference
125
125
  - Subtask 4: "Add JWT authentication" (no screenshot)
126
126
  - Subtask 5: "Test authentication flow" → Instructions include screenshot reference
127
127
 
128
128
  - **Screenshot Reference Examples:**
129
- - Task: `- Sistema de autenticação do dentista` → Automatically matches and references `login_recover_signup.png` from `.task-flow/screens/`
130
- - Task: `- Dashboard básico com estrutura task-flow-screen dashboard.png` → References specific `.task-flow/screens/dashboard.png`
131
- - Task: `- CRUD completo de pacientes` → Automatically matches and references `patient.png` and `patient_profile.png` from `.task-flow/screens/` if available
129
+ - Task: `- Dentist authentication system` → Automatically matches and references `login_recover_signup.png` from `.task-flow/screens/`
130
+ - Task: `- Basic dashboard with structure task-flow-screen dashboard.png` → References specific `.task-flow/screens/dashboard.png`
131
+ - Task: `- Complete patient CRUD` → Automatically matches and references `patient.png` and `patient_profile.png` from `.task-flow/screens/` if available
132
132
  - **IMPORTANT**: `task-flow-screen` always references files in `.task-flow/screens/` - no need to specify full path
133
133
 
134
134
  - **Critical Rules:**
@@ -5,8 +5,10 @@ alwaysApply: true
5
5
  ---
6
6
 
7
7
  - **Task Refactor - Improve Code Quality:**
8
- - **FAST FORMAT**: `task-flow: refactor` → Refactor code from current commit
9
- - When user says "task-flow: refactor" or "refactor current tasks":
8
+ - **FAST FORMAT**: `task-flow: refactor X` or `task-flow: refactor X,Y` or `task-flow: refactor all` → Refactor specific task(s)
9
+ - **SIMPLIFIED SYNTAX**: No need to say "task" - just use the number: `task-flow: refactor 1` instead of `task-flow: refactor task 1`
10
+ - **REQUIRED**: Task ID is required - use `task-flow: refactor all` to refactor all tasks
11
+ - When user says "task-flow: refactor X", "task-flow: refactor X,Y", "task-flow: refactor all", or "refactor tasks":
10
12
  - **IDENTIFY**: Files changed in current commit (or staged changes)
11
13
  - **REFACTOR**: Improve code quality without changing functionality
12
14
  - **REMOVE**: All explanatory comments (following code_comments.mdc rules)
@@ -51,20 +53,21 @@ alwaysApply: true
51
53
  5. Show summary of changes
52
54
 
53
55
  - **Natural Language Phrases:**
54
- - **FAST FORMAT**: `task-flow: refactor` or `task-flow refactor`
55
- - "refactor current tasks"
56
- - "refactor code from commit"
56
+ - **FAST FORMAT**: `task-flow: refactor X` or `task-flow: refactor X,Y` or `task-flow: refactor all`
57
+ - "refactor task 1"
58
+ - "refactor tasks 10,11"
59
+ - "refactor all tasks"
57
60
  - "improve code quality"
58
61
  - "clean up code"
59
- - Any variation asking to refactor/improve code
62
+ - Any variation asking to refactor/improve code (must include task ID or "all")
60
63
 
61
64
  - **Example:**
62
65
  ```
63
- User: "task-flow: refactor"
66
+ User: "task-flow: refactor 1"
64
67
 
65
68
  AI Action:
66
- 1. Check git diff or staged files
67
- 2. Identify files changed in current commit
69
+ 1. Identify files related to task 1 (from git history or task implementation)
70
+ 2. Read each file
68
71
  3. For each file:
69
72
  - Remove explanatory comments
70
73
  - Improve code structure
@@ -73,6 +76,14 @@ alwaysApply: true
73
76
  4. Preserve separation comments
74
77
  5. Verify functionality unchanged
75
78
  6. Show refactoring summary
79
+
80
+ User: "task-flow: refactor all"
81
+
82
+ AI Action:
83
+ 1. Process all tasks
84
+ 2. Identify files for each task
85
+ 3. Refactor all files
86
+ 4. Show summary
76
87
  ```
77
88
 
78
89
  - **Integration:**
@@ -0,0 +1,113 @@
1
+ ---
2
+ description: Generate implementation reports for completed tasks
3
+ globs: **/*
4
+ alwaysApply: true
5
+ ---
6
+
7
+ - **Task Report - Generate Implementation Reports:**
8
+ - **FAST FORMAT**: `task-flow: report X` → Generate implementation report for task X (simplified - no "task" needed)
9
+ - **MULTIPLE TASKS**: `task-flow: report X,Y` → Generate reports for multiple tasks
10
+ - **ALL TASKS**: `task-flow: report all` → Generate reports for all tasks
11
+ - When user says "task-flow: report X", "report X", "report X,Y", "report all", "generate report for task X", or "create report task X":
12
+ - **READ**: `.task-flow/.internal/tasks.json` to get task details
13
+ - **READ**: `.task-flow/.internal/status.json` to verify task is completed
14
+ - **ANALYZE**: Codebase changes related to the task (git history, file changes)
15
+ - **GENERATE**: Markdown report documenting what was implemented
16
+ - **SAVE**: Report to `.task-flow/docs/task-X-implementation.md`
17
+
18
+ - **Report Generation Rules:**
19
+ 1. **Verify Completion**: Task must be marked as "done" in status.json (all subtasks completed)
20
+ 2. **Report Structure**:
21
+ - Task title and description
22
+ - List of all subtasks with their status
23
+ - Implementation details (files created/modified)
24
+ - Code changes summary
25
+ - Testing information (if applicable)
26
+ - Notes and considerations
27
+ 3. **File Location**: `.task-flow/docs/task-X-implementation.md`
28
+ 4. **File Naming**: `task-{taskId}-implementation.md` (e.g., `task-1-implementation.md`)
29
+ 5. **Directory Creation**: Create `.task-flow/docs/` if it doesn't exist
30
+
31
+ - **Report Template:**
32
+ ```markdown
33
+ # Task {X}: {Task Title}
34
+
35
+ **Status**: ✅ Completed
36
+ **Date**: {completion date}
37
+
38
+ ## Description
39
+
40
+ {Task description from tasks.json}
41
+
42
+ ## Subtasks Completed
43
+
44
+ {List all subtasks with their status}
45
+
46
+ ## Implementation Details
47
+
48
+ ### Files Created
49
+ - {file path}
50
+ - {file path}
51
+
52
+ ### Files Modified
53
+ - {file path}
54
+ - {file path}
55
+
56
+ ## Code Changes Summary
57
+
58
+ {Summary of what was implemented}
59
+
60
+ ## Testing
61
+
62
+ {Testing information if applicable}
63
+
64
+ ## Notes
65
+
66
+ {Additional notes or considerations}
67
+ ```
68
+
69
+ - **Report Content:**
70
+ 1. **Task Information**: Title, description, completion date
71
+ 2. **Subtasks**: List all subtasks with their completion status
72
+ 3. **Files**: List files created and modified (from git history or file system)
73
+ 4. **Implementation**: Summary of what was implemented
74
+ 5. **Testing**: Testing information if tests were added
75
+ 6. **Notes**: Additional considerations or follow-up items
76
+
77
+ - **Natural Language Phrases:**
78
+ - **FAST FORMAT**: `task-flow: report X` or `task-flow report X` (simplified)
79
+ - **MULTIPLE**: `task-flow: report X,Y` or `task-flow: report all`
80
+ - "generate report for task X" or "report X"
81
+ - "report tasks 10,11"
82
+ - "report all tasks"
83
+ - "create report task X"
84
+ - "document task X"
85
+ - "report for task X"
86
+ - Any variation asking for task report generation
87
+
88
+ - **Example:**
89
+ ```
90
+ User: "task-flow: report 1"
91
+
92
+ AI Action:
93
+ 1. Read tasks.json and status.json
94
+ 2. Verify task 1 is completed
95
+ 3. Analyze codebase for changes related to task 1
96
+ 4. Generate markdown report
97
+ 5. Save to .task-flow/docs/task-1-implementation.md
98
+ 6. Show confirmation message
99
+ ```
100
+
101
+ - **Error Handling:**
102
+ - If task is not completed: Show warning and ask if user wants to generate partial report
103
+ - If task doesn't exist: Show error message
104
+ - If docs directory doesn't exist: Create it automatically
105
+
106
+ - **Integration:**
107
+ - Works with [task_execution.mdc](mdc:.cursor/rules/task_execution.mdc) workflow
108
+ - Uses task data from `.task-flow/.internal/tasks.json` and `.task-flow/.internal/status.json`
109
+ - Reports are stored in `.task-flow/docs/` directory
110
+ - Can reference git history for implementation details
111
+
112
+ - **Principle:**
113
+ > **Generate comprehensive implementation reports documenting what was completed in each task. Reports should be useful for code reviews, documentation, and project tracking.**
@@ -5,8 +5,10 @@ alwaysApply: true
5
5
  ---
6
6
 
7
7
  - **Task Review - Verify Completed Tasks:**
8
- - **FAST FORMAT**: `task-flow: review` → Review all completed tasks
9
- - When user says "task-flow: review" or "review completed tasks":
8
+ - **FAST FORMAT**: `task-flow: review X` or `task-flow: review X,Y` or `task-flow: review all` → Review specific task(s)
9
+ - **SIMPLIFIED SYNTAX**: No need to say "task" - just use the number: `task-flow: review 1` instead of `task-flow: review task 1`
10
+ - **REQUIRED**: Task ID is required - use `task-flow: review all` to review all tasks
11
+ - When user says "task-flow: review X", "task-flow: review X,Y", "task-flow: review all", or "review completed tasks":
10
12
  - **READ**: `.task-flow/.internal/tasks.json` and `.task-flow/.internal/status.json`
11
13
  - **IDENTIFY**: All tasks/subtasks marked as "done"
12
14
  - **VERIFY**: Check if each completed task/subtask is actually implemented
@@ -44,20 +46,22 @@ alwaysApply: true
44
46
  ```
45
47
 
46
48
  - **Natural Language Phrases:**
47
- - **FAST FORMAT**: `task-flow: review` or `task-flow review`
48
- - "review completed tasks"
49
+ - **FAST FORMAT**: `task-flow: review X` or `task-flow: review X,Y` or `task-flow: review all`
50
+ - "review task 1"
51
+ - "review tasks 10,11"
52
+ - "review all tasks"
49
53
  - "verify done tasks"
50
54
  - "check if tasks are really done"
51
55
  - "review task status"
52
- - Any variation asking to review/verify completed tasks
56
+ - Any variation asking to review/verify completed tasks (must include task ID or "all")
53
57
 
54
58
  - **Example:**
55
59
  ```
56
- User: "task-flow: review"
60
+ User: "task-flow: review 1"
57
61
 
58
62
  AI Action:
59
63
  1. Read tasks.json and status.json
60
- 2. Find all "done" tasks/subtasks
64
+ 2. Find task 1 and its "done" subtasks
61
65
  3. Verify each one:
62
66
  - Check if files exist
63
67
  - Check if code matches requirements
@@ -65,6 +69,15 @@ alwaysApply: true
65
69
  4. Report findings
66
70
  5. Ask if user wants to correct status
67
71
  6. If confirmed, update status.json
72
+
73
+ User: "task-flow: review all"
74
+
75
+ AI Action:
76
+ 1. Read tasks.json and status.json
77
+ 2. Find all "done" tasks/subtasks
78
+ 3. Verify each one
79
+ 4. Report findings
80
+ 5. Ask if user wants to correct status
68
81
  ```
69
82
 
70
83
  - **Integration:**
@@ -6,14 +6,17 @@ alwaysApply: true
6
6
 
7
7
  - **Task Work - Simplified Commands:**
8
8
  - **FASTEST FORMAT**: `task-flow: run next X` (e.g., "task-flow: run next 4" → work on next 4 subtasks)
9
- - **TASK SPECIFIC**: `task-flow: run task X` (e.g., "task-flow: run task 1" → work on all subtasks of task 1)
10
- - When user says "task-flow: run next X", "faça as próximas X subtasks", or "work on next X subtasks":
9
+ - **TASK SPECIFIC**: `task-flow: run X` or `task-flow: run X,Y` or `task-flow: run all` (e.g., "task-flow: run 1" → work on all subtasks of task 1)
10
+ - **SIMPLIFIED SYNTAX**: No need to say "task" - just use the number: `task-flow: run 1` instead of `task-flow: run task 1`
11
+ - When user says "task-flow: run next X" or "work on next X subtasks":
11
12
  - **INTERPRET**: User wants to work on the next X pending subtasks from RBIN Task Flow
12
13
  - **AUTOMATIC**: Read tasks, find next X pending, implement them sequentially
13
14
  - **UPDATE**: Mark each subtask as done after completion
14
15
  - **NO NEED**: To specify "task flow" explicitly - it's implied
15
- - When user says "task-flow: run task X", "execute todas as subtasks da task X", or "work on task X":
16
- - **INTERPRET**: User wants to work on all pending subtasks of a specific task
16
+ - When user says "task-flow: run X" or "task-flow: run X,Y" or "task-flow: run all":
17
+ - **INTERPRET**: User wants to work on all pending subtasks of specific task(s) or all tasks
18
+ - **MULTIPLE TASKS**: Comma-separated IDs (e.g., "10,11") processes multiple tasks sequentially
19
+ - **ALL TASKS**: "all" processes all tasks in order
17
20
  - **DEPENDENCY CHECK**: Before executing, verify that all tasks before X (1, 2, ..., X-1) are completely done
18
21
  - **CONFLICT PREVENTION**: Only execute subtasks of task X if no previous tasks have pending subtasks (allows parallel work by multiple AIs)
19
22
  - **PARTIAL EXECUTION**: If previous tasks have pending subtasks, inform user that task X cannot be fully executed until previous tasks are complete
@@ -23,30 +26,33 @@ alwaysApply: true
23
26
 
24
27
  - **Natural Language Phrases:**
25
28
  - **FAST FORMAT**: `task-flow: run next X` or `task-flow run next X` (e.g., "task-flow: run next 4")
26
- - **TASK FORMAT**: `task-flow: run task X` or `task-flow run task X` (e.g., "task-flow: run task 1")
27
- - "faça as próximas 3 subtasks"
29
+ - **TASK FORMAT**: `task-flow: run X` or `task-flow: run X,Y` or `task-flow: run all` (e.g., "task-flow: run 1" or "task-flow: run 10,11" or "task-flow: run all")
30
+ - "work on next 3 subtasks"
28
31
  - "work on next 5 subtasks"
29
- - "próximas 2 subtasks"
30
- - "faça próximas subtasks"
32
+ - "next 2 subtasks"
33
+ - "work on next subtasks"
31
34
  - "implement next X subtasks"
32
- - "trabalhe nas próximas X subtasks"
33
- - "execute todas as subtasks da task 1"
35
+ - "work on next X subtasks"
36
+ - "execute all subtasks of task 1"
34
37
  - "work on all subtasks of task 2"
35
- - Any phrase with "próximas" + number + "subtasks" or "next" + number + "subtasks"
38
+ - Any phrase with "next" + number + "subtasks"
36
39
  - Any phrase with "task" + number + "subtasks" or "all subtasks" + "task" + number
37
40
 
38
41
  - **Fast Command Format:**
39
42
  - `task-flow: run next X` → Work on next X subtasks sequentially (fastest way)
40
43
  - `task-flow run next X` → Same as above (without colon)
41
44
  - `task-flow: run next` → Work on next 1 subtask (default)
42
- - `task-flow: run task X` → Work on all pending subtasks of task X
43
- - `task-flow run task X` → Same as above (without colon)
45
+ - `task-flow: run X` → Work on all pending subtasks of task X (simplified - no "task" needed)
46
+ - `task-flow: run X,Y` → Work on all pending subtasks of tasks X and Y
47
+ - `task-flow: run all` → Work on all pending subtasks of all tasks
48
+ - `task-flow run X` → Same as above (without colon)
44
49
  - Examples:
45
50
  - "task-flow: run next 4" → Work on next 4 subtasks
46
51
  - "task-flow run next 3" → Work on next 3 subtasks
47
52
  - "task-flow: run next" → Work on next 1 subtask
48
- - "task-flow: run task 1" → Work on all pending subtasks of task 1
49
- - "task-flow run task 2" → Work on all pending subtasks of task 2
53
+ - "task-flow: run 1" → Work on all pending subtasks of task 1
54
+ - "task-flow: run 10,11" → Work on all pending subtasks of tasks 10 and 11
55
+ - "task-flow: run all" → Work on all pending subtasks of all tasks
50
56
 
51
57
  - **Required Actions for `task-flow: run next X`:**
52
58
  1. **Read task files**: `.task-flow/.internal/tasks.json` and `.task-flow/.internal/status.json`
@@ -118,7 +124,7 @@ alwaysApply: true
118
124
  3. Update `.task-flow/tasks.status.md`:
119
125
  - Change `- [ ]` to `- [x]` for the subtask
120
126
  - If all subtasks of a task are done, mark task as `- [x]`
121
- - **REGENERATE SUMMARY**: Always update the "📊 Resumo" section at the top with:
127
+ - **REGENERATE SUMMARY**: Always update the "📊 Summary" section at the top with:
122
128
  - Count of completed tasks (✅)
123
129
  - Count of in-progress tasks (⏳)
124
130
  - Total remaining subtasks (📝)
@@ -171,16 +177,16 @@ alwaysApply: true
171
177
  7. Mark task 3 as "done" if all subtasks completed
172
178
  8. Show completion summary
173
179
 
174
- User: "faça as próximas 3 subtasks"
180
+ User: "work on next 3 subtasks"
175
181
  AI Action: Same workflow as "run next 3", works with natural language too
176
182
 
177
- User: "execute todas as subtasks da task 2"
183
+ User: "execute all subtasks of task 2"
178
184
  AI Action: Same workflow as "run task 2", includes dependency check
179
185
  ```
180
186
 
181
187
  - **Default Behavior:**
182
- - If user says "próximas subtasks" without number → assume 1 subtask
183
- - If user says "próximas X subtasks" → work on exactly X subtasks
188
+ - If user says "next subtasks" without number → assume 1 subtask
189
+ - If user says "next X subtasks" → work on exactly X subtasks
184
190
  - If user says "task X" without "next" → interpret as "run task X" (all subtasks of that task)
185
191
  - Always work sequentially (don't skip or reorder)
186
192