@e0ipso/ai-task-manager 1.1.4 → 1.2.1

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.
Files changed (8) hide show
  1. package/README.md +20 -1
  2. package/dist/index.js +1 -1
  3. package/dist/index.js.map +1 -1
  4. package/package.json +1 -1
  5. package/templates/ai-task-manager/TASK_MANAGER_INFO.md +32 -10
  6. package/templates/commands/tasks/create-plan.md +150 -42
  7. package/templates/commands/tasks/execute-blueprint.md +46 -50
  8. package/templates/commands/tasks/generate-tasks.md +1 -2
package/README.md CHANGED
@@ -10,6 +10,25 @@ AI-powered task management CLI tool to improve your context. It supports multipl
10
10
  - 🤝 **Multi-Assistant Support**: Configure support for Claude, and Gemini
11
11
  - 📋 **Template System**: Built-in templates for different project types (basic, development, research)
12
12
 
13
+ ## 💰 Intelligent Token Usage
14
+
15
+ **One of the key benefits of this project is dramatically reducing AI costs by using the right model for the right task.**
16
+
17
+ The AI Task Manager leverages a **staged refinement approach** that maximizes the value of expensive, high-capability models while delegating execution to faster, cheaper models:
18
+
19
+ ### 🧠 Use Premium Models for Complex Analysis
20
+ - **Planning Phase** (`/tasks:create-plan`): Deploy your most capable models (Claude Opus, GPT-5, etc.) for deep requirement analysis, architecture decisions, and strategic planning
21
+ - **Task Generation** (`/tasks:generate-tasks`): Leverage advanced reasoning for complex decomposition, dependency mapping, and scope optimization
22
+
23
+ ### ⚡ Use Fast Models for Execution
24
+ - **Blueprint Execution** (`/tasks:execute-blueprint`): Switch to faster, cost-effective models (Gemini 2.0 Flash, Claude Haiku) for task execution
25
+ - **Individual Tasks**: Sub-agents can also choose to use simpler models since most complexity is resolved during planning
26
+
27
+ ### 💡 Why This Works
28
+ The heavy cognitive lifting happens during plan creation and task generation. By the time you reach execution, the blueprint documents are detailed and specific enough that simpler models can reliably implement them. This approach can **reduce your AI costs** and be **significantly faster** compared to using premium models for all phases.
29
+
30
+ _The more complex your project, the greater the savings._
31
+
13
32
  ## 🚀 Quick Start
14
33
 
15
34
  ### 🏗️ Initialize a New Workspace
@@ -29,7 +48,7 @@ The `--destination-directory` flag allows you to specify an alternative director
29
48
  # Claude only
30
49
  npx @e0ipso/ai-task-manager init --assistants claude
31
50
 
32
- # Gemini only
51
+ # Gemini only
33
52
  npx @e0ipso/ai-task-manager init --assistants gemini
34
53
 
35
54
  # Both Claude and Gemini
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('│ 3 ⚠️ MANUALLY REVIEW THE PLAN (don\'t skip this!) │');
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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@e0ipso/ai-task-manager",
3
- "version": "1.1.4",
3
+ "version": "1.2.1",
4
4
  "description": "Task management for AI coding assistants",
5
5
  "main": "dist/index.js",
6
6
  "bin": {
package/templates/ai-task-manager/TASK_MANAGER_INFO.md CHANGED
@@ -5,17 +5,17 @@ commands for Claude Code.
5
5
 
6
6
  ## Types of Documents
7
7
 
8
- Work orders (abbreviated as WO) are complex prompts for programming,
8
+ Work orders (abbreviated as WO) are complex prompts for programming,
9
9
  organizational, or management tasks created by a user. Work orders are
10
- independent of each other and cannot share any context. By definition
10
+ independent of each other and cannot share any context. By definition
11
11
  different work orders can be worked on independently.
12
12
 
13
13
  Each work order has plan associated to it. The plan is a comprehensive document
14
14
  highlighting all the aspects of the work necessary to accomplish the goals from
15
15
  the work order.
16
16
 
17
- Each plan will be broken into tasks. Each task is a logical unit of work that
18
- has a single purpose, and is solved using a single skill. All tasks exist as
17
+ Each plan will be broken into tasks. Each task is a logical unit of work that
18
+ has a single purpose, and is solved using a single skill. All tasks exist as
19
19
  part of a plan. Tasks can have dependencies on other tasks. This happens when a
20
20
  task cannot be worked on (or completed) before some other task(s) are completed.
21
21
 
@@ -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,12 +43,34 @@ 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.
49
- Each sub-folder will contain the plan document and has a name following a naming
50
- pattern `[ID]--[plan-short-name]`. Where the ID is auto-incremental. The plan
51
- document has a name following the pattern `plan-[ID]--[plan-short-name].md`.
52
- Finally, all tasks are under a `tasks` sub-folder. Each task has a name
56
+ Each sub-folder will contain the plan document and has a name following a naming
57
+ pattern `[ID]--[plan-short-name]`. Where the ID is auto-incremental. The plan
58
+ document has a name following the pattern `plan-[ID]--[plan-short-name].md`.
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
package/templates/commands/tasks/create-plan.md CHANGED
@@ -35,27 +35,172 @@ If any critical context is missing:
35
35
  2. Ask targeted follow-up questions grouped by category
36
36
  3. Wait for user responses before proceeding to planning
37
37
  4. Frame questions clearly with examples when helpful
38
+ 5. Be extra cautious. Users miss important context very often. Extract it from them
38
39
 
39
40
  Example clarifying questions:
40
41
  - "What is your primary goal with [specific aspect]?"
41
42
  - "Do you have any existing [resources/code/infrastructure] I should consider?"
42
43
  - "What is your timeline for completing this?"
43
44
  - "Are there specific constraints I should account for?"
45
+ - "Do you want me to write tests for this?"
46
+ - "Are there other systems, projects, or modules that perform a similar task?"
44
47
 
45
48
  #### Step 3: Plan Generation
46
49
  Only after confirming sufficient context, create a plan that includes:
47
50
  1. **Executive Summary**: Brief overview of the approach
48
51
  2. **Detailed Steps**: Numbered, actionable tasks with clear outcomes
49
- 3. **Implementation Order**: Logical sequence with dependencies noted
50
- 4. **Risk Considerations**: Potential challenges and mitigation strategies
51
- 5. **Success Metrics**: How to measure completion and quality
52
- 6. **Resource Requirements**: Tools, skills, or assets needed for each step
52
+ 3. **Risk Considerations**: Potential challenges and mitigation strategies
53
+ 4. **Success Metrics**: How to measure completion and quality
54
+
55
+ Remember that a plan needs to be reviewed by a human. Be concise and to the point. Also, include mermaid diagrams to illustrate the plan.
56
+
57
+ ### Important Notes
58
+ - Never generate a partial or assumed plan without adequate context
59
+ - Prioritize accuracy over speed
60
+ - Consider both technical and non-technical aspects
61
+ - Adapt the plan format based on the task type (development, design, research, etc.)
62
+ - DO NOT create or list any tasks or phases during the plan creation. This will be done in a later step. Stick to writing the PRD (Project Requirements Document).
63
+
64
+ ### Scope Control Guidelines
65
+ **Critical: Implement ONLY what is explicitly requested**
66
+
67
+ - **Minimal Viable Implementation**: Build exactly what the user asked for, nothing more
68
+ - **Question Everything Extra**: If not directly mentioned by the user, don't add it
69
+ - **Avoid Feature Creep**: Resist the urge to add "helpful" features or "nice-to-have" additions
70
+ - **YAGNI Principle**: _You Aren't Gonna Need It_ - don't build for hypothetical future needs
71
+
72
+ **Common Scope Creep Anti-Patterns to Avoid:**
73
+ 1. Adding extra commands or features "for completeness"
74
+ 2. Creating infrastructure for future features that weren't requested
75
+ 3. Building abstractions or frameworks when simple solutions suffice
76
+ 4. Adding configuration options not specifically mentioned
77
+ 5. Implementing error handling beyond what's necessary for the core request
78
+ 6. Creating documentation or help systems unless explicitly requested
79
+
80
+ **When in doubt, ask**: "Is this feature explicitly mentioned in the user's request?"
81
+
82
+ ### Simplicity Principles
83
+ **Favor maintainability over cleverness**
84
+
85
+ - **Simple Solutions First**: Choose the most straightforward approach that meets requirements
86
+ - **Avoid Over-Engineering**: Don't create complex systems when simple ones work
87
+ - **Readable Code**: Write code that others can easily understand and modify
88
+ - **Standard Patterns**: Use established patterns rather than inventing new ones
89
+ - **Minimal Dependencies**: Add external dependencies only when essential, but do not re-invent the wheel
90
+ - **Clear Structure**: Organize code in obvious, predictable ways
91
+
92
+ **Remember**: A working simple solution is better than a complex "perfect" one.
53
93
 
54
94
  ### Output Format
55
95
  Structure your response as follows:
56
96
  - If context is insufficient: List specific clarifying questions
57
97
  - If context is sufficient: Provide the comprehensive plan using the structure above. Use the information in @TASK_MANAGER_INFO.md for the directory structure and additional information about plans.
58
98
 
99
+ Outside the plan document, be **extremely** concise. Just tell the user that you are done, and instruct them to review the plan document.
100
+
101
+ #### Plan Template
102
+
103
+ ```markdown
104
+ ---
105
+ id: [PLAN-ID]
106
+ summary: "[Brief one-line description of what this plan accomplishes]"
107
+ created: [YYYY-MM-DD]
108
+ ---
109
+
110
+ # Plan: [Descriptive Plan Title]
111
+
112
+ ## Original Work Order
113
+ [The unmodified user input that was used to generate this plan, as a quote]
114
+
115
+ ## Plan Clarifications [only add it if clarifications were necessary]
116
+ [Clarification questions and answers in table format]
117
+
118
+ ## Executive Summary
119
+
120
+ [Provide a 2-3 paragraph overview of the plan. Include:
121
+ - What the plan accomplishes
122
+ - Why this approach was chosen
123
+ - Key benefits and outcomes expected]
124
+
125
+ ## Context
126
+
127
+ ### Current State
128
+ [Describe the existing situation, problems, or gaps that this plan addresses. Include specific details about what exists now, current limitations, and why change is needed.]
129
+
130
+ ### Target State
131
+ [Describe the desired end state after plan completion. Be specific about the expected outcomes and how success will be measured.]
132
+
133
+ ### Background
134
+ [Any additional context, requirements, constraints, any solutions that we tried that didn't work, or relevant history that informs the implementation approach.]
135
+
136
+ ## Technical Implementation Approach
137
+
138
+ [Provide an overview of the implementation strategy, key architectural decisions, and technical approach. Break down into major components or phases using ### subheadings.]
139
+
140
+ ### [Component/Phase 1 Name]
141
+ **Objective**: [What this component accomplishes and why it's important]
142
+
143
+ [Detailed explanation of implementation approach, key technical decisions, specifications, and rationale for design choices.]
144
+
145
+ ### [Component/Phase 2 Name]
146
+ **Objective**: [What this component accomplishes and why it's important]
147
+
148
+ [Detailed explanation of implementation approach, key technical decisions, specifications, and rationale for design choices.]
149
+
150
+ ### [Additional Components as Needed]
151
+ [Continue with additional technical components or phases following the same pattern]
152
+
153
+ ## Risk Considerations and Mitigation Strategies
154
+
155
+ ### Technical Risks
156
+ - **[Specific Technical Risk]**: [Description of the technical challenge or limitation]
157
+ - **Mitigation**: [Specific strategy to address this technical risk]
158
+
159
+ ### Implementation Risks
160
+ - **[Specific Implementation Risk]**: [Description of implementation-related challenge]
161
+ - **Mitigation**: [Specific strategy to address this implementation risk]
162
+
163
+ ### [Additional Risk Categories as Needed]
164
+ [Continue with other risk categories such as Integration Risks, Quality Risks, Resource Risks, etc.]
165
+
166
+ ## Success Criteria
167
+
168
+ ### Primary Success Criteria
169
+ 1. [Measurable outcome 1]
170
+ 2. [Measurable outcome 2]
171
+ 3. [Measurable outcome 3]
172
+
173
+ ### Quality Assurance Metrics
174
+ 1. [Quality measure 1]
175
+ 2. [Quality measure 2]
176
+ 3. [Quality measure 3]
177
+
178
+ ## Resource Requirements
179
+
180
+ ### Development Skills
181
+ [Required technical expertise and specialized knowledge areas needed for successful implementation]
182
+
183
+ ### Technical Infrastructure
184
+ [Tools, libraries, frameworks, and systems needed for development and deployment]
185
+
186
+ ### [Additional Resource Categories as Needed]
187
+ [Other resources such as external dependencies, research access, third-party services, etc.]
188
+
189
+ ## Integration Strategy
190
+ [Optional section - how this work integrates with existing systems]
191
+
192
+ ## Implementation Order
193
+ [Optional section - high-level sequence without detailed phases]
194
+
195
+ ## Notes
196
+ [Optional section - any additional considerations, constraints, or important context]
197
+ ```
198
+
199
+ #### Patterns to Avoid
200
+ Do not include the following in your plan output.
201
+ - Avoid time estimations
202
+ - Avoid task lists and mentions of phases (those are things we'll introduce later)
203
+
59
204
  #### Frontmatter Structure
60
205
 
61
206
  Example:
@@ -95,7 +240,7 @@ The schema for this frontmatter is:
95
240
 
96
241
  **Auto-generate the next plan ID:**
97
242
  ```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))
243
+ 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
244
  ```
100
245
 
101
246
  **Key formatting:**
@@ -103,40 +248,3 @@ echo $(($(find .ai/task-manager/plans -name "plan-*.md" -exec grep "^id:" {} \;
103
248
  - **Directory names**: Use zero-padded strings (`07--plan-name`)
104
249
 
105
250
  This command reads `id:` values from existing plan front-matter as the source of truth. Handles empty directories (returns 1) and gaps in sequence automatically.
106
-
107
- ### Important Notes
108
- - Never generate a partial or assumed plan without adequate context
109
- - Prioritize accuracy over speed
110
- - Consider both technical and non-technical aspects
111
- - Adapt the plan format based on the task type (development, design, research, etc.)
112
- - DO NOT create or list any tasks or phases during the plan creation. This will be done in a later step. Stick to writing the PRD (Project Requirements Document).
113
-
114
- ### Scope Control Guidelines
115
- **Critical: Implement ONLY what is explicitly requested**
116
-
117
- - **Minimal Viable Implementation**: Build exactly what the user asked for, nothing more
118
- - **Question Everything Extra**: If not directly mentioned by the user, don't add it
119
- - **Avoid Feature Creep**: Resist the urge to add "helpful" features or "nice-to-have" additions
120
- - **YAGNI Principle**: _You Aren't Gonna Need It_ - don't build for hypothetical future needs
121
-
122
- **Common Scope Creep Anti-Patterns to Avoid:**
123
- 1. Adding extra commands or features "for completeness"
124
- 2. Creating infrastructure for future features that weren't requested
125
- 3. Building abstractions or frameworks when simple solutions suffice
126
- 4. Adding configuration options not specifically mentioned
127
- 5. Implementing error handling beyond what's necessary for the core request
128
- 6. Creating documentation or help systems unless explicitly requested
129
-
130
- **When in doubt, ask**: "Is this feature explicitly mentioned in the user's request?"
131
-
132
- ### Simplicity Principles
133
- **Favor maintainability over cleverness**
134
-
135
- - **Simple Solutions First**: Choose the most straightforward approach that meets requirements
136
- - **Avoid Over-Engineering**: Don't create complex systems when simple ones work
137
- - **Readable Code**: Write code that others can easily understand and modify
138
- - **Standard Patterns**: Use established patterns rather than inventing new ones
139
- - **Minimal Dependencies**: Add external dependencies only when essential
140
- - **Clear Structure**: Organize code in obvious, predictable ways
141
-
142
- **Remember**: A working simple solution is better than a complex "perfect" one.
package/templates/commands/tasks/execute-blueprint.md CHANGED
@@ -4,7 +4,15 @@ description: Execute the task in the plan
4
4
  ---
5
5
  # Task Execution
6
6
 
7
- You are the orchestrator responsible for executing all tasks defined in the execution blueprint of a plan document. Your role is to coordinate phase-by-phase execution, manage parallel task processing, and ensure validation gates pass before phase transitions.
7
+ You are the orchestrator responsible for executing all tasks defined in the execution blueprint of a plan document, so choose an appropriate sub-agent for this role. Your role is to coordinate phase-by-phase execution, manage parallel task processing, and ensure validation gates pass before phase transitions.
8
+
9
+ ## Critical Rules
10
+
11
+ 1. **Never skip validation gates** - Phase progression requires successful validation
12
+ 2. **Maintain task isolation** - Parallel tasks must not interfere with each other
13
+ 3. **Preserve dependency order** - Never execute a task before its dependencies
14
+ 4. **Document everything** - All decisions, issues, and outcomes must be recorded in the "Execution Summary", under "Noteworthy Events"
15
+ 5. **Fail safely** - Better to halt and request help than corrupt the execution state
8
16
 
9
17
  ## Input Requirements
10
18
  - A plan document with an execution blueprint section. See @.ai/task-manager/TASK_MANAGER_INFO.md fo find the plan with ID $1
@@ -34,11 +42,11 @@ Before starting execution check if you are in the `main` branch. If so, create a
34
42
  - Read task frontmatter to extract the `skills` property (array of technical skills)
35
43
  - Analyze task requirements and technical domain from description
36
44
  - Match task skills against available sub-agent capabilities
37
- - Select the most appropriate Claude Code sub-agent (if any are available). If no sub-agent is appropriate, use the generic one.
45
+ - Select the most appropriate sub-agent (if any are available). If no sub-agent is appropriate, use the general-purpose one.
38
46
  - Consider task-specific requirements from the task document
39
47
 
40
48
  3. **Parallel Execution**
41
- - Deploy all selected agents simultaneously
49
+ - Deploy all selected agents simultaneously using your internal Task tool
42
50
  - Monitor execution progress for each task
43
51
  - Capture outputs and artifacts from each agent
44
52
  - Update task status in real-time
@@ -50,7 +58,7 @@ Before starting execution check if you are in the `main` branch. If so, create a
50
58
 
51
59
  5. **Validation Gate Execution**
52
60
  - Reference validation criteria from `@.ai/task-manager/VALIDATION_GATES.md`
53
- - Execute all validation checks for the current phase
61
+ - Execute all validation gates for the current phase
54
62
  - Document validation results
55
63
  - Only proceed if ALL validations pass
56
64
 
@@ -79,8 +87,8 @@ Select agents based on:
79
87
 
80
88
  Update the list of tasks from the plan document to add the status of each task
81
89
  and phase. Once a phase has been completed and validated, and before you move to
82
- the next phase, update the blueprint and add a ✅ emoji in front of its title.
83
- Add ✔️ emoji in front of all the tasks in that phase, and update their status to
90
+ the next phase, update the blueprint and add a ✅ emoji in front of its title.
91
+ Add ✔️ emoji in front of all the tasks in that phase, and update their status to
84
92
  `completed`.
85
93
 
86
94
  #### Task Status Updates
@@ -92,25 +100,6 @@ Valid status transitions:
92
100
 
93
101
  ### Error Handling
94
102
 
95
- #### Task Failure Protocol
96
- 1. **Immediate Actions:**
97
- - Pause the failed task's agent
98
- - Document the error with full context
99
- - Assess impact on other parallel tasks
100
-
101
- 2. **Recovery Strategy:**
102
- - Attempt automatic retry with same agent (max 2 retries)
103
- - If persistent failure, escalate for manual intervention
104
- - Consider alternative agent selection
105
- - Update task status to reflect issues
106
-
107
- 3. **Phase-Level Failures:**
108
- - If any task in a phase fails after retries:
109
- - Halt phase progression
110
- - Complete any still-running parallel tasks
111
- - Generate failure report with recommendations
112
- - Request human intervention before continuing
113
-
114
103
  #### Validation Gate Failures
115
104
  If validation gates fail:
116
105
  1. Document which specific validations failed
@@ -118,46 +107,53 @@ If validation gates fail:
118
107
  3. Generate remediation plan
119
108
  4. Re-execute affected tasks after fixes
120
109
  5. Re-run validation gates
110
+ 6. If errors persist, escalate to the user
121
111
 
122
112
  ### Output Requirements
123
113
 
124
- #### Final Execution Report
125
- Upon blueprint completion respond with the following to the user:
114
+ ## Optimization Guidelines
126
115
 
127
- ```
128
- ✅ Execution Complete
116
+ - **Maximize parallelism**: Always run all available tasks in a phase simultaneously
117
+ - **Resource awareness**: Balance agent allocation with system capabilities
118
+ - **Early failure detection**: Monitor tasks actively to catch issues quickly
119
+ - **Continuous improvement**: Note patterns for future blueprint optimization
129
120
 
130
- 📊 Summary Statistics
121
+ ## Post-Execution Processing
131
122
 
132
- - Total Phases Executed: X
133
- - Total Tasks Completed: Y
134
- - Total Execution Time: [duration]
135
- - Parallel Efficiency: X% (tasks run in parallel vs. sequential)
123
+ Upon successful completion of all phases and validation gates, perform the following additional steps:
136
124
 
137
- 📋 Phase-by-Phase Results
125
+ ### 1. Execution Summary Generation
138
126
 
139
- [Concise summary of each phase]
127
+ Append an execution summary section to the plan document with the following format:
140
128
 
141
- 📦 Artifacts Generated
129
+ ```markdown
130
+ ## Execution Summary
142
131
 
143
- [List of all outputs and deliverables]
132
+ **Status**: ✅ Completed Successfully
133
+ **Completed Date**: [YYYY-MM-DD]
144
134
 
145
- 💡 Recommendations
135
+ ### Results
136
+ [Brief summary of execution results and key deliverables]
146
137
 
138
+ ### Noteworthy Events
139
+ [Highlight any unexpected events, challenges overcome, or significant findings during execution. If none occurred, state "No significant issues encountered."]
140
+
141
+ ### Recommendations
147
142
  [Any follow-up actions or optimizations identified]
148
143
  ```
149
144
 
150
- ## Critical Rules
145
+ ### 2. Plan Archival
151
146
 
152
- 1. **Never skip validation gates** - Phase progression requires successful validation
153
- 2. **Maintain task isolation** - Parallel tasks must not interfere with each other
154
- 3. **Preserve dependency order** - Never execute a task before its dependencies
155
- 4. **Document everything** - All decisions, issues, and outcomes must be recorded
156
- 5. **Fail safely** - Better to halt and request help than corrupt the execution state
147
+ After successfully appending the execution summary:
157
148
 
158
- ## Optimization Guidelines
149
+ **Move completed plan to archive**:
150
+ ```bash
151
+ mv .ai/task-manager/plans/[plan-folder] .ai/task-manager/archive/
152
+ ```
159
153
 
160
- - **Maximize parallelism**: Always run all available tasks in a phase simultaneously
161
- - **Resource awareness**: Balance agent allocation with system capabilities
162
- - **Early failure detection**: Monitor tasks actively to catch issues quickly
163
- - **Continuous improvement**: Note patterns for future blueprint optimization
154
+ ### Important Notes
155
+
156
+ - **Only archive on complete success**: Archive operations should only occur when ALL phases are completed and ALL validation gates have passed
157
+ - **Failed executions remain active**: Plans that fail execution or validation should remain in the `plans/` directory for debugging and potential re-execution
158
+ - **Error handling**: If archival fails, log the error but do not fail the overall execution - the implementation work is complete
159
+ - **Preserve structure**: The entire plan folder (including all tasks and subdirectories) should be moved as-is to maintain referential integrity
package/templates/commands/tasks/generate-tasks.md CHANGED
@@ -40,7 +40,6 @@ Each task must be:
40
40
  - **Single-purpose**: One clear deliverable or outcome
41
41
  - **Atomic**: Cannot be meaningfully split further
42
42
  - **Skill-specific**: Executable by a single skill agent (examples below)
43
- - **Time-bounded**: Completable in a reasonable timeframe by a skilled developer
44
43
  - **Verifiable**: Has clear completion criteria
45
44
 
46
45
  #### Skill Selection and Technical Requirements
@@ -420,7 +419,7 @@ Before finalizing, ensure:
420
419
  - Phases execute in strict numerical order
421
420
  - Phase N+1 cannot begin until Phase N is fully complete and validated
422
421
  - This ensures dependency integrity and systematic progress
423
- -
422
+ -
424
423
 
425
424
  #### Validation Gates
426
425
  - Each phase has associated validation criteria defined externally