@e0ipso/ai-task-manager 1.26.3 → 1.26.5

package/templates/ai-task-manager/config/scripts/validate-plan-blueprint.cjs

@@ -2,245 +2,137 @@
 
 const fs = require('fs');
 const path = require('path');
-const { findTaskManagerRoot } = require('./shared-utils.cjs');
+const sharedUtils = require('./shared-utils.cjs');
+const {
+  findTaskManagerRoot,
+  findPlanById,
+  countTasks,
+  checkBlueprintExists,
+  getAllPlans,
+  validatePlanFile,
+  checkStandardRootShortcut,
+  resolvePlan
+} = sharedUtils;
 
 /**
  * Error logging utility
+ * @private
  * @param {string} message - Error message
  * @param {...any} args - Additional arguments to log
  */
-function errorLog(message, ...args) {
+function _errorLog(message, ...args) {
   console.error(`[ERROR] ${message}`, ...args);
 }
 
-/**
- * Find plan file and directory for a given plan ID
- * @param {string|number} planId - Plan ID to search for
- * @returns {Object|null} Object with planFile and planDir, or null if not found
- */
-function findPlanById(planId) {
-  const taskManagerRoot = findTaskManagerRoot();
-
-  if (!taskManagerRoot) {
-    errorLog('No .ai/task-manager directory found in current directory or any parent directory.');
-    return null;
-  }
-
-  // Convert planId to numeric for flexible matching (handles both "2" and "02")
-  const numericPlanId = parseInt(planId, 10);
-
-  if (isNaN(numericPlanId)) {
-    errorLog(`Invalid plan ID: ${planId}. Plan ID must be numeric.`);
-    return null;
-  }
-
-  const plansDir = path.join(taskManagerRoot, 'plans');
-  const archiveDir = path.join(taskManagerRoot, 'archive');
-
-  // Search both plans and archive directories
-  for (const dir of [plansDir, archiveDir]) {
-    if (!fs.existsSync(dir)) {
-      continue;
-    }
-
-    try {
-      const entries = fs.readdirSync(dir, { withFileTypes: true });
-
-      for (const entry of entries) {
-        // Match directory pattern: [plan-id]--* (with flexible ID matching)
-        if (entry.isDirectory()) {
-          // Extract numeric ID from directory name, stripping leading zeros
-          const dirMatch = entry.name.match(/^0*(\d+)--/);
-          if (dirMatch && parseInt(dirMatch[1], 10) === numericPlanId) {
-            const planDirPath = path.join(dir, entry.name);
-
-          try {
-            const planDirEntries = fs.readdirSync(planDirPath, { withFileTypes: true });
-
-            // Look for plan file: plan-[plan-id]--*.md (with flexible ID matching)
-            for (const planEntry of planDirEntries) {
-              if (planEntry.isFile()) {
-                // Extract numeric ID from filename, stripping leading zeros
-                const fileMatch = planEntry.name.match(/^plan-0*(\d+)--.*\.md$/);
-                if (fileMatch && parseInt(fileMatch[1], 10) === numericPlanId) {
-                  const planFilePath = path.join(planDirPath, planEntry.name);
-
-                  return {
-                    planFile: planFilePath,
-                    planDir: planDirPath
-                  };
-                }
-              }
-            }
-          } catch (err) {
-            errorLog(`Failed to read plan directory ${planDirPath}: ${err.message}`);
-          }
-          }
-        }
-      }
-    } catch (err) {
-      errorLog(`Failed to read directory ${dir}: ${err.message}`);
-    }
-  }
-
-  return null;
-}
-
-/**
- * Count task files in a plan's tasks directory
- * @param {string} planDir - Plan directory path
- * @returns {number} Number of task files found
- */
-function countTasks(planDir) {
-  const tasksDir = path.join(planDir, 'tasks');
-
-  if (!fs.existsSync(tasksDir)) {
-    return 0;
-  }
-
-  try {
-    const stats = fs.lstatSync(tasksDir);
-    if (!stats.isDirectory()) {
-      return 0;
-    }
-
-    const files = fs.readdirSync(tasksDir).filter(f => f.endsWith('.md'));
-    return files.length;
-  } catch (err) {
-    errorLog(`Failed to read tasks directory ${tasksDir}: ${err.message}`);
-    return 0;
-  }
-}
-
-/**
- * Check if execution blueprint section exists in plan file
- * @param {string} planFile - Path to plan file
- * @returns {boolean} True if blueprint section exists, false otherwise
- */
-function checkBlueprintExists(planFile) {
-  try {
-    const planContent = fs.readFileSync(planFile, 'utf8');
-    const blueprintExists = /^## Execution Blueprint/m.test(planContent);
-    return blueprintExists;
-  } catch (err) {
-    errorLog(`Failed to read plan file ${planFile}: ${err.message}`);
-    return false;
-  }
-}
-
 /**
  * List available plans for error messaging
+ * @private
+ * @param {string} [taskManagerRoot] - Optional task manager root path
  * @returns {string[]} Array of plan directory names
  */
-function listAvailablePlans() {
-  const taskManagerRoot = findTaskManagerRoot();
-
-  if (!taskManagerRoot) {
-    return [];
-  }
-
-  const plansDir = path.join(taskManagerRoot, 'plans');
-  const archiveDir = path.join(taskManagerRoot, 'archive');
-  const plans = [];
-
-  for (const dir of [plansDir, archiveDir]) {
-    if (!fs.existsSync(dir)) {
-      continue;
-    }
-
-    try {
-      const entries = fs.readdirSync(dir, { withFileTypes: true });
-      for (const entry of entries) {
-        if (entry.isDirectory() && entry.name.match(/^\d+--/)) {
-          plans.push(entry.name);
-        }
-      }
-    } catch (err) {
-      // Silently continue
-    }
-  }
-
-  return plans.sort((a, b) => {
-    const aId = parseInt(a.match(/^(\d+)--/)[1], 10);
-    const bId = parseInt(b.match(/^(\d+)--/)[1], 10);
-    return aId - bId;
-  });
+function _listAvailablePlans(taskManagerRoot) {
+  const plans = getAllPlans(taskManagerRoot);
+  return plans
+    .map(p => p.name)
+    .sort((a, b) => {
+      const aIdMatch = a.match(/^(\d+)--/);
+      const bIdMatch = b.match(/^(\d+)--/);
+      if (!aIdMatch || !bIdMatch) return 0;
+      return parseInt(aIdMatch[1], 10) - parseInt(bIdMatch[1], 10);
+    });
 }
 
 /**
  * Validate plan blueprint and output JSON or specific field
- * @param {string|number} planId - Plan ID to validate
- * @param {string} [fieldName] - Optional field name to extract (planFile, planDir, taskCount, blueprintExists)
+ * @private
+ * @param {string|number} inputId - Plan ID or absolute path to validate
+ * @param {string} [fieldName] - Optional field name to extract (planFile, planDir, taskCount, blueprintExists, taskManagerRoot, planId)
+ * @param {string} [startPath] - Optional start path for finding task manager root
  */
-function validatePlanBlueprint(planId, fieldName) {
-  if (!planId) {
-    errorLog('Plan ID is required');
-    errorLog('');
-    errorLog('Usage: node validate-plan-blueprint.cjs <plan-id> [field-name]');
-    errorLog('');
-    errorLog('Examples:');
-    errorLog('  node validate-plan-blueprint.cjs 47                  # Output full JSON');
-    errorLog('  node validate-plan-blueprint.cjs 47 planFile         # Output just the plan file path');
-    errorLog('  node validate-plan-blueprint.cjs 47 planDir          # Output just the plan directory');
-    errorLog('  node validate-plan-blueprint.cjs 47 taskCount        # Output just the task count');
-    errorLog('  node validate-plan-blueprint.cjs 47 blueprintExists  # Output yes/no');
+function _validatePlanBlueprint(inputId, fieldName, startPath = process.cwd()) {
+  if (!inputId) {
+    _errorLog('Plan ID or absolute path is required');
+    _errorLog('');
+    _errorLog('Usage: node validate-plan-blueprint.cjs <plan-id-or-path> [field-name]');
+    _errorLog('');
+    _errorLog('Examples:');
+    _errorLog('  node validate-plan-blueprint.cjs 47                  # Output full JSON');
+    _errorLog('  node validate-plan-blueprint.cjs /path/to/plan.md    # Output full JSON for specific file');
+    _errorLog('  node validate-plan-blueprint.cjs 47 planFile         # Output just the plan file path');
+    _errorLog('  node validate-plan-blueprint.cjs 47 blueprintExists  # Output yes/no');
+    process.exit(1);
+  }
+
+  // Check if input is numeric (allowing padded zeros) - if not a number or path, it's invalid
+  const numericInput = parseInt(inputId, 10);
+  const isNumeric = !isNaN(numericInput);
+  const isAbsolutePath = inputId.startsWith('/');
+
+  if (!isNumeric && !isAbsolutePath) {
+    _errorLog(`Invalid plan ID: "${inputId}" is not a valid number`);
     process.exit(1);
   }
 
-  const planInfo = findPlanById(planId);
+  const resolved = resolvePlan(inputId, startPath);
 
-  if (!planInfo) {
-    errorLog(`Plan ID ${planId} not found`);
-    errorLog('');
+  if (!resolved) {
+    _errorLog(`Plan ID ${inputId} not found or invalid`);
+    _errorLog('');
 
-    const availablePlans = listAvailablePlans();
+    const tmRoot = findTaskManagerRoot(startPath);
+    const availablePlans = _listAvailablePlans(tmRoot);
     if (availablePlans.length > 0) {
-      errorLog('Available plans:');
+      _errorLog('Available plans:');
       availablePlans.forEach(plan => {
-        errorLog(`  ${plan}`);
+        _errorLog(`  ${plan}`);
       });
-    } else {
-      errorLog('No plans found in .ai/task-manager/{plans,archive}/');
     }
 
-    errorLog('');
-    errorLog('Please verify:');
-    errorLog('  1. You are in the correct project directory');
-    errorLog('  2. The plan exists in .ai/task-manager/plans/ or .ai/task-manager/archive/');
-    errorLog('  3. The plan directory follows the naming pattern: [plan-id]--[name]');
-    errorLog('  4. The plan file follows the naming pattern: plan-[plan-id]--[name].md');
     process.exit(1);
   }
 
-  const { planFile, planDir } = planInfo;
+  const {
+    planFile,
+    planDir,
+    taskManagerRoot,
+    planId
+  } = resolved;
+
   const taskCount = countTasks(planDir);
   const blueprintExists = checkBlueprintExists(planFile);
 
   const result = {
     planFile,
     planDir,
+    taskManagerRoot,
+    planId,
     taskCount,
     blueprintExists: blueprintExists ? 'yes' : 'no'
   };
 
   // If field name is provided, output just that field
   if (fieldName) {
-    const validFields = ['planFile', 'planDir', 'taskCount', 'blueprintExists'];
+    const validFields = ['planFile', 'planDir', 'taskCount', 'blueprintExists', 'taskManagerRoot', 'planId'];
     if (!validFields.includes(fieldName)) {
-      errorLog(`Invalid field name: ${fieldName}`);
-      errorLog(`Valid fields: ${validFields.join(', ')}`);
+      _errorLog(`Invalid field name: ${fieldName}`);
+      _errorLog(`Valid fields: ${validFields.join(', ')}`);
       process.exit(1);
     }
     // Use process.stdout.write to avoid util.inspect colorization
-    // Convert to string explicitly to ensure plain text output
     process.stdout.write(String(result[fieldName]) + '\n');
   } else {
-    // Output full JSON for backward compatibility
+    // Output full JSON
     console.log(JSON.stringify(result, null, 2));
   }
 }
 
 // Main execution
-const planId = process.argv[2];
-const fieldName = process.argv[3];
-validatePlanBlueprint(planId, fieldName);
+if (require.main === module) {
+  const planId = process.argv[2];
+  const fieldName = process.argv[3];
+  _validatePlanBlueprint(planId, fieldName);
+}
+
+module.exports = {
+  _validatePlanBlueprint
+};

package/templates/assistant/commands/tasks/create-plan.md

@@ -4,29 +4,59 @@ description: Create a comprehensive plan to accomplish the request from the user
 ---
 # Comprehensive Plan Creation
 
-You are a strategic planning specialist who creates actionable plan documents that balance comprehensive context with 
-disciplined scope control. Your role is to think hard to create detailed, actionable plans based on user input while 
+You are a strategic planning specialist who creates actionable plan documents that balance comprehensive context with
+disciplined scope control. Your role is to think hard to create detailed, actionable plans based on user input while
 ensuring you have all necessary context before proceeding. Use the plan-creator sub-agent for this if it is available.
 
-## Assistant Configuration
-
-Before proceeding with this command, you MUST load and respect the assistant's configuration:
-
-Load the following configuration files in order of precedence (later files override earlier ones):
-1. `/workspace/AGENTS.md` - Project-level task management guidance
-2. `/workspace/CLAUDE.md` - Claude-specific assistant configuration (if it exists)
-3. `/home/node/.claude/CLAUDE.md` - Global Claude configuration from your home directory (if it exists)
-
-These files contain your global and project-level configuration rules. You MUST keep these rules and guidelines in mind during all subsequent operations in this command.
-
 ---
 
-Think harder and use tools.
+Ultrathink, think harder, and use tools.
+
+## Find the AI Task Manager root
 
-Include .ai/task-manager/config/TASK_MANAGER.md for the directory structure of tasks.
+```bash
+if [ ! -f /tmp/find-ai-task-manager-root.js ]; then
+  cat << 'EOF' > /tmp/find-ai-task-manager-root.js
+const fs = require('fs');
+const path = require('path');
+
+const findRoot = (currentDir) => {
+  const taskManagerPath = path.join(currentDir, '.ai/task-manager');
+  const metadataPath = path.join(taskManagerPath, '.init-metadata.json');
+
+  try {
+    if (fs.existsSync(metadataPath) && JSON.parse(fs.readFileSync(metadataPath, 'utf8')).version) {
+      console.log(path.resolve(taskManagerPath));
+      process.exit(0);
+    }
+  } catch (e) {
+    // Continue searching
+  }
+
+  const parentDir = path.dirname(currentDir);
+  if (parentDir !== currentDir) {
+    findRoot(parentDir);
+  } else {
+    process.exit(1);
+  }
+};
+
+findRoot(process.cwd());
+EOF
+fi
+
+root=$(node /tmp/find-ai-task-manager-root.js)
+
+if [ -z "$root" ]; then
+    echo "Error: Could not find task manager root directory (.ai/task-manager)"
+    exit 1
+fi
+```
 
 ## Instructions
 
+Include $root/ $root/.ai/task-manager/config/TASK_MANAGER.md for the directory structure of tasks.
+
 The user input is:
 
 <user-input>
@@ -39,11 +69,11 @@ If no user input is provided stop immediately and show an error message to the u
 
 Use your internal Todo task tool to track the following plan generation:
 
-- [ ] Read and execute .ai/task-manager/config/hooks/PRE_PLAN.md
+- [ ] Read and execute $root/ $root/.ai/task-manager/config/hooks/PRE_PLAN.md
 - [ ] User input and context analysis
 - [ ] Clarification questions
 - [ ] Plan generation
-- [ ] Read and execute .ai/task-manager/config/hooks/POST_PLAN.md
+- [ ] Read and execute $root/ $root/.ai/task-manager/config/hooks/POST_PLAN.md
 
 #### Step 1: Context Analysis
 Before creating any plan, analyze the user's request for:
@@ -66,7 +96,7 @@ Try to answer your own questions first by inspecting the codebase, docs, and ass
 IMPORTANT: Once you have the user's answers go back to Step 2. Do this in a loop until you have no more questions. Ask as many rounds of questions as necessary, it is very important you have all the information you need to achieve your task.
 
 #### Step 3: Plan Generation
-Only after confirming sufficient context, create a plan according the the .ai/task-manager/config/templates/PLAN_TEMPLATE.md
+Only after confirming sufficient context, create a plan according the the $root/ $root/.ai/task-manager/config/templates/PLAN_TEMPLATE.md
 
 ##### CRITICAL: Output Format
 
@@ -88,7 +118,7 @@ This structured output enables automated workflow coordination and must be inclu
 
 ###### Plan Template
 
-Use the template in .ai/task-manager/config/templates/PLAN_TEMPLATE.md
+Use the template in $root/ $root/.ai/task-manager/config/templates/PLAN_TEMPLATE.md
 
 ###### Patterns to Avoid
 Do not include the following in your plan output.
@@ -132,10 +162,11 @@ The schema for this frontmatter is:
 ```
 
 ### Plan ID Generation
+
 Execute this script to determine the plan ID:
 
 ```bash
-node .ai/task-manager/config/scripts/get-next-plan-id.cjs
+next_id=$(node $root/config/scripts/get-next-plan-id.cjs)
 ```
 
 **Key formatting:**

package/templates/assistant/commands/tasks/execute-blueprint.md

@@ -4,17 +4,6 @@ description: Execute the task in the plan.
 ---
 # Task Execution
 
-## Assistant Configuration
-
-Before proceeding with this command, you MUST load and respect the assistant's configuration:
-
-Load the following configuration files in order of precedence (later files override earlier ones):
-1. `/workspace/AGENTS.md` - Project-level task management guidance
-2. `/workspace/CLAUDE.md` - Claude-specific assistant configuration (if it exists)
-3. `/home/node/.claude/CLAUDE.md` - Global Claude configuration from your home directory (if it exists)
-
-These files contain your global and project-level configuration rules. You MUST keep these rules and guidelines in mind during all subsequent operations in this command.
-
 ---
 
 You are the coordinator 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.
@@ -44,12 +33,55 @@ Before proceeding with execution, validate that tasks exist and the execution bl
 
 **Validation Steps:**
 
+First, discover the task manager root directory:
+
+```bash
+if [ ! -f /tmp/find-ai-task-manager-root.cjs ]; then
+  cat << 'EOF' > /tmp/find-ai-task-manager-root.cjs
+const fs = require('fs');
+const path = require('path');
+
+const findRoot = (currentDir) => {
+  const taskManagerPath = path.join(currentDir, '.ai/task-manager');
+  const metadataPath = path.join(taskManagerPath, '.init-metadata.json');
+
+  try {
+    if (fs.existsSync(metadataPath) && JSON.parse(fs.readFileSync(metadataPath, 'utf8')).version) {
+      console.log(path.resolve(taskManagerPath));
+      process.exit(0);
+    }
+  } catch (e) {
+    // Continue searching
+  }
+
+  const parentDir = path.dirname(currentDir);
+  if (parentDir !== currentDir) {
+    findRoot(parentDir);
+  } else {
+    process.exit(1);
+  }
+};
+
+findRoot(process.cwd());
+EOF
+fi
+
+root=$(node /tmp/find-ai-task-manager-root.js)
+
+if [ -z "$root" ]; then
+    echo "Error: Could not find task manager root directory (.ai/task-manager)"
+    exit 1
+fi
+```
+
+Then extract validation results:
+
 ```bash
 # Extract validation results directly from script
-plan_file=$(node .ai/task-manager/config/scripts/validate-plan-blueprint.cjs $1 planFile)
-plan_dir=$(node .ai/task-manager/config/scripts/validate-plan-blueprint.cjs $1 planDir)
-task_count=$(node .ai/task-manager/config/scripts/validate-plan-blueprint.cjs $1 taskCount)
-blueprint_exists=$(node .ai/task-manager/config/scripts/validate-plan-blueprint.cjs $1 blueprintExists)
+plan_file=$(node $root/config/scripts/validate-plan-blueprint.cjs $1 planFile)
+plan_dir=$(node $root/config/scripts/validate-plan-blueprint.cjs $1 planDir)
+task_count=$(node $root/config/scripts/validate-plan-blueprint.cjs $1 taskCount)
+blueprint_exists=$(node $root/config/scripts/validate-plan-blueprint.cjs $1 blueprintExists)
 ```
 
 4. **Automatic task generation**:
@@ -82,21 +114,21 @@ Use your internal Todo task tool to track the execution of all phases, and the f
 
 - [ ] Create feature branch from the main branch.
 - [ ] Validate or auto-generate tasks and execution blueprint if missing.
-- [ ] Execute .ai/task-manager/config/hooks/PRE_PHASE.md hook before Phase 1.
+- [ ] Execute $root/.ai/task-manager/config/hooks/PRE_PHASE.md hook before Phase 1.
 - [ ] Phase 1: Execute 1 task(s) in parallel.
-- [ ] Execute .ai/task-manager/config/hooks/POST_PHASE.md hook after Phase 1.
-- [ ] Execute .ai/task-manager/config/hooks/PRE_PHASE.md hook before Phase 2.
+- [ ] Execute $root/.ai/task-manager/config/hooks/POST_PHASE.md hook after Phase 1.
+- [ ] Execute $root/.ai/task-manager/config/hooks/PRE_PHASE.md hook before Phase 2.
 - [ ] Phase 2: Execute 3 task(s) in parallel.
-- [ ] Execute .ai/task-manager/config/hooks/POST_PHASE.md hook after Phase 2.
-- [ ] Execute .ai/task-manager/config/hooks/PRE_PHASE.md hook before Phase 3.
+- [ ] Execute $root/.ai/task-manager/config/hooks/POST_PHASE.md hook after Phase 2.
+- [ ] Execute $root/.ai/task-manager/config/hooks/PRE_PHASE.md hook before Phase 3.
 - [ ] Phase 3: Execute 1 task(s) in parallel.
-- [ ] Execute .ai/task-manager/config/hooks/POST_PHASE.md hook after Phase 3.
-- [ ] Update the Plan 7 with execution summary using .ai/task-manager/config/hooks/EXECUTION_SUMMARY_TEMPLATE.md.
+- [ ] Execute $root/.ai/task-manager/config/hooks/POST_PHASE.md hook after Phase 3.
+- [ ] Update the Plan 7 with execution summary using $root/.ai/task-manager/config/hooks/EXECUTION_SUMMARY_TEMPLATE.md.
 - [ ] Archive Plan 7.
 
 ### Phase Pre-Execution
 
-Read and execute .ai/task-manager/config/hooks/PRE_PHASE.md
+Read and execute $root/.ai/task-manager/config/hooks/PRE_PHASE.md
 
 ### Phase Execution Workflow
 
@@ -105,7 +137,7 @@ Read and execute .ai/task-manager/config/hooks/PRE_PHASE.md
     - List all tasks scheduled for parallel execution in this phase
 
 2. **Agent Selection and Task Assignment**
-Read and execute .ai/task-manager/config/hooks/PRE_TASK_ASSIGNMENT.md
+Read and execute $root/.ai/task-manager/config/hooks/PRE_TASK_ASSIGNMENT.md
 
 3. **Parallel Execution**
     - Deploy all selected agents simultaneously using your internal Task tool
@@ -120,7 +152,7 @@ Read and execute .ai/task-manager/config/hooks/PRE_TASK_ASSIGNMENT.md
 
 ### Phase Post-Execution
 
-Read and execute .ai/task-manager/config/hooks/POST_PHASE.md
+Read and execute $root/.ai/task-manager/config/hooks/POST_PHASE.md
 
 
 ### Phase Transition
@@ -132,14 +164,14 @@ Read and execute .ai/task-manager/config/hooks/POST_PHASE.md
 ### Error Handling
 
 #### Validation Gate Failures
-Read and execute .ai/task-manager/config/hooks/POST_ERROR_DETECTION.md
+Read and execute $root/.ai/task-manager/config/hooks/POST_ERROR_DETECTION.md
 
 ### Output Requirements
 
 **Output Behavior:**
 
 Provide a concise execution summary:
-- Example: "Execution completed. Review summary: `.ai/task-manager/archive/[plan]/plan-[id].md`"
+- Example: "Execution completed. Review summary: `$root/.ai/task-manager/archive/[plan]/plan-[id].md`"
 
 **CRITICAL - Structured Output for Command Coordination:**
 
@@ -150,7 +182,7 @@ Always end your output with a standardized summary in this exact format:
 Execution Summary:
 - Plan ID: [numeric-id]
 - Status: Archived
-- Location: .ai/task-manager/archive/[plan-id]--[plan-name]/
+- Location: $root/.ai/task-manager/archive/[plan-id]--[plan-name]/
 ```
 
 This structured output enables automated workflow coordination and must be included even when running standalone.
@@ -171,7 +203,7 @@ Upon successful completion of all phases and validation gates, perform the follo
 
 ### 1. Execution Summary Generation
 
-Append an execution summary section to the plan document with the format described in .ai/task-manager/config/templates/[EXECUTION_SUMMARY_TEMPLATE.md
+Append an execution summary section to the plan document with the format described in $root/.ai/task-manager/config/templates/[EXECUTION_SUMMARY_TEMPLATE.md
 
 ### 2. Plan Archival
 
@@ -179,7 +211,7 @@ After successfully appending the execution summary:
 
 **Move completed plan to archive**:
 ```bash
-mv .ai/task-manager/plans/[plan-folder] .ai/task-manager/archive/
+mv $root/.ai/task-manager/plans/[plan-folder] $root/.ai/task-manager/archive/
 ```
 
 ### Important Notes