Forensic categorization and hygiene protocols for structured data cleanup.
Residue Classifier is part of the operator kit for separating canonical assets, transient residue, runtime artifacts, and review-needed material before cleanup or promotion decisions are made.
Cleanup without classification creates risk. This layer exists to preserve signal while reducing sprawl.
Classify first. Remove carefully. Protect what matters.
- scans a workspace tree
- classifies files into governance buckets
- writes a local residue report
- stays non-destructive
- is safe to rerun
If you are about to clean up a workspace and you are not completely sure what should be kept, ignored, promoted, or archived, classification first is safer than deletion first.
residue_classifier.py— local classification scriptSKILL.md— skill wrapper / usage contextLICENSECONTRIBUTING.md
python3 residue_classifier.pyThat writes a local residue-classifier-report.json in the current working directory.
- no destructive actions
- no secret embedding
- no automatic cleanup
- report generation only
The free version gives you a safe classification pass. The Pro version is for when you want to save 5+ hours of cleanup confusion, reduce repo risk, and get a clearer path to a clean workspace.
Pro is intended to include:
- richer classification rules
- confidence-scored recommendations
- backup-first cleanup planning
- thin-root cleanup order
- clearer promote / ignore / archive decisions
Stripe Payment Link:
If the free version helped you separate signal from junk, good. If you want the deeper cleanup and governance layer, that is what the Pro version is for.