AI-агенты

Документация Testo поддерживает стандарт llms.txt — машиночитаемый формат, который помогает AI-агентам быстро разобраться во фреймворке и генерировать корректные тесты.

Что такое llms.txt?

llms.txt — это соглашение о предоставлении документации в формате, удобном для LLM. Вместо парсинга HTML-страниц AI-агент загружает один структурированный файл со всей ключевой информацией о проекте.

Testo предоставляет два эндпоинта:

Файл	Содержимое	Когда использовать
/llms.txt	Список страниц с краткими описаниями.	Быстрый обзор доступной документации.
/llms-full.txt	Полный текст всех страниц документации.	Когда агенту нужен полный контекст для генерации кода.

Если ваш AI-агент поддерживает контекстное окно от 100K+ токенов, используйте llms-full.txt — в нём есть всё необходимое для корректного написания тестов без дополнительных запросов.

Написание тестов с помощью AI

Большинство AI-агентов (Claude, ChatGPT, Cursor, Copilot и т.д.) могут использовать документацию Testo как контекст. Общий подход:

1. Передайте контекст. Укажите агенту на llms-full.txt или вставьте нужный раздел документации.
2. Опишите, что тестировать. Предоставьте класс или функцию, которые нужно покрыть тестами.
3. Проверьте и запустите. Просмотрите сгенерированные тесты и запустите их командой vendor/bin/testo run.

Пример промпта

Using the Testo PHP testing framework, write tests for the following class:

{вставьте ваш класс сюда}

Documentation: https://php-testo.github.io/llms-full.txt

Claude Code

Claude Code может загружать URL в процессе работы. Добавьте инструкцию в CLAUDE.md вашего проекта:

When writing PHP tests, use the Testo framework.
Fetch the documentation before writing tests: https://php-testo.github.io/llms-full.txt

Claude Code прочитает эту инструкцию и загрузит документацию, когда ему понадобится генерировать тесты.

Cursor, Windsurf и другие

AI-редакторы кода позволяют добавлять внешнюю документацию как контекст. Типичный подход — зарегистрировать URL документации в настройках редактора и затем ссылаться на неё в чате.

• Cursor: Добавьте URL через Settings → Features → Docs → Add new doc. После индексации ссылайтесь в чате через @Docs → выберите Testo.
• Windsurf: Вставьте URL напрямую в сообщение Cascade.

Также можно вставить содержимое llms-full.txt прямо в чат как контекст — это работает в любой IDE с AI-ассистентом, даже если она не поддерживает индексацию URL.