haacked/dotfiles/followup

Follow-ups

Mid-session capture for things that must not fall through the cracks. Items live in one central file and resurface via the SessionStart hook (followup-detect.sh) and /standup.

The file

~/dev/haacked/notes/PostHog/Followups.md — ## Open and ## Archive sections, newest first, one line per item, never hard-wrapped:

-[ ] 2026-08-14 · [PostHog/posthog · haacked/flags-foo] Check p99 after canary rollout ([PR #37211](https://github.com/PostHog/posthog/pull/37211), `rust/feature-flags/src/lib.rs:412`)

- [ ] open, - [x] done, - [-] dropped. Closed items carry a — closed YYYY-MM-DD or — dropped YYYY-MM-DD suffix; the marker is always the final such fragment at the end of the line, since item text may contain its own em dashes. scripts/followup-open.sh [org/repo] prints open items — the single owner of open-item selection. Non-GitHub contexts use [no-repo].

Modes

Parse the first argument from user input. A keyword selects a mode only when the input reads as that command — bare list/review, or done/drop plus short match text. Text that reads as a task to remember ("review the flag cleanup PR") is add-mode text; prefer add when unsure, since a stray capture is visible and cheap.

Add mode (default)

Speed is the point: one script call, at most one Edit, done.

1. Run the helper with the follow-up text:

scripts/followup-add.sh "<text>"

Pass the text as one quoted argument. It inserts the item at the top of ## Open (creating the file when missing) and prints a capture summary.

1. If the conversation has an obvious source the text doesn't already carry — the PR under discussion, a file:line — weave it into the just-added line as a markdown link with one Edit. Skip this when nothing obvious exists; never research to find a link.

1. Relay the script's summary to the user. If the script errors, surface the error — never report a capture that didn't land.

List mode

Run followup-open.sh and print its output grouped: current repo first (derive org/repo from git remote get-url origin), then the rest, each with its age in days. No file changes.

Done / drop mode

1. Find open lines matching <match> (case-insensitive substring over followup-open.sh output).
2. Exactly one match: flip - [ ] to - [x] (done) or - [-] (drop) in place and append — closed YYYY-MM-DD (or — dropped YYYY-MM-DD).
3. Multiple matches: show them numbered and ask which one. Zero: say so and suggest /followup list.

Closed items stay under ## Open until the next review sweeps them to ## Archive — the flip is the fast path.

Review mode

The deliberate sweep (standup surfacing is the passive one):

1. List every open item with its age; flag items older than 14 days as stale (keep in sync with STALE_DAYS in followup-detect.sh).
2. Ask the user for keep/done/drop decisions in one batch — a compact numbered prompt, not one question per item.
3. Apply the flips, then move all - [x] and - [-] lines from ## Open to the top of ## Archive, preserving their order — directly under the heading and its blank line, creating the blank line (or the section) if missing.
4. Report: kept, done, dropped counts and the oldest remaining item.

Boundary: /followup vs /handoff vs /note