start-leftover

Files (1)

• SKILL.md

SKILL.md (first lines)

# Start Leftover

Picks open entries from `planning/leftover-tasks.md`, lets the user choose one or a batch to work on, and spawns a clean Claude session focused on just those items. The original session keeps its context untouched.

## When to use

- User wants to address a previously-deferred follow-up
- "What's parked?" / "let's clear some leftovers" / "tackle that auth refactor we noted"
- After `context-gate` writes a handover, user wants to tackle one parked item rather than resume the main thread

## Steps

### 1. Locate and read

```bash
repo_root=$(git rev-parse --show-toplevel 2>/dev/null) || repo_root="$PWD"
target="$repo_root/planning/leftover-tasks.md"
```

If `target` doesn't exist, tell the user there are no leftovers to start from and stop. Don't auto-scaffold here — there's nothing to scaffold for.

### 2. Parse open entries

Each entry begins with `## YYYY-MM-DD HH:MM — <summary>`. Read the file and extract entries where `Status: open`. Skip `in-progress` and `done`.

If zero open entries, print:

```
No open leftovers in planning/leftover-tasks.md. ✓
```

### 3. Present the list

Show open entries newest-first by capture timestamp:

```
Open leftovers (4):

1. 2026-04-27 18:53 — Refactor auth middleware to drop legacy session-token path
   Scope: medium  |  Captured 2h ago

2. 2026-04-26 14:10 — Investigate flaky CI run on linter step
   Scope: small  |  Captured 1d ago

3. 2026-04-25 09:30 — Add OG images to blog posts
   Scope: medium  |  Captured 2d ago

4. 2026-04-23 16:45 — Migrate utils.py to typed module structure
   Scope: large  |  Captured 4d ago
```

### 4. User picks

Ask:

> Pick one or more (e.g. `1`, `1,3`, or `all`). Or `cancel`.

- Single number → one task focus
- Comma-list → batch mode
- `all` → batch all opens
- `cancel` → exit cleanly

### 5. Mark in-progress

For each picked entry, change `**Status:** open` → `**Status:** in-progress` in the file. Append a marker line:

```
- **Started:** 2026-04-27 21:05 (session: <new-session-id-or-cwd-marker>)
```

This way the original session knows what's been claimed.

### 6. Build a focused-session prompt

Construct an initial message for the new session that includes:

- Which leftover(s) to tackle (full entry text from the file)
- The original repo context (path, branch)
- A one-line directive: "Tackle the items below. When complete, mark each as `Status: done` in `planning/leftover-tasks.md` and append a one-line outcome note."

Example payload:

```
Continue from these parked items in this repo:

[paste the full markdown entry blocks here]

Repo: /home/user/repos/myproject
Branch: main

When you finish each, mark `Status: done` in planning/leftover-tasks.md and append a one-line outcome below the entry. If any item turns out larger than the estimated scope, ask before continuing.
```

### 7. Spawn

Delegate to `new-claude-here` (same plugin) with the message pre-loaded. Default form:

```bash
# in a new Konsole window at $repo_root, opens claude with -m "<the payload>"
```

If `new-claude-here` isn't available or the user prefers manual launch, print the command + payload and let the user run it.

### 8. Return

Print one summary line in the original session:

```
✓ Started: "Refactor auth middleware..." in new session (1 picked, 3 still open)
```

## Batch behaviour

If the user picked multiple items, the new session gets all picked entries in one prompt. Tell it to handle them sequentially. The original session's `leftover-tasks.md` reflects all picked items as `in-progress`.

## Cleanup after completion

The new session is responsible for marking `Status: done` and appending an outcome line per task. If the user reports "I finished those" in the original session and the file still shows in-progress, offer to update it from this side — but the new session should normally do it.

From danielrosehill/Claude-Hopper, MIT.

More from danielrosehill/Claude-Hopper