Not withstanding the current contributor policy there are a number of
areas that AI agents could be helpful for. This series introduces an
AGENTS.md file which is the basic guide to the source tree and a
number of "skills". Skills are like scripts except far less clearly
defined. However I have found the issue triage skill quite useful for
off-loading the drudgery of going through stuff by hand. I've also
used the issue helper to automate the task of starting a debug session
by pulling in test cases from the tracker.

These originally where a set of skills for ECA (eca.dev) but I've
ported them across to the agent agnostic .agents directory. All the
references to ECA should now be removed. I have some personal tweaks
in my ~/.config/eca that make agent specific suggestions.

I'm not suggesting this is ready for up-streaming (or indeed should
ever go upstream) but I'm posting the collected set for comment and
I'd be interested how well these hold up across different agentic
systems.

v3
  - split AGENTS.md into two commits (so first can go upstream)
  - symlink GEMINI.md as it doesn't fallback to AGENTS.md
  - significantly de-scoped qemu-code-explorer
  - various other suggestions from last review

v2
  - re-organised all the skills, now prefixed qemu-FOO
  - update AGENTS.md as we add each skill
  - moved a bunch of stuff from agents to skills
  - added a new script/expand_macro.py
  - see bellow --- in each patch for details

The expand_macro is an attempt to make the code explorer more
efficient and stop it getting confused by our heavy macro use. I have
found the semcode MCP server
(https://github.com/facebookexperimental/semcode) does a pretty good
job of navigating code flows so I've de-scoped the code explorer just
to deal with the trickier aspects of navigating the QEMU code base.

The issue triage skill has so far proved to be the most useful and has
seen a fair bit of tweaking since the last version.

Alex.

Alex Bennée (11):
  AGENTS.md: introduce a very basic guide for AI agents
  AGENTS.md: expand with information on skills, layout and style
  scripts/expand-macro.py: helper script exploding macros
  .agents/skills: add qemu-code-explorer skill
  .agents/skills: add qemu-build skill
  .agents/skills: add qemu-testing skill
  .agents/skills: add qemu-code-reviewer skill
  .agents/skills: add qemu-mail-thread skill
  .agents/skills: add qemu-issue-helper skill
  .agents/skills: add qemu-issue-triage agent skill
  MAINTAINERS: add a section for AI agents

 MAINTAINERS                                   |   6 +
 .agents/skills/qemu-build/SKILL.md            |  50 ++++
 .agents/skills/qemu-code-explorer/SKILL.md    |  88 ++++++
 .../qemu-code-explorer/evals/evals.json       |  26 ++
 .agents/skills/qemu-code-reviewer/SKILL.md    |  93 ++++++
 .agents/skills/qemu-issue-helper/SKILL.md     |  47 +++
 .agents/skills/qemu-issue-triage/SKILL.md     | 112 +++++++
 .../qemu-issue-triage/assets/labels.txt       | 133 +++++++++
 .../skills/qemu-issue-triage/evals/evals.json |  18 ++
 .../scripts/update_labels.sh                  |  16 +
 .agents/skills/qemu-mail-thread/SKILL.md      |  40 +++
 .../scripts/qemu_mail_parser.py               |  98 +++++++
 .agents/skills/qemu-testing/SKILL.md          |  56 ++++
 .gitignore                                    |   2 +
 AGENTS.md                                     |  91 ++++++
 GEMINI.md                                     |   1 +
 scripts/expand-macro.py                       | 274 ++++++++++++++++++
 17 files changed, 1151 insertions(+)
 create mode 100644 .agents/skills/qemu-build/SKILL.md
 create mode 100644 .agents/skills/qemu-code-explorer/SKILL.md
 create mode 100644 .agents/skills/qemu-code-explorer/evals/evals.json
 create mode 100644 .agents/skills/qemu-code-reviewer/SKILL.md
 create mode 100644 .agents/skills/qemu-issue-helper/SKILL.md
 create mode 100644 .agents/skills/qemu-issue-triage/SKILL.md
 create mode 100644 .agents/skills/qemu-issue-triage/assets/labels.txt
 create mode 100644 .agents/skills/qemu-issue-triage/evals/evals.json
 create mode 100755 .agents/skills/qemu-issue-triage/scripts/update_labels.sh
 create mode 100644 .agents/skills/qemu-mail-thread/SKILL.md
 create mode 100644 .agents/skills/qemu-mail-thread/scripts/qemu_mail_parser.py
 create mode 100644 .agents/skills/qemu-testing/SKILL.md
 create mode 100644 AGENTS.md
 create mode 120000 GEMINI.md
 create mode 100755 scripts/expand-macro.py

-- 
2.47.3