Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Anti-Patterns to Eliminate

Common prompt engineering mistakes and their fixes.


ALL CAPS Shouting

YOU MUST NEVER SKIP ANY PHASE
ABSOLUTELY FORBIDDEN
CRITICAL RULES: ...

Problem: No special token salience. Wasted effort. Fix: Use structural placement (start/end, separate section).


Long Lists of “NEVER” / “DO NOT”

- Don't do A
- Don't do B
- Don't do C
- Never do D
[...10 more...]

Problem: Negation activates concepts. Creates a constraint satisfaction puzzle. Fix: Replace with 3-5 constitutional principles + affirmative alternatives.


Kitchen-Sink Prompts (2000+ tokens)

Problem: Lost-in-the-middle effect. Critical information gets diluted.

flowchart TD
    KS["Kitchen-Sink Prompt<br/>2000+ tokens"] --> FIX
    FIX["Fix strategies"]
    FIX --> F1["Keep system prompt focused and minimal"]
    FIX --> F2["Move examples to separate few-shot injection"]
    FIX --> F3["Use structured sections: Role, Scope, Process"]
    FIX --> F4["Target 300-800 tokens for specialized agents"]

Politeness Padding

"Please kindly consider writing some code that might help with..."

Problem: Wasted tokens. Models are already helpful. Fix: Be direct: “Write code that implements X.”


Ambiguous Scope

"Help the user with their request"

Problem: Agent doesn’t know boundaries. Fix: “Handle requests in [domain]. Redirect [out-of-scope] to [handler].”


Implicit Tool Restrictions

prompt: "You should only use specific tools..."

Problem: Vague. Agent guesses wrong. Fix: Explicit tool config + “Your only tools: [X, Y, Z].”


No Verification Step

Problem: Agent generates without checking.

flowchart LR
    subgraph "Without verification"
        G1[Generate] --> O1[Output]
    end

    subgraph "With verification"
        G2[Generate] --> V[Verify against criteria] --> O2[Output final version]
    end

Fix: Include a self-check step in every process.


Quick Checklist

  • Does every agent have explicit Role + Scope?
  • Are all constraints affirmative (what to do, not what to avoid)?
  • Are critical constraints at both start and end of prompt?
  • Is there a Process section with structure?
  • Is output format specified?
  • Are redundancies eliminated?
  • Is the prompt focused (300-800 tokens for specialists)?
  • Are tool restrictions explicit?
  • Is there a verification step?
  • Is the instruction hierarchy explicit?