Готовність до ШІ

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

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

Метрики цієї категорії

Цикл верифікації має найбільшу вагу, бо він є серцевиною автономної роботи: агент, здатний розгорнути проєкт, запустити тести й перевірити власну зміну, категорично корисніший за того, хто цього не може. Контекст для агентів охоплює файли інструкцій (CLAUDE.md, AGENTS.md, …) та машиночитану документацію (llms.txt). Читабельність коду вимірює перевірюваність типів і керованість розмірів файлів. Інтерфейси шукають схеми API, сервери MCP та придатні до запуску приклади.

Чесність вимірювання

Сигнали — це евристики на основі наявності та розміру файлів у дереві репозиторію; вміст файлів не оцінюється. Вони показують, що інфраструктура існує, а не наскільки вона добра. Змістовність враховується там, де її дешево виявити: файл інструкцій, менший за ~200 байтів, вважається заготовкою й отримує часткові бали — цілеспрямований захист від маніпулювання бейджем.

Метрики, що не застосовуються, дають null, а не штраф: репозиторій із самою лише документацією не оцінюється за читабельністю коду, а звичайна бібліотека без поверхні API — за схемами інтерфейсів.

Як читати бейдж

• Бейдж відповідає на справді нове закупівельне питання — чи може команда продуктивно спрямувати агентів на цю кодову базу? — яке класичні сигнали здоров'я ніколи не були розраховані охопити.
• Із 4% сирої ваги — всередині калібрувальної кривої, що насичується від сирого значення 91, — Готовність до ШІ може підштовхнути індекс здоров'я, але не здатна ані створити, ані зруйнувати рейтинг: кожен діапазон, включно зі 100/100, залишається досяжним і за нульової категорії.

Як покращити Готовність до ШІ

• Додати змістовний CLAUDE.md або AGENTS.md та llms.txt.
• Забезпечити розгортання однією командою (Makefile, justfile, …), автоматизовані тести, конфігурацію лінтера та перевірку типів — цикл верифікації.
• Тримати файли вихідного коду в межах ~1 500 рядків і запровадити перевірку типів.
• Постачати схеми OpenAPI/GraphQL/protobuf, сервер MCP або придатні до запуску приклади там, де це відповідає природі проєкту.

Дивіться також: інженерна якість · версії методології