@kendoo.agentdesk/agentdesk 0.10.5 → 0.11.0

package/bin/agentdesk.mjs

@@ -71,6 +71,7 @@ if (!command || command === "help" || command === "--help") {
   Options:
     --description, -d    Task description or requirements
     --cwd                Working directory (defaults to current)
+    --child-strategy     How to handle child tasks: "inline" (default) or "branch"
 
 
   How it works:
@@ -101,6 +102,7 @@ if (AGENT_NAMES.includes(command?.toLowerCase())) {
   let description = "";
   let cwd = process.cwd();
   let taskId = null;
+  let childStrategy = null;
   const remaining = args.slice(1);
 
   for (let i = 0; i < remaining.length; i++) {
@@ -108,6 +110,8 @@ if (AGENT_NAMES.includes(command?.toLowerCase())) {
       description = remaining[++i];
     } else if (remaining[i] === "--cwd" && remaining[i + 1]) {
       cwd = remaining[++i];
+    } else if (remaining[i] === "--child-strategy" && remaining[i + 1]) {
+      childStrategy = remaining[++i];
     } else if (!taskId && !remaining[i].startsWith("-")) {
       taskId = remaining[i];
     }
@@ -120,7 +124,7 @@ if (AGENT_NAMES.includes(command?.toLowerCase())) {
   }
 
   const { runTeam } = await import("../cli/team.mjs");
-  const code = await runTeam(taskId, { description, cwd, soloAgent: command.charAt(0).toUpperCase() + command.slice(1).toLowerCase() });
+  const code = await runTeam(taskId, { description, cwd, soloAgent: command.charAt(0).toUpperCase() + command.slice(1).toLowerCase(), childStrategy });
   process.exit(code);
 }
 
@@ -140,10 +144,11 @@ else if (command === "init") {
 }
 
 else if (command === "team") {
-  // Parse options first to find -d, --cwd, --legacy
+  // Parse options first to find -d, --cwd, --child-strategy
   let description = "";
   let cwd = process.cwd();
   let taskId = null;
+  let childStrategy = null;
   const remaining = args.slice(1);
 
   for (let i = 0; i < remaining.length; i++) {
@@ -151,6 +156,8 @@ else if (command === "team") {
       description = remaining[++i];
     } else if (remaining[i] === "--cwd" && remaining[i + 1]) {
       cwd = remaining[++i];
+    } else if (remaining[i] === "--child-strategy" && remaining[i + 1]) {
+      childStrategy = remaining[++i];
     } else if (!taskId && !remaining[i].startsWith("-")) {
       taskId = remaining[i];
     }
@@ -163,7 +170,7 @@ else if (command === "team") {
   }
 
   const { runTeam } = await import("../cli/team.mjs");
-  const code = await runTeam(taskId, { description, cwd });
+  const code = await runTeam(taskId, { description, cwd, childStrategy });
   process.exit(code);
 }
 

package/cli/orchestrator.mjs

@@ -47,7 +47,7 @@ function timestamp() {
 export async function runOrchestrator({
   taskId, taskLink, description, createTask, tracker, config,
   project, team, teamSections, inboxUrl, sessionUrl, cwd,
-  onEvent, apiKey, serverUrl, soloAgent,
+  onEvent, apiKey, serverUrl, soloAgent, childStrategy,
 }) {
   const trackerCreds = await fetchTrackerCredentials(project?.name, apiKey, serverUrl);
   const env = { ...process.env, ...loadDotEnv(cwd), ...trackerCreds };
@@ -64,7 +64,7 @@ export async function runOrchestrator({
   }
 
   const fullPrompt = soloAgent
-    ? buildSoloPrompt({ agentName: soloAgent, taskId, description, tracker, config, project, sessionUrl })
+    ? buildSoloPrompt({ agentName: soloAgent, taskId, description, tracker, config, project, sessionUrl, childStrategy })
     : buildPrompt({ taskId, taskLink, description, createTask, tracker, config, project, teamSections, inboxUrl, sessionUrl });
 
   emit({

package/cli/prompt.mjs

@@ -102,7 +102,7 @@ export function buildPrompt({ taskId, taskLink, description, createTask, tracker
   return `${prompt}\n\n---\n\n## PROJECT CONTEXT\n\n${context}\n\n${timeInfo}`;
 }
 
-export function buildSoloPrompt({ agentName, taskId, description, tracker, config, project, sessionUrl }) {
+export function buildSoloPrompt({ agentName, taskId, description, tracker, config, project, sessionUrl, childStrategy }) {
   const agent = BUILT_IN_AGENTS[agentName];
   if (!agent) throw new Error(`Unknown agent: ${agentName}`);
 
@@ -244,6 +244,60 @@ export function buildSoloPrompt({ agentName, taskId, description, tracker, confi
     }
   }
 
+  // Child task handling — when the task has subtasks/child items
+  if (tracker) {
+    const strategy = childStrategy || "inline";
+    lines.push(
+      `## Handling parent tasks with child items`,
+      ``,
+      `After fetching the task, check if it has child items / subtasks. If it does, work on all child items that are marked "To Do" (or equivalent open status).`,
+      ``,
+    );
+
+    if (strategy === "branch") {
+      lines.push(
+        `**Strategy: one branch per child item**`,
+        ``,
+        `1. Create a parent feature branch from main: \`feat/<parent-task-id>\``,
+        `2. For each child item marked "To Do" (sequentially):`,
+        `   a. Pull/rebase the parent branch to include any prior child merges`,
+        `   b. Create a child branch from the parent: \`feat/<parent-task-id>/<child-task-id>\``,
+        `   c. Do the work, commit`,
+        `   d. Push the child branch and open a PR **targeting the parent branch** (not main)`,
+        `   e. Post the PR link as a comment on the child task`,
+        `   f. Update the child task status to "In Review"`,
+        `   g. Switch back to the parent branch before starting the next child`,
+        `3. After all children are done, post a summary on the parent task listing all child PRs`,
+        ``,
+        `Each child PR can be reviewed and merged to the parent branch independently.`,
+        `When all children are merged, the parent branch can be merged to main.`,
+        ``,
+      );
+    } else {
+      lines.push(
+        `**Strategy: all changes on parent branch (inline)**`,
+        ``,
+        `1. Create a feature branch from main: \`feat/<parent-task-id>\``,
+        `2. For each child item marked "To Do" (sequentially):`,
+        `   a. Do the work on the parent branch`,
+        `   b. Commit with a message referencing the child task ID`,
+        `   c. Post a comment on the child task describing what was done`,
+        `   d. Update the child task status to "Done"`,
+        `3. Push the branch and open a single PR targeting main`,
+        `4. Post the PR link on the parent task`,
+        `5. Post a summary on the parent task listing all completed children`,
+        ``,
+        `This keeps everything in one branch — no conflicts, one PR to review.`,
+        ``,
+      );
+    }
+
+    lines.push(
+      `If the task has no child items, just work on it normally as a single task.`,
+      ``,
+    );
+  }
+
   // Add custom instructions
   if (config?.instructions) {
     lines.push(`## Additional Instructions`, ``, config.instructions, ``);

package/cli/team.mjs

@@ -90,6 +90,9 @@ export async function runTeam(taskId, opts = {}) {
   if (opts.soloAgent) {
     console.log(`Agent: ${opts.soloAgent} (solo mode)`);
   }
+  if (opts.childStrategy) {
+    console.log(`Child strategy: ${opts.childStrategy}`);
+  }
 
   // Resolve team and generate dynamic prompt sections
   const team = resolveTeam(config);
@@ -211,6 +214,7 @@ export async function runTeam(taskId, opts = {}) {
     apiKey,
     serverUrl: agentdeskServer,
     soloAgent: opts.soloAgent || null,
+    childStrategy: opts.childStrategy || null,
   });
 
   clearInterval(heartbeatInterval);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kendoo.agentdesk/agentdesk",
-  "version": "0.10.5",
+  "version": "0.11.0",
   "description": "AI team orchestrator for Claude Code — run collaborative agent sessions from your terminal",
   "type": "module",
   "bin": {