Skillsman AGENTS.md

Goal

Produce a short, accurate, maintainable instruction file that helps coding agents work in the current repository without consuming unnecessary context or inventing project facts.

Treat AGENTS.md as an entry map for agents, not a full project manual. Prefer pointers to canonical docs over duplicating long explanations.

Workflow

1. Determine the requested mode.

   • If the user asks for a proposal, plan, review, or recommendation, do not edit files.
   • If the user asks to create, update, write, or implement the file, edit the relevant instruction file.
   • If the user names agent.md, normalize to AGENTS.md unless the repository or tool explicitly requires another filename.

2. Inspect the repository before writing.

   • Read existing instruction files: AGENTS.md, AGENTS.override.md, CLAUDE.md, .github/copilot-instructions.md, GEMINI.md.
   • Read basic project anchors if present: README.md, package/build config, test config, docs/, .github/workflows/.
   • Use rg --files first. Do not infer commands, stack, or layout from filenames alone when config files can verify them.