Research & Context

/catchup

Use when returning to work after any break — auto-detects depth. Short break (hours): reads only uncommitted changes. Long break (48h+) or context overflow: reads all branch changes vs main. Covers catchup, context recovery, refresh, rebuild understanding. NOT for: mid-task exploration (use Read/Grep directly).

$ golems-cli skills install catchup
Good
90% best pass rate
10 assertions
3 evals

Updated 2 weeks ago

Auto-detects break length and adjusts depth. Short break = uncommitted changes only. Long break = full branch diff vs main.

When to Use

  • Returning after ANY break (hours or days)
  • Context window overflow — need to rebuild understanding
  • Before committing — review what's staged
  • Reviewing what's been done on a feature branch

Auto-Detect Mode

Check both signals to pick the right mode:

# 1. Check uncommitted changes
git status --short
 
# 2. Check branch commit count
git log --oneline main...HEAD 2>/dev/null | wc -l
Uncommitted changes?Branch commits?Mode
YesFew (0-3)Quick — read uncommitted only
NoMany (4+)Full — read all branch changes
YesMany (4+)Full — read everything
NoNoneNothing to catch up on

User can override: /catchup quick or /catchup full


Quick Mode (short break, uncommitted changes)

Step 1: Get Status

git status --short

Status codes:

  • M — Modified (staged)
  • M — Modified (unstaged)
  • MM — Modified (both)
  • A — Added (staged)
  • ?? — Untracked

Step 2: Read Modified Files

Read only files with M status. Skip untracked (??) unless relevant.

Step 3: Quick Summary

  • Files currently being edited
  • What changes are in progress
  • Ready to continue or need clarification