O arquivo que ensina IA a não estragar tudo

AI coding agents like Claude Code, Cursor, and Copilot Workspace start each session with zero context, which can lead to well-intentioned but destructive decisions — updating locked dependencies, rewriting immutable migrations, or refactoring intentional patterns. The AGENTS.md file is a Markdown document placed at the repository root that acts as a structured briefing for any AI agent working on the project. It should contain stack versions, architectural decisions, explicit restrictions, and workflow conventions written as direct operational instructions rather than human-readable documentation. Architects and tech leads are urged to treat creating and maintaining this file as a core responsibility, since junior developers using agents without this context can inadvertently undo decisions that were never written down. Practical advice includes starting with the three things a new developer should never change, documenting non-obvious version constraints, and iterating the file whenever an agent makes a correctable mistake.