FerroxLabs/agents-md

546 stars · Last commit 2026-05-31

Drop-in AGENTS.md that makes every coding agent behave like a senior engineer instead of an eager intern. Kills sycophancy, stops drive-by refactors, forces verification loops. Synthesizes Karpathy's four principles and Boris Cherny's Claude Code workflow. Works with Claude Code, Codex, Gemini CLI, Cursor, and the open standard.

README preview

<p align="center">
  <img src="https://github.com/FerroxLabs/agents-md/releases/download/v0.1.0/hero.png" alt="Sean Donahoe's AGENTS.md — Smarter Operating Instructions for Coding Agents" width="100%">
</p>

**One file. Every coding agent starts behaving like a senior engineer.**

Drop it into any repo. Claude Code, Codex, Cursor, Gemini CLI, Aider, Windsurf, Copilot, and Devin all read it on their own. No plugins. No config. No setup rituals.

It just works.

This is the tool and the core operating discipline we run on every project at Ferrox Labs. One file, every agent, every repo.

---

## Install

### The easy way — hand it to your agent

Open Claude Code, Codex, Cursor, or any coding agent in your project root. Paste this:

View full repository on GitHub →