Review Agents md
# Prompt: Review AGENTS.md
Review the repository's `AGENTS.md` and any nested agent instruction files.
Do not rewrite the whole file unless it is necessary. Make the smallest safe patch that improves usefulness for coding agents.
Check for:
- Context bloat.
- Conflicting instructions.
- Stale setup, test, lint, build, or deploy commands.
- Lint or formatter documentation copied into the instruction file.
- Skill bodies or tool manuals pasted into repository guidance.
- Unsafe instructions involving tests, secrets, git history, destructive commands, approvals, deployments, or releases.
When editing:
1. Preserve repository-specific commands, paths, conventions, and risk areas.
2. Remove stale, generic, duplicated, or contradictory guidance.
3. Add precedence rules only if multiple instruction sources can conflict.
4. Keep the file readable and short.
5. Do not create a CLI, generator, dependency, or new instruction framework.
After editing, summarize what changed, why it was necessary, how to verify the current commands, and what was intentionally not changed.when to use it
Community prompt sourced from the open-source GitHub repo Rayna-RRR/agent-instruction-smells (MIT). A "Review Agents md" 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