raisedadead/adhoc-sweep

Ad-Hoc Sweep

Standalone entropy scan. Dispatches the sweeper agent outside the epic lifecycle. Works in any project without tracker state or an active dp-cto epic.

Step 1: Detect Scope

Determine what to sweep:

1. If args specify files or directories, use those
2. Otherwise ask: "What should I sweep? Provide a directory, file glob, or 'all' for the full project."

Step 2: Select Category

Present a category menu via AskUserQuestion:

• dead-code — unused imports, unreachable branches, commented-out blocks
• inconsistent-patterns — mixed naming, divergent error handling, structural drift
• stale-comments — comments describing old behavior, orphaned TODOs
• naming-violations — convention breaks, misleading names
• all — full entropy scan across all categories

If the user provided a category in their args (e.g., /dp-cto:adhoc-sweep dead-code), skip the menu.

Step 3: Stringer Scan (optional)

Run the optional stringer JSONL collectors before dispatching the sweeper. The collectors are fixed: deadcode,docstale,githygiene. Output is piped directly into dp-engine create-graph --stdin (deterministic SHA-256 IDs make re-imports idempotent).

Bash:

if command -v stringer >/dev/null 2>&1; then
  stringer scan --collectors deadcode,docstale,githygiene -q | dp-engine create-graph --stdin
else
  printf 'stringer not installed — skipping JSONL collectors. Install: brew install davetashner/tap/stringer (or per project)\n'
fi

Stringer is OPTIONAL — when absent, skip silently and continue. Do not block on install.

Step 4: Dispatch Sweeper

Spawn sweeper agent via Agent tool with subagent_type: "dp-cto:sweeper".

Include in the prompt:

• The file scope from Step 1
• The drift category from Step 2
• "This is an ad-hoc sweep — no tracker state, no task_id, no stage context."
• "Report all findings. Fix CRITICAL and WARNING. Report SUGGESTION only."

Step 5: Present Findings

Parse the sweeper receipt. Present findings grouped by severity, then summarize:

## Sweep Results

- **Fixed:** {N} items (CRITICAL + WARNING)
- **Reported:** {N} items (SUGGESTION)
- **Files scanned:** {N}

For each SUGGESTION, ask: "File this to the cabinet for future work? (yes / skip)"

If yes, use /dp-cab:file to capture the finding.