> ## Content Index
> Fetch the complete content index at: https://debugly.dev/llms.txt
> Use this file to discover other available public pages before exploring further.

# Writing an AGENTS.md That Actually Reduces Bugs
- URL: https://debugly.dev/agents-md-that-reduces-bugs/
- Published: 2025-11-25T09:15:00.000Z
- Updated: 2026-10-17T05:49:32.000Z
- Description: Most agent instruction files are a list of vibes. Here is what belongs in one, based on which rules measurably changed the output.
- Author: Rohit Bhadani
- Tags: AI, Code Review, Engineering Culture, Tooling

| Instead of a rule saying          | Use                                                |
| --------------------------------- | -------------------------------------------------- |
| Never catch bare exceptions       | ESLint no-empty, Ruff BLE001                       |
| Always filter by tenant\_id       | A repository layer that requires it in the type    |
| Money is integer paise            | A Paise branded type                               |
| No I/O in loops                   | A query count assertion in tests                   |
| Config must fail fast             | A schema validated at startup with Zod or Pydantic |
| Do not use this deprecated helper | @deprecated plus an ESLint rule                    |

---

Published on [debugly.dev](https://debugly.dev/) by [Rohit Bhadani](https://debugly.dev/about/) | Founder of [Krova Cloud](https://krova.cloud/?ref=debugly.dev)