🪣 Slop-Mop
Slop-mop reshapes the agent’s terrain so the most maintainable move feels like the easiest one downhill.
It does not try to turn agents into what they aren't. Slop-mop reshapes the workflow
landscape around them: refit carves the initial terrain, swab/scour/buff keep the
gradient pointed at maintainable code, and wake-angry-drunk-captain blocks fake
progress when only a human decision can break the tie.
Don't make sloppy choices. Keep moving forward and address debt relentlessly.
Resist the urge to side-step the check. Just fix what it flags and keep moving: that is the whole idea.
It is purposefully opinionated, as structure begets adherence to best practices.
Project Status
slop-mop has reached 2.0.0. The current public policy surface for release and
stability expectations lives here:
Quick Start
Install it:
pipx install slopmop[all]
Set up a repo:
sm init
Choose a starting point.
For an existing repo, start with refit. It walks the project through a
structured cleanup before you enter the day-to-day maintenance loop:
sm refit --start
sm refit --iterate
sm refit --finish
If you cannot do the full refit right now, generate a baseline as a temporary
escape hatch. That keeps new failures loud while you come back to the cleanup:
sm status --generate-baseline-snapshot
sm swab --ignore-baseline-failures
Run the normal loop:
sm swab
If it fails, fix what it reported and run sm swab again. When it passes,
commit. Before opening or updating a PR, run the deeper pass:
sm scour
After CI or review feedback lands:
sm buff
If you are not sure what comes next, use the auto-advance command:
sm sail
It reads the current workflow state and runs the next obvious slop-mop verb.
Use with Claude
Slop-mop ships as a Claude plugin: a skill that auto-triggers on remediation
prompts, plus eight slash commands (/sm-init, /sm-refit, /sm-sail,
/sm-swab, /sm-scour, /sm-buff, /sm-barnacle,
/sm-wake-angry-drunk-captain). Install once and sm is available in every
repo — no per-repo sm agent install required.
In Claude Code or Cowork:
/plugin marketplace add ScienceIsNeato/slop-mop
/plugin install slopmop
Then ask Claude things like "refit this repo", "sail this repo", "swab my
changes before I commit", "buff PR 142", or "file a barnacle for this sm
friction". The skill activates on remediation language and runs the right verb.
The CLI itself is still a prerequisite — install it once with
pipx install slopmop[all] and the plugin will call into it.
