Repolode
truecourse-ai

truecourse-ai/truecourse

Создаёт сквозные тесты Playwright по PRD, ADR и README и выявляет расхождения между продуктом и документацией.

Звёзды
538
Форки
44
Открытые issues
52
Последний коммит
24 дня назад

Что это?

TrueCourse читает уже существующую документацию команды — например, PRD, ADR, README и сайты с документацией — и выделяет из неё набор утверждений. Затем он определяет пользовательские сценарии работы с продуктом и пишет тест для каждого из них, проверяя запущенный интерфейс.

Если тест падает, значит, продукт и документация больше не совпадают; сообщение об ошибке указывает конкретное утверждение, с которым возникло расхождение. Тесты оформляются как спеки Playwright, и для каждого предусмотрены собственные тестовые данные, чтобы тесты не использовали общее состояние. Инструмент работает через вход в Claude Code и включает локальный режим без авторизации, а также проверки pull request через GitHub App.

Проект написан на TypeScript, использует монорепозиторий pnpm и PostgreSQL. Он предоставляет конечную точку MCP, через которую Claude Code может читать документы рабочего пространства, сценарии, запуски и ошибки.

Ключевые возможности

  • 01Преобразует PRD, ADR, README и сайты с документацией в набор утверждений, пригодных для тестирования.
  • 02Создаёт сквозные тесты Playwright для каждого пользовательского сценария, проверяя запущенный продукт.
  • 03При падении тестов указывает конкретное утверждение из документации, которому они противоречат.
  • 04Проверяет pull request в GitHub на конфликты с документацией и ошибки тестов.
  • 05Предоставляет конечную точку MCP, чтобы Claude Code мог запрашивать результаты для рабочего пространства.

Сценарии использования

  • Проверка того, соответствует ли поведение продукта описанию в PRD и пользовательской документации.
  • Выявление расхождений между записями об архитектурных решениях и работающей системой.
  • Запуск проверок на основе документации для pull request до слияния.

Быстрый старт

  1. 1

    Скопируйте пример файла окружения

    cp .env.example .env
  2. 2

    Запустите Postgres с помощью Docker Compose

    docker compose up -d
  3. 3

    Установите зависимости

    pnpm install
  4. 4

    Запустите сервер разработки и откройте http://localhost:3000

    pnpm dev

Что важно знать

  • Необходим вход в Claude Code, а бинарный файл claude должен быть доступен в PATH.
  • CLI truecourse для npm устарел и больше не поддерживается.
  • Для использования кода из ee/ в production требуется подписка Enterprise.

В подборках

Темы

Частые вопросы

Что такое truecourse?
Создаёт сквозные тесты Playwright по PRD, ADR и README и выявляет расхождения между продуктом и документацией. TrueCourse читает уже существующую документацию команды — например, PRD, ADR, README и сайты с документацией — и выделяет из неё набор утверждений. Затем он определяет пользовательские сценарии работы с продуктом и пишет тест для каждого из них, проверяя запущенный интерфейс.
truecourse можно использовать бесплатно? Какая у него лицензия?
truecourse распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
truecourse всё ещё поддерживается?
Активно поддерживается. Последний коммит в truecourse — 14 окт. 2026 г..
Для чего можно использовать truecourse?
Проверка того, соответствует ли поведение продукта описанию в PRD и пользовательской документации. Выявление расхождений между записями об архитектурных решениях и работающей системой. Запуск проверок на основе документации для pull request до слияния.
Как установить truecourse?
Скопируйте пример файла окружения: cp .env.example .env Запустите Postgres с помощью Docker Compose: docker compose up -d Установите зависимости: pnpm install Запустите сервер разработки и откройте http://localhost:3000: pnpm dev
Где скачать truecourse?
Исходный код и инструкции по установке — на GitHub: https://github.com/truecourse-ai/truecourse

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Опенсорсный AI-агент для тестирования, который превращает Gherkin feature-файлы в автоматизированные сквозные тесты браузера, API, безопасности, доступности и визуального интерфейса.

1,2 тыс.+7 за неделю202PythonAGPL-3.0Активно поддерживаетсяОбновлён 9 дней назад