What it does

re-frame-pair adds live runtime debugging and interactive pair-programming capabilities for ClojureScript apps using re-frame and shadow-cljs. It connects to the app's nREPL, inspects app-db and recent epochs, dispatches events, and can hot-swap handlers to test fixes without immediate source edits. This is designed for fast investigative loops where reproducing and validating behavior in the running app is essential.

When to use it

Use this skill when the user reports UI bugs, unexpected app-db state, or when you need to verify behavioural changes in the running app. It's ideal for: diagnosing why a UI didn't update, tracing which event produced a state transition, testing a handler change via hot-swap, or performing post-mortems by walking parent dispatch chains. Do not use if the app isn't running or isn't built with shadow-cljs.

What's included

Scripts: recommended helper scripts referenced in the skill (discover-app.sh, app-summary.sh, dispatch.sh, eval-cljs.sh, tail-build.sh). Note: fetch output reports no embedded scripts directory, so scripts may be provided in repo tooling.
References: in-skill docs and links to docs/skill/* for deeper operations and troubleshooting.
Instructions: mandatory discover-app.sh probe; follow the empirical loop (observe, inspect epoch, form hypothesis, probe, compare, then edit). Surface failures verbatim and prefer compact diffs before full snapshots.