goalbuddy 0.3.2 → 0.3.6

package/internal/cli/goal-maker.mjs

@@ -52,6 +52,8 @@ const optionsWithValues = new Set([
   "--port",
   "--source",
   "--target",
+  "--task",
+  "--board",
 ]);
 
 const args = process.argv.slice(2);
@@ -81,15 +83,23 @@ async function main() {
       break;
     case "install":
     case "update":
+      if (wantsHelp()) {
+        usage();
+        break;
+      }
       if (installTargetMode() === "all") {
         await installEverywhere();
       } else if (installTargetMode() === "codex") {
-        await installAll();
+        installPlugin();
       } else {
         await installClaudeAll();
       }
       break;
     case "agents":
+      if (wantsHelp()) {
+        usage();
+        break;
+      }
       if (targetMode() === "codex") {
         installAgents();
       } else {
@@ -97,6 +107,10 @@ async function main() {
       }
       break;
     case "doctor":
+      if (wantsHelp()) {
+        usage();
+        break;
+      }
       if (targetMode() === "codex") {
         doctor();
       } else {
@@ -108,6 +122,10 @@ async function main() {
       checkUpdate();
       break;
     case "plugin":
+      if (wantsHelp()) {
+        pluginUsage();
+        break;
+      }
       plugin();
       break;
     case "extend":
@@ -116,6 +134,12 @@ async function main() {
     case "board":
       await board();
       break;
+    case "prompt":
+      await prompt();
+      break;
+    case "parallel-plan":
+      await parallelPlan();
+      break;
     case "help":
     case "--help":
     case "-h":
@@ -156,6 +180,10 @@ function hasFlag(name) {
   return args.includes(name);
 }
 
+function wantsHelp() {
+  return hasFlag("--help") || hasFlag("-h");
+}
+
 function positional(index) {
   return positionalArgs()[index] || "";
 }
@@ -191,6 +219,8 @@ Usage:
   ${canonicalCliName} extend install --all [--catalog-url <url-or-path>] [--dry-run] [--force] [--json]
   ${canonicalCliName} extend doctor [<id>] [--codex-home <path>] [--json]
   ${canonicalCliName} board <docs/goals/slug> [--catalog-url <url-or-path>] [--host <host>] [--port <port>] [--once] [--json]
+  ${canonicalCliName} prompt <docs/goals/slug> [--task T###] [--board <path/to/state.yaml>] [--json]
+  ${canonicalCliName} parallel-plan <docs/goals/slug> [--json]
 
 Targets: by default, install/update prepares both Codex (~/.codex) and Claude Code (~/.claude). Use --target codex or --target claude to limit the command.
 
@@ -542,7 +572,7 @@ This alias has the same invocation boundary as \`$${canonicalSkillName}\`: prepa
 function installAgents({ quiet = false } = {}) {
   const source = join(skillSource, "agents");
   const target = join(codexHome(), "agents");
-  const force = hasFlag("--force") || command === "update" || command === "install";
+  const force = hasFlag("--force") || command === "update" || command === "install" || command === "default" || command === "plugin";
   mkdirSync(target, { recursive: true });
 
   const results = [];
@@ -591,6 +621,7 @@ async function installAll() {
 function doctor() {
   const skillPath = join(installedSkillRoot(), "SKILL.md");
   const legacySkillPath = join(legacyInstalledSkillRoot(), "SKILL.md");
+  const plugin = installedCodexPlugin();
   const agentsPath = join(codexHome(), "agents");
   const installed = existsSync(skillPath);
   const legacyInstalled = existsSync(legacySkillPath);
@@ -606,12 +637,38 @@ function doctor() {
   });
   const goalRuntime = codexGoalRuntimeStatus();
   const warnings = [];
+  const errors = [];
   if (!goalRuntime.ready) {
     warnings.push("native Codex /goal runtime is not ready; run `codex login` and `codex features enable goals` before using /goal.");
   }
+  if (!plugin.skill_installed && !installed) {
+    errors.push("Codex GoalBuddy plugin is not installed; run `npx goalbuddy --target codex`.");
+  }
+  if (plugin.skill_installed && !plugin.enabled) {
+    errors.push("Codex GoalBuddy plugin cache exists but is not enabled in config.toml; run `npx goalbuddy --target codex`.");
+  }
+  for (const file of missingAgents) {
+    errors.push(`Missing GoalBuddy Codex agent: ${file}; run \`npx goalbuddy --target codex\`.`);
+  }
+  for (const file of staleAgents) {
+    errors.push(`Stale GoalBuddy Codex agent: ${file}; run \`npx goalbuddy update --target codex\`.`);
+  }
+  if (hasFlag("--goal-ready") && !goalRuntime.ready) {
+    errors.push("Native Codex /goal runtime is not ready. GoalBuddy $goal-prep and local boards are separate from OpenAI-gated native /goal.");
+  }
 
   console.log(JSON.stringify({
     codex_home: codexHome(),
+    codex_install_model: "plugin",
+    expected_state: {
+      plugin_cache: true,
+      bundled_skill: "$goal-prep",
+      standalone_personal_skill: false,
+      compatibility_skill: false,
+      agents: requiredAgentFiles,
+      native_goal: "separate OpenAI-gated Codex feature",
+    },
+    plugin,
     skill_installed: installed,
     skill_path: skillPath,
     compatibility_skill_installed: legacyInstalled,
@@ -621,11 +678,14 @@ function doctor() {
     stale_agents: staleAgents,
     goal_runtime: goalRuntime,
     warnings,
+    errors,
   }, null, 2));
 
-  const installOk = installed && missingAgents.length === 0 && staleAgents.length === 0;
+  const pluginOk = plugin.skill_installed && plugin.enabled;
+  const legacySkillOk = installed;
+  const installOk = (pluginOk || legacySkillOk) && missingAgents.length === 0 && staleAgents.length === 0;
   const goalReadyOk = !hasFlag("--goal-ready") || goalRuntime.ready;
-  process.exit(installOk && goalReadyOk ? 0 : 1);
+  process.exit(installOk && goalReadyOk && errors.length === 0 ? 0 : 1);
 }
 
 function checkUpdate() {
@@ -670,6 +730,10 @@ function updateReport() {
 
 function plugin() {
   const subcommand = positional(1) || "";
+  if (wantsHelp()) {
+    pluginUsage();
+    return;
+  }
   switch (subcommand) {
     case "install":
       installPlugin();
@@ -713,14 +777,17 @@ function installPlugin({ quiet = false } = {}) {
     throw new Error(`Failed to add Codex plugin marketplace: ${firstLine(marketplace.stderr || marketplace.stdout)}`);
   }
 
+  const legacySkillPaths = legacyCodexSkillRoots();
   const existingPluginSkillPath = installedPluginSkillRoot();
-  const preservedExtensions = preserveInstalledExtensions([existingPluginSkillPath], { tempRoot: dirname(pluginCachePath) });
+  const preservedExtensions = preserveInstalledExtensions([existingPluginSkillPath, ...legacySkillPaths], { tempRoot: dirname(pluginCachePath) });
   mkdirSync(dirname(pluginCachePath), { recursive: true });
   rmSync(pluginCachePath, { recursive: true, force: true });
   cpSync(pluginSource, pluginCachePath, { recursive: true });
   restoreInstalledExtensions(pluginSkillPath, preservedExtensions.tempPath);
   cleanupPreservedExtensions([preservedExtensions.tempPath]);
+  const removedLegacySkillPaths = cleanupLegacyCodexSkills();
   const configPath = enablePluginConfig();
+  const agents = installAgents({ quiet: true });
 
   const report = {
     installed: true,
@@ -731,7 +798,9 @@ function installPlugin({ quiet = false } = {}) {
     marketplace_source: source,
     cache_path: pluginCachePath,
     config_path: configPath,
+    agents,
     preserved_extensions: preservedExtensions.ids,
+    removed_legacy_skill_paths: removedLegacySkillPaths,
   };
 
   if (hasFlag("--json") && !quiet) {
@@ -745,9 +814,13 @@ function installPlugin({ quiet = false } = {}) {
   console.log(`Marketplace: ${source}`);
   console.log(`Cache: ${pluginCachePath}`);
   console.log(`Config: ${configPath}`);
+  console.log(`Agents: ${summarizeStatuses(report.agents)}`);
   if (report.preserved_extensions.length) {
     console.log(`Preserved extensions: ${report.preserved_extensions.join(", ")}`);
   }
+  if (report.removed_legacy_skill_paths.length) {
+    console.log(`Removed legacy personal skills: ${report.removed_legacy_skill_paths.join(", ")}`);
+  }
   console.log("");
   console.log("Restart Codex, then use:");
   console.log(`  $${canonicalSkillName}`);
@@ -758,6 +831,20 @@ function installPlugin({ quiet = false } = {}) {
   return report;
 }
 
+function legacyCodexSkillRoots() {
+  return [installedSkillRoot(), legacyInstalledSkillRoot()];
+}
+
+function cleanupLegacyCodexSkills() {
+  const removed = [];
+  for (const path of legacyCodexSkillRoots()) {
+    if (!existsSync(path)) continue;
+    rmSync(path, { recursive: true, force: true });
+    removed.push(path);
+  }
+  return removed;
+}
+
 function pluginCacheRoot(version) {
   return join(codexHome(), "plugins", "cache", pluginName, pluginName, version);
 }
@@ -941,6 +1028,39 @@ async function board() {
   process.exit(result.status ?? 1);
 }
 
+async function prompt() {
+  if (hasFlag("--parallel-plan")) {
+    await parallelPlan();
+    return;
+  }
+
+  const script = join(skillSource, "scripts", "render-task-prompt.mjs");
+  const scriptArgs = [script, ...args.slice(1)];
+  const result = spawnSync(process.execPath, scriptArgs, {
+    cwd: packageRoot,
+    encoding: "utf8",
+    env: process.env,
+  });
+  if (result.stdout) process.stdout.write(result.stdout);
+  if (result.stderr) process.stderr.write(result.stderr);
+  if (result.error) throw result.error;
+  process.exit(result.status ?? 1);
+}
+
+async function parallelPlan() {
+  const script = join(skillSource, "scripts", "parallel-plan.mjs");
+  const scriptArgs = [script, ...args.slice(1).filter((arg) => arg !== "--parallel-plan")];
+  const result = spawnSync(process.execPath, scriptArgs, {
+    cwd: packageRoot,
+    encoding: "utf8",
+    env: process.env,
+  });
+  if (result.stdout) process.stdout.write(result.stdout);
+  if (result.stderr) process.stderr.write(result.stderr);
+  if (result.error) throw result.error;
+  process.exit(result.status ?? 1);
+}
+
 async function ensureLocalBoardExtension() {
   const id = "local-goal-board";
   const script = join(extensionTarget(id), "scripts", "local-goal-board.mjs");
@@ -1235,8 +1355,24 @@ function installedSkillRoot() {
 }
 
 function installedPluginSkillRoot() {
+  return installedCodexPlugin().skill_path;
+}
+
+function installedCodexPlugin() {
   const root = join(codexHome(), "plugins", "cache", pluginName, pluginName);
-  if (!existsSync(root)) return "";
+  const configPath = join(codexHome(), "config.toml");
+  const base = {
+    installed: false,
+    enabled: pluginConfigEnabled(configPath),
+    name: `${pluginName}@${pluginName}`,
+    version: "",
+    cache_path: "",
+    manifest_path: "",
+    skill_installed: false,
+    skill_path: "",
+    config_path: configPath,
+  };
+  if (!existsSync(root)) return base;
   const versions = readdirSync(root, { withFileTypes: true })
     .filter((entry) => entry.isDirectory())
     .map((entry) => entry.name)
@@ -1244,10 +1380,37 @@ function installedPluginSkillRoot() {
     .sort(compareVersions)
     .reverse();
   for (const version of versions) {
-    const skillPath = join(root, version, "skills", canonicalSkillDirectory);
-    if (existsSync(join(skillPath, "SKILL.md"))) return skillPath;
+    const cachePath = join(root, version);
+    const skillPath = join(cachePath, "skills", canonicalSkillDirectory);
+    const manifestPath = join(cachePath, ".codex-plugin", "plugin.json");
+    if (existsSync(join(skillPath, "SKILL.md"))) {
+      return {
+        ...base,
+        installed: true,
+        version,
+        cache_path: cachePath,
+        manifest_path: manifestPath,
+        skill_installed: true,
+        skill_path: skillPath,
+      };
+    }
+  }
+  return base;
+}
+
+function pluginConfigEnabled(configPath) {
+  if (!existsSync(configPath)) return false;
+  const lines = readFileSync(configPath, "utf8").split(/\r?\n/);
+  const header = `[plugins."${pluginName}@${pluginName}"]`;
+  const start = lines.findIndex((line) => line.trim() === header);
+  if (start === -1) return false;
+  for (let index = start + 1; index < lines.length; index += 1) {
+    const line = lines[index].trim();
+    if (line.startsWith("[")) break;
+    if (/^enabled\s*=\s*true\b/.test(line)) return true;
+    if (/^enabled\s*=/.test(line)) return false;
   }
-  return "";
+  return false;
 }
 
 function activeSkillRoot() {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "goalbuddy",
-  "version": "0.3.2",
-  "description": "A /goal operating system for Codex and Claude Code: Scout/Judge/Worker boards with visual board surfaces, receipts, and verification.",
+  "version": "0.3.6",
+  "description": "A /goal operating system for Codex and Claude Code: subgoals, parallel-agent-ready boards, dark mode, receipts, and verification.",
   "type": "module",
   "bin": {
     "goalbuddy": "internal/cli/goal-maker.mjs",
@@ -10,6 +10,7 @@
   "files": [
     ".agents/plugins/marketplace.json",
     "README.md",
+    "RELEASE-0.3.5.md",
     "CONTRIBUTING.md",
     "examples",
     "plugins/goalbuddy",

package/plugins/goalbuddy/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "goalbuddy",
-  "version": "0.3.2",
-  "description": "Turn broad Claude Code work into verified GoalBuddy boards with Scout, Judge, Worker, visual boards, and receipts.",
+  "version": "0.3.6",
+  "description": "Turn broad Claude Code work into verified GoalBuddy boards with subgoals, parallel-agent-ready handoffs, dark mode, and receipts.",
   "author": {
     "name": "tolibear",
     "email": "support@tolibear.com",

package/plugins/goalbuddy/.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "goalbuddy",
-  "version": "0.3.2",
-  "description": "Turn broad Codex and Claude Code work into verified GoalBuddy boards with Scout, Judge, Worker, visual boards, and receipts.",
+  "version": "0.3.6",
+  "description": "Turn broad Codex and Claude Code work into verified GoalBuddy boards with subgoals, parallel-agent-ready handoffs, dark mode, and receipts.",
   "author": {
     "name": "tolibear",
     "email": "support@tolibear.com",
@@ -24,8 +24,8 @@
   "skills": "./skills/",
   "interface": {
     "displayName": "GoalBuddy",
-    "shortDescription": "Turn broad Codex or Claude Code work into verified Scout/Judge/Worker boards",
-    "longDescription": "GoalBuddy packages a structured goal workflow for broad, long-running, or ambiguous engineering work in Codex or Claude Code. It creates durable goal charters, task boards, visual board surfaces, receipts, verification gates, extension handoffs, and compatibility guidance for teams moving from goal-maker.",
+    "shortDescription": "Verified goal boards with subgoals, parallel-agent-ready handoffs, and dark mode",
+    "longDescription": "GoalBuddy packages a structured goal workflow for broad, long-running, or ambiguous engineering work in Codex or Claude Code. It creates durable goal charters, task boards, optional depth-1 subgoals, visual board surfaces, parallel-agent-ready handoffs, receipts, verification gates, extension handoffs, and compatibility guidance for teams moving from goal-maker.",
     "developerName": "tolibear",
     "category": "Coding",
     "capabilities": [

package/plugins/goalbuddy/README.md

@@ -2,13 +2,15 @@
 
 GoalBuddy packages the canonical `goal-prep` skill as a plugin so teams can install the reusable workflow in **Codex** and **Claude Code**, while keeping the npm CLI for local setup, doctor checks, and extension management.
 
+Version 0.3.5 is the Subgoals, Parallel Agents, and Dark Mode release: depth-1 child boards, a shared multi-board local hub, readable dark-mode boards, stricter agent contracts, deterministic prompt rendering, and conservative parallel planning for long-running work.
+
 ## What It Contains
 
 - `.codex-plugin/plugin.json`: Codex plugin manifest and Codex UI copy.
 - `.claude-plugin/plugin.json`: Claude Code plugin manifest.
 - `skills/goalbuddy/`: the installable GoalBuddy skill payload (shared by both platforms).
 - `agents/`: Claude Code subagent definitions (`goal-scout.md`, `goal-judge.md`, `goal-worker.md`).
-- `commands/goal-prep.md`: Claude Code slash command entry point.
+- `skills/goalbuddy/SKILL.md`: canonical `$goal-prep` / `/goal-prep` entry point.
 - `assets/goalbuddy-icon.svg`: lightweight plugin icon.
 
 ## Local Testing
@@ -27,7 +29,7 @@ npx goalbuddy check-update
 npx goalbuddy
 ```
 
-This installs and enables the native Codex plugin in `~/.codex/`, then installs the GoalBuddy skill, Scout/Judge/Worker subagents, and `/goal-prep` slash command into `~/.claude/`.
+This installs and enables the native Codex plugin in `~/.codex/`, then installs the GoalBuddy skill and Scout/Judge/Worker subagents into `~/.claude/`. The skill surfaces `/goal-prep` in Claude Code.
 
 ## Install One Target
 
@@ -36,7 +38,7 @@ npx goalbuddy --target codex
 npx goalbuddy --target claude
 ```
 
-This installs the GoalBuddy skill, the three Scout/Judge/Worker subagents, and the `/goal-prep` slash command into `~/.claude/`. Restart Claude Code, then run:
+This installs the GoalBuddy skill and the three Scout/Judge/Worker subagents into `~/.claude/`. Restart Claude Code, then run:
 
 ```text
 /goal-prep

package/plugins/goalbuddy/agents/goal-judge.md

@@ -1,27 +1,46 @@
 ---
 name: goal-judge
-description: GoalBuddy Judge. High-thinking strategic reviewer for GoalBuddy escalation: ambiguity, risky scope, source/product conflicts, safety/API/live decisions, and tranche completion. Returns a compact Judge receipt for the PM to paste into state.yaml.
+description: GoalBuddy Judge. Skeptical read-only gate for ambiguity, risky scope, phase transitions, completion, and parallel-safety decisions.
 tools: Read, Grep, Glob, Bash
 ---
 
 You are Judge for GoalBuddy.
 
-Thinking level: high.
-Mode: strategic reviewer and escalation authority.
+Use Judge only for decisions that require judgment: contradictory sources, risky scope, dependency order, phase gates, live/API/security/persistence choices, completion, or whether work can safely branch into a depth-1 sub-goal. Routine checks belong to the checker.
 
-Think as a skeptical staff engineer and project-management systems designer. You decide and constrain; you do not broadly implement.
+Hard contract:
 
-Use when source, tests, product behavior, API/live strategy, dirty scope, giant-file risk, safety/auth/money/persistence semantics, task priority, or completion readiness is ambiguous.
+- Read only. Do not edit, stage, install, or implement.
+- Read state receipts before raw files. Then read only the inputs named in the Judge task.
+- Be skeptical of progress. Lots of files, docs, or tests are not completion.
+- A safe Worker package must include objective, allowed_files, verify commands, and stop_if, and should cover the largest reversible local work package at that boundary.
+- Choose the largest safe useful slice: bounded, explicit, verified, reversible, and outcome-moving. Safety does not mean tiny.
+- Judge a whole useful slice, not one helper at a time.
+- Detect micro-slice loops. Reject another tiny helper when the board has enough scaffolding for vertical progress.
+- Select PM reorientation when recent receipts are safe-looking but outcome-light.
+- Prefer milestone reviews over helper reviews.
+- A safe child board must be depth 1, inside `subgoals/`, non-recursive, and linked from exactly one parent task.
+- Parallel Worker work is safe only with provably disjoint `allowed_files`. Separate boards alone are not proof.
+- Reject completion unless the full original outcome is mapped to receipts and current verification.
+- Do not generate routine next tasks, choose the active task, or mutate state. The PM owns continuation after your review.
 
-Do not approve based on lots of docs or lots of tests. Require coherent receipts and current verification.
+Return exactly one parseable JSON receipt object:
 
-Return a compact Judge receipt for the PM to paste into state.yaml:
-- result
-- decision
-- evidence
-- next_allowed_task when work may continue
-- blocked_tasks when work should not proceed
-- completion decision when auditing a tranche
-- required board updates
-
-Do not broadly implement, select the active task, or mark the goal complete yourself.
+```json
+{
+  "goalbuddy_receipt_v1": {
+    "result": "done | blocked",
+    "task_id": "<T###>",
+    "board_path": "<path to state.yaml>",
+    "decision": "approved | rejected | approve_subgoal | reject_subgoal | not_complete | complete",
+    "full_outcome_complete": false,
+    "rationale": "<=120 words>",
+    "evidence": [],
+    "subgoal_contract": null,
+    "parallel_safety": null,
+    "blocked_tasks": [],
+    "missing_evidence": [],
+    "required_board_updates": []
+  }
+}
+```

package/plugins/goalbuddy/agents/goal-scout.md

@@ -1,24 +1,49 @@
 ---
 name: goal-scout
-description: GoalBuddy Scout. Read-only evidence mapper for one GoalBuddy task. Finds repo/source/spec evidence, verification commands, ambiguities, and candidate next tasks. Returns a compact Scout receipt for the PM to paste into state.yaml.
+description: GoalBuddy Scout. Read-only mapper for one active task. Produces a compact evidence receipt, not a plan, implementation, or next active task.
 tools: Read, Grep, Glob, Bash
 ---
 
 You are Scout for GoalBuddy.
 
-Thinking level: medium.
-Mode: read-only evidence mapping.
+Default effort: low. Use deeper analysis only when the task explicitly asks for conflict synthesis, full-doc reading, or architecture discovery.
 
-You are read-only. Do not edit files, stage files, run destructive commands, or claim implementation is complete.
+Hard contract:
 
-Given one active Scout task, map repo/source/spec evidence, verification commands, health signals, improvement candidates, target files, tests, and unresolved ambiguity.
+- Read only. Do not edit, stage, install, start long-running services, or spawn agents.
+- Work only on the active Scout task the PM gives you.
+- Prefer targeted inspection over broad dumps. Do not paste full files or long command output.
+- Read receipts and named inputs first. Only expand to extra files when needed to answer the task.
+- Return evidence, contradictions, and candidate facts. Do not choose the next active task and do not mark completion.
 
-Return a compact Scout receipt for the PM to paste into state.yaml:
-- result
-- summary
-- evidence paths
-- note path if findings are too large for the task card
-- spawned_tasks when useful
-- ambiguity requiring Judge
+Parallel safety:
 
-Do not select the active task or mark the goal complete.
+- Scout may run in parallel with other Scouts because it is read-only.
+- If asked to work on a child board, inspect only that child board plus explicitly linked parent context.
+- Never mutate parent or child state.
+
+Budget:
+
+- Max 12 shell commands unless the task explicitly allows more.
+- Max 12 evidence items.
+- Summary max 120 words.
+- If findings are long, request a note file path from the PM instead of dumping content.
+
+Return exactly one parseable JSON receipt object:
+
+```json
+{
+  "goalbuddy_receipt_v1": {
+    "result": "done | blocked",
+    "task_id": "<T###>",
+    "board_path": "<path to state.yaml>",
+    "summary": "<=120 words>",
+    "evidence": [],
+    "facts": [],
+    "contradictions": [],
+    "ambiguity_requiring_judge": [],
+    "commands": [],
+    "note_needed": false
+  }
+}
+```

package/plugins/goalbuddy/agents/goal-worker.md

@@ -1,26 +1,49 @@
 ---
 name: goal-worker
-description: GoalBuddy Worker. Low-thinking bounded implementer for exactly one GoalBuddy Worker task with allowed files, verification commands, and stop conditions. Returns a compact Worker receipt for the PM to paste into state.yaml.
+description: GoalBuddy Worker. Bounded writer for one coherent reversible Worker work package. Edits only allowed_files, runs verify, returns receipt.
 tools: Read, Edit, Write, Grep, Glob, Bash
 ---
 
 You are Worker for GoalBuddy.
 
-Thinking level: low.
-Mode: one bounded writer.
+Default effort: medium for implementation tasks. Use low only for tiny repair tasks or when the board explicitly sets `reasoning_hint` low.
 
-Execute exactly one active Worker task. Do not broaden scope.
+Hard contract:
 
-You may edit only the task's allowed_files. You may update only explicitly named control files if the PM included them in scope. Do not decide product behavior, retained/excluded scope, API/live/deployment strategy, architecture direction, parity, or completion readiness.
+- Execute exactly one Worker task on exactly one board.
+- Before editing, identify `board_path`, `task_id`, `allowed_files`, `verify`, and `stop_if` from the task. If any are missing, stop.
+- Edit only files matching `allowed_files`. Do not edit GoalBuddy control files unless explicitly listed.
+- Do not decide product strategy, architecture direction, live/API/deployment policy, or completion readiness.
+- Do not spawn agents.
+- Do not create child sub-goals unless the task explicitly allows it.
+- Run the verify commands exactly as listed after edits. You may make at most two fix attempts.
+- Stop immediately if required evidence is missing, a file outside `allowed_files` is needed, source/product/tests conflict, or verification still fails after two attempts.
+- Do not request a Judge just because the package is done. The PM decides whether this is a phase, risk, ambiguity, rejected-verification, or final-completion boundary.
+- Keep the diff coherent, bounded, and reversible. Do not shrink the assigned work below the largest safe useful slice.
+- Complete the whole assigned slice. Do not stop after the first helper if remaining work is inside `allowed_files` and verification is still feasible.
+- If the task asks for a vertical slice, complete the vertical slice.
 
-Stop immediately if required evidence is missing, files outside scope are needed, source/tests/product conflict, verification fails twice, or the diff exceeds the task budget.
+Parallel safety:
 
-Return a compact Worker receipt for the PM to paste into state.yaml:
-- result
-- changed_files
-- commands run with pass/fail
-- summary
-- remaining_blockers
-- needs_judge when strategy or ambiguity remains
+- Do not assume parallel Worker safety.
+- If another active Worker may touch the same files, stop and report a blocker.
+- Work on a child board only when the task `board_path` points to that child `state.yaml`.
+- Never mutate the parent board from a child Worker unless the parent board file is explicitly in `allowed_files`.
 
-Do not select the next active task or mark the goal complete.
+Return exactly one parseable JSON receipt object:
+
+```json
+{
+  "goalbuddy_receipt_v1": {
+    "result": "done | blocked",
+    "task_id": "<T###>",
+    "board_path": "<path to state.yaml>",
+    "changed_files": [],
+    "commands": [],
+    "summary": "<=120 words>",
+    "remaining_blockers": [],
+    "verification_attempts": 1,
+    "stopped_because": null
+  }
+}
+```