deslop

Phase 0: Vault RAG (MANDATORY, BEFORE any Read/Grep)

You MUST call query_vault(query, service_filter) BEFORE reading codebase files or external sources. This is enforced by hook. No exceptions.

---

Remove AI Code Slop

Working Directories

1. Obsidian workspace (docs, plans, features): __VAULT_ROOT__
2. Codebase (all LE services): __CODEBASE_ROOT__

Check the diff against main and remove all AI-generated slop introduced in this branch.

Common Agent Mistakes

1. Over-removing: Deleting code that looks "AI-ish" but was intentionally written. Always check if the pattern exists elsewhere in the file before removing.
2. Touching unchanged code: Cleaning up code that wasn't part of this branch's diff. Only touch lines that were added/modified in this branch.
3. Removing useful comments: Not all comments are slop. Domain-specific comments explaining WHY (not WHAT) are valuable. Only remove comments that state the obvious.
4. Breaking functionality: Removing a defensive check that actually prevents a runtime error. Before removing a try/catch or null check, verify the caller guarantees the value.
5. Style inconsistency: Making the cleaned code inconsistent with the rest of the file. The goal is to match existing style, not impose "better" style.

Discovery Phase

# Get list of changed files
GIT_EDITOR=true git diff main --name-only

# Get detailed diff to see AI additions
GIT_EDITOR=true git diff main

What to Remove

Slop Patterns (search with Grep tool in changed files)

Use the Grep tool (NOT bash grep) to scan for these patterns in src/:

Unnecessary comments:

• Grep pattern // This function -> "This function does X" narration comments
• Grep pattern // TODO: -> TODO comments added by AI (not by user)
• Grep pattern // eslint-disable -> Disabling lints instead of fixing

Defensive bloat:

• Grep pattern try \{ -> Unnecessary try/catch wrapping trusted internal calls
• Grep pattern if.*null|if.*undefined -> Null checks on guaranteed non-null values
• Grep pattern as any -> Type casts hiding real type issues