AI Audit Agents Md

Навык: проверка AGENTS.md

Если аудит ведёт к существенной правке источника истины, сначала получи ai-work-control/full; сам аудит не повторяет этот контроль.

Используй этот навык для независимой проверки одного или нескольких AGENTS.md как машинной точки входа и для проверки соседних instruction-файлов, которые читает конкретная обвязка, например CLAUDE.md: кратких, операционных, детерминированных и не перегруженных сведениями, которые лучше держать в README.md, вложенных инструкциях или профильных документах.

Когда применять

Применяй навык, если нужно:

• проверить существующий AGENTS.md;
• проверить набор файлов AGENTS.md в одном репозитории;
• проверить, не нужен ли рядом CLAUDE.md или другой instruction-файл для конкретной обвязки и не создаёт ли он второй источник истины;
• оценить, не перегружен ли AGENTS.md;
• проверить, не смешаны ли машинный и человеческий входы;
• проверить, не конфликтуют ли корневой и вложенные AGENTS.md;
• подготовить замечания перед изменением AGENTS.md.

Если задача требует не только проверки, но и создания, изменения, сокращения или разделения AGENTS.md, сначала используй ai-agents-md-maintenance, а этот навык применяй как независимый контроль результата.

Не применяй навык для общей проверки всей документации проекта, если задача не сосредоточена на AGENTS.md и соседних инструкциях.

Входные данные

Для применения навыка должны быть доступны настолько, насколько это возможно:

• проверяемый файл или набор файлов AGENTS.md;
• соседние файлы инструкций, если они участвуют в цепочке применения;
• README.md и другие документы, на которые ссылается AGENTS.md;
• сведения о структуре репозитория, если проверяется вложенность инструкций;
• проверяемые источники, если нужно подтвердить основание замечания.

Если часть цепочки инструкций недоступна, зафиксируй это ограничение явно.

Обязательный порядок

1. Определи контур инструкций: какие файлы реально участвуют в управлении агентом и можно ли восстановить порядок применения. Если проект использует обвязку, читающую не AGENTS.md, а соседний instruction-файл, например CLAUDE.md, включи его в проверку контура.
2. Проверь роль AGENTS.md как машинного входа: нет ли подмены README, длинного обзора проекта или общих пожеланий вместо рабочих правил.
3. Проверь связку соседних instruction-файлов: не дублируют ли AGENTS.md и CLAUDE.md один и тот же текст вручную, нет ли расхождения между ними и не зависит ли корректность поведения от неописанного порядка их слияния.
4. Проверь минимальную достаточность контекста: каждое правило должно менять поведение агента в реальной задаче.
5. Проверь детерминизм и конфликты: противоречия, неявные переопределения, спорящие обязанности и расплывчатые условия применения.
6. Проверь операционность: команды, пути, роли, форматы, условия и точки остановки должны быть указаны там, где без них правило не выполняется.
7. Проверь границы между переносимым и локальным: временные гипотезы, проектные особенности и будущие идеи не должны выглядеть как универсальное правило.
8. Подготовь отчёт: сначала замечания по важности, затем открытые вопросы и ограничения проверки.

Что читать дополнительно

• references/review-checklist.md — детальный чек-лист проверки AGENTS.md и связанных инструкционных файлов.

Формат результата

Результатом должен быть отчёт пользователю, в котором:

• замечания перечислены по важности;
• для каждого замечания указано, где именно проблема;
• для каждого замечания указано, какое проверяемое правило оно нарушает;
• отделены наблюдаемый факт, вывод и предлагаемое исправление;
• нет лишнего пересказа разделов без проблем.

Если существенных замечаний нет, скажи это прямо и отдельно назови остаточные риски проверки.

Ошибки применения

Ошибкой считается:

• свести проверку к стилистическим замечаниям без связи с рабочими правилами;
• не проверить иерархию инструкций;
• признать перегруженный AGENTS.md хорошим только потому, что он подробный;
• не заметить смешение README.md и AGENTS.md;
• сгладить конфликт между файлами или разделами вместо явной фиксации;
• принять абстрактные требования без проверки операционности;
• не отделить выводы отчёта от наблюдаемых фактов;
• предложить расширить файл без доказанной пользы.

Связь с другими навыками

• ai-agents-md-maintenance — когда по результатам проверки нужно создать, изменить, сократить или разделить AGENTS.md.
• ai-data-collection — когда нужно собрать контекст по нескольким файлам инструкций и связанным документам.
• ai-work-control — когда замечания ведут к изменению источника истины.
• ai-work-result-evaluation — когда отчёт будет принят как основание для изменения проектных инструкций.