opencodekit 0.12.2 → 0.12.4

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

@@ -1,321 +1,144 @@
 ---
-description: Create handoff for next session - save state with repo provenance
+description: Create handoff for next session - save progress and context
 argument-hint: "<bead-id> [instructions]"
 agent: build
 ---
 
-# Handoff
+# Handoff: $ARGUMENTS
 
-**Load skills:**
+You're pausing work on a task. Save state so the next session can pick up cleanly.
 
-```typescript
-skill({ name: "beads" }); // Session protocol
-skill({ name: "verification-before-completion" });
-```
-
-## Phase 1: Check Messages
+## Why Handoff?
 
-Check for any messages that might affect handoff:
+- Context window getting full
+- Hit budget limit
+- Blocked on something external
+- End of work session
+- Switching to different task
 
-```typescript
-bd_inbox({ n: 5, unread: true, global: true });
-```
+Don't grind past diminishing returns. A clean handoff beats degraded output.
 
-## Phase 2: Release Locks
+## Gather State
 
-Release any file reservations you hold:
+Get current task status:
 
-```typescript
-bd_release({ _: true });
+```bash
+bd show $ARGUMENTS
 ```
 
-## Phase 3: Gather State
-
-```typescript
-bd_show({ id: "$ARGUMENTS" });
-```
+Get git state:
 
 ```bash
-# Git state
-git remote get-url origin 2>/dev/null
+git remote get-url origin 2>/dev/null || echo "No remote"
 git branch --show-current
-git rev-parse HEAD
+git rev-parse --short HEAD
 git status --porcelain
-
-# Uncommitted changes
-git diff --stat
 ```
 
-## Phase 4: Verify Artifacts
-
-Check what artifacts exist and are valid:
+Check what artifacts exist:
 
 ```bash
-ls -la .beads/artifacts/<bead-id>/ 2>/dev/null
-```
-
-For each artifact, verify it's not empty:
-
-```bash
-wc -l .beads/artifacts/<bead-id>/spec.md 2>/dev/null
-wc -l .beads/artifacts/<bead-id>/research.md 2>/dev/null
-wc -l .beads/artifacts/<bead-id>/plan.md 2>/dev/null
-```
-
-```
-Artifact Check:
-━━━━━━━━━━━━━━
-
-- spec.md: [exists/missing] ([N] lines)
-- research.md: [exists/missing] ([N] lines)
-- plan.md: [exists/missing] ([N] lines)
-- review.md: [exists/missing] ([N] lines)
+ls .beads/artifacts/$ARGUMENTS/ 2>/dev/null || echo "No artifacts yet"
 ```
 
-## Phase 5: Commit WIP (if needed)
+## Commit Work In Progress
 
-If uncommitted changes exist:
+If you have uncommitted changes, commit them:
 
 ```bash
 git add -A
-git commit -m "WIP: <bead-id> - [current step]"
+git commit -m "WIP: $ARGUMENTS - [where you stopped]"
 ```
 
-## Phase 6: Calculate Session Stats
-
-Track estimation accuracy:
+Don't leave uncommitted work. The next session needs a clean starting point.
 
-```
-Session Stats:
-━━━━━━━━━━━━━━
+## Create The Handoff
 
-Estimate: [S/M/L] (~[N] tool calls)
-Actual: [N] tool calls
-Variance: [+/-N%]
-
-Progress: [N]% complete
-Time in session: [estimated duration]
+```bash
+mkdir -p .beads/artifacts/$ARGUMENTS/handoffs
 ```
 
-## Phase 7: Create Handoff
-
-Write `.beads/artifacts/<bead-id>/handoffs/<timestamp>.md`:
+Write `.beads/artifacts/$ARGUMENTS/handoffs/$(date +%Y%m%d-%H%M).md`:
 
 ```markdown
-# Handoff: <bead-id>
-
-**Created:** <ISO timestamp>
-**Agent:** build
-
-## Provenance
-
-| Field  | Value            |
-| ------ | ---------------- |
-| Repo   | [git remote URL] |
-| Branch | [branch name]    |
-| Commit | [commit hash]    |
-| Clean  | [yes/no]         |
-
-## Session Stats
-
-| Metric   | Value         |
-| -------- | ------------- |
-| Estimate | [S/M/L]       |
-| Budget   | ~[N] calls    |
-| Actual   | [N] calls     |
-| Variance | [+/-N%]       |
-| Progress | [N]% complete |
-
-## Session Context
-
-**Current Session:** [session ID]
-
-Next session can load context with:
-```
-
-read_session("last", project="current")
-
-```
-
-## Bead State
+# Handoff: $ARGUMENTS
 
-| Field    | Value      |
-| -------- | ---------- |
-| ID       | <bead-id>  |
-| Title    | [title]    |
-| Status   | [status]   |
-| Priority | [priority] |
+**Created:** [timestamp]
+**Branch:** [branch]
+**Commit:** [hash]
 
 ## Progress
 
-### Completed
+What's done:
 
-- [x] [Step/task completed]
-- [x] [Step/task completed]
+- [completed step]
+- [completed step]
 
-### In Progress
+What's in progress:
 
-- [ ] [Current step] - [where stopped, what's next]
+- [current step] - stopped here because [reason]
 
-### Remaining
+What's remaining:
 
-- [ ] [Step not started]
-- [ ] [Step not started]
+- [next step]
+- [future step]
 
 ## Context
 
-### Key Files
+Key files touched:
 
-| File              | Relevance        |
-| ----------------- | ---------------- |
-| `src/foo.ts:42`   | [why relevant]   |
-| `src/bar.ts`      | [why relevant]   |
+- `src/foo.ts` - [what was changed]
+- `src/bar.ts` - [what was changed]
 
-### Decisions Made
+Decisions made:
 
-- [Decision 1] - [reason]
-- [Decision 2] - [reason]
+- [decision]: [why]
 
-### Blockers/Issues
+## Blockers
 
-- [Issue 1] - [status: resolved/pending/blocked]
-
-## Lessons Learned
-
-### What Went Well
-
-- [Thing that worked smoothly]
-
-### What Was Harder Than Expected
-
-- [Challenge encountered]
-- [Why it was harder]
-
-### Patterns Discovered
-
-- [Pattern worth remembering]
+[If any blockers, list them. Otherwise "None"]
 
 ## Resume Instructions
 
-[Specific instructions for next session]
-
 1. [First thing to do]
 2. [Second thing to do]
 3. [Third thing to do]
 
-**Recommended:** Start next session with `/resume <bead-id>`
-
-## Artifacts
-
-| Artifact     | Status  | Lines |
-| ------------ | ------- | ----- |
-| spec.md      | [✓/✗]   | [N]   |
-| research.md  | [✓/✗]   | [N]   |
-| plan.md      | [✓/✗]   | [N]   |
-| review.md    | [✓/✗]   | [N]   |
+Start next session with: `/resume $ARGUMENTS`
 ```
 
-## Phase 8: Create Observation (if notable learnings)
-
-If session revealed patterns or gotchas:
+## Sync State
 
 ```typescript
-observation({
-  type: "learning",
-  title: "Session learning: [topic]",
-  content: `
-## What Happened
-[Brief description]
-
-## Lesson
-[What we learned]
-
-## Application
-[When to apply this learning]
-  `,
-  concepts: "[keywords]",
-  bead_id: "<bead-id>",
-});
+bd_sync();
 ```
 
-## Phase 9: Update Memory (if gotchas found)
+This commits the handoff and pushes to remote.
 
-If you discovered issues worth remembering:
+## Output
 
-```typescript
-memory -
-  update({
-    file: "project/gotchas",
-    content: `
-## [Gotcha Title]
-
-**Symptom:** [What you see]
-**Cause:** [Root cause]
-**Fix:** [How to resolve]
-  `,
-    mode: "append",
-  });
 ```
+Handoff: $ARGUMENTS
 
-## Phase 10: Notify Blockers (if any)
-
-If there are blockers for next session:
+Branch: [branch]
+Commit: [hash]
+Progress: [X]% complete
+Saved: .beads/artifacts/$ARGUMENTS/handoffs/[timestamp].md
 
-```typescript
-bd_msg({
-  subj: "Handoff: <bead-id> - Blocked",
-  body: `
-Blockers:
-- [Blocker 1]
-- [Blocker 2]
-
-Needs: [what's required to unblock]
-  `,
-  to: "all",
-  importance: "high",
-  global: true,
-});
+Next session: /resume $ARGUMENTS
 ```
 
-## Phase 11: Update Bead & Sync
+## Record Learnings (If Any)
+
+If you discovered something worth remembering:
 
 ```typescript
-bd_msg({
-  subj: "Handoff created",
-  body: "Progress: [N]%\nNext: [what needs to happen]",
-  to: "all",
-  importance: "normal",
-  global: false,
+observation({
+  type: "learning",
+  title: "[what you learned]",
+  content: "[details]",
+  bead_id: "$ARGUMENTS",
 });
-
-bd_sync({ reason: "Handoff created for $ARGUMENTS" });
-```
-
-## Output
-
 ```
-Handoff Created: <bead-id>
-━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Commit: [hash]
-Branch: [branch]
-Progress: [N]% complete
-
-Session Stats:
-- Estimate: [S/M/L] (~[N] calls)
-- Actual: [N] calls
-- Variance: [+/-N%]
 
-Artifacts verified: [N]/[N]
-Saved: .beads/artifacts/<bead-id>/handoffs/<timestamp>.md
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━
-To continue: /resume <bead-id>
-━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-The handoff is saved. Start a fresh session for best performance.
-
-Next session will auto-load:
-- This handoff document
-- Previous session context via read_session("last")
-```
+Start fresh session for best performance. Context accumulation degrades output quality.