RepoRadar TrueCourse: AI-платформа для анализа архитектуры и кода
TrueCourse — это AI-платформа для анализа архитектуры и интеллектуального анализа кода, которая помогает выявлятьCircular dependencies, нарушения слоёв, мёртвые модули и другие дефекты. Она предлагает как веб-интерфейс, так и командную строку, что удобно для разных рабочих процессов.
Проект выделяется благодаря сочетанию традиционных линтеров и анализа с помощью языковых моделей, что позволяет обнаруживать не только распространенные проблемы, но и более сложные, такие как конфликты в логике бизнес-правил. TrueCourse способен обрабатывать JavaScript, TypeScript, Python и C#. Для запуска доступна версия на npm, и стоит отметить, что результаты можно хранить в специальной директории .truecourse/ для удобного просмотра в дашборде.
Важное ограничение: несмотря на широкий функционал, проект пока находится на ранней стадии, и могут быть проблемы с совместимостью. Если ты работаешь с крупными проектами и сталкиваешься с трудностями в поддержке кода, стоит попробовать TrueCourse.
TrueCourse — это платформа для архитектуры и анализа кода на основе искусственного интеллекта, которая позволяет выявлять ошибки в коде и отклонения в бизнес-логике. В проекте используются более 1500 детерминированных правил и свыше 100 правил, основанных на больших языковых моделях (LLM), и поддерживаются языки JavaScript, TypeScript, Python и C#.
Основные функции
- Анализ кода (`truecourse analyze`) — выявление дефектов на основе различных категорий, таких как неиспользуемый код, циклические зависимости, ошибки безопасности, а также проблемы с производительностью. Анализ выполняется с помощью Tree-sitter и LLM.
- Защита спецификации (`truecourse guard`) — отслеживание изменений в бизнес-логике. Платформа создает корпус спецификаций из ваших документов, а затем генерирует сценарные тесты, которые проверяют соответствие реализации документированным требованиям.
Результаты анализа хранятся в каталоге `.truecourse/` и становятся доступны для коллективного просмотра через веб-интерфейс или CLI.
Установка и запуск
Установить TrueCourse можно с помощью npm:
npm install -g truecourseПосле установки команда `truecourse` будет доступна в командной строке. Если ты не хочешь устанавливать глобально, команду можно выполнить с помощью:
npx truecourse Чтобы начать анализ, выполни следующие команды:
cd
truecourse analyze
truecourse list Эти команды запустят анализ кода в твоем репозитории и выведут список найденных нарушений.
Как это работает
Первый запуск `truecourse analyze` создаст каталог `.truecourse/`, где будут храниться результаты анализа. В этом каталоге находятся такие файлы:
LATEST.json— последний снимок анализа.config.json— настройки для текущего репозитория.hooks.yaml— политика пред-коммит хука.
Первый запуск также создает файлы, которые можно коммитить, чтобы они отслеживали работу команды.
Ограничения
Для работы LLM — например, при анализе с использованием LLM или генерации сценарием — необходимо иметь доступ к Claude Code или к API провайдера с соответствующими ключами. Если ни один из вариантов недоступен, некоторые функции будут недоступны, но детерминированный анализ все равно будет выполнен.
К тому же, необходимо обеспечить наличие .NET 8 SDK для анализа C# кода, так как он требует его для исполнения.
Панель управления
TrueCourse включает веб-интерфейс, который позволяет просматривать результаты анализа кода и отклонений в бизнес-логике на одном экране. Чтобы запустить панель, выполни команду:
truecourse dashboardПанель управления предоставляет возможность детально рассматривать выявленные проблемы и управлять процессом защиты спецификации.
Проект TrueCourse полезен для команд разработчиков, желающих поддерживать высокое качество кода и соответствие бизнес-требованиям, минимизируя риски и повышая производительность процесса разработки.
Открыть на GitHub: truecourse-ai/truecourse →
