Repair Prompt
# Repair Prompt: Context Bloat
Review the repository's agent instruction files, especially `AGENTS.md`, for context bloat.
Do not rewrite the project documentation. Make the smallest safe patch that turns the active instruction file into practical coding-agent guidance.
Please:
1. Identify stale history, duplicated docs, dead links, old setup commands, and narrative that agents should not act on.
2. Preserve current commands, safety constraints, project-specific conventions, and paths that help agents work.
3. Move or replace long background sections with short links to the right docs when those docs exist.
4. Remove conflicting old guidance instead of keeping it "for context."
5. Add a short precedence rule if nested instruction files or user task instructions may conflict.
After editing, summarize what was removed, what was preserved, how to verify the current commands, and what you intentionally left unchanged.when to use it
Community prompt sourced from the open-source GitHub repo Rayna-RRR/agent-instruction-smells (MIT). A "Repair 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
writingcommunitygeneral
source
Rayna-RRR/agent-instruction-smells · MIT
more in Writing
Writing✓ tested
Explain anything to a smart friend
great teacher who refuses to dumb things down
Writing✓ tested
Line-edit my draft (keep my voice)
sharp copy editor who tightens without flattening
Writing✓ tested
Outline a long piece before you write it
editor who structures the argument before a word is drafted