I labeled 558 AGENTS.md files. Here’s what they say — and what almost nobody writes down

Описание и применение

Проект собрал 558 файлов AGENTS.md, классифицировал их по 9 категориям с помощью правил, а затем проверил точность классификатора. Результаты показывают, что ограничения и команды сборки/тестирования доминируют, а «gotchas» редки. Инструмент agent‑charters позволяет разработчикам сравнивать свои файлы с базой данных.

Задача

Developers lack a systematic view of AGENTS.md content, making it hard to ensure completeness and consistency across repos.

Результат

The project produced a reproducible baseline of AGENTS.md content, revealing that prohibitions and build/test commands dominate, while gotchas are rare. The tool enables developers to audit their own files against this baseline.

Рабочий процесс

• Collect AGENTS.md files from public repos
• Apply rule‑based classifier to assign 9 categories
• Validate classifier against blind‑labeled held‑out samples
• Publish dataset and tooling (agent‑charters)
• Invite external users to run compare and provide feedback

Доказательства

92% precision / 70% recall on 55 English files, 88% / 73% on 50 Chinese files

Источник

49% point to some other file; 15% route to a knowledge or rules directory

Источник