Soul-Brews-Studio/auto-retrospective

/auto-retrospective — Configure Auto-Trigger Settings

Manage the auto-scale hook that triggers /rrr and /forward based on context window usage.

CRITICAL: Auto = Silent

When auto-triggered, run /rrr and /forward SILENTLY.

• Do NOT ask the user "should I run /rrr?" — just do it
• Do NOT announce "I'm about to run /rrr" — just do it
• Do NOT prompt for confirmation — the user already opted in by having auto enabled
• Write the retro files quietly, then continue with whatever the user was doing
• If the user notices and asks "why did you do that?" → explain: "Auto-retrospective is enabled. You can disable it with /auto-rrr off"

The whole point is zero distraction. Auto means auto.

The hook (hooks/auto-scale.sh) injects a plain instruction message when a threshold is hit — it does NOT use AskUserQuestion and does NOT prompt the user. When you see an auto-trigger message like 📝 Auto-trigger: context at Xk. Silently run /rrr now..., just invoke the skill and keep working on the user's current request. No confirmation, no announcement.

Usage

/auto-rrr                # Show current status
/auto-rrr on             # Enable auto-triggers
/auto-rrr off            # Disable auto-triggers
/auto-rrr status         # Show thresholds + next triggers
/auto-rrr snooze 30m     # Temporarily disable for 30 minutes
/auto-rrr snooze 1h      # Temporarily disable for 1 hour
/auto-rrr snooze 2h      # Temporarily disable for 2 hours
/auto-rrr rrr:150k       # Set /rrr interval to every 150k tokens
/auto-rrr fwd:200k       # Set /forward interval to every 200k tokens
/auto-rrr rrr:150k fwd:195k  # Set both

How It Works

Auto-scale hook (~/.claude/hooks/auto-scale.sh) runs on every UserPromptSubmit:

1. Reads context usage from /tmp/statusline-raw.json
2. Shows status line: 10:20 | 46k (rrr:150k fwd:195k) | white.local | auto:on
3. At threshold: injects a silent instruction message telling Claude to run /rrr or /forward without asking or announcing
4. Uses flag files per session to avoid re-triggering
5. Snooze flag ($TDIR/claude-auto-scale-snooze) temporarily short-circuits triggers until a unix timestamp — status line shows auto:snoozed

Steps

status (default, no args)

TDIR="${TMPDIR:-${TMP:-${TEMP:-/tmp}}}"
HOOK="$HOME/.claude/hooks/auto-scale.sh"

# Current intervals
grep "RRR_INTERVAL=" "$HOOK" | head -1
grep "FWD_INTERVAL=" "$HOOK" | head -1

# Toggle status
[ -f "$TDIR/claude-auto-scale-off" ] && echo "auto: OFF" || echo "auto: ON"

# Current context
cat "$TDIR/statusline-raw.json" 2>/dev/null | jq -r '"Context: \(.context_window.used_percentage)% (\((.context_window.current_usage | ((.input_tokens//0)+(.cache_creation_input_tokens//0)+(.cache_read_input_tokens//0)+(.output_tokens//0))) / 1000 | floor))k)"'

Display:

Auto-RRR Status:
  /rrr every 150k tokens
  /forward every 195k tokens
  Toggle: ON
  Context: 14% (46k)
  Next /rrr: 150k
  Next /forward: 195k

on

TDIR="${TMPDIR:-${TMP:-${TEMP:-/tmp}}}"
rm -f "$TDIR/claude-auto-scale-off"

off

TDIR="${TMPDIR:-${TMP:-${TEMP:-/tmp}}}"
touch "$TDIR/claude-auto-scale-off"

snooze <duration>

Temporarily disable auto-triggers without fully turning off. Duration supports Nm (minutes) or Nh (hours), e.g. 30m, 1h, 2h. Status line will show auto:snoozed until the snooze expires, then automatically return to auto:on.

TDIR="${TMPDIR:-${TMP:-${TEMP:-/tmp}}}"
DURATION="$1"   # e.g. 30m, 1h, 2h
# Parse duration: 30m=1800, 1h=3600, 2h=7200
case "$DURATION" in
  *m) SECONDS=$((${DURATION%m} * 60)) ;;
  *h) SECONDS=$((${DURATION%h} * 3600)) ;;
  *)  echo "Invalid duration: $DURATION (use Nm or Nh)"; exit 1 ;;
esac
UNTIL=$(($(date +%s) + SECONDS))
echo "$UNTIL" > "$TDIR/claude-auto-scale-snooze"
echo "Snoozed until $(date -d @$UNTIL '+%H:%M')"

To clear an active snooze early:

TDIR="${TMPDIR:-${TMP:-${TEMP:-/tmp}}}"
rm -f "$TDIR/claude-auto-scale-snooze"

rrr:<N>k / fwd:<N>k

Update the interval in the hook script:

HOOK="$HOME/.claude/hooks/auto-scale.sh"
# For rrr:150k
sed -i 's/RRR_INTERVAL=.*/RRR_INTERVAL=150/' "$HOOK"
# For fwd:200k
sed -i 's/FWD_INTERVAL=.*/FWD_INTERVAL=200/' "$HOOK"

Then clear session flags to apply immediately:

TDIR="${TMPDIR:-${TMP:-${TEMP:-/tmp}}}"
rm -f "$TDIR/claude-auto-rrr-"* "$TDIR/claude-auto-fwd-"*

Show updated status after any change.

Hook Location

~/.claude/hooks/auto-scale.sh — registered in ~/.claude/settings.json under UserPromptSubmit.

If hook doesn't exist, tell user to create it or run the setup.

When User Asks "Why Did You Do That?"

If the user notices a retro was written automatically and asks about it:

Auto-retrospective is enabled — it runs /rrr silently when context
reaches the threshold (default: every 150k tokens).

  /auto-rrr off          # disable auto-triggers
  /auto-rrr on           # re-enable
  /auto-rrr snooze 30m   # temporarily mute for 30 minutes
  /auto-rrr rrr:200k     # change threshold
  /auto-rrr status       # see current settings

Never be defensive. Just explain and show the controls.

Default Behavior

• Default: ON (auto, silent)
• Memory consent = auto (from /awaken): auto-rrr is expected
• Memory consent = manual (from /awaken): auto-rrr is OFF until user enables it
• Check CLAUDE.md Demographics table for Memory field

ARGUMENTS: $ARGUMENTS