AGENTS.md Authoring

Purpose

Create and improve AGENTS.md files that are short, scoped, and useful to coding agents. Preserve intent and non-obvious rules; do not summarize the repo.

Critical rules

• Suggest changes before editing; discuss first unless the user explicitly asks for direct edits.
• Normal repo/brownfield AGENTS.md should aim for ~20 lines or less.
• Do not restate what an agent can infer from code, package files, folder names, or a quick search.
• Prefer compressed, high-signal half-sentences over full prose, except for greenfield/founder notes and personal/global files.
• Nested AGENTS.md files should mostly contain local edge cases, local pointers, or skill/doc routing.
• Use RFC2119 caps (MUST, SHOULD, REQUIRED) sparingly for true non-negotiables.
• Do not use XML-ish wrappers by default.

Inputs expected