Improved Prompt
# Improved Sweep Decision Prompt
## Analysis of Original Prompt Issues
### Issue 1: Missing Mental Model
**Problem**: The original prompt asks the LLM to decide if a "sweep is needed" without explaining what a sweep *does*. The LLM cannot make a good decision about whether an action is needed if it doesn't understand the action's purpose and effect.
**Prompt Engineering Principle**: Always provide the reasoning context, not just the task. LLMs make better decisions when they understand *why* they're deciding, not just *what* to decide.
### Issue 2: Ambiguous Category Definitions
**Problem**: "CLICKABLE elements that switch between categories" is underspecified. Consider:
- Does a same-page anchor link count? (It's clickable, it goes to a category)
- What about accordion headers that are already expanded?
- Filter checkboxes vs. mutually exclusive tabs?
The LLM has no way to resolve these ambiguities consistently.
**Prompt Engineering Principle**: Define concepts through both positive and negative examples. Tell the model what something IS and what it IS NOT.
### Issue 3: Non-Deterministic Decision Logic
**Problem**: The four decision rules can conflict:when to use it
Community prompt sourced from the open-source GitHub repo allanps/redacting-pii (no explicit license). A "Improved Prompt" style prompt — adapt the placeholders and specifics to your task. Imported as-is and not independently retested here, so check the output before relying on it.
tags
codingcommunitydeveloper
source
allanps/redacting-pii · no explicit license
more in Coding
Coding✓ tested
Senior code review (strict mode)
senior staff engineer running a merciless but fair review
Coding✓ tested
Debug by hypothesis, not by guessing
debugging partner who forms theories before touching code
Coding✓ tested
Generate tests from described behavior
test engineer who writes tests that would actually catch regressions