docs: update deslop-around documentation for pipeline architecture

Added comprehensive documentation for the new 3-phase slop detection
pipeline introduced in #107:

- **Architecture section**: Explains Phase 1 (regex), Phase 2 (multi-pass),
  Phase 3 (CLI tools) with certainty levels (HIGH/MEDIUM/LOW)
- **Thoroughness levels**: Documents quick/normal/deep modes
- **Language-aware tools**: Lists recommended tools per language
  - JavaScript/TypeScript: jscpd, madge, escomplex
  - Python: pylint, radon
  - Go: golangci-lint
  - Rust: clippy
- **Enhanced detection list**: Added buzzword inflation and code smells

Updated files:
- README.md: Main command reference
- docs/USAGE.md: Detailed usage guide

Refs #107

Author: avifenesh

README.md

@@ -152,14 +152,28 @@ Ship your code from commit to production with full validation and state integrat
 
 ### `/deslop-around` - AI Slop Cleanup
 
-Remove debugging code, old TODOs, and AI slop from your codebase.
+Remove debugging code, old TODOs, and AI slop from your codebase with a 3-phase detection pipeline.
 
 ```bash
 /deslop-around                    # Report mode - analyze only
 /deslop-around apply              # Apply fixes with verification
 /deslop-around apply src/ 10      # Fix up to 10 issues in src/
 ```
 
+**Architecture:**
+- **Phase 1** - Built-in regex patterns (HIGH certainty)
+- **Phase 2** - Multi-pass analyzers (MEDIUM certainty)
+- **Phase 3** - Optional CLI tools (LOW certainty, graceful degradation)
+  - JavaScript/TypeScript: jscpd, madge, escomplex
+  - Python: pylint, radon
+  - Go: golangci-lint
+  - Rust: clippy
+
+**Thoroughness levels:**
+- `quick` - Phase 1 only (fastest)
+- `normal` - Phase 1 + Phase 2 (default)
+- `deep` - Phase 1 + Phase 2 + Phase 3 (if tools available)
+
 **Detects:**
 - Console debugging (`console.log`, `print()`, `dbg!()`)
 - Old TODOs and commented code
@@ -170,6 +184,7 @@ Remove debugging code, old TODOs, and AI slop from your codebase.
 - Phantom references (issue/PR mentions, file path references in comments)
 - Infrastructure components configured but never used (unused DB clients, caches, API clients)
 - Code smells: boolean blindness, message chains, mutable globals, dead code, shotgun surgery
+- Buzzword inflation (quality claims without evidence)
 
 ---
 

docs/USAGE.md

@@ -47,19 +47,38 @@ Complete guide to using awesome-slash commands with real-world examples.
 
 ### `/deslop-around`
 
-Remove debugging code, old TODOs, and AI slop from your codebase.
+Remove debugging code, old TODOs, and AI slop from your codebase with a 3-phase detection pipeline.
 
 ```bash
 /deslop-around                    # Report mode (safe, no changes)
 /deslop-around apply              # Apply fixes automatically
 /deslop-around apply src/ 10      # Fix 10 issues in src/ only
 ```
 
+**Architecture:**
+- **Phase 1** - Built-in regex patterns (HIGH certainty) - always runs
+- **Phase 2** - Multi-pass analyzers (MEDIUM certainty) - context-aware
+- **Phase 3** - Optional CLI tools (LOW certainty) - graceful degradation
+  - JavaScript/TypeScript: jscpd, madge, escomplex
+  - Python: pylint, radon
+  - Go: golangci-lint
+  - Rust: clippy
+
+**Thoroughness levels:**
+- `quick` - Phase 1 only (fastest)
+- `normal` - Phase 1 + Phase 2 (default, recommended)
+- `deep` - All phases if tools available (most thorough)
+
 **Detects:**
 - Console debugging (`console.log`, `print()`, `dbg!()`)
 - Old TODOs and commented code
 - Placeholder text, magic numbers
 - Empty catch blocks, disabled linters
+- Placeholder functions
+- Excessive documentation
+- Phantom references
+- Buzzword inflation
+- Code smells and over-engineering patterns
 
 ---