opencodekit 0.20.2 → 0.20.4

package/dist/template/.opencode/command/ship.md

@@ -8,9 +8,9 @@ agent: build
 
 Execute PRD tasks, verify each passes, run review, close the bead.
 
-> **Workflow:** `/create` → `/start <id>` → **`/ship <id>`**
+> **Workflow:** `/create` → **`/ship <id>`**
 >
-> Bead MUST be `in_progress` with `prd.md`. Run `/start` first if not.
+> Bead MUST have `prd.md`. If not yet claimed, `/ship` auto-claims it.
 
 ## Load Skills
 
@@ -48,19 +48,84 @@ skill({ name: "verification-before-completion" });
 
 ## Phase 1: Guards
 
+### Memory Grounding
+
+Search memory for context, prior decisions, and known issues before executing:
+
+```typescript
+memory-search({ query: "$ARGUMENTS" });
+memory-search({ query: "<bead title keywords>", limit: 5 });
+memory-read({ file: "handoffs/last" });
+```
+
+Use findings to avoid re-discovering known issues or repeating failed approaches.
+
+### Bead Validation
+
 ```bash
 br show $ARGUMENTS
 ```
 
 Verify:
 
-- Bead status is `in_progress` (if not, tell user to run `/start $ARGUMENTS`)
+- Bead is `in_progress` or unclaimed (auto-claim if needed)
 - `.beads/artifacts/$ARGUMENTS/prd.md` exists (if not, tell user to run `/create` first)
 
 Check what artifacts exist:
 
 Read `.beads/artifacts/$ARGUMENTS/` to check what artifacts exist.
 
+## Phase 1B: Auto-Claim (if not yet in_progress)
+
+If bead status is NOT `in_progress`, auto-claim it:
+
+```bash
+br update $ARGUMENTS --status in_progress
+```
+
+Then ask about workspace:
+
+```typescript
+question({
+  questions: [
+    {
+      header: "Workspace",
+      question: "How do you want to set up the workspace?",
+      options: [
+        {
+          label: "Create feature branch (Recommended)",
+          description: "git checkout -b feat/<bead-id>-<title>",
+        },
+        {
+          label: "Use current branch",
+          description: "Work on current branch",
+        },
+      ],
+    },
+  ],
+});
+```
+
+**If feature branch selected:**
+
+Map bead type to branch prefix:
+
+| Bead Type | Branch Prefix |
+| --------- | ------------- |
+| feature   | feat          |
+| bug       | fix           |
+| task      | task          |
+| epic      | epic          |
+
+```bash
+# Example: feat/br-42-add-auth
+git checkout -b $PREFIX/$BEAD_ID-$TITLE_SLUG
+```
+
+**If current branch:** Continue without branch creation.
+
+**If bead is already `in_progress`:** Skip this phase entirely.
+
 ## Phase 2: Route to Execution
 
 | Artifact exists | Action                                                   |
@@ -333,8 +398,7 @@ Report:
 
 ## Related Commands
 
-| Need        | Command       |
-| ----------- | ------------- |
-| Create spec | `/create`     |
-| Claim task  | `/start <id>` |
-| Create PR   | `/pr`         |
+| Need        | Command   |
+| ----------- | --------- |
+| Create spec | `/create` |
+| Create PR   | `/pr`     |

package/dist/template/.opencode/command/status.md

@@ -99,7 +99,7 @@ Based on gathered state, recommend ONE next step:
 | State                        | Suggestion                    |
 | ---------------------------- | ----------------------------- |
 | Has in_progress tasks        | `/ship <id>` (continue work)  |
-| Has ready tasks, none active | `/start <id>` (pick up work)  |
+| Has ready tasks, none active | `/ship <id>` (pick up work)   |
 | Uncommitted changes          | Review and commit             |
 | Nothing active or ready      | `/create "<desc>"` (new work) |
 

package/dist/template/.opencode/command/ui-review.md

@@ -88,5 +88,4 @@ observation({
 | Need                 | Command   |
 | -------------------- | --------- |
 | Design from scratch  | `/design` |
-| Start implementation | `/start`  |
 | Ship implementation  | `/ship`   |

package/dist/template/.opencode/command/ui-slop-check.md

@@ -143,4 +143,4 @@ observation({
 | ---------------------------------------- | ------------ |
 | Design from scratch                      | `/design`    |
 | Full UI review (single screen/component) | `/ui-review` |
-| Implementation work                      | `/start`     |
+| Implementation work                      | `/ship`      |

package/dist/template/.opencode/command/verify.md

@@ -149,7 +149,17 @@ Output:
 5. **Blocking issues** to fix before shipping
 6. **Next step**: `/ship $ARGUMENTS` if ready, or list fixes needed
 
-Record significant findings with `observation()`.
+Record significant findings with `observation()`:
+
+```typescript
+observation({
+  type: "discovery", // or "warning", "bugfix"
+  title: "Verify: [bead-id] [key finding]",
+  narrative: "[What was found, impact, resolution]",
+  concepts: "verification, [component]",
+  confidence: "high",
+});
+```
 
 ## Related Commands