Готовність до ШІ вимірює, наскільки добре репозиторій пристосований до розробки та супроводу із ШІ-агентами для кодування: чи знаходить агент, що потрапляє в кодову базу, настанови; чи може він налаштувати середовище й верифікувати власні зміни; чи може читати код у межах обмежень моделі; чи може виявити машиночитані інтерфейси.
Це незалежний, додатковий бейдж. Категорія має вагу 0.0 у загальному індексі здоров'я — вона обчислюється й показується окремо та ніколи не змінює числа здоров'я. Солідний проєкт до-ШІ-ери не втрачає балів через брак агентського інструментарію; проєкт, який у нього інвестує, здобуває помітну окрему відзнаку.
Метрики цієї категорії
| Метрика | Вага в категорії |
|---|---|
| Цикл верифікації для ШІ | 40% |
| Контекст для ШІ-агентів | 30% |
| Читабельність коду для ШІ | 15% |
| Інтерфейси для ШІ | 15% |
Цикл верифікації має найбільшу вагу, бо він є серцевиною автономної роботи: агент, здатний розгорнути проєкт, запустити тести й перевірити власну зміну, категорично корисніший за того, хто цього не може. Контекст для агентів охоплює файли інструкцій (CLAUDE.md, AGENTS.md, …) та машиночитану документацію (llms.txt). Читабельність коду вимірює перевірюваність типів і керованість розмірів файлів. Інтерфейси шукають схеми API, сервери MCP та придатні до запуску приклади.
Чесність вимірювання
Сигнали — це евристики на основі наявності та розміру файлів у дереві репозиторію; вміст файлів не оцінюється. Вони показують, що інфраструктура існує, а не наскільки вона добра. Змістовність враховується там, де її дешево виявити: файл інструкцій, менший за ~200 байтів, вважається заготовкою й отримує часткові бали — цілеспрямований захист від маніпулювання бейджем.
Метрики, що не застосовуються, дають null, а не штраф: репозиторій із самою лише документацією не оцінюється за читабельністю коду, а звичайна бібліотека без поверхні API — за схемами інтерфейсів.
Як читати бейдж
- Бейдж відповідає на справді нове закупівельне питання — чи може команда продуктивно спрямувати агентів на цю кодову базу? — яке класичні сигнали здоров'я ніколи не були розраховані охопити.
- Оскільки вага дорівнює 0.0, порівняння індексу здоров'я між репозиторіями зовсім не залежать від Готовності до ШІ.
Як покращити Готовність до ШІ
- Додати змістовний
CLAUDE.mdабоAGENTS.mdтаllms.txt. - Забезпечити розгортання однією командою (Makefile, justfile, …), автоматизовані тести, конфігурацію лінтера та перевірку типів — цикл верифікації.
- Тримати файли вихідного коду в межах ~1 500 рядків і запровадити перевірку типів.
- Постачати схеми OpenAPI/GraphQL/protobuf, сервер MCP або придатні до запуску приклади там, де це відповідає природі проєкту.
Дивіться також: інженерна якість · версії методології