---
title: "Prompt Bloat"
description: "The accumulation of redundant, generic, or conflicting instructions in system prompts that degrades agent performance."
section: "concepts"
type: "concept"
created: "2026-08-22"
updated: "2026-08-24"
confidence: "high"
tags: ["agents", "context-engineering", "anti-patterns"]
canonical: "https://pyweb.dev/wiki/prompt-bloat"
---
# Prompt Bloat

**Prompt Bloat** is an anti-pattern where developers pack dozens of disparate instructions, generic style guides, defensive guardrails, and full API references into an LLM's system prompt.

## Symptoms of Prompt Bloat
- **Instruction Shadowing:** Long rule lists cause newer rules to override or contradict earlier directives.
- **High Per-Turn Latency & Cost:** Every single turn re-processes hundreds of bloated prompt tokens before reading the user's message.
- **Sycophancy & Hedging:** Models weighed down by overly cautious instructions spend more time explaining why they can't do something than executing the code.

## How to Kill Prompt Bloat
1. **Apply the Defensibility Test:** For every sentence in a prompt or instruction file, ask: *"Can I defend why this is here with a real failure case?"* If not, delete it.
2. **Move Docs to the Filesystem:** Keep system prompts minimal and point to local files (`docs/`, `skills/`, `CONTEXT.md`) that the agent loads only when needed.
3. **Use Tool Definitions:** Replace large textual output formats with structured tool calling schemas (e.g. JSON schema parameters).

## Related
[context rot](/wiki/context-rot), [progressive disclosure](/wiki/progressive-disclosure), [agents md spec](/wiki/agents-md-spec), [context engineering](/wiki/context-engineering).

---

## Agent Navigation

cluster: person (170 pages) | betweenness: 32.6

### References (outbound)
- [Context Rot](https://pyweb.dev/wiki/context-rot.md)

### Referenced by (inbound)
- [Agent Harness Engineering](https://pyweb.dev/wiki/agent-harness-engineering.md)
- [Context Budget Audit](https://pyweb.dev/wiki/context-budget-audit.md)
- [Progressive Disclosure](https://pyweb.dev/wiki/progressive-disclosure.md)
- [Skill Treatment Effect](https://pyweb.dev/wiki/skill-treatment-effect.md)

### Evidence (verified primary sources)
- [aihero-dev-homepage-2026](https://pyweb.dev/wiki/raw/articles/aihero-dev-homepage-2026.md) | origin: https://www.aihero.dev/ | ingested: 2026-08-22 | sha256: 231157fed45f82922924a050e09b5b81a443891814fc1d72c874d864a6075419

### Machine endpoints
- Knowledge graph: https://pyweb.dev/api/graph.json
- Graph analysis: https://pyweb.dev/api/graph-analysis.json
- Context index: https://pyweb.dev/llms.txt