lennney/stop-that-shit

Stop That Shit（别再造史了） – A Guard for AI Coding Agents

What it is – A lightweight plugin/skill that sits in front of AI‑driven coding assistants (Codex, Claude Code, OpenCode, Hermes CLI, Pi, etc.) and stops them from doing unnecessary work. It encodes a simple set of rules (the SHIT philosophy) that detect four common wasteful behaviours:

Letter	Wasteful behaviour
S – Scope creep	Adding unrelated refactors or files when only a single fix is requested.
H – Hashing & hypothetical hardening	Generating checksums, compatibility layers or other artefacts that no one will ever use.
I – Intent violation	Changing files that were only meant to be read/reviewed.
T – Task thrashing	Re‑running the same review/test cycle without any new information.

When the guard detects any of these patterns it rejects the action (or asks for an explicit override) instead of letting the agent waste tokens, time, or introduce accidental bugs.

---

How it works

1. Skill – Analyses the current diff / request, walks the call‑graph and decides what the real deliverable is.
2. Guard – Hooks into the host tool (Codex, Claude Code, OpenCode, Hermes, Pi, Oh‑My‑Pi) and intercepts file writes, dependency installs, sub‑agent spawns, hash generation, etc.
3. If the operation matches a SHIT pattern, the guard either:
   • Stops it outright, returning a permission_deny_returned response, or
   • Allows it when the user supplies an explicit flag (e.g. hash=allow, deps=allow).
4. The guard can also run in watch mode, merely reporting what it would have blocked.

The decision flow is documented in skills/stop-that-shit/SKILL.md and follows a five‑step checklist (what to deliver, existing capability, missing gaps, usefulness of the defence, verification).

---

Installation (quick start)

Requires Node 18+ (Pi 0.84.4 needs Node 22.19+).

Host	Install command
Claude Code	bash\nclaude plugin validate .\nclaude plugin marketplace add ./\nclaude plugin install stop-that-shit@stop-that-shit\n
Codex	bash\ncodex plugin marketplace add lennney/stop-that-shit --ref 0.2.5\ncodex plugin add stop-that-shit@stop-that-shit\n
OpenCode	bash\nopencode plugin github:lennney/stop-that-shit -g\n
Hermes CLI	bash\nhermes plugins install lennney/stop-that-shit/.hermes-plugin --no-enable\nhermes plugins enable stop-that-shit\n
Pi Coding Agent	bash\npi install /path/to/stop-that-shit\n
Oh My Pi	bash\nomp -e /path/to/stop-that-shit/omp/stop-that-shit.ts --skills /path/to/stop-that-shit/skills\n

After installing, restart the host process (or run the host‑specific reload command) and the guard is ready.

---

Basic usage

Commands are issued as the first line of a prompt (no quoting). The plugin adds a /stop-that-shit (or $stop-that-shit) namespace.

$stop-that-shit review -- Review this diff, only report problems, do not modify.
$stop-that-shit change -- Fix the config‑read failure and add any required callers.
$stop-that-shit lock change files=src/config.cjs|test/config.test.cjs -- Fix this behaviour.
$stop-that-shit change deps=allow -- Permit adding a new parser dependency.
$stop-that-shit change hash=allow -- Generate a checksum because the release pipeline needs it.

Command	What it does
review	Analyse a diff and list SHIT violations without changing code.
answer	Answer a question while still enforcing the guard.
monitor	Continuously watch a session and report violations.
change	Permit the minimal modifications required to satisfy the task.
watch	Observe actions but never block them.
status / runtime	Show the guard’s current state and logged events.

---

Ecosystem support

• Codex – works as a plugin that registers a set of hooks.
• Claude Code – installed via the Claude plugin marketplace; invoked with /stop-that-shit:stop-that-shit.
• OpenCode – global install from GitHub; commands are $stop-that-shit ….
• Hermes Agent CLI – added as a Hermes plugin; enables the guard for all subsequent CLI sessions.
• Pi Coding Agent – provides a dedicated Adapter and two skills (stop-that-shit and stss).
• Oh My Pi – ships as an independent extension that can be loaded with omp.

---

“Stop That Shit Slop” (STSS)

An optional companion skill that trims defensive, filler language from prose. It can be installed separately (npx skills add ./skills/stss --global) and offers two commands:

• rewrite – rewrite a paragraph to keep only the essential conditions.
• audit – point out unnecessary hedging.

---

Evidence & testing

The repository ships 18 curated good/bad cases plus a full evaluation suite (evals/codex-paired). Results, logs, and the exact test harness are recorded in EVIDENCE.md.

---

License

MIT – free for personal, academic, or commercial use.

---

Bottom line – If you use AI‑driven coding agents and find them over‑engineering, adding extra checksums, or wandering off‑task, Stop That Shit gives you a configurable guard that keeps the agent focused on the real deliverable while still allowing explicit overrides when the extra work is truly needed.