Shunt Studio
The Shunt Studio (at /client/shunt-studio) is where you write the concepts Foreshock watches for on your behalf — up to 24 shunts, edited live and deployed with a single click. Available on Tectonic and above.
What an editable shunt is
A shunt is one concept, defined by example. You write phrases that mean the thing you're watching for; Aldous embeds them and keeps their center point. Anything landing near that center trips the shunt — including wordings you never listed. This is not a keyword blocklist, which is exactly why paraphrases, typos, and novel insults still get caught. See Shunts & Latent Concept Erasure for the geometry behind that.
The more angles a phrase set covers — first/second/third person, whole sentences, bare token clusters — the wider and truer the net. That's what the phrasing coach on the right of the editor grades.
The studio workflow
Three panes, left to right:
- Your shunts — the list of shunts in your account bank, plus starter templates (the built-in safety defaults, and a reward example) and a + New shunt button.
- Editor — name (lowercase with underscores, 34 chars max), Intent (Reward or Discourage), Action, and a phrase composer (up to 32 phrases, 300 characters each). One idea per line; mix voices, whole sentences, and bare token clusters.
- Phrasing coach — a health score out of 100, flags on weak or narrow phrasing, and a test playground where you paste a specimen to see whether this shunt would catch it.
Nothing goes live until you press Deploy — edits stay yours, in the browser, until then. Deploying re-embeds the whole bank in one pass and live-reloads it into the scoring gateway.
!!!SCREEN SHOT: The Shunt Studio editor with a shunt open, the phrasing coach showing a health score and flags, and the test playground populated with a probe specimen.
Live coaching
Wording lints run client-side and are always on. A second layer — live coaching — embeds your draft phrases as you type for real semantic feedback (does this phrase actually land near the centroid you intend?). It's a toggle in the header, since it costs a small amount of scoring capacity per keystroke pause.
Intent: reward vs. discourage
- Discourage dampens, receipts, or quietly logs what you want less of. Action options:
minimize,receipt,log_only. - Reward highlights what you want more of. Its only action is
highlight— instead of suppressing a match, it surfaces it.
Starting from a template
The studio ships with the real Trust & Safety default phrase sets as starting points — racism, sexism, harassment — plus one reward exemplar, thoughtful_help, built from phrases like "You reproduced the bug and pinned the exact line — really helpful" and "Explaining the tradeoff instead of just saying no." Start a new shunt from any template and edit it to fit your community's own language.
Incentive shunt trackers: finding your unsung heroes
Reward shunts are the mechanism behind incentive tracking. A shunt trained on patient, specific, helpful responses — like thoughtful_help — doesn't flag anything to suppress; it finds the people who are quietly doing the good work of holding a community together, so you can recognize them instead of only ever hearing about the people causing friction. Pair a reward shunt with the GitHub Interactions Envoy or a chat channel and the highlight action surfaces those contributors in your graphs over time.
Limits
- 24 shunts per account
- 32 phrases per shunt, 300 characters each
- 34-character shunt names, lowercase with underscores
Where to go next
Shunts you build here apply anywhere your account scores content — including the Manual Spectrometer and connected sensors. For per-repository shunts that live in version control instead of the studio, see the GitHub Interactions Envoy.