Skip to content

Instantly share code, notes, and snippets.

@zaferayan
Created August 4, 2026 06:26
Show Gist options
  • Select an option

  • Save zaferayan/bc35ed044fc13a96775a6f523c8224ef to your computer and use it in GitHub Desktop.

Select an option

Save zaferayan/bc35ed044fc13a96775a6f523c8224ef to your computer and use it in GitHub Desktop.
Sample Agents md file for simplifying development process
# AGENTS.md
- Do not preserve backward compatibility. Remove obsolete paths instead of
adding compatibility layers, fallbacks, or migrations.
- Choose the simplest implementation that fully meets the current
requirements. Avoid speculative abstractions, configuration, and
indirection.
- Grow the system in layers. Start from the smallest version that works end
to end, and add each new capability on top of a product that already
works. Never trade a working product for unfinished complexity.
- Keep components modular and concerns clearly separated.
- Prefer established, well-maintained libraries when they reduce overall
complexity or improve reliability. Do not reimplement common
functionality without a clear reason.
- Lean on the dependencies already in the project before writing your own
implementation or adding packages. Do not assume a library lacks a
capability without checking its documentation and types.
- Make architectural decisions for the long term. Do not accept a stopgap
that only works for now and is meant to be replaced later.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment