multi-agents-cli 1.1.91 → 1.1.92

package/core/templates/CLAUDE.md

@@ -574,4 +574,27 @@ Log completion in TASK.md checklist.
 Confirm: "Remote configured — proceeding with task."
 
 **Never begin task implementation until this flag is cleared.
-Never delete the flag on failure.**
+Never delete the flag on failure.**
+## Completed Task Protocol
+
+If `TASK.md` status is `COMPLETED` at session start, a previous task finished in this worktree.
+
+**Do not re-run completed work. Treat any new user input as a follow-on task.**
+
+### On session start with COMPLETED TASK.md
+
+1. Read `TASK.md` silently - note what was completed
+2. Read `.claude-scope` for output mode (already set - no action needed)
+3. Emit session confirmation per Output Mode Contract
+4. Output (insights/full modes): `✔ Previous task complete. Ready for follow-on work.`
+5. Wait for user input
+
+### On receiving follow-on task
+
+1. Treat it as a new task within the same scope and worktree
+2. Execute it fully per your agent mission and scope rules
+3. Append a new entry to TASK.md under a `## Follow-on Task` heading with status IN PROGRESS
+4. When complete, update status to COMPLETED and run `npm run complete`
+
+**Never begin implementation before confirming scope.
+Never touch files outside your assigned scope.**

package/core/workflow/agent.js

@@ -1064,6 +1064,51 @@ const main = async () => {
     if (activeChoice === 4) { continue agentLoop; }
   }
 
+  // COMPLETED gate
+  const completedSlot = tracking?.[project]?.[agent];
+  if (completedSlot?.status === 'COMPLETED') {
+    const sanitizedForWorktree = config.projectName.toLowerCase().replace(/\s+/g, '-');
+    const completedTimestamp   = completedSlot.branch ? completedSlot.branch.split('/')[3] : null;
+    const completedWorktreeName = completedTimestamp
+      ? `${project}-${sanitizedForWorktree}-${agent.toLowerCase()}-${completedTimestamp}`
+      : null;
+    const completedWorktreePath = completedWorktreeName
+      ? path.join(ROOT, 'worktrees', completedWorktreeName)
+      : null;
+    const worktreeExists = completedWorktreePath && fs.existsSync(completedWorktreePath);
+
+    separator();
+    console.log(`\n  ${bold(green('\u2713'))} ${bold(agent)} previously completed${completedSlot.completedAt ? ' on ' + new Date(completedSlot.completedAt).toLocaleDateString() : ''}.`);
+    if (worktreeExists) {
+      console.log(`  ${dim('Worktree')} : ${dim(completedWorktreePath)}\n`);
+    }
+
+    const completedOptions = worktreeExists
+      ? ['Continue in existing worktree', 'Start a new task', 'Pick a different agent']
+      : ['Start a new task', 'Pick a different agent'];
+
+    const completedChoice = await arrowSelect('What would you like to do?', completedOptions, rl);
+
+    if (worktreeExists) {
+      if (completedChoice === 0) {
+        openIDE(completedWorktreePath);
+        rl.close();
+        return;
+      }
+      if (completedChoice === 1) {
+        guards.clearTrackingSlot(tracking, project, agent, ROOT);
+        // fall through to fresh launch
+      }
+      if (completedChoice === 2) { continue agentLoop; }
+    } else {
+      if (completedChoice === 0) {
+        guards.clearTrackingSlot(tracking, project, agent, ROOT);
+        // fall through to fresh launch
+      }
+      if (completedChoice === 1) { continue agentLoop; }
+    }
+  }
+
   // MISSING gate
   const trackingSlot = tracking?.[project]?.[agent];
   if (trackingSlot?.status === 'MISSING') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multi-agents-cli",
-  "version": "1.1.91",
+  "version": "1.1.92",
   "description": "Multi-agent workflow orchestration for Claude Code — isolated git worktrees, structured state tracking, autonomous task chaining",
   "keywords": [
     "claude-code",