@e0ipso/ai-task-manager 1.1.3 → 1.2.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/README.md +36 -57
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
- package/templates/ai-task-manager/TASK_MANAGER_INFO.md +24 -2
- package/templates/commands/tasks/create-plan.md +1 -1
- package/templates/commands/tasks/execute-blueprint.md +47 -0
- package/templates/commands/tasks/generate-tasks.md +2 -37
package/README.md
CHANGED
|
@@ -1,51 +1,29 @@
|
|
|
1
|
-
# AI Task Manager
|
|
1
|
+
# 🤖 AI Task Manager
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
## Features
|
|
3
|
+
[](https://www.npmjs.com/package/@e0ipso/ai-task-manager)
|
|
4
|
+
[](LICENSE)
|
|
6
5
|
|
|
7
|
-
-
|
|
8
|
-
- **Intelligent Directory Structure**: Organized file structure with assistant-specific directories
|
|
9
|
-
- **Interactive CLI**: Enhanced user interface with colored output and progress indicators
|
|
10
|
-
- **Template System**: Built-in templates for different project types (basic, development, research)
|
|
11
|
-
- **Task Management**: Create, list, and manage tasks with status tracking
|
|
12
|
-
- **Installation Management**: Comprehensive installation, verification, and repair capabilities
|
|
13
|
-
- **Cross-Platform**: Works on Windows, macOS, and Linux
|
|
6
|
+
AI-powered task management CLI tool to improve your context. It supports multiple coding assistants including Claude and Gemini for comprehensive development workflow integration.
|
|
14
7
|
|
|
15
|
-
##
|
|
8
|
+
## ✨ Features
|
|
16
9
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
# Install globally
|
|
20
|
-
npm install -g @e0ipso/ai-task-manager
|
|
10
|
+
- 🤝 **Multi-Assistant Support**: Configure support for Claude, and Gemini
|
|
11
|
+
- 📋 **Template System**: Built-in templates for different project types (basic, development, research)
|
|
21
12
|
|
|
22
|
-
|
|
23
|
-
npx @e0ipso/ai-task-manager --help
|
|
24
|
-
```
|
|
13
|
+
## 🚀 Quick Start
|
|
25
14
|
|
|
26
|
-
### Initialize a New Workspace
|
|
15
|
+
### 🏗️ Initialize a New Workspace
|
|
27
16
|
|
|
28
17
|
The `--assistants` flag is **required** when initializing a workspace. You must specify which coding assistant(s) you want to configure support for.
|
|
29
18
|
|
|
30
|
-
The `--destination-directory` flag allows you to specify an alternative directory for the workspace. By default, the workspace is initialized in the current working directory.
|
|
31
|
-
|
|
32
|
-
```bash
|
|
33
|
-
# Quick start with Claude
|
|
34
|
-
npx @e0ipso/ai-task-manager init --assistants claude
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
If the script detects that any of the folders it needs to create already exist it merge the folder structures, but it will overwrite the files in them.
|
|
38
|
-
|
|
39
|
-
## Assistant Selection
|
|
40
|
-
|
|
41
19
|
AI Task Manager supports multiple coding assistants. You **must** specify which assistant(s) to use during initialization using the `--assistants` flag.
|
|
42
20
|
|
|
43
|
-
|
|
21
|
+
🤖 Supported Assistants are
|
|
44
22
|
|
|
45
|
-
- **Claude**: Anthropic's Claude AI assistant
|
|
46
|
-
- **Gemini**: Google's Gemini AI assistant
|
|
23
|
+
- 🎭 **Claude**: Anthropic's Claude AI assistant
|
|
24
|
+
- 💎 **Gemini**: Google's Gemini AI assistant
|
|
47
25
|
|
|
48
|
-
|
|
26
|
+
The `--destination-directory` flag allows you to specify an alternative directory for the workspace. By default, the workspace is initialized in the current working directory.
|
|
49
27
|
|
|
50
28
|
```bash
|
|
51
29
|
# Claude only
|
|
@@ -53,16 +31,14 @@ npx @e0ipso/ai-task-manager init --assistants claude
|
|
|
53
31
|
|
|
54
32
|
# Gemini only
|
|
55
33
|
npx @e0ipso/ai-task-manager init --assistants gemini
|
|
56
|
-
```
|
|
57
34
|
|
|
58
|
-
### Multiple Assistant Setup
|
|
59
|
-
|
|
60
|
-
```bash
|
|
61
35
|
# Both Claude and Gemini
|
|
62
36
|
npx @e0ipso/ai-task-manager init --assistants claude,gemini
|
|
63
37
|
```
|
|
64
38
|
|
|
65
|
-
|
|
39
|
+
If the script detects that any of the folders it needs to create already exist it merge the folder structures, but it will overwrite the files in them.
|
|
40
|
+
|
|
41
|
+
### 📂 Directory Structure
|
|
66
42
|
|
|
67
43
|
When you initialize with assistant selection, the following directory structure is created:
|
|
68
44
|
|
|
@@ -88,25 +64,26 @@ project-root/
|
|
|
88
64
|
└── project files...
|
|
89
65
|
```
|
|
90
66
|
|
|
91
|
-
## Suggested Workflow
|
|
67
|
+
## 💡 Suggested Workflow
|
|
92
68
|
|
|
93
|
-
### One-time Setup
|
|
69
|
+
### 📋 One-time Setup
|
|
94
70
|
|
|
95
71
|
Review and tweak the `.ai/task-manager/TASK_MANAGER_INFO.md` and `.ai/task-manager/VALIDATION_GATES.md`. These files are yours to edit and should reflect your project's tech stack and goals.
|
|
96
72
|
|
|
97
|
-
### Day-to-day Workflow
|
|
73
|
+
### 🔄 Day-to-day Workflow
|
|
98
74
|
|
|
99
|
-
1. Create a plan: `/tasks:create-plan Create an authentication workflow for the application using ...`
|
|
100
|
-
2. Provide additional context if the assistant needs it.
|
|
101
|
-
3. Manually review the plan and make the necessary edits. You might be tempted to skip this step, **do not skip this step**. Find the plan document in `.ai/task-manager/plans/01--authentication-workflow/plan-01--authentication-workflow.md`
|
|
102
|
-
4. Create the tasks for the plan: `/tasks:generate-tasks 1`
|
|
103
|
-
5. Review the list of tasks. This step is important to avoid scope creep and ensure the right things are to be built. Again, **do not skip this step**. Find the tasks in the folder `.ai/task-manager/plans/01--authentication-workflow/tasks/`
|
|
104
|
-
6. Execute the tasks: `/tasks:execute-blueprint 1`
|
|
105
|
-
7. Review the implementation and the generated tests.
|
|
75
|
+
1. 📝 Create a plan: `/tasks:create-plan Create an authentication workflow for the application using ...`
|
|
76
|
+
2. 💬 Provide additional context if the assistant needs it.
|
|
77
|
+
3. ⚠️ Manually review the plan and make the necessary edits. You might be tempted to skip this step, **do not skip this step**. Find the plan document in `.ai/task-manager/plans/01--authentication-workflow/plan-01--authentication-workflow.md`
|
|
78
|
+
4. 📋 Create the tasks for the plan: `/tasks:generate-tasks 1`
|
|
79
|
+
5. 👀 Review the list of tasks. This step is important to avoid scope creep and ensure the right things are to be built. Again, **do not skip this step**. Find the tasks in the folder `.ai/task-manager/plans/01--authentication-workflow/tasks/`
|
|
80
|
+
6. 🚀 Execute the tasks: `/tasks:execute-blueprint 1`
|
|
81
|
+
7. ✅ Review the implementation and the generated tests.
|
|
106
82
|
|
|
107
|
-
|
|
83
|
+
## 🔧 Troubleshooting
|
|
108
84
|
|
|
109
|
-
|
|
85
|
+
<details>
|
|
86
|
+
<summary>🚫 Permission Errors</summary>
|
|
110
87
|
|
|
111
88
|
**Error**: File system permission errors during initialization
|
|
112
89
|
|
|
@@ -115,14 +92,16 @@ Review and tweak the `.ai/task-manager/TASK_MANAGER_INFO.md` and `.ai/task-manag
|
|
|
115
92
|
- On Unix systems, check directory ownership: `ls -la`
|
|
116
93
|
- Try running with appropriate permissions or in a user-owned directory
|
|
117
94
|
|
|
118
|
-
|
|
95
|
+
</details>
|
|
96
|
+
|
|
97
|
+
## 📄 License
|
|
119
98
|
|
|
120
|
-
Proprietary Software with Revocation Rights
|
|
99
|
+
⚖️ **Proprietary Software with Revocation Rights.**
|
|
121
100
|
|
|
122
101
|
This software is free to use, run, and operate for any lawful purposes. The
|
|
123
102
|
author can revoke the license to use it at any time and by any reason. A license
|
|
124
103
|
revocation notice may be provided through:
|
|
125
104
|
|
|
126
|
-
- Direct communication to known users
|
|
127
|
-
- Public announcement on the project repository
|
|
128
|
-
- Update to the LICENSE file
|
|
105
|
+
- 📧 Direct communication to known users
|
|
106
|
+
- 📢 Public announcement on the project repository
|
|
107
|
+
- 📝 Update to the LICENSE file
|
package/dist/index.js
CHANGED
|
@@ -238,7 +238,7 @@ async function displayWorkflowHelp() {
|
|
|
238
238
|
console.log('│ │');
|
|
239
239
|
console.log('│ 2 Provide additional context if the assistant needs it │');
|
|
240
240
|
console.log('│ │');
|
|
241
|
-
console.log(
|
|
241
|
+
console.log("│ 3 ⚠️ MANUALLY REVIEW THE PLAN (don't skip this!) │");
|
|
242
242
|
console.log('│ 📂 Find it in: .ai/task-manager/plans/01--*/plan-*.md │');
|
|
243
243
|
console.log('│ │');
|
|
244
244
|
console.log('│ 4 Create the tasks for the plan: │');
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -23,7 +23,7 @@ task cannot be worked on (or completed) before some other task(s) are completed.
|
|
|
23
23
|
|
|
24
24
|
To find a plan document from its ID use the following command (replace {planId} with the ID, like 06):
|
|
25
25
|
```shell
|
|
26
|
-
find . -name "plan-[0-9][0-9]*--*.md" -type f -exec grep -l "^id: \?{planId}$" {} \;
|
|
26
|
+
find .ai/task-manager/{plans,archive} -name "plan-[0-9][0-9]*--*.md" -type f -exec grep -l "^id: \?{planId}$" {} \;
|
|
27
27
|
```
|
|
28
28
|
|
|
29
29
|
Plans, and tasks are stored as MarkDown files with a YAML front-matter. They are
|
|
@@ -34,7 +34,7 @@ Plans are organized as follows:
|
|
|
34
34
|
```
|
|
35
35
|
.ai/
|
|
36
36
|
task-manager/
|
|
37
|
-
plans/
|
|
37
|
+
plans/ # Active plans (work in progress)
|
|
38
38
|
01--authentication-provider/
|
|
39
39
|
plan-01--authentication-provider.md
|
|
40
40
|
tasks/
|
|
@@ -43,6 +43,13 @@ Plans are organized as follows:
|
|
|
43
43
|
03--this-example-task.md
|
|
44
44
|
04--create-tests.md
|
|
45
45
|
05--update-documentation.md
|
|
46
|
+
archive/ # Completed plans (successfully executed)
|
|
47
|
+
05--user-management/
|
|
48
|
+
plan-05--user-management.md
|
|
49
|
+
tasks/
|
|
50
|
+
01--create-user-model.md
|
|
51
|
+
02--implement-crud-operations.md
|
|
52
|
+
03--add-validation.md
|
|
46
53
|
```
|
|
47
54
|
|
|
48
55
|
Note how in the `.ai/task-manager/plans/` folder we have a sub-folder per plan.
|
|
@@ -52,3 +59,18 @@ document has a name following the pattern `plan-[ID]--[plan-short-name].md`.
|
|
|
52
59
|
Finally, all tasks are under a `tasks` sub-folder. Each task has a name
|
|
53
60
|
according to the pattern `[incremental-ID]--[task-short-name].md`. IDs for tasks
|
|
54
61
|
are auto-incremental within a plan. Each plan starts their tasks' IDs from 01.
|
|
62
|
+
|
|
63
|
+
## Plan Lifecycle and Archive System
|
|
64
|
+
|
|
65
|
+
Plans follow a lifecycle that maintains workspace organization:
|
|
66
|
+
|
|
67
|
+
1. **Active Plans**: When created, plans are placed in the `plans/` directory where they remain while being worked on.
|
|
68
|
+
|
|
69
|
+
2. **Completed Plans**: Upon successful execution of a blueprint (via `/tasks:execute-blueprint`), the entire plan directory is automatically moved from `plans/` to `archive/`.
|
|
70
|
+
|
|
71
|
+
3. **Archive Directory**: The `archive/` directory serves as permanent storage for completed work. This separation keeps the active workspace clean while preserving completed plans for reference.
|
|
72
|
+
|
|
73
|
+
The archive system provides several benefits:
|
|
74
|
+
- **Workspace Organization**: Active plans remain easily accessible while completed work doesn't clutter the workspace
|
|
75
|
+
- **Historical Reference**: Completed plans and their tasks remain available for future reference or learning
|
|
76
|
+
- **Automatic Management**: No manual intervention required - archival happens automatically upon successful completion
|
|
@@ -95,7 +95,7 @@ The schema for this frontmatter is:
|
|
|
95
95
|
|
|
96
96
|
**Auto-generate the next plan ID:**
|
|
97
97
|
```bash
|
|
98
|
-
echo $(($(find .ai/task-manager/plans -name "plan-*.md" -exec grep "^id:" {} \; | sed 's/id: *//' | sort -n | tail -1 | sed 's/^$/0/') + 1))
|
|
98
|
+
echo $(($(find .ai/task-manager/{plans,archive} -name "plan-*.md" -exec grep "^id:" {} \; 2>/dev/null | sed 's/id: *//' | sort -n | tail -1 | sed 's/^$/0/') + 1))
|
|
99
99
|
```
|
|
100
100
|
|
|
101
101
|
**Key formatting:**
|
|
@@ -161,3 +161,50 @@ Upon blueprint completion respond with the following to the user:
|
|
|
161
161
|
- **Resource awareness**: Balance agent allocation with system capabilities
|
|
162
162
|
- **Early failure detection**: Monitor tasks actively to catch issues quickly
|
|
163
163
|
- **Continuous improvement**: Note patterns for future blueprint optimization
|
|
164
|
+
|
|
165
|
+
## Post-Execution Processing
|
|
166
|
+
|
|
167
|
+
Upon successful completion of all phases and validation gates, perform the following additional steps:
|
|
168
|
+
|
|
169
|
+
### 1. Execution Summary Generation
|
|
170
|
+
|
|
171
|
+
Append an execution summary section to the plan document with the following format:
|
|
172
|
+
|
|
173
|
+
```markdown
|
|
174
|
+
## Execution Summary
|
|
175
|
+
|
|
176
|
+
**Status**: ✅ Completed Successfully
|
|
177
|
+
**Completed Date**: [YYYY-MM-DD]
|
|
178
|
+
**Total Execution Time**: [duration]
|
|
179
|
+
|
|
180
|
+
### Results
|
|
181
|
+
[Brief summary of execution results and key deliverables]
|
|
182
|
+
|
|
183
|
+
### Noteworthy Events
|
|
184
|
+
[Highlight any unexpected events, challenges overcome, or significant findings during execution. If none occurred, state "No significant issues encountered."]
|
|
185
|
+
|
|
186
|
+
### Final Validation
|
|
187
|
+
✅ All validation gates passed
|
|
188
|
+
✅ All tasks completed successfully
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
### 2. Plan Archival
|
|
192
|
+
|
|
193
|
+
After successfully appending the execution summary:
|
|
194
|
+
|
|
195
|
+
1. **Create archive directory if needed**:
|
|
196
|
+
```bash
|
|
197
|
+
mkdir -p .ai/task-manager/archive
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
2. **Move completed plan to archive**:
|
|
201
|
+
```bash
|
|
202
|
+
mv .ai/task-manager/plans/[plan-folder] .ai/task-manager/archive/
|
|
203
|
+
```
|
|
204
|
+
|
|
205
|
+
### Important Notes
|
|
206
|
+
|
|
207
|
+
- **Only archive on complete success**: Archive operations should only occur when ALL phases are completed and ALL validation gates have passed
|
|
208
|
+
- **Failed executions remain active**: Plans that fail execution or validation should remain in the `plans/` directory for debugging and potential re-execution
|
|
209
|
+
- **Error handling**: If archival fails, log the error but do not fail the overall execution - the implementation work is complete
|
|
210
|
+
- **Preserve structure**: The entire plan folder (including all tasks and subdirectories) should be moved as-is to maintain referential integrity
|
|
@@ -103,49 +103,12 @@ Tests that verify custom business logic, critical paths, and edge cases specific
|
|
|
103
103
|
- Configuration files or static data
|
|
104
104
|
- Obvious functionality that would break immediately if incorrect
|
|
105
105
|
|
|
106
|
-
**Testing Anti-patterns to Avoid:**
|
|
107
|
-
```javascript
|
|
108
|
-
// DON'T: Testing library functionality
|
|
109
|
-
test('useState updates state', () => {
|
|
110
|
-
// This tests React, not your code
|
|
111
|
-
});
|
|
112
|
-
|
|
113
|
-
// DON'T: Testing trivial getters
|
|
114
|
-
test('getName returns name property', () => {
|
|
115
|
-
expect(user.getName()).toBe(user.name);
|
|
116
|
-
});
|
|
117
|
-
|
|
118
|
-
// DON'T: Comprehensive test suites for simple functions
|
|
119
|
-
test('add function with 15 different number combinations', () => {
|
|
120
|
-
// Overkill for a simple addition function
|
|
121
|
-
});
|
|
122
|
-
```
|
|
123
|
-
|
|
124
|
-
**Testing Positive Patterns:**
|
|
125
|
-
```javascript
|
|
126
|
-
// DO: Test business logic
|
|
127
|
-
test('calculateOrderTotal applies correct discounts and tax', () => {
|
|
128
|
-
// Tests your specific calculation logic
|
|
129
|
-
});
|
|
130
|
-
|
|
131
|
-
// DO: Test critical paths
|
|
132
|
-
test('payment processing handles failed transactions', () => {
|
|
133
|
-
// Tests important error handling
|
|
134
|
-
});
|
|
135
|
-
|
|
136
|
-
// DO: Test edge cases
|
|
137
|
-
test('user registration handles duplicate emails', () => {
|
|
138
|
-
// Tests specific business rule
|
|
139
|
-
});
|
|
140
|
-
```
|
|
141
|
-
|
|
142
106
|
**Test Task Creation Rules:**
|
|
143
107
|
- Combine related test scenarios into single tasks (e.g., "Test user authentication flow" not separate tasks for login, logout, validation)
|
|
144
108
|
- Focus on integration and critical path testing over unit test coverage
|
|
145
109
|
- Avoid creating separate tasks for testing each CRUD operation individually
|
|
146
110
|
- Question whether simple functions need dedicated test tasks
|
|
147
111
|
|
|
148
|
-
|
|
149
112
|
### Process
|
|
150
113
|
|
|
151
114
|
#### Step 1: Task Decomposition
|
|
@@ -246,6 +209,8 @@ The schema for this frontmatter is:
|
|
|
246
209
|
- [ ] Criterion 2
|
|
247
210
|
- [ ] Criterion 3
|
|
248
211
|
|
|
212
|
+
Use your internal TODO tool to track these and keep on track.
|
|
213
|
+
|
|
249
214
|
## Technical Requirements
|
|
250
215
|
[Specific technical details, APIs, libraries, etc. - use this to infer appropriate skills]
|
|
251
216
|
|