@e0ipso/ai-task-manager 1.0.1 → 1.1.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.
package/README.md CHANGED
@@ -94,14 +94,14 @@ project-root/
94
94
 
95
95
  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
96
 
97
- ### Regular Workflow
97
+ ### Day-to-day Workflow
98
98
 
99
99
  1. Create a plan: `/tasks:create-plan Create an authentication workflow for the application using ...`
100
100
  2. Provide additional context if the assistant needs it.
101
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 01`
103
- 5. Review the list of tasks. This step is important to avoid scope creep. Find the tasks in the folder `.ai/task-manager/plans/01--authentication-workflow/tasks/`
104
- 6. Execute the tasks: `/tasks:execute-blueprint 01`
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
105
  7. Review the implementation and the generated tests.
106
106
 
107
107
  ### Troubleshooting
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAmB,aAAa,EAAE,MAAM,SAAS,CAAC;AAiBjF;;;;;;;;GAQG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CA8FvE;AA2ED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGtE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3D,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB,CAAC,CAgBD"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAmB,aAAa,EAAE,MAAM,SAAS,CAAC;AAgBjF;;;;;;;;GAQG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAoFvE;AA2ED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGtE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3D,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB,CAAC,CAgBD"}
package/dist/index.js CHANGED
@@ -79,23 +79,15 @@ async function init(options) {
79
79
  await createAssistantStructure(assistant, baseDir);
80
80
  }
81
81
  // Show success message with created directories
82
- const createdDirectories = (0, utils_1.getCreatedDirectories)(assistants, baseDir);
83
- await logger.success('AI Task Manager initialized successfully!');
84
- await logger.info('Created directory structure:');
85
- for (const dir of createdDirectories) {
86
- await logger.info(` ✓ ${dir}`);
87
- }
88
- // Show copied templates
89
- await logger.info('Template files copied:');
90
- await logger.info(` ✓ ${(0, utils_1.resolvePath)(baseDir, '.ai/task-manager/TASK_MANAGER_INFO.md')}`);
91
- await logger.info(` ✓ ${(0, utils_1.resolvePath)(baseDir, '.ai/task-manager/VALIDATION_GATES.md')}`);
82
+ await logger.success('🎉 AI Task Manager initialized successfully!');
92
83
  for (const assistant of assistants) {
93
84
  const templateFormat = (0, utils_1.getTemplateFormat)(assistant);
94
85
  await logger.info(` ✓ ${(0, utils_1.resolvePath)(baseDir, `.${assistant}/commands/tasks/create-plan.${templateFormat}`)}`);
95
86
  await logger.info(` ✓ ${(0, utils_1.resolvePath)(baseDir, `.${assistant}/commands/tasks/execute-blueprint.${templateFormat}`)}`);
96
87
  await logger.info(` ✓ ${(0, utils_1.resolvePath)(baseDir, `.${assistant}/commands/tasks/generate-tasks.${templateFormat}`)}`);
97
88
  }
98
- await logger.success('Project is ready for AI-powered task management!');
89
+ // Show suggested workflow help text
90
+ await displayWorkflowHelp();
99
91
  return {
100
92
  success: true,
101
93
  message: 'AI Task Manager initialized successfully!',
@@ -216,4 +208,49 @@ async function getInitInfo(baseDir) {
216
208
  assistants,
217
209
  };
218
210
  }
211
+ /**
212
+ * Display formatted workflow help text to guide users after successful installation
213
+ */
214
+ async function displayWorkflowHelp() {
215
+ const separator = '═'.repeat(60);
216
+ const thinSeparator = '─'.repeat(60);
217
+ await logger.info('');
218
+ await logger.info(`╔${separator}╗`);
219
+ await logger.info(`║${' '.repeat(18)}🚀 SUGGESTED WORKFLOW 🚀${' '.repeat(18)}║`);
220
+ await logger.info(`╚${separator}╝`);
221
+ await logger.info('');
222
+ await logger.info(`┌─ 📋 ONE-TIME SETUP ${thinSeparator.slice(20)}┐`);
223
+ await logger.info('│ │');
224
+ await logger.info('│ Review and tweak these files to match your project: │');
225
+ await logger.info('│ • .ai/task-manager/TASK_MANAGER_INFO.md │');
226
+ await logger.info('│ • .ai/task-manager/VALIDATION_GATES.md │');
227
+ await logger.info('│ │');
228
+ await logger.info(`└${thinSeparator}┘`);
229
+ await logger.info('');
230
+ await logger.info(`┌─ 🔄 DAY-TO-DAY WORKFLOW ${thinSeparator.slice(22)}┐`);
231
+ await logger.info('│ │');
232
+ await logger.info('│ 1️⃣ Create a plan: │');
233
+ await logger.info('│ /tasks:create-plan Create an authentication... │');
234
+ await logger.info('│ │');
235
+ await logger.info('│ 2️⃣ Provide additional context if the assistant needs it │');
236
+ await logger.info('│ │');
237
+ await logger.info('│ 3️⃣ ⚠️ MANUALLY REVIEW THE PLAN (don\'t skip this!) │');
238
+ await logger.info('│ Find it in: .ai/task-manager/plans/01--*/plan-*.md │');
239
+ await logger.info('│ │');
240
+ await logger.info('│ 4️⃣ Create the tasks for the plan: │');
241
+ await logger.info('│ /tasks:generate-tasks 1 │');
242
+ await logger.info('│ │');
243
+ await logger.info('│ 5️⃣ ⚠️ REVIEW THE TASKS LIST (avoid scope creep!) │');
244
+ await logger.info('│ Find them in: .ai/task-manager/plans/01--*/tasks/ │');
245
+ await logger.info('│ │');
246
+ await logger.info('│ 6️⃣ Execute the tasks: │');
247
+ await logger.info('│ /tasks:execute-blueprint 1 │');
248
+ await logger.info('│ │');
249
+ await logger.info('│ 7️⃣ Review the implementation and generated tests │');
250
+ await logger.info('│ │');
251
+ await logger.info(`└${thinSeparator}┘`);
252
+ await logger.info('');
253
+ await logger.info('💡 Pro tip: The manual review steps are crucial for success!');
254
+ await logger.info('');
255
+ }
219
256
  //# sourceMappingURL=index.js.map
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":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BH,oBAoFC;AA8ED,sCAGC;AAKD,kCAqBC;AAxND,mCAAiF;AACjF,iDAAmC;AACnC,mCAYiB;AAEjB;;;;;;;;GAQG;AACI,KAAK,UAAU,IAAI,CAAC,OAAoB;IAC7C,IAAI,CAAC;QACH,2BAA2B;QAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,oBAAoB,IAAI,GAAG,CAAC;QACpD,MAAM,eAAe,GAAG,IAAA,mBAAW,EAAC,OAAO,CAAC,CAAC;QAE7C,8BAA8B;QAC9B,MAAM,MAAM,CAAC,IAAI,CAAC,oCAAoC,eAAe,KAAK,CAAC,CAAC;QAE5E,gCAAgC;QAChC,MAAM,UAAU,GAAG,IAAA,uBAAe,EAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACvD,MAAM,MAAM,CAAC,KAAK,CAAC,sBAAsB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAElE,sBAAsB;QACtB,IAAA,0BAAkB,EAAC,UAAU,CAAC,CAAC;QAC/B,MAAM,MAAM,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAElD,oCAAoC;QACpC,MAAM,MAAM,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;QACzE,MAAM,IAAA,iBAAS,EAAC,IAAA,mBAAW,EAAC,OAAO,EAAE,wBAAwB,CAAC,CAAC,CAAC;QAEhE,4CAA4C;QAC5C,MAAM,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QACzD,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAEnC,2DAA2D;QAC3D,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,MAAM,CAAC,IAAI,CAAC,iBAAiB,SAAS,6BAA6B,CAAC,CAAC;YAC3E,MAAM,wBAAwB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;QAED,gDAAgD;QAChD,MAAM,MAAM,CAAC,OAAO,CAAC,8CAA8C,CAAC,CAAC;QAErE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,cAAc,GAAG,IAAA,yBAAiB,EAAC,SAAS,CAAC,CAAC;YACpD,MAAM,MAAM,CAAC,IAAI,CACf,OAAO,IAAA,mBAAW,EAAC,OAAO,EAAE,IAAI,SAAS,+BAA+B,cAAc,EAAE,CAAC,EAAE,CAC5F,CAAC;YACF,MAAM,MAAM,CAAC,IAAI,CACf,OAAO,IAAA,mBAAW,EAAC,OAAO,EAAE,IAAI,SAAS,qCAAqC,cAAc,EAAE,CAAC,EAAE,CAClG,CAAC;YACF,MAAM,MAAM,CAAC,IAAI,CACf,OAAO,IAAA,mBAAW,EAAC,OAAO,EAAE,IAAI,SAAS,kCAAkC,cAAc,EAAE,CAAC,EAAE,CAC/F,CAAC;QACJ,CAAC;QAED,oCAAoC;QACpC,MAAM,mBAAmB,EAAE,CAAC;QAE5B,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,2CAA2C;YACpD,IAAI,EAAE,EAAE,UAAU,EAAE;SACrB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,YAAoB,CAAC;QACzB,IAAI,aAAoB,CAAC;QAEzB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC;YAC7B,aAAa,GAAG,KAAK,CAAC;YACtB,IACE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;gBAC3C,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAC9C,CAAC;gBACD,MAAM,MAAM,CAAC,KAAK,CAAC,wBAAwB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9D,CAAC;iBAAM,IAAI,KAAK,YAAY,uBAAe,EAAE,CAAC;gBAC5C,MAAM,MAAM,CAAC,KAAK,CAAC,sBAAsB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5D,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,CAAC,KAAK,CAAC,0BAA0B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;aAAM,CAAC;YACN,YAAY,GAAG,0CAA0C,CAAC;YAC1D,aAAa,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACzC,MAAM,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACnC,CAAC;QAED,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,aAAa;SACrB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,mBAAmB,CAAC,OAAe;IAChD,MAAM,SAAS,GAAG;QAChB;YACE,MAAM,EAAE,IAAA,uBAAe,EAAC,sCAAsC,CAAC;YAC/D,IAAI,EAAE,IAAA,mBAAW,EAAC,OAAO,EAAE,uCAAuC,CAAC;SACpE;QACD;YACE,MAAM,EAAE,IAAA,uBAAe,EAAC,qCAAqC,CAAC;YAC9D,IAAI,EAAE,IAAA,mBAAW,EAAC,OAAO,EAAE,sCAAsC,CAAC;SACnE;KACF,CAAC;IAEF,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,kCAAkC;QAClC,IAAI,CAAC,CAAC,MAAM,IAAA,cAAM,EAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,uBAAe,CAAC,4BAA4B,QAAQ,CAAC,MAAM,EAAE,EAAE;gBACvE,YAAY,EAAE,QAAQ,CAAC,MAAM;aAC9B,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAA,oBAAY,EAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,MAAM,CAAC,KAAK,CAAC,aAAa,QAAQ,CAAC,MAAM,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,wBAAwB,CAAC,SAAoB,EAAE,OAAe;IAC3E,uCAAuC;IACvC,MAAM,QAAQ,GAAG,IAAA,mBAAW,EAAC,OAAO,EAAE,IAAI,SAAS,iBAAiB,CAAC,CAAC;IAEtE,MAAM,IAAA,iBAAS,EAAC,QAAQ,CAAC,CAAC;IAC1B,MAAM,MAAM,CAAC,KAAK,CAAC,uCAAuC,SAAS,OAAO,QAAQ,EAAE,CAAC,CAAC;IAEtF,oDAAoD;IACpD,MAAM,cAAc,GAAG,IAAA,yBAAiB,EAAC,SAAS,CAAC,CAAC;IACpD,MAAM,MAAM,CAAC,KAAK,CAAC,YAAY,cAAc,wBAAwB,SAAS,YAAY,CAAC,CAAC;IAE5F,oEAAoE;IACpE,MAAM,oBAAoB,GAAG,MAAM,IAAA,gCAAwB,EAAC,gBAAgB,CAAC,CAAC;IAE9E,KAAK,MAAM,YAAY,IAAI,oBAAoB,EAAE,CAAC;QAChD,MAAM,YAAY,GAAG,GAAG,YAAY,IAAI,cAAc,EAAE,CAAC;QAEzD,0DAA0D;QAC1D,MAAM,YAAY,GAAG,IAAA,uBAAe,EAAC,kBAAkB,YAAY,KAAK,CAAC,CAAC;QAC1E,MAAM,QAAQ,GAAG,IAAA,mBAAW,EAAC,OAAO,EAAE,IAAI,SAAS,mBAAmB,YAAY,EAAE,CAAC,CAAC;QAEtF,qCAAqC;QACrC,IAAI,CAAC,CAAC,MAAM,IAAA,cAAM,EAAC,YAAY,CAAC,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,uBAAe,CAAC,+BAA+B,YAAY,EAAE,EAAE;gBACvE,YAAY,EAAE,YAAY;gBAC1B,SAAS;gBACT,cAAc;aACf,CAAC,CAAC;QACL,CAAC;QAED,uDAAuD;QACvD,MAAM,gBAAgB,GAAG,MAAM,IAAA,8BAAsB,EAAC,YAAY,EAAE,cAAc,CAAC,CAAC;QAEpF,6CAA6C;QAC7C,MAAM,IAAA,8BAAsB,EAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QAEzD,MAAM,MAAM,CAAC,KAAK,CAChB,eAAe,YAAY,mBAAmB,YAAY,QAAQ,SAAS,OAAO,QAAQ,EAAE,CAC7F,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,aAAa,CAAC,OAAgB;IAClD,MAAM,SAAS,GAAG,OAAO,IAAI,GAAG,CAAC;IACjC,OAAO,MAAM,IAAA,cAAM,EAAC,IAAA,mBAAW,EAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,WAAW,CAAC,OAAgB;IAMhD,MAAM,SAAS,GAAG,OAAO,IAAI,GAAG,CAAC;IACjC,MAAM,gBAAgB,GAAG,MAAM,IAAA,cAAM,EAAC,IAAA,mBAAW,EAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAClF,MAAM,eAAe,GAAG,MAAM,IAAA,cAAM,EAAC,IAAA,mBAAW,EAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC,CAAC;IACvF,MAAM,eAAe,GAAG,MAAM,IAAA,cAAM,EAAC,IAAA,mBAAW,EAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC,CAAC;IAEvF,MAAM,UAAU,GAAgB,EAAE,CAAC;IACnC,IAAI,eAAe;QAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,eAAe;QAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE/C,OAAO;QACL,gBAAgB;QAChB,eAAe;QACf,eAAe;QACf,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,mBAAmB;IAChC,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACjC,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAErC,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtB,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC;IACpC,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,2BAA2B,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAClF,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC;IACpC,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEtB,MAAM,MAAM,CAAC,IAAI,CAAC,wBAAwB,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACtE,MAAM,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACpF,MAAM,MAAM,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IACnF,MAAM,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACpF,MAAM,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACpF,MAAM,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACpF,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,aAAa,GAAG,CAAC,CAAC;IACxC,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEtB,MAAM,MAAM,CAAC,IAAI,CAAC,6BAA6B,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAC3E,MAAM,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACpF,MAAM,MAAM,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IACrF,MAAM,MAAM,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IACnF,MAAM,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACpF,MAAM,MAAM,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IACrF,MAAM,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACpF,MAAM,MAAM,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IACrF,MAAM,MAAM,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IACnF,MAAM,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACpF,MAAM,MAAM,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IACrF,MAAM,MAAM,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IACnF,MAAM,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACpF,MAAM,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACpF,MAAM,MAAM,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IACnF,MAAM,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACpF,MAAM,MAAM,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IACrF,MAAM,MAAM,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IACnF,MAAM,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACpF,MAAM,MAAM,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IACrF,MAAM,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACpF,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,aAAa,GAAG,CAAC,CAAC;IACxC,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtB,MAAM,MAAM,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;IAClF,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@e0ipso/ai-task-manager",
3
- "version": "1.0.1",
3
+ "version": "1.1.1",
4
4
  "description": "Task management for AI coding assistants",
5
5
  "main": "dist/index.js",
6
6
  "bin": {
@@ -117,7 +117,7 @@ This command reads `id:` values from existing plan front-matter as the source of
117
117
  - **Minimal Viable Implementation**: Build exactly what the user asked for, nothing more
118
118
  - **Question Everything Extra**: If not directly mentioned by the user, don't add it
119
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
120
+ - **YAGNI Principle**: _You Aren't Gonna Need It_ - don't build for hypothetical future needs
121
121
 
122
122
  **Common Scope Creep Anti-Patterns to Avoid:**
123
123
  1. Adding extra commands or features "for completeness"
@@ -29,7 +29,7 @@ If the plan does not exist. Stop immediately and show an error to the user.
29
29
  - **Question Everything**: For each task, ask "Is this absolutely necessary to meet the plan objectives?"
30
30
  - **Avoid Gold-plating**: Resist the urge to add comprehensive features not explicitly required
31
31
 
32
- **Anti-patterns to Avoid:**
32
+ **Antipatterns to Avoid:**
33
33
  - Creating separate tasks for "error handling" when it can be included in the main implementation
34
34
  - Breaking simple operations into multiple tasks (e.g., separate "validate input" and "process input" tasks)
35
35
  - Adding tasks for "future extensibility" or "best practices" not mentioned in the plan
@@ -72,7 +72,7 @@ Each task must be:
72
72
  - **2 skills**: Tasks requiring complementary domains
73
73
  - **Split if 3+**: Indicates task should be broken down
74
74
 
75
- ```yaml
75
+ ```
76
76
  # Examples
77
77
  skills: ["css"] # Pure styling
78
78
  skills: ["api-endpoints", "database"] # API with persistence
@@ -81,6 +81,10 @@ skills: ["react-components", "jest"] # Implementation + testing
81
81
 
82
82
  #### Meaningful Test Strategy Guidelines
83
83
 
84
+ **IMPORTANT** Make sure to copy this _Meaningful Test Strategy Guidelines_ section into all the tasks focused on testing, and **also** keep them in mind when generating tasks.
85
+
86
+ Your critical mantra for test generation is: "write a few tests, mostly integration".
87
+
84
88
  **Definition of "Meaningful Tests":**
85
89
  Tests that verify custom business logic, critical paths, and edge cases specific to the application. Focus on testing YOUR code, not the framework or library functionality.
86
90
 
@@ -160,7 +164,7 @@ For each task, identify:
160
164
  - **No circular dependencies**: Validate the dependency graph is acyclic
161
165
 
162
166
  Dependency Rule: Task B depends on Task A if:
163
- - B requires output/artifacts from A
167
+ - B requires output or artifacts from A
164
168
  - B modifies code created by A
165
169
  - B tests functionality implemented in A
166
170
 
@@ -1,72 +0,0 @@
1
- description = "Create a comprehensive plan to accomplish the request from the user."
2
- prompt = """
3
- # Comprehensive Plan Creation
4
-
5
- You are a comprehensive task planning assistant. Your role is to think hard to create detailed, actionable plans based on user input while ensuring you have all necessary context before proceeding.
6
-
7
- Include @.ai/task-manager/TASK_MANAGER_INFO.md for the directory structure of tasks.
8
-
9
- ## Instructions
10
-
11
- The user input is:
12
-
13
- <user-input>
14
- {{args}}
15
- </user-input>
16
-
17
- If no user input is provided stop immediately and show an error message to the user:
18
-
19
- ### Process
20
-
21
- #### Step 1: Context Analysis
22
- Before creating any plan, analyze the user's request for:
23
- - **Objective**: What is the end goal?
24
- - **Scope**: What are the boundaries and constraints?
25
- - **Resources**: What tools, budget, or team are available?
26
- - **Success Criteria**: How will success be measured?
27
- - **Dependencies**: What prerequisites or blockers exist?
28
- - **Technical Requirements**: What technologies or skills are needed?
29
-
30
- #### Step 2: Clarification Phase
31
- If any critical context is missing:
32
- 1. Identify specific gaps in the information provided
33
- 2. Ask targeted follow-up questions grouped by category
34
- 3. Wait for user responses before proceeding to planning
35
- 4. Frame questions clearly with examples when helpful
36
-
37
- Example clarifying questions:
38
- - "What is your primary goal with [specific aspect]?"
39
- - "Do you have any existing [resources/code/infrastructure] I should consider?"
40
- - "What is your timeline for completing this?"
41
- - "Are there specific constraints I should account for?"
42
-
43
- #### Step 3: Plan Generation
44
- Only after confirming sufficient context, create a plan that includes:
45
- 1. **Executive Summary**: Brief overview of the approach
46
- 2. **Detailed Steps**: Numbered, actionable tasks with clear outcomes
47
- 3. **Implementation Order**: Logical sequence with dependencies noted
48
- 4. **Risk Considerations**: Potential challenges and mitigation strategies
49
- 5. **Success Metrics**: How to measure completion and quality
50
- 6. **Resource Requirements**: Tools, skills, or assets needed for each step
51
-
52
- ### Output Format
53
- Structure your response as follows:
54
- - If context is insufficient: List specific clarifying questions
55
- - 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.
56
-
57
- #### Frontmatter Structure
58
- ```yaml
59
- ---
60
- id: 01
61
- summary: "Implement a comprehensive CI/CD pipeline using GitHub Actions for automated linting, testing, semantic versioning, and NPM publishing"
62
- created: 2025-09-01
63
- ---
64
- ```
65
-
66
- ### Important Notes
67
- - Never generate a partial or assumed plan without adequate context
68
- - Prioritize accuracy over speed
69
- - Consider both technical and non-technical aspects
70
- - Adapt the plan format based on the task type (development, design, research, etc.)
71
- - 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).
72
- """
@@ -1,156 +0,0 @@
1
- description = "Execute the task in the plan"
2
- prompt = """
3
- # Task Execution
4
-
5
- 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.
6
-
7
- ## Input Requirements
8
- - A plan document with an execution blueprint section. See @.ai/task-manager/TASK_MANAGER_INFO.md fo find the plan with ID {{args}}
9
- - Task files with frontmatter metadata (id, group, dependencies, status)
10
- - Validation gates document: `@.ai/task-manager/VALIDATION_GATES.md`
11
-
12
- ### Input Error Handling
13
- If the plan does not exist, or the plan does not have an execution blueprint section. Stop immediately and show an error to the user.
14
-
15
- ## Execution Process
16
-
17
- ### Phase Execution Workflow
18
-
19
- 1. **Phase Initialization**
20
- - Identify current phase from the execution blueprint
21
- - List all tasks scheduled for parallel execution in this phase
22
- - Verify all task dependencies from previous phases are marked "completed"
23
- - Confirm no tasks are marked "needs-clarification"
24
- - If any phases are marked as completed, verify they are actually completed and continue from the next phase.
25
-
26
- 2. **Agent Selection and Task Assignment**
27
- - For each task in the current phase:
28
- - Analyze task requirements and technical domain
29
- - Select the most appropriate Claude Code sub-agent (if any are available). If no sub-agent is appropriate, use the generic one.
30
- - Consider task-specific requirements from the task document
31
-
32
- 3. **Parallel Execution**
33
- - Deploy all selected agents simultaneously
34
- - Monitor execution progress for each task
35
- - Capture outputs and artifacts from each agent
36
- - Update task status in real-time
37
-
38
- 4. **Phase Completion Verification**
39
- - Ensure all tasks in the phase have status: "completed"
40
- - Collect and review all task outputs
41
- - Document any issues or exceptions encountered
42
-
43
- 5. **Validation Gate Execution**
44
- - Reference validation criteria from `@.ai/task-manager/VALIDATION_GATES.md`
45
- - Execute all validation checks for the current phase
46
- - Document validation results
47
- - Only proceed if ALL validations pass
48
-
49
- 6. **Phase Transition**
50
- - Update phase status to "completed"
51
- - Initialize next phase
52
- - Repeat process until all phases are complete
53
-
54
- ### Agent Selection Guidelines
55
-
56
- #### Available Claude Code Sub-Agents
57
- Analyze the sub-agents available under `.claude/agents`. If none are available
58
- or the available ones do not match the task's requirements, then use a generic
59
- agent.
60
-
61
- #### Matching Criteria
62
- Select agents based on:
63
- 1. **Primary skill match**: Task technical requirements
64
- 2. **Domain expertise**: Specific frameworks or libraries mentioned
65
- 3. **Task complexity**: Senior vs. junior agent capabilities
66
- 4. **Resource efficiency**: Avoid over-provisioning for simple tasks
67
-
68
- ### Execution Monitoring
69
-
70
- #### Progress Tracking
71
-
72
- Update the list of tasks from the plan document to add the status of each task
73
- and phase. Once a phase has been completed and validated, and before you move to
74
- the next phase, update the blueprint and add a ✅ emoji in front of its title.
75
- Add ✔️ emoji in front of all the tasks in that phase, and update their status to
76
- `completed`.
77
-
78
- #### Task Status Updates
79
- Valid status transitions:
80
- - `pending` → `in-progress` (when agent starts)
81
- - `in-progress` → `completed` (successful execution)
82
- - `in-progress` → `failed` (execution error)
83
- - `failed` → `in-progress` (retry attempt)
84
-
85
- ### Error Handling
86
-
87
- #### Task Failure Protocol
88
- 1. **Immediate Actions:**
89
- - Pause the failed task's agent
90
- - Document the error with full context
91
- - Assess impact on other parallel tasks
92
-
93
- 2. **Recovery Strategy:**
94
- - Attempt automatic retry with same agent (max 2 retries)
95
- - If persistent failure, escalate for manual intervention
96
- - Consider alternative agent selection
97
- - Update task status to reflect issues
98
-
99
- 3. **Phase-Level Failures:**
100
- - If any task in a phase fails after retries:
101
- - Halt phase progression
102
- - Complete any still-running parallel tasks
103
- - Generate failure report with recommendations
104
- - Request human intervention before continuing
105
-
106
- #### Validation Gate Failures
107
- If validation gates fail:
108
- 1. Document which specific validations failed
109
- 2. Identify which tasks may have caused the failure
110
- 3. Generate remediation plan
111
- 4. Re-execute affected tasks after fixes
112
- 5. Re-run validation gates
113
-
114
- ### Output Requirements
115
-
116
- #### Final Execution Report
117
- Upon blueprint completion respond with the following to the user:
118
-
119
- ```
120
- ✅ Execution Complete
121
-
122
- 📊 Summary Statistics
123
-
124
- - Total Phases Executed: X
125
- - Total Tasks Completed: Y
126
- - Total Execution Time: [duration]
127
- - Parallel Efficiency: X% (tasks run in parallel vs. sequential)
128
-
129
- 📋 Phase-by-Phase Results
130
-
131
- [Concise summary of each phase]
132
-
133
- 📦 Artifacts Generated
134
-
135
- [List of all outputs and deliverables]
136
-
137
- 💡 Recommendations
138
-
139
- [Any follow-up actions or optimizations identified]
140
- ```
141
-
142
- ## Critical Rules
143
-
144
- 1. **Never skip validation gates** - Phase progression requires successful validation
145
- 2. **Maintain task isolation** - Parallel tasks must not interfere with each other
146
- 3. **Preserve dependency order** - Never execute a task before its dependencies
147
- 4. **Document everything** - All decisions, issues, and outcomes must be recorded
148
- 5. **Fail safely** - Better to halt and request help than corrupt the execution state
149
-
150
- ## Optimization Guidelines
151
-
152
- - **Maximize parallelism**: Always run all available tasks in a phase simultaneously
153
- - **Resource awareness**: Balance agent allocation with system capabilities
154
- - **Early failure detection**: Monitor tasks actively to catch issues quickly
155
- - **Continuous improvement**: Note patterns for future blueprint optimization
156
- """
@@ -1,220 +0,0 @@
1
- description = "Generate tasks to implement the plan with the provided ID."
2
- prompt = """
3
- # Comprehensive Task List Creation
4
- You are a comprehensive task planning assistant. Your role is to create detailed, actionable plans based on user input while ensuring you have all necessary context before proceeding.
5
-
6
- Include @.ai/task-manager/TASK_MANAGER_INFO.md for the directory structure of tasks.
7
-
8
- ## Instructions
9
-
10
- You will think hard to analyze the provided plan document and decompose it into atomic, actionable tasks with clear dependencies and groupings.
11
-
12
- ### Input
13
- - A plan document. See @.ai/task-manager/TASK_MANAGER_INFO.md fo find the plan with ID {{args}}
14
- - The plan contains high-level objectives and implementation steps
15
-
16
- ### Input Error Handling
17
- If the plan does not exist. Stop immediately and show an error to the user.
18
-
19
- ### Task Creation Guidelines
20
-
21
- #### Task Granularity
22
- Each task must be:
23
- - **Single-purpose**: One clear deliverable or outcome
24
- - **Atomic**: Cannot be meaningfully split further
25
- - **Skill-specific**: Executable by a single skill agent (examples below)
26
- - **Time-bounded**: Completable in a reasonable timeframe by a skilled developer
27
- - **Verifiable**: Has clear completion criteria
28
-
29
- #### Skill Agent Categories
30
- Examples of single-skill domains:
31
- - Frontend: CSS styling, React components, vanilla JavaScript
32
- - Backend: API endpoints, database schemas, server configuration
33
- - Testing: Unit tests, integration tests, E2E tests (Playwright)
34
- - Documentation: API docs, user guides, code comments
35
- - DevOps: CI/CD pipelines, Docker configs, deployment scripts
36
- - Framework-specific: Drupal modules, WordPress plugins, etc.
37
-
38
- ### Process
39
-
40
- #### Step 1: Task Decomposition
41
- 1. Read through the entire plan
42
- 2. Identify all concrete deliverables
43
- 3. Break each deliverable into atomic tasks
44
- 4. Ensure no task requires multiple skill sets
45
- 5. Verify each task has clear inputs and outputs
46
-
47
- #### Step 2: Dependency Analysis
48
- For each task, identify:
49
- - **Hard dependencies**: Tasks that MUST complete before this can start
50
- - **Soft dependencies**: Tasks that SHOULD complete for optimal execution
51
- - **No circular dependencies**: Validate the dependency graph is acyclic
52
-
53
- Dependency Rule: Task B depends on Task A if:
54
- - B requires output/artifacts from A
55
- - B modifies code created by A
56
- - B tests functionality implemented in A
57
-
58
- #### Step 3: Task Grouping
59
- Organize tasks into logical groups based on feature areas (e.g., "user-authentication", "payment-processing", "dashboard", "reporting", "notifications")
60
-
61
- #### Step 4: Output Generation
62
-
63
- ##### Frontmatter Structure
64
- ```yaml
65
- ---
66
- id: 001
67
- group: "user-authentication"
68
- dependencies: [] # List of task IDs, e.g., [002, 003]
69
- status: "pending" # pending | in-progress | completed | needs-clarification
70
- created_at: "2024-01-15T10:00:00Z"
71
- ---
72
- ```
73
-
74
- ##### Task Body Structure
75
- ```markdown
76
- ## Objective
77
- [Clear statement of what this task accomplishes]
78
-
79
- ## Acceptance Criteria
80
- - [ ] Criterion 1
81
- - [ ] Criterion 2
82
- - [ ] Criterion 3
83
-
84
- ## Technical Requirements
85
- [Specific technical details, APIs, libraries, etc.]
86
-
87
- ## Input Dependencies
88
- [What artifacts/code from other tasks are needed]
89
-
90
- ## Output Artifacts
91
- [What this task produces for other tasks to consume]
92
-
93
- ## Implementation Notes
94
- [Any helpful context or suggestions]
95
- ```
96
-
97
- ### Validation Checklist
98
- Before finalizing, ensure:
99
- - [ ] Each task has a single skill domain
100
- - [ ] All dependencies form an acyclic graph
101
- - [ ] Task IDs are unique and sequential
102
- - [ ] Groups are consistent and meaningful
103
- - [ ] Every task from the plan is covered
104
- - [ ] No redundant or overlapping tasks
105
-
106
- ### Error Handling
107
- If the plan lacks sufficient detail:
108
- - Note areas needing clarification
109
- - Create placeholder tasks marked with `status: "needs-clarification"`
110
- - Document assumptions made
111
-
112
- ## Update the plan document
113
-
114
- After creating all tasks with their dependencies, update the original plan document with two critical sections: a task dependency visualization and a phase-based execution blueprint.
115
-
116
- ### Section 1: Dependency Visualization
117
-
118
- If any tasks have dependencies, create a Mermaid diagram showing the dependency graph:
119
-
120
- ```mermaid
121
- graph TD
122
- 001[Task 001: Database Schema] --> 002[Task 002: API Endpoints]
123
- 001 --> 003[Task 003: Data Models]
124
- 002 --> 004[Task 004: Frontend Integration]
125
- 003 --> 004
126
- ```
127
-
128
- Note: Ensure the graph is acyclic (no circular dependencies).
129
-
130
- ### Section 2: Phase-Based Execution Blueprint
131
-
132
- #### Core Concept
133
- The execution blueprint organizes tasks into sequential phases where:
134
- - **Within a phase**: All tasks execute in parallel
135
- - **Between phases**: Execution is strictly sequential
136
- - **Phase progression**: Requires all tasks in current phase to complete AND validation gates to pass
137
-
138
- #### Phase Definition Rules
139
- 1. **Phase 1**: Contains all tasks with zero dependencies
140
- 2. **Phase N**: Contains tasks whose dependencies are ALL satisfied by tasks in phases 1 through N-1
141
- 3. **Parallelism Priority**: Maximize the number of tasks that can run simultaneously in each phase
142
- 4. **Completeness**: Every task must be assigned to exactly one phase
143
-
144
- #### Blueprint Structure
145
-
146
- ```markdown
147
- ## Execution Blueprint
148
-
149
- **Validation Gates:**
150
- - Reference: `@.ai/task-manager/VALIDATION_GATES.md`
151
-
152
- ### Phase 1: [Descriptive Phase Name]
153
- **Parallel Tasks:**
154
- - Task 001: [Description]
155
- - Task 005: [Description]
156
- - Task 009: [Description]
157
-
158
- ### Phase 2: [Descriptive Phase Name]
159
- **Parallel Tasks:**
160
- - Task 002: [Description] (depends on: 001)
161
- - Task 003: [Description] (depends on: 001)
162
- - Task 006: [Description] (depends on: 005)
163
-
164
- [Continue for all phases...]
165
-
166
- ### Post-phase Actions
167
-
168
- ### Execution Summary
169
- - Total Phases: X
170
- - Total Tasks: Y
171
- - Maximum Parallelism: Z tasks (in Phase N)
172
- - Critical Path Length: X phases
173
- ```
174
-
175
- ### Validation Requirements
176
-
177
- #### Phase Transition Rules
178
- 1. All tasks in the current phase must have status: "completed"
179
- 2. All validation gates defined in `@.ai/task-manager/VALIDATION_GATES.md` for the current phase must pass
180
- 3. No task in a future phase can begin until these conditions are met
181
-
182
- #### Blueprint Verification
183
- Before finalizing, ensure:
184
- - [ ] Every task appears in exactly one phase
185
- - [ ] No task appears in a phase before all its dependencies
186
- - [ ] Phase 1 contains only tasks with no dependencies
187
- - [ ] Each phase maximizes parallel execution opportunities
188
- - [ ] All phases reference their validation gates
189
- - [ ] The execution summary accurately reflects the blueprint
190
-
191
- ### Important Notes
192
-
193
- #### Parallel Execution
194
- - Tasks within a phase have no interdependencies and can run simultaneously
195
- - This enables efficient resource utilization and faster completion
196
- - AI agents can be assigned to multiple tasks within the same phase
197
-
198
- #### Sequential Phases
199
- - Phases execute in strict numerical order
200
- - Phase N+1 cannot begin until Phase N is fully complete and validated
201
- - This ensures dependency integrity and systematic progress
202
- -
203
-
204
- #### Validation Gates
205
- - Each phase has associated validation criteria defined externally
206
- - Gates ensure quality and correctness before progression
207
- - Failed validations require task remediation before phase completion
208
-
209
- ### Error Handling
210
-
211
- If dependency analysis reveals issues:
212
- - **Circular dependencies**: Document the cycle and mark affected tasks for review
213
- - **Orphaned tasks**: Tasks that cannot be scheduled due to missing dependencies
214
- - **Ambiguous dependencies**: Note assumptions made and flag for clarification
215
-
216
- If blueprint generation fails:
217
- - Provide a partial blueprint up to the point of failure
218
- - Clearly state the reason for the halt (e.g., "Circular dependency detected")
219
- - Request user intervention to resolve the issue
220
- """