ralphctl 0.1.4 → 0.2.0

package/dist/cli.mjs

@@ -2,15 +2,17 @@
 import {
   addCheckScriptToRepository,
   projectAddCommand
-} from "./chunk-YIB7QYU4.mjs";
+} from "./chunk-Q3VWJARJ.mjs";
 import {
   addTask,
   areAllTasksDone,
   branchExists,
+  buildHeadlessAiRequest,
   buildIdeateAutoPrompt,
   buildIdeatePrompt,
   buildTicketRefinePrompt,
   exportRequirementsToMarkdown,
+  extractJsonArray,
   extractJsonObject,
   formatTicketForPrompt,
   getActiveProvider,
@@ -31,6 +33,7 @@ import {
   providerDisplayName,
   removeTask,
   renderParsedTasksTable,
+  reorderByDependencies,
   reorderTask,
   resolveProvider,
   runAiSession,
@@ -49,13 +52,13 @@ import {
   sprintStartCommand,
   updateTaskStatus,
   validateImportTasks
-} from "./chunk-M7JV6MKD.mjs";
+} from "./chunk-HLGOQNJ4.mjs";
 import {
   escapableSelect
 } from "./chunk-7LZ6GOGN.mjs";
 import {
   sprintCreateCommand
-} from "./chunk-DZ6HHTM5.mjs";
+} from "./chunk-XQHEKKDN.mjs";
 import {
   addTicket,
   allRequirementsApproved,
@@ -70,7 +73,7 @@ import {
   removeTicket,
   ticketAddCommand,
   updateTicket
-} from "./chunk-F2MMCTB5.mjs";
+} from "./chunk-XPDI4SYI.mjs";
 import {
   EXIT_ERROR,
   exitWithCode
@@ -81,8 +84,9 @@ import {
   listProjects,
   removeProject,
   removeProjectRepo
-} from "./chunk-PDI6HBZ7.mjs";
+} from "./chunk-LG6B7QVO.mjs";
 import {
+  DEFAULT_EVALUATION_ITERATIONS,
   assertSprintStatus,
   closeSprint,
   deleteSprint,
@@ -91,6 +95,7 @@ import {
   getCurrentSprint,
   getCurrentSprintOrThrow,
   getEditor,
+  getEvaluationIterations,
   getProgress,
   getSprint,
   listSprints,
@@ -100,8 +105,9 @@ import {
   setAiProvider,
   setCurrentSprint,
   setEditor,
+  setEvaluationIterations,
   withFileLock
-} from "./chunk-LFDW6MWF.mjs";
+} from "./chunk-KPTPKLXY.mjs";
 import {
   ensureError,
   wrapAsync
@@ -127,7 +133,7 @@ import {
   getTasksFilePath,
   readValidatedJson,
   validateProjectPath
-} from "./chunk-W3TY22IS.mjs";
+} from "./chunk-ZDEVRTGY.mjs";
 import {
   DomainError,
   NoCurrentSprintError,
@@ -414,6 +420,12 @@ function buildConfigSubMenu() {
   const items = [];
   items.push({ name: "Show Settings", value: "show", description: "View current configuration" });
   items.push({ name: "Set AI Provider", value: "set provider", description: "Choose Claude Code or GitHub Copilot" });
+  items.push({ name: "Set Editor", value: "set editor", description: "Editor for refinement sessions" });
+  items.push({
+    name: "Set Evaluation Iterations",
+    value: "set evaluationIterations",
+    description: "Generator-evaluator loop count (0 = disabled)"
+  });
   items.push(line());
   items.push({ name: "Back", value: "back", description: "Return to main menu" });
   return { title: "Configuration", items };
@@ -610,7 +622,7 @@ async function showDashboard() {
 }
 
 // src/interactive/index.ts
-import { select as select3 } from "@inquirer/prompts";
+import { input as input5, select as select3 } from "@inquirer/prompts";
 
 // src/commands/project/list.ts
 async function projectListCommand() {
@@ -1146,7 +1158,7 @@ async function invokeAiInteractive(prompt, repoPaths, ideateDir) {
   await writeFile(contextFile, prompt, "utf-8");
   const provider = await getActiveProvider();
   const startPrompt = `I have a quick idea I want to implement. The full context is in ideate-context.md. Please read that file and help me refine the idea into requirements and then plan implementation tasks.`;
-  const args = ["--add-dir", ...repoPaths];
+  const args = repoPaths.flatMap((path) => ["--add-dir", path]);
   const result = spawnInteractive(
     startPrompt,
     {
@@ -1162,36 +1174,55 @@ async function invokeAiInteractive(prompt, repoPaths, ideateDir) {
 }
 async function invokeAiAuto(prompt, repoPaths, ideateDir) {
   const provider = await getActiveProvider();
-  const args = ["--permission-mode", "plan", "--print"];
-  for (const path of repoPaths) {
-    args.push("--add-dir", path);
-  }
-  args.push("-p", prompt);
+  const request = buildHeadlessAiRequest(repoPaths, prompt);
   return spawnHeadless(
     {
       cwd: ideateDir,
-      args,
+      args: request.args,
+      prompt: request.prompt,
       env: provider.getSpawnEnv()
     },
     provider
   );
 }
 function parseIdeateOutput(output) {
-  const jsonStr = extractJsonObject(output);
-  const parseR = Result.try(() => JSON.parse(jsonStr));
-  if (!parseR.ok) {
-    throw new Error(`Invalid JSON: ${parseR.error.message}`, { cause: parseR.error });
+  const firstBrace = output.indexOf("{");
+  const firstBracket = output.indexOf("[");
+  const objectFirst = firstBrace !== -1 && (firstBracket === -1 || firstBrace < firstBracket);
+  if (objectFirst) {
+    return parseIdeateObject(output);
+  }
+  if (firstBracket !== -1) {
+    const arrayR = Result.try(() => extractJsonArray(output));
+    if (arrayR.ok) {
+      const parseR = Result.try(() => JSON.parse(arrayR.value));
+      if (parseR.ok && Array.isArray(parseR.value)) {
+        return { requirements: "", tasks: parseR.value };
+      }
+    }
   }
-  const result = IdeateOutputSchema.safeParse(parseR.value);
-  if (!result.success) {
-    const issues = result.error.issues.map((issue) => {
-      const path = issue.path.length > 0 ? `[${issue.path.join(".")}]` : "";
-      return `  ${path}: ${issue.message}`;
-    }).join("\n");
-    throw new Error(`Invalid ideate output format:
+  throw new Error("No valid ideate output found \u2014 expected { requirements, tasks } object or a tasks array");
+}
+function parseIdeateObject(output) {
+  const jsonStr = extractJsonObject(output);
+  const parsed = JSON.parse(jsonStr);
+  const result = IdeateOutputSchema.safeParse(parsed);
+  if (result.success) {
+    return result.data;
+  }
+  if (typeof parsed === "object" && parsed !== null && "tasks" in parsed) {
+    const obj = parsed;
+    if (Array.isArray(obj["tasks"])) {
+      const requirements = typeof obj["requirements"] === "string" ? obj["requirements"] : "";
+      return { requirements, tasks: obj["tasks"] };
+    }
+  }
+  const issues = result.error.issues.map((issue) => {
+    const path = issue.path.length > 0 ? `[${issue.path.join(".")}]` : "";
+    return `  ${path}: ${issue.message}`;
+  }).join("\n");
+  throw new Error(`Invalid ideate output format:
 ${issues}`);
-  }
-  return result.data;
 }
 async function sprintIdeateCommand(args) {
   const { sprintId, options } = parseArgs(args);
@@ -1291,8 +1322,12 @@ async function sprintIdeateCommand(args) {
     reposByProject.set(projectName, project.repositories);
     selectedPaths = await selectProjectPaths(reposByProject, "Select paths to explore:");
   }
-  ticket.affectedRepositories = selectedPaths;
-  await saveSprint(sprint);
+  const updatedSprint = await getSprint(id);
+  const savedTicket = updatedSprint.tickets.find((t) => t.id === ticket.id);
+  if (savedTicket) {
+    savedTicket.affectedRepositories = selectedPaths;
+  }
+  await saveSprint(updatedSprint);
   if (selectedPaths.length > 1) {
     console.log(muted(`Paths: ${selectedPaths.join(", ")}`));
   } else {
@@ -1332,13 +1367,13 @@ async function sprintIdeateCommand(args) {
       return;
     }
     const ideateOutput = ideateR.value;
-    const ticketIdx = sprint.tickets.findIndex((t) => t.id === ticket.id);
-    const ticketToUpdate = sprint.tickets[ticketIdx];
-    if (ticketIdx !== -1 && ticketToUpdate) {
-      ticketToUpdate.requirements = ideateOutput.requirements;
-      ticketToUpdate.requirementStatus = "approved";
+    const autoSprint = await getSprint(id);
+    const autoTicket = autoSprint.tickets.find((t) => t.id === ticket.id);
+    if (autoTicket) {
+      autoTicket.requirements = ideateOutput.requirements;
+      autoTicket.requirementStatus = "approved";
     }
-    await saveSprint(sprint);
+    await saveSprint(autoSprint);
     showSuccess("Requirements approved and saved!");
     log.newline();
     const parsedTasksR = Result.try(() => parseTasksJson(JSON.stringify(ideateOutput.tasks)));
@@ -1348,6 +1383,9 @@ async function sprintIdeateCommand(args) {
       return;
     }
     const parsedTasks = parsedTasksR.value;
+    for (const task of parsedTasks) {
+      task.ticketId ??= ticket.id;
+    }
     if (parsedTasks.length === 0) {
       showWarning("No tasks generated.");
       log.newline();
@@ -1358,7 +1396,7 @@ async function sprintIdeateCommand(args) {
     console.log(renderParsedTasksTable(parsedTasks));
     console.log("");
     const existingTasks = await getTasks(id);
-    const ticketIds = new Set(sprint.tickets.map((t) => t.id));
+    const ticketIds = new Set(autoSprint.tickets.map((t) => t.id));
     const validationErrors = validateImportTasks(parsedTasks, existingTasks, ticketIds);
     if (validationErrors.length > 0) {
       showError("Validation failed");
@@ -1368,8 +1406,13 @@ async function sprintIdeateCommand(args) {
       log.newline();
       return;
     }
+    if (ideateOutput.requirements === "") {
+      showWarning("AI output was a bare tasks array \u2014 requirements not captured.");
+    }
     showInfo("Importing tasks...");
     const imported = await importTasks(parsedTasks, id);
+    await reorderByDependencies(id);
+    log.dim("Tasks reordered by dependencies.");
     terminalBell();
     showSuccess(`Imported ${String(imported)}/${String(parsedTasks.length)} tasks.`);
     log.newline();
@@ -1405,13 +1448,13 @@ async function sprintIdeateCommand(args) {
         return;
       }
       const ideateOutput = ideateR.value;
-      const ticketIdx = sprint.tickets.findIndex((t) => t.id === ticket.id);
-      const ticketToUpdate = sprint.tickets[ticketIdx];
-      if (ticketIdx !== -1 && ticketToUpdate) {
-        ticketToUpdate.requirements = ideateOutput.requirements;
-        ticketToUpdate.requirementStatus = "approved";
+      const interactiveSprint = await getSprint(id);
+      const interactiveTicket = interactiveSprint.tickets.find((t) => t.id === ticket.id);
+      if (interactiveTicket) {
+        interactiveTicket.requirements = ideateOutput.requirements;
+        interactiveTicket.requirementStatus = "approved";
       }
-      await saveSprint(sprint);
+      await saveSprint(interactiveSprint);
       showSuccess("Requirements approved and saved!");
       log.newline();
       const parsedTasksR = Result.try(() => parseTasksJson(JSON.stringify(ideateOutput.tasks)));
@@ -1421,6 +1464,9 @@ async function sprintIdeateCommand(args) {
         return;
       }
       const parsedTasks = parsedTasksR.value;
+      for (const task of parsedTasks) {
+        task.ticketId ??= ticket.id;
+      }
       if (parsedTasks.length === 0) {
         showWarning("No tasks in file.");
         log.newline();
@@ -1431,7 +1477,7 @@ async function sprintIdeateCommand(args) {
       console.log(renderParsedTasksTable(parsedTasks));
       console.log("");
       const existingTasks = await getTasks(id);
-      const ticketIds = new Set(sprint.tickets.map((t) => t.id));
+      const ticketIds = new Set(interactiveSprint.tickets.map((t) => t.id));
       const validationErrors = validateImportTasks(parsedTasks, existingTasks, ticketIds);
       if (validationErrors.length > 0) {
         showError("Validation failed");
@@ -1441,8 +1487,13 @@ async function sprintIdeateCommand(args) {
         log.newline();
         return;
       }
+      if (ideateOutput.requirements === "") {
+        showWarning("AI output was a bare tasks array \u2014 requirements not captured.");
+      }
       showInfo("Importing tasks...");
       const imported = await importTasks(parsedTasks, id);
+      await reorderByDependencies(id);
+      log.dim("Tasks reordered by dependencies.");
       terminalBell();
       showSuccess(`Imported ${String(imported)}/${String(parsedTasks.length)} tasks.`);
       log.newline();
@@ -3216,7 +3267,7 @@ async function progressShowCommand() {
 async function configSetCommand(args) {
   if (args.length < 2) {
     showError("Usage: ralphctl config set <key> <value>");
-    log.dim("Available keys: provider, editor");
+    log.dim("Available keys: provider, editor, evaluationIterations");
     log.newline();
     return;
   }
@@ -3247,16 +3298,32 @@ async function configSetCommand(args) {
     log.newline();
     return;
   }
+  if (key === "evaluationIterations") {
+    const parsed = Number.parseInt(value ?? "", 10);
+    if (Number.isNaN(parsed) || parsed < 0 || !Number.isInteger(parsed)) {
+      showError(`Invalid evaluation iterations: ${value ?? "(empty)"}`);
+      log.dim("Must be an integer >= 0 (0 = disabled)");
+      log.newline();
+      return;
+    }
+    await setEvaluationIterations(parsed);
+    showSuccess(`Evaluation iterations set to: ${String(parsed)}`);
+    log.newline();
+    return;
+  }
   showError(`Unknown config key: ${key ?? "(empty)"}`);
-  log.dim("Available keys: provider, editor");
+  log.dim("Available keys: provider, editor, evaluationIterations");
   log.newline();
 }
 async function configShowCommand() {
   const provider = await getAiProvider();
   const editorCmd = await getEditor();
+  const evalIterations = await getEvaluationIterations();
   printHeader("Configuration", icons.info);
   console.log(field("AI Provider", provider ?? "(not set \u2014 will prompt on first use)"));
   console.log(field("Editor", editorCmd ?? "(not set \u2014 will prompt on first use)"));
+  const evalDisplay = evalIterations === DEFAULT_EVALUATION_ITERATIONS ? `${String(evalIterations)} (default)` : evalIterations === 0 ? "0 (disabled)" : String(evalIterations);
+  console.log(field("Evaluation Iterations", evalDisplay));
   log.newline();
 }
 
@@ -3320,7 +3387,8 @@ async function checkAiProvider() {
     stdio: ["ignore", "pipe", "pipe"]
   });
   if (result.status === 0) {
-    return { name: "AI provider binary", status: "pass", detail: `${binary} found` };
+    const detail = provider === "copilot" ? `${binary} found (public preview)` : `${binary} found`;
+    return { name: "AI provider binary", status: "pass", detail };
   }
   return {
     name: "AI provider binary",
@@ -3375,6 +3443,21 @@ async function checkProjectPaths() {
   }
   return { name: "Project paths", status: "fail", detail: issues.join("; ") };
 }
+async function checkEvaluationConfig() {
+  const config = await getConfig();
+  if (config.evaluationIterations == null) {
+    return {
+      name: "Evaluation config",
+      status: "warn",
+      detail: "evaluationIterations not set \u2014 defaulting to 1 (set via: ralphctl config set evaluationIterations <n>)"
+    };
+  }
+  return {
+    name: "Evaluation config",
+    status: "pass",
+    detail: `evaluationIterations: ${String(config.evaluationIterations)}`
+  };
+}
 async function checkCurrentSprint() {
   const config = await getConfig();
   const sprintId = config.currentSprint;
@@ -3402,7 +3485,8 @@ async function doctorCommand() {
     checkAiProvider(),
     checkDataDirectory(),
     checkProjectPaths(),
-    checkCurrentSprint()
+    checkCurrentSprint(),
+    checkEvaluationConfig()
   ]);
   results.push(...asyncResults);
   for (const result of results) {
@@ -3520,6 +3604,26 @@ var commandMap = {
         theme: selectTheme
       });
       await configSetCommand(["provider", choice]);
+    },
+    "set editor": async () => {
+      const current = await getEditor();
+      const value = await input5({
+        message: `${emoji.donut} Which editor should open for refinement?`,
+        default: current ?? void 0,
+        theme: selectTheme
+      });
+      if (value.trim()) {
+        await configSetCommand(["editor", value.trim()]);
+      }
+    },
+    "set evaluationIterations": async () => {
+      const current = await getEvaluationIterations();
+      const value = await input5({
+        message: `${emoji.donut} How many evaluation loops? (0 = disabled)`,
+        default: String(current),
+        theme: selectTheme
+      });
+      await configSetCommand(["evaluationIterations", value.trim()]);
     }
   }
 };
@@ -3659,7 +3763,7 @@ async function interactiveMode() {
       continue;
     }
     if (command === "wizard") {
-      const { runWizard } = await import("./wizard-MCDDXLGE.mjs");
+      const { runWizard } = await import("./wizard-2OKIQLZJ.mjs");
       await runWizard();
       continue;
     }
@@ -3870,7 +3974,7 @@ Examples:
   sprint.command("health").description("Check sprint health").action(async () => {
     await sprintHealthCommand();
   });
-  sprint.command("start [id]").description("Run automated implementation loop").option("-s, --session", "Interactive AI session (collaborate with your AI provider)").option("-t, --step", "Step through tasks with approval between each").option("-c, --count <n>", "Limit to N tasks").option("--no-commit", "Skip automatic git commit after each task completes").option("--concurrency <n>", "Max parallel tasks (default: auto based on unique repos)").option("--max-retries <n>", "Max rate-limit retries per task (default: 5)").option("--fail-fast", "Stop launching new tasks on first failure").option("-f, --force", "Skip precondition checks (e.g., unplanned tickets)").option("--refresh-check", "Force re-run check scripts even if they already ran this sprint").option("-b, --branch", "Create sprint branch (ralphctl/<sprint-id>) in all repos").option("--branch-name <name>", "Use a custom branch name for sprint execution").addHelpText(
+  sprint.command("start [id]").description("Run automated implementation loop").option("-s, --session", "Interactive AI session (collaborate with your AI provider)").option("-t, --step", "Step through tasks with approval between each").option("-c, --count <n>", "Limit to N tasks").option("--no-commit", "Skip automatic git commit after each task completes").option("--concurrency <n>", "Max parallel tasks (default: auto based on unique repos)").option("--max-retries <n>", "Max rate-limit retries per task (default: 5)").option("--fail-fast", "Stop launching new tasks on first failure").option("-f, --force", "Skip precondition checks (e.g., unplanned tickets)").option("--refresh-check", "Force re-run check scripts even if they already ran this sprint").option("-b, --branch", "Create sprint branch (ralphctl/<sprint-id>) in all repos").option("--branch-name <name>", "Use a custom branch name for sprint execution").option("--max-budget-usd <amount>", "Max USD budget per AI task (Claude only)").option("--fallback-model <model>", "Fallback model when primary is overloaded (Claude only)").addHelpText(
     "after",
     `
 Exit Codes:
@@ -3906,6 +4010,8 @@ Branch Management:
       if (opts?.refreshCheck) args.push("--refresh-check");
       if (opts?.branch) args.push("--branch");
       if (opts?.branchName) args.push("--branch-name", opts.branchName);
+      if (opts?.maxBudgetUsd) args.push("--max-budget-usd", opts.maxBudgetUsd);
+      if (opts?.fallbackModel) args.push("--fallback-model", opts.fallbackModel);
       await sprintStartCommand(args);
     }
   );
@@ -4128,8 +4234,8 @@ Checks performed:
 // package.json
 var package_default = {
   name: "ralphctl",
-  version: "0.1.4",
-  description: "Sprint and task management CLI for AI-assisted coding",
+  version: "0.2.0",
+  description: "Agent harness for long-running AI coding tasks \u2014 orchestrates Claude Code & GitHub Copilot across repositories",
   homepage: "https://github.com/lukas-grigis/ralphctl",
   type: "module",
   license: "MIT",
@@ -4143,13 +4249,15 @@ var package_default = {
   },
   keywords: [
     "cli",
-    "claude",
-    "ai",
-    "sprint",
-    "task-management",
-    "planning",
+    "agent-harness",
+    "claude-code",
+    "github-copilot",
+    "ai-coding",
+    "task-orchestration",
     "anthropic",
-    "developer-tools"
+    "developer-tools",
+    "long-running-agents",
+    "generator-evaluator"
   ],
   bin: {
     ralphctl: "./dist/cli.mjs"
@@ -4180,7 +4288,7 @@ var package_default = {
     node: ">=24.0.0"
   },
   dependencies: {
-    "@inquirer/prompts": "^8.3.0",
+    "@inquirer/prompts": "^8.3.2",
     colorette: "^2.0.20",
     commander: "^14.0.3",
     "gradient-string": "^3.0.0",
@@ -4191,19 +4299,20 @@ var package_default = {
   },
   devDependencies: {
     "@eslint/js": "^10.0.1",
-    "@types/node": "^25.3.3",
+    "@types/node": "^25.5.0",
     "@types/tabtab": "^3.0.4",
-    eslint: "^10.0.2",
+    "@vitest/coverage-v8": "^4.1.1",
+    eslint: "^10.1.0",
     "eslint-config-prettier": "^10.1.8",
     globals: "^17.4.0",
     husky: "^9.1.7",
-    "lint-staged": "^16.3.1",
+    "lint-staged": "^16.4.0",
     prettier: "^3.8.1",
     tsup: "^8.5.1",
     tsx: "^4.21.0",
     typescript: "^5.9.3",
-    "typescript-eslint": "^8.56.1",
-    vitest: "^4.0.18"
+    "typescript-eslint": "^8.57.2",
+    vitest: "^4.1.1"
   },
   "lint-staged": {
     "*.ts": [
@@ -4247,7 +4356,7 @@ registerCompletionCommands(program);
 registerDoctorCommands(program);
 async function main() {
   if (process.env["COMP_CWORD"] && process.env["COMP_POINT"] && process.env["COMP_LINE"]) {
-    const { handleCompletionRequest } = await import("./handle-K2AZLTKU.mjs");
+    const { handleCompletionRequest } = await import("./handle-CCTBNAJZ.mjs");
     if (await handleCompletionRequest(program)) return;
   }
   if (process.argv.length <= 2 || process.argv[2] === "interactive") {

package/dist/{create-MQ4OHZAX.mjs → create-DJHCP7LN.mjs}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   sprintCreateCommand
-} from "./chunk-DZ6HHTM5.mjs";
-import "./chunk-LFDW6MWF.mjs";
+} from "./chunk-XQHEKKDN.mjs";
+import "./chunk-KPTPKLXY.mjs";
 import "./chunk-OEUJDSHY.mjs";
-import "./chunk-W3TY22IS.mjs";
+import "./chunk-ZDEVRTGY.mjs";
 import "./chunk-EDJX7TT6.mjs";
 import "./chunk-QBXHAXHI.mjs";
 export {

package/dist/{handle-K2AZLTKU.mjs → handle-CCTBNAJZ.mjs}

@@ -7,7 +7,7 @@ async function handleCompletionRequest(program) {
     return false;
   }
   const tabtab = (await import("tabtab")).default;
-  const { resolveCompletions } = await import("./resolver-NH34HTB6.mjs");
+  const { resolveCompletions } = await import("./resolver-L52KR4GY.mjs");
   const tabEnv = tabtab.parseEnv(env);
   const completions = await resolveCompletions(program, {
     line: tabEnv.line,

package/dist/{project-Q4LKML42.mjs → project-ZYGNPVGL.mjs}

@@ -9,8 +9,8 @@ import {
   removeProject,
   removeProjectRepo,
   updateProject
-} from "./chunk-PDI6HBZ7.mjs";
-import "./chunk-W3TY22IS.mjs";
+} from "./chunk-LG6B7QVO.mjs";
+import "./chunk-ZDEVRTGY.mjs";
 import {
   ProjectExistsError,
   ProjectNotFoundError

package/dist/prompts/ideate-auto.md

@@ -52,7 +52,8 @@ Analyze the idea and produce complete, implementation-agnostic requirements:
 
 Explore the selected repositories and produce implementation tasks:
 
-1. **Explore codebase** — Read CLAUDE.md (if exists), understand project structure, find patterns
+1. **Explore codebase** — Read the repository instruction files (`CLAUDE.md`, `.github/copilot-instructions.md`, etc.)
+   when present, understand project structure, find patterns
 2. **Map requirements to implementation** — Determine which parts map to which repository
 3. **Create tasks** — Following the Planning Common Context guidelines below
 4. **Validate** — Ensure tasks are non-overlapping, properly ordered, and completable
@@ -111,7 +112,7 @@ If you cannot produce a valid plan, output `<planning-blocked>reason</planning-b
 - Each task has `id`, `name`, `projectPath`, `steps`, and optional `blockedBy`
 - `projectPath` must be one of the Selected Repositories paths
 - Steps reference actual files discovered during exploration
-- Verification steps use commands from CLAUDE.md if available
+- Verification steps use commands from the repository instruction files if available
 - Tasks properly ordered by dependencies
 
 **Example:**

package/dist/prompts/ideate.md

@@ -79,8 +79,8 @@ Focus: Determine HOW to implement the approved requirements
 
 **Steps:**
 
-1. **Explore the codebase** — Read CLAUDE.md (if exists), check project structure, find similar implementations, extract
-   verification commands
+1. **Explore the codebase** — Read the repository instruction files (`CLAUDE.md`, `.github/copilot-instructions.md`,
+   etc.) when present, check project structure, find similar implementations, extract verification commands
 2. **Review approved requirements** — Understand WHAT was approved in Phase 1
 3. **Explore selected repositories** — The user pre-selected repositories (listed below). Deep-dive to understand
    patterns, conventions, and existing code

package/dist/prompts/plan-auto.md

@@ -1,7 +1,8 @@
 # Headless Task Planning Protocol
 
-You are a task planning specialist. Your goal is to produce a dependency-ordered set of implementation tasks — each one a
-self-contained mini-spec that can be picked up cold and completed in a single Claude session. Make all decisions
+You are a task planning specialist. Your goal is to produce a dependency-ordered set of implementation tasks — each one
+a
+self-contained mini-spec that can be picked up cold and completed in a single AI session. Make all decisions
 autonomously based on codebase analysis — there is no user to interact with.
 
 ## Protocol
@@ -10,9 +11,10 @@ autonomously based on codebase analysis — there is no user to interact with.
 
 Explore efficiently — read what matters, skip what does not:
 
-1. **Read CLAUDE.md first** (if it exists) — Primary source for project conventions, patterns, verification commands, and
-   architecture. Follow any links to other documentation. Check `.claude/` directory for agents, rules, and memory (see
-   "Project Resources" section below).
+1. **Read project instructions first** — Start with `CLAUDE.md` if it exists, and also check provider-specific files
+   such
+   as `.github/copilot-instructions.md` when present. Follow any links to other documentation. Check `.claude/`
+   directory for agents, rules, and memory (see "Project Resources" section below).
 2. **Read manifest files** — package.json, pyproject.toml, Cargo.toml, go.mod, pom.xml, etc. for dependencies and
    scripts
 3. **Read README** — Project overview, setup, and architecture
@@ -21,8 +23,8 @@ Explore efficiently — read what matters, skip what does not:
    exactly.
 6. **Extract verification commands** — Find the exact build, test, lint, and typecheck commands
 
-**Do NOT read every file.** Read CLAUDE.md/README, then only the specific files needed to understand patterns and plan
-tasks.
+**Do NOT read every file.** Read the project instruction files/README first, then only the specific files needed to
+understand patterns and plan tasks.
 
 ### Step 2: Review Ticket Requirements
 
@@ -73,7 +75,8 @@ Before outputting JSON, verify EVERY item on this checklist:
 3. **Valid dependencies** — All `blockedBy` references point to earlier tasks with real code dependencies
 4. **Maximized parallelism** — Independent tasks do NOT block each other unnecessarily
 5. **Precise steps** — Every task has 3+ specific, actionable steps with file references
-6. **Verification steps** — Every task ends with project-appropriate verification commands from CLAUDE.md
+6. **Verification steps** — Every task ends with project-appropriate verification commands from the repository
+   instructions
 7. **projectPath assigned** — Every task has a `projectPath` from the project's repository paths
 8. **Clear done state** — For each task, the question "how do I know this is done?" has an obvious answer
 9. **Valid JSON** — The output parses as a JSON array of task objects matching the schema