deslop GPT

deslop

A deletion-first Agent Skill for agent-maintained codebases

简体中文 · English

Evidence-backed cleanup that reduces accumulated machinery while preserving real behavior.

deslop audits and, when explicitly authorized, removes complexity accumulated through repeated coding-agent implementation and correction cycles. Those cycles often leave overlapping regression tests, producer-verifies-producer checks, and fallback layers that hide failures instead of handling a current contract.

This is semantic subtraction, not source beautification. deslop is not a formatter, style humanizer, test-count minimizer, blanket ban on defensive code, or automatic permission to edit a repository. It follows justification chains to independent evidence and preserves behavior whose contract remains real or uncertain.

Reduce test surface, not behavior surface.

What it targets

The percentages below are design priorities, not measured prevalence.

Priority	Target	Question
~50%	Test-suite bloat	Does each test protect a distinct failure domain with a current owner and an independent oracle?
~25%	Verification theater	Can the verifier fail independently from the producer, or do both share the same information and failure domain?
~25%	Defensive / fallback bloat	Does the recovery path implement a current contract, or merely mask an unexpected internal error?

Generic dead code, wrappers, abstractions, and comments are secondary. They matter only when they belong to one of these clusters or have direct high-confidence deletion evidence.

Subtract machinery. Preserve behavior.

Remove	Preserve
Self-justifying or duplicate tests	Distinct success, rejection, error, and edge-case behavior
Checksums, receipts, or validators with no independent consumer	Persistence and corruption checks across a real failure boundary
Speculative or obsolete fallback chains	Supported compatibility and documented protocol behavior
Repeated defenses inside trusted call graphs	Real handling at external and untrusted boundaries
Wrapper/test clusters with no independent purpose	Security, transactions, concurrency, resource, and scientific invariants

Resemblance to a smell is a lead, not a verdict. Security and trust boundaries, supported callers, persisted formats, and numerical constraints are preserved by default when evidence is incomplete.

Quick Start

Codex: install v0.3.4 as a standalone Skill

Invoke the bundled installer with this GitHub Skill URL:

$skill-installer
Install the Skill from:
https://github.com/MrZoyo/deslop-GPT/tree/v0.3.4/skills/deslop

For a reviewable local checkout, symlink the runtime directory into Codex's canonical user Skill location:

git clone --branch v0.3.4 --depth 1 https://github.com/MrZoyo/deslop-GPT.git "$HOME/.local/share/deslop-GPT"
mkdir -p "$HOME/.agents/skills"
ln -s "$HOME/.local/share/deslop-GPT/skills/deslop" "$HOME/.agents/skills/deslop"

After installation, confirm that the selected Skill path points to the intended release; see the discovery checks in Getting Started. The tagged v0.3.4 path is the current released, pinned standalone Skill; main is the development branch and may contain unreleased changes.