opencodekit 0.15.0 → 0.15.2

package/dist/index.js

@@ -750,7 +750,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "opencodekit",
-  version: "0.15.0",
+  version: "0.15.2",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
   keywords: ["agents", "cli", "mcp", "opencode", "opencodekit", "template"],
   license: "MIT",
@@ -3762,13 +3762,34 @@ async function editAutoupdate(configPath) {
 
 // src/commands/init.ts
 import { execSync } from "node:child_process";
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync4, readdirSync as readdirSync3, writeFileSync as writeFileSync4 } from "node:fs";
+import {
+  existsSync as existsSync4,
+  mkdirSync as mkdirSync3,
+  readFileSync as readFileSync4,
+  readdirSync as readdirSync3,
+  renameSync,
+  rmSync,
+  writeFileSync as writeFileSync4
+} from "node:fs";
 import { homedir, platform } from "node:os";
 import { basename as basename2, dirname, join as join4 } from "node:path";
 import { fileURLToPath } from "node:url";
 var import_picocolors8 = __toESM(require_picocolors(), 1);
-var EXCLUDED_DIRS = ["node_modules", ".git", "dist", ".DS_Store", "coverage", ".next", ".turbo"];
-var EXCLUDED_FILES = ["bun.lock", "package-lock.json", "yarn.lock", "pnpm-lock.yaml"];
+var EXCLUDED_DIRS = [
+  "node_modules",
+  ".git",
+  "dist",
+  ".DS_Store",
+  "coverage",
+  ".next",
+  ".turbo"
+];
+var EXCLUDED_FILES = [
+  "bun.lock",
+  "package-lock.json",
+  "yarn.lock",
+  "pnpm-lock.yaml"
+];
 function getGlobalConfigDir() {
   const os = platform();
   if (os === "win32") {
@@ -3795,7 +3816,10 @@ function detectMode(targetDir) {
 function getTemplateRoot() {
   const __filename2 = fileURLToPath(import.meta.url);
   const __dirname2 = dirname(__filename2);
-  const possiblePaths = [join4(__dirname2, "template"), join4(__dirname2, "..", "..", ".opencode")];
+  const possiblePaths = [
+    join4(__dirname2, "template"),
+    join4(__dirname2, "..", "..", ".opencode")
+  ];
   for (const path of possiblePaths) {
     const opencodeDir = join4(path, ".opencode");
     if (existsSync4(opencodeDir)) {
@@ -3831,6 +3855,139 @@ async function copyOpenCodeOnly(templateRoot, targetDir) {
   await copyDir(opencodeSrc, opencodeDest);
   return true;
 }
+var MODEL_PRESETS = {
+  free: {
+    model: "opencode/minimax-m2.1-free",
+    agents: {
+      build: "opencode/minimax-m2.1-free",
+      plan: "opencode/minimax-m2.1-free",
+      review: "opencode/minimax-m2.1-free",
+      explore: "opencode/grok-code",
+      general: "opencode/glm-4.7-free",
+      looker: "opencode/gpt-5-nano",
+      vision: "opencode/gpt-5-nano",
+      scout: "opencode/big-pickle"
+    }
+  },
+  recommend: {
+    model: "proxypal/gemini-claude-opus-4-5-thinking",
+    agents: {
+      build: "proxypal/gemini-claude-opus-4-5-thinking",
+      plan: "proxypal/gemini-3-flash-preview",
+      review: "proxypal/gemini-3-pro-preview",
+      explore: "opencode/grok-code",
+      general: "opencode/glm-4.7-free",
+      looker: "proxypal/gemini-3-flash-preview",
+      vision: "proxypal/gemini-3-pro-preview",
+      scout: "proxypal/gemini-claude-sonnet-4-5"
+    }
+  }
+};
+function applyModelPreset(targetDir, preset) {
+  const configPath = join4(targetDir, ".opencode", "opencode.json");
+  if (!existsSync4(configPath))
+    return;
+  const config = JSON.parse(readFileSync4(configPath, "utf-8"));
+  const presetConfig = MODEL_PRESETS[preset];
+  config.model = presetConfig.model;
+  if (config.agent) {
+    for (const [agentName, model] of Object.entries(presetConfig.agents)) {
+      if (config.agent[agentName]) {
+        config.agent[agentName].model = model;
+      }
+    }
+  }
+  writeFileSync4(configPath, JSON.stringify(config, null, 2));
+}
+var AGENT_DESCRIPTIONS = {
+  build: "Main coding agent (complex tasks)",
+  plan: "Planning and design agent",
+  review: "Code review and debugging",
+  explore: "Fast codebase search",
+  general: "Quick, simple tasks",
+  looker: "Image/PDF extraction (cheap)",
+  vision: "Visual analysis (quality)",
+  scout: "External research/docs",
+  compaction: "Context summarization"
+};
+async function promptCustomModels(targetDir) {
+  const configPath = join4(targetDir, ".opencode", "opencode.json");
+  if (!existsSync4(configPath))
+    return;
+  const config = JSON.parse(readFileSync4(configPath, "utf-8"));
+  f2.info(import_picocolors8.default.dim("Enter model IDs (e.g., opencode/grok-code, proxypal/gemini-3-pro-preview)"));
+  f2.info(import_picocolors8.default.dim(`Press Enter to keep current value
+`));
+  const mainModel = await te({
+    message: "Main session model",
+    placeholder: config.model || "opencode/minimax-m2.1-free",
+    defaultValue: config.model
+  });
+  if (lD(mainModel)) {
+    f2.warn("Cancelled - keeping defaults");
+    return;
+  }
+  if (mainModel) {
+    config.model = mainModel;
+  }
+  const agents = Object.keys(AGENT_DESCRIPTIONS);
+  for (const agent of agents) {
+    if (!config.agent?.[agent])
+      continue;
+    const currentModel = config.agent[agent].model || config.model;
+    const agentModel = await te({
+      message: `${agent} - ${AGENT_DESCRIPTIONS[agent]}`,
+      placeholder: currentModel,
+      defaultValue: currentModel
+    });
+    if (lD(agentModel)) {
+      f2.warn("Cancelled - saving partial config");
+      break;
+    }
+    if (agentModel) {
+      config.agent[agent].model = agentModel;
+    }
+  }
+  writeFileSync4(configPath, JSON.stringify(config, null, 2));
+}
+function getAffectedFiles(dir, prefix = "") {
+  if (!existsSync4(dir))
+    return [];
+  const files = [];
+  for (const entry of readdirSync3(dir, { withFileTypes: true })) {
+    if (EXCLUDED_DIRS.includes(entry.name))
+      continue;
+    const path = prefix ? `${prefix}/${entry.name}` : entry.name;
+    if (entry.isDirectory()) {
+      files.push(...getAffectedFiles(join4(dir, entry.name), path));
+    } else {
+      files.push(path);
+    }
+  }
+  return files;
+}
+function backupOpenCode(targetDir) {
+  const opencodeDir = join4(targetDir, ".opencode");
+  if (!existsSync4(opencodeDir))
+    return null;
+  const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
+  const backupDir = join4(targetDir, `.opencode.bak-${timestamp}`);
+  renameSync(opencodeDir, backupDir);
+  return backupDir;
+}
+function getTemplateFiles(templateRoot) {
+  const opencodeSrc = join4(templateRoot, ".opencode");
+  if (!existsSync4(opencodeSrc))
+    return new Set;
+  return new Set(getAffectedFiles(opencodeSrc));
+}
+function findOrphans(targetDir, templateFiles) {
+  const opencodeDir = join4(targetDir, ".opencode");
+  if (!existsSync4(opencodeDir))
+    return [];
+  const existingFiles = getAffectedFiles(opencodeDir);
+  return existingFiles.filter((f3) => !templateFiles.has(f3));
+}
 async function initCommand(options = {}) {
   if (process.argv.includes("--quiet"))
     return;
@@ -3880,6 +4037,47 @@ for all OpenCode projects on this machine.`, "Global Installation Complete");
     $e("Nothing to do");
     return;
   }
+  if (mode === "already-initialized" && options.force) {
+    const opencodeDir2 = join4(targetDir, ".opencode");
+    const affected = getAffectedFiles(opencodeDir2);
+    if (affected.length > 0 && !options.yes) {
+      f2.warn(`${affected.length} files will be overwritten:`);
+      const preview = affected.slice(0, 10);
+      for (const file of preview) {
+        f2.info(import_picocolors8.default.dim(`  .opencode/${file}`));
+      }
+      if (affected.length > 10) {
+        f2.info(import_picocolors8.default.dim(`  ... and ${affected.length - 10} more`));
+      }
+      if (!options.backup) {
+        const shouldBackup = await se({
+          message: "Backup existing .opencode before overwriting?",
+          initialValue: true
+        });
+        if (lD(shouldBackup)) {
+          ue("Cancelled");
+          process.exit(0);
+        }
+        if (shouldBackup) {
+          options.backup = true;
+        }
+      }
+      const proceed = await se({
+        message: options.backup ? "Proceed? (existing config will be backed up)" : "Proceed without backup?",
+        initialValue: options.backup
+      });
+      if (lD(proceed) || !proceed) {
+        ue("Cancelled");
+        process.exit(0);
+      }
+    }
+    if (options.backup) {
+      const backupPath = backupOpenCode(targetDir);
+      if (backupPath) {
+        f2.info(`Backed up to ${import_picocolors8.default.cyan(basename2(backupPath))}`);
+      }
+    }
+  }
   const templateRoot = getTemplateRoot();
   if (!templateRoot) {
     f2.error("Template not found. Please reinstall opencodekit.");
@@ -3915,6 +4113,51 @@ for all OpenCode projects on this machine.`, "Global Installation Complete");
     process.exit(1);
   }
   s.stop("Done");
+  if (options.free) {
+    applyModelPreset(targetDir, "free");
+    f2.info("Applied free model preset");
+  } else if (options.recommend) {
+    applyModelPreset(targetDir, "recommend");
+    f2.info("Applied recommended model preset");
+  } else if (options.yes) {
+    applyModelPreset(targetDir, "free");
+    f2.info("Applied free model preset (default)");
+  } else {
+    const preset = await ie({
+      message: "Choose model preset",
+      options: [
+        {
+          value: "free",
+          label: "Free models",
+          hint: "minimax, glm, grok (no API costs)"
+        },
+        {
+          value: "recommend",
+          label: "Recommended models",
+          hint: "claude-opus, gemini-pro (best quality)"
+        },
+        {
+          value: "custom",
+          label: "Custom",
+          hint: "configure each agent individually"
+        },
+        {
+          value: "skip",
+          label: "Skip",
+          hint: "keep template defaults"
+        }
+      ]
+    });
+    if (!lD(preset)) {
+      if (preset === "custom") {
+        await promptCustomModels(targetDir);
+        f2.info("Applied custom model configuration");
+      } else if (preset !== "skip") {
+        applyModelPreset(targetDir, preset);
+        f2.info(`Applied ${preset} model preset`);
+      }
+    }
+  }
   if (options.beads) {
     const beadsDir = join4(targetDir, ".beads");
     if (!existsSync4(beadsDir)) {
@@ -3936,7 +4179,94 @@ version: 1
       f2.info(".beads/ already exists");
     }
   }
-  le("cd .opencode && bun install", "Next steps");
+  const opencodeDir = join4(targetDir, ".opencode");
+  if (existsSync4(join4(opencodeDir, "package.json"))) {
+    const installSpinner = de();
+    installSpinner.start("Installing dependencies");
+    try {
+      execSync("bun install", { cwd: opencodeDir, stdio: "ignore" });
+      installSpinner.stop("Dependencies installed");
+    } catch {
+      installSpinner.stop("Failed to install (run manually: cd .opencode && bun install)");
+    }
+  }
+  if (mode === "already-initialized" && options.force && !options.backup) {
+    const templateFiles = getTemplateFiles(templateRoot);
+    const orphans = findOrphans(targetDir, templateFiles);
+    if (orphans.length > 0) {
+      f2.warn(`Found ${orphans.length} orphan files not in template`);
+      if (options.pruneAll) {
+        const pruneSpinner = de();
+        pruneSpinner.start("Removing orphan files");
+        for (const orphan of orphans) {
+          rmSync(join4(opencodeDir, orphan));
+        }
+        pruneSpinner.stop(`Removed ${orphans.length} orphan files`);
+      } else if (options.prune) {
+        const selected = await ae({
+          message: "Select orphan files to delete",
+          options: orphans.map((o2) => ({ value: o2, label: o2 })),
+          required: false
+        });
+        if (!lD(selected) && selected.length > 0) {
+          const pruneSpinner = de();
+          pruneSpinner.start("Deleting files");
+          for (const file of selected) {
+            rmSync(join4(opencodeDir, file));
+          }
+          pruneSpinner.stop(`Deleted ${selected.length} files`);
+        }
+      } else if (!options.yes) {
+        const preview = orphans.slice(0, 5);
+        for (const file of preview) {
+          f2.info(import_picocolors8.default.dim(`  .opencode/${file}`));
+        }
+        if (orphans.length > 5) {
+          f2.info(import_picocolors8.default.dim(`  ... and ${orphans.length - 5} more`));
+        }
+        const orphanAction = await ie({
+          message: "How to handle orphan files?",
+          options: [
+            { value: "keep", label: "Keep all", hint: "leave orphan files" },
+            {
+              value: "select",
+              label: "Select",
+              hint: "choose which to delete"
+            },
+            {
+              value: "delete",
+              label: "Delete all",
+              hint: "remove all orphans"
+            }
+          ]
+        });
+        if (!lD(orphanAction)) {
+          if (orphanAction === "delete") {
+            const pruneSpinner = de();
+            pruneSpinner.start("Removing orphan files");
+            for (const orphan of orphans) {
+              rmSync(join4(opencodeDir, orphan));
+            }
+            pruneSpinner.stop(`Removed ${orphans.length} orphan files`);
+          } else if (orphanAction === "select") {
+            const selected = await ae({
+              message: "Select orphan files to delete",
+              options: orphans.map((o2) => ({ value: o2, label: o2 })),
+              required: false
+            });
+            if (!lD(selected) && selected.length > 0) {
+              const pruneSpinner = de();
+              pruneSpinner.start("Deleting files");
+              for (const file of selected) {
+                rmSync(join4(opencodeDir, file));
+              }
+              pruneSpinner.stop(`Deleted ${selected.length} files`);
+            }
+          }
+        }
+      }
+    }
+  }
   $e(import_picocolors8.default.green("Ready to code!"));
 }
 
@@ -3946,7 +4276,7 @@ import { basename as basename4, join as join7 } from "node:path";
 var import_picocolors11 = __toESM(require_picocolors(), 1);
 
 // src/commands/skill.ts
-import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync5, readdirSync as readdirSync4, rmSync, writeFileSync as writeFileSync5 } from "node:fs";
+import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync5, readdirSync as readdirSync4, rmSync as rmSync2, writeFileSync as writeFileSync5 } from "node:fs";
 import { basename as basename3, join as join5 } from "node:path";
 var import_picocolors9 = __toESM(require_picocolors(), 1);
 async function skillCommand(action) {
@@ -4228,7 +4558,7 @@ async function removeSkill(skillDir, skillNameArg) {
     ue("Cancelled");
     return;
   }
-  rmSync(skill.path, { recursive: true, force: true });
+  rmSync2(skill.path, { recursive: true, force: true });
   f2.success(`Removed skill "${skill.name}"`);
 }
 
@@ -4239,7 +4569,7 @@ import {
   mkdirSync as mkdirSync5,
   readFileSync as readFileSync6,
   readdirSync as readdirSync5,
-  rmSync as rmSync2,
+  rmSync as rmSync3,
   writeFileSync as writeFileSync6
 } from "node:fs";
 import { dirname as dirname2, join as join6 } from "node:path";
@@ -4453,36 +4783,42 @@ async function upgradeCommand(options = {}) {
   });
   if (orphans.length > 0) {
     f2.info(`${import_picocolors10.default.yellow(orphans.length.toString())} files found that are not in the template (orphans).`);
-    if (options.prune) {
+    if (options.pruneAll) {
       const s2 = de();
       s2.start("Pruning orphans");
       for (const orphan of orphans) {
-        rmSync2(join6(opencodeDir, orphan));
+        rmSync3(join6(opencodeDir, orphan));
       }
       s2.stop(`Removed ${orphans.length} files`);
-    } else {
-      const shouldPrune = await se({
-        message: "Do you want to review and delete them?",
-        initialValue: false
+    } else if (options.prune) {
+      const selected = await ae({
+        message: "Select files to delete",
+        options: orphans.map((o2) => ({ value: o2, label: o2 })),
+        required: false
       });
-      if (!lD(shouldPrune) && shouldPrune) {
-        const selected = await ae({
-          message: "Select files to delete",
-          options: orphans.map((o2) => ({ value: o2, label: o2 })),
-          required: false
-        });
-        if (!lD(selected) && selected.length > 0) {
-          const s2 = de();
-          s2.start("Deleting files");
-          for (const file of selected) {
-            rmSync2(join6(opencodeDir, file));
-          }
-          s2.stop(`Deleted ${selected.length} files`);
+      if (!lD(selected) && selected.length > 0) {
+        const s2 = de();
+        s2.start("Deleting files");
+        for (const file of selected) {
+          rmSync3(join6(opencodeDir, file));
         }
+        s2.stop(`Deleted ${selected.length} files`);
       }
+    } else {
+      f2.info(`Run with ${import_picocolors10.default.cyan("--prune")} to select files or ${import_picocolors10.default.cyan("--prune-all")} to delete all`);
+    }
+  }
+  if (existsSync6(join6(opencodeDir, "package.json"))) {
+    const installSpinner = de();
+    installSpinner.start("Installing dependencies");
+    try {
+      const { execSync: execSync2 } = await import("node:child_process");
+      execSync2("bun install", { cwd: opencodeDir, stdio: "ignore" });
+      installSpinner.stop("Dependencies installed");
+    } catch {
+      installSpinner.stop("Failed to install (run manually: cd .opencode && bun install)");
     }
   }
-  le("cd .opencode && bun install", "Run if dependencies changed");
   $e(import_picocolors10.default.green(`Upgraded to ${versionInfo.latest}`));
 }
 
@@ -6087,7 +6423,7 @@ var cli = cac("ock");
 cli.option("--verbose", "Enable verbose logging");
 cli.option("--quiet", "Suppress all output");
 cli.version(`${packageVersion}`);
-cli.command("init", "Initialize OpenCodeKit in current directory").option("--force", "Reinitialize even if already exists").option("--beads", "Also initialize .beads/ for multi-agent coordination").option("--global", "Install to global OpenCode config (~/.config/opencode/)").action(initCommand);
+cli.command("init", "Initialize OpenCodeKit in current directory").option("--force", "Reinitialize even if already exists").option("--beads", "Also initialize .beads/ for multi-agent coordination").option("--global", "Install to global OpenCode config (~/.config/opencode/)").option("--free", "Use free models (default)").option("--recommend", "Use recommended premium models").option("-y, --yes", "Skip prompts, use defaults (for CI)").option("--backup", "Backup existing .opencode before overwriting").option("--prune", "Manually select orphan files to delete").option("--prune-all", "Auto-delete all orphan files").action(initCommand);
 cli.command("agent [action]", "Manage agents (list, add, view)").action(async (action) => {
   if (!action) {
     console.log(`
@@ -6137,7 +6473,7 @@ cli.command("status", "Show project overview").action(statusCommand);
 cli.command("config [action]", "Edit opencode.json (model, mcp, permission, validate, show)").action(async (action) => {
   await configCommand(action);
 });
-cli.command("upgrade", "Update .opencode/ templates to latest version").option("--force", "Force upgrade even if already up to date").option("--check", "Check for updates without upgrading").action(async (options) => {
+cli.command("upgrade", "Update .opencode/ templates to latest version").option("--force", "Force upgrade even if already up to date").option("--check", "Check for updates without upgrading").option("--prune", "Manually select orphan files to delete").option("--prune-all", "Auto-delete all orphan files").action(async (options) => {
   await upgradeCommand(options);
 });
 cli.command("completion [shell]", "Generate shell completion script (bash, zsh, fish)").action(async (shell) => {

package/dist/template/.opencode/README.md

@@ -119,7 +119,7 @@ GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json
 
 **Core:** brainstorming, writing-plans, executing-plans, verification-before-completion, using-superpowers, finishing-a-development-branch
 **Code:** requesting-code-review, receiving-code-review, root-cause-tracing, test-driven-development, testing-anti-patterns, condition-based-waiting, defense-in-depth, systematic-debugging
-**UI/UX:** frontend-aesthetics, mockup-to-code, visual-analysis, ui-ux-research, accessibility-audit, design-system-audit
+**UI/UX:** frontend-design, mockup-to-code, visual-analysis, ui-ux-research, accessibility-audit, design-system-audit
 **Workflow:** gemini-large-context, subagent-driven-development, dispatching-parallel-agents, using-git-worktrees, sharing-skills, writing-skills, testing-skills-with-subagents
 
 **Note:** Skills load via native `skill()` tool. Commands auto-load relevant expertise.

package/dist/template/.opencode/agent/vision.md

@@ -65,9 +65,9 @@ Comprehensive analysis with actionable recommendations.
 **Use when:** Design review, accessibility audit, system consistency check
 **Skills:** Combine multiple skills based on task:
 
-- **UI/UX Review**: Primary `ui-ux-research`, supporting `frontend-aesthetics`
+- **UI/UX Review**: Primary `ui-ux-research`, supporting `frontend-design`
 - **Accessibility**: Primary `accessibility-audit`, supporting `visual-analysis`
-- **Design System**: Primary `design-system-audit`, supporting `frontend-aesthetics`
+- **Design System**: Primary `design-system-audit`, supporting `frontend-design`
 - **Mockup Analysis**: Primary `mockup-to-code`, supporting `visual-analysis`
 
 ```
@@ -99,7 +99,7 @@ Load skill(s) → Systematic analysis → Structured findings → Recommendation
 - "Check accessibility" → `accessibility-audit`
 - "Audit our design system" → `design-system-audit`
 - "Convert this design to code" → `mockup-to-code`
-- "Is this too AI-looking?" → `frontend-aesthetics`
+- "Is this too AI-looking?" → `frontend-design`
 - "Deep UI/UX analysis" → `ui-ux-research`
 
 ## Output Format
@@ -144,4 +144,4 @@ When reviewing designs, actively identify these AI-slop patterns:
 - Excessive rounded corners on everything
 - Glassmorphism without purpose
 
-**Alternative directions** are covered in `frontend-aesthetics` skill.
+**Alternative directions** are covered in `frontend-design` skill.

package/dist/template/.opencode/command/agent-browser.md

@@ -0,0 +1,21 @@
+---
+description: Automate browser tasks (scraping, form filling, web interaction)
+argument-hint: "[what you want to do in the browser]"
+agent: general
+---
+
+# Agent Browser: $ARGUMENTS
+
+Automate browser tasks using agent-browser CLI.
+
+## Load Skill
+
+```typescript
+skill({ name: "agent-browser" });
+```
+
+Then follow the skill instructions to help with browser automation.
+
+<user-request>
+$ARGUMENTS
+</user-request>

package/dist/template/.opencode/command/complete-next-task.md

@@ -0,0 +1,77 @@
+---
+description: Complete the next incomplete PRD task for a bead
+argument-hint: "<bead-id>"
+agent: build
+---
+
+# Complete Next Task: $ARGUMENTS
+
+Complete one task from a bead PRD task list.
+
+This command is **Beads-native**:
+
+- PRD: `.beads/artifacts/<bead-id>/prd.md`
+- Tasks: `.beads/artifacts/<bead-id>/prd.json`
+- Progress: `.beads/artifacts/<bead-id>/progress.txt`
+
+## Preconditions
+
+- A bead exists: `bd show $ARGUMENTS`
+- PRD task list exists:
+
+```bash
+ls ".beads/artifacts/$ARGUMENTS/prd.json"
+```
+
+If missing:
+
+- Create PRD: `.beads/artifacts/$ARGUMENTS/prd.md` (use `skill({ name: "prd" })`)
+- Convert: `skill({ name: "prd-task" })`
+
+## Process
+
+### 1) Get Bearings
+
+- Read `.beads/artifacts/$ARGUMENTS/progress.txt` (create if missing)
+- Read `.beads/artifacts/$ARGUMENTS/prd.json`
+- Pick the next task with `passes: false`
+
+### 2) Implement the Task
+
+Implement only what’s needed to satisfy the verification steps.
+
+### 3) Run Feedback Loops (Required)
+
+Run what applies to the repo:
+
+- tests
+- lint
+- typecheck
+
+Do not commit if any fail.
+
+### 4) Update PRD JSON
+
+Set that task’s `passes` to `true`.
+
+### 5) Update Progress Log
+
+Append a short entry to `.beads/artifacts/$ARGUMENTS/progress.txt`:
+
+```markdown
+## Task - <task.id>
+
+- What was implemented
+- Files changed
+- Learnings / patterns
+```
+
+### 6) Commit (Ask First)
+
+Show staged changes and ask user before committing.
+
+## Completion
+
+If all tasks have `passes: true`, report that the PRD is complete and recommend:
+
+- `/finish $ARGUMENTS`