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.
- package/.cursor/rules/code_comments.mdc +62 -62
- package/.cursor/rules/commit_practices.mdc +75 -75
- package/.cursor/rules/git_control.mdc +63 -63
- package/.cursor/rules/task_estimate.mdc +92 -0
- package/.cursor/rules/task_execution.mdc +15 -7
- package/.cursor/rules/task_generation.mdc +16 -16
- package/.cursor/rules/task_refactor.mdc +20 -9
- package/.cursor/rules/task_report.mdc +113 -0
- package/.cursor/rules/task_review.mdc +20 -7
- package/.cursor/rules/task_work.mdc +26 -20
- package/.task-flow/README.md +96 -46
- package/.task-flow/screens/example.png.txt +10 -11
- package/.task-flow/tasks.input.txt +4 -4
- package/.task-flow/tasks.status.md +7 -7
- package/CLAUDE.md +13 -5
- package/GEMINI.md +13 -5
- package/README.md +22 -10
- package/bin/cli.js +24 -0
- package/lib/estimate.js +117 -0
- package/lib/install.js +11 -32
- package/lib/report.js +297 -0
- package/lib/utils.js +16 -1
- package/lib/version.js +8 -5
- package/package.json +1 -1
|
@@ -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
|
|
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
|
|
27
|
-
- `task-flow: refactor` - Refactor
|
|
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 "
|
|
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
|
-
- "
|
|
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: "
|
|
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: "
|
|
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
|
-
<!-- ⚠️
|
|
82
|
+
<!-- ⚠️ WARNING: This file is automatically updated by AI. DO NOT edit manually. -->
|
|
83
83
|
|
|
84
|
-
## 📊
|
|
84
|
+
## 📊 Summary
|
|
85
85
|
|
|
86
|
-
- ✅ **Tasks
|
|
87
|
-
- ⏳ **Tasks
|
|
88
|
-
- 📝 **Subtasks
|
|
86
|
+
- ✅ **Completed Tasks**: 0
|
|
87
|
+
- ⏳ **Tasks in Progress**: 2
|
|
88
|
+
- 📝 **Remaining Subtasks**: 8
|
|
89
89
|
|
|
90
90
|
**Tasks:**
|
|
91
|
-
- ✅ Task 1: First task (
|
|
92
|
-
- ⏳ Task 2: Second task (3 subtasks
|
|
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
|
-
- ✅
|
|
111
|
-
- ⏳ Tasks
|
|
112
|
-
- 📝 Total
|
|
113
|
-
-
|
|
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: "
|
|
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: `-
|
|
130
|
-
- Task: `-
|
|
131
|
-
- Task: `-
|
|
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
|
|
9
|
-
-
|
|
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
|
|
56
|
-
- "refactor
|
|
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.
|
|
67
|
-
2.
|
|
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
|
|
9
|
-
-
|
|
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
|
|
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
|
|
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
|
|
10
|
-
-
|
|
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
|
|
16
|
-
- **INTERPRET**: User wants to work on all pending subtasks of
|
|
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
|
|
27
|
-
- "
|
|
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
|
-
- "
|
|
30
|
-
- "
|
|
32
|
+
- "next 2 subtasks"
|
|
33
|
+
- "work on next subtasks"
|
|
31
34
|
- "implement next X subtasks"
|
|
32
|
-
- "
|
|
33
|
-
- "execute
|
|
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 "
|
|
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
|
|
43
|
-
- `task-flow run
|
|
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
|
|
49
|
-
- "task-flow run
|
|
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 "📊
|
|
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: "
|
|
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
|
|
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 "
|
|
183
|
-
- If user says "
|
|
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
|
|