Метрики репозиторію

Контекст для ШІ-агентів

Як inspect.software вимірює настанови для агентів — CLAUDE.md, AGENTS.md, правила Cursor, інструкції Copilot та llms.txt. Частина бейджа «Готовність до ШІ».

Методологія v1.13.0Оновлено 2026-07-13

Контекст для ШІ-агентів вимірює, чи надає репозиторій ШІ-агентам для кодування настанови та машиночитану документацію. Агент, що потрапляє в незнайому кодову базу, стикається з тією ж проблемою, що й новий співробітник — тільки він читає ввідні матеріали за мілісекунди, у кожній сесії. Проєкти, які фіксують ці матеріали письмово, отримують вимірно кращі результати роботи агентів.

  • Категорія: Готовність до ШІ (30% у межах категорії)
  • Вага в загальному індексі: 0% — частина незалежного бейджа «Готовність до ШІ»
  • Ключ метрики: ai_agent_context

Як обчислюється значення

КомпонентВагаПідтвердження
Інструкції для агентів60CLAUDE.md, AGENTS.md, .cursor/rules, інструкції Copilot, GEMINI.md чи еквівалент; файл, менший за ~200 байтів, вважається заготовкою і отримує часткові бали
Машиночитана документація40наявний llms.txt або llms-full.txt

Що містить якісний контекст для агентів

Ефективний файл інструкцій розповідає агентові те, що README розповідає людині, а на додачу — те, що знають лише мейнтейнери: як зібрати й протестувати проєкт, які каталоги важливі, які в проєкті домовленості та де приховані пастки («контейнер обслуговує зібрані образи — після редагування потрібне перескладання»). Конвенція llms.txt доповнює це, надаючи мовним моделям упорядкований покажчик документації проєкту.

Правило про заготовки існує тому, що сигналами наявності можна маніпулювати: порожній CLAUDE.md, створений заради бейджа, помітно відрізняється від справжнього, і методологія враховує змістовність там, де її дешево виявити.

Як читати результат

  • Сигнали ґрунтуються на наявності та розмірі файлів у дереві репозиторію; вміст не оцінюється — це чесно визнане обмеження, зазначене в усій категорії Готовність до ШІ.
  • Зараховується будь-яка з визнаних конвенцій інструкцій; методологія нейтральна щодо постачальників агентських інструментів — так само, як стан безпеки не залежить від конкретних інструментів.

Як покращити значення

  • Написати змістовний CLAUDE.md або AGENTS.md: команди складання та тестування, структура, домовленості й відомі пастки. Підтримувати його актуальним — це документація з виконавчою аудиторією.
  • Додати llms.txt, що індексує документацію проєкту для споживання мовними моделями.

Дивіться також: цикл верифікації для ШІ · Готовність до ШІ