agents-md
Installation
SKILL.md
AGENTS.md Creation & Refactoring
Create minimal, focused AGENTS.md files that use progressive disclosure.
Core Principles
- Instruction budget: LLMs can follow ~150-200 instructions consistently. Every token loads on every request.
- Progressive disclosure: Give agents only what they need now, point elsewhere for specifics.
- Avoid staleness: Don't document file paths—they change. Document capabilities and domain concepts.
What Belongs in Root AGENTS.md
Only these essentials:
- One-sentence project description (anchors agent decisions)
- Package manager (if not npm)
- Non-standard build/typecheck commands
Everything else goes elsewhere.