Drift

Локальный CLI и read-only MCP-сервер, которые не дают агенту нарушать слоистость API-роутов в Next.js

CLIНизкий риск

dadbodgeoff/drift

Установка

git clone https://github.com/dadbodgeoff/drift.git && cd drift
pnpm install --frozen-lockfile
pnpm build && pnpm build:engine

Нужен Rust. Точка входа: node packages/cli/dist/main.js.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Drift сканирует репозиторий на TypeScript или JavaScript и выводит соглашение: API-роуты Next.js не должны напрямую импортировать клиенты доступа к данным вроде Prisma. После подтверждения человеком соглашение фиксируется как контракт, существующие нарушения попадают в базовую линию. Команда drift check проверяет дифф и называет файл, строку и нарушенное правило; в режиме block она завершается с кодом 2. Read-only MCP-сервер drift-mcp дает агенту заранее прочитать контракт и через get_task_preflight получить примеры файлов, где паттерн уже реализован.

Для кого. Для команд на Next.js, которые пускают агентов писать API-роуты и хотят сохранить слой сервисов.

Подходит, если

  • Агенты добавляют роуты, которые ходят в базу в обход сервисов
  • Нужен гейт в CI на нарушение архитектурного соглашения
  • Нужно дать агенту примеры правильной реализации перед задачей

Не подходит, если

  • Проект не на Next.js или не на TypeScript и JavaScript
  • Нужно общее ревью кода или проверка других правил

Пример запроса к агенту

Перед добавлением эндпоинта запроси у Drift preflight и следуй найденным примерам

Ограничения

Бета: пакет не опубликован в npm, сборка только из исходников и требует Rust и pnpm, бинарника drift пока нет. Поддерживается одно семейство соглашений для Next.js. Хуки на момент редактирования не выпущены. Пакет driftdetect в npm не имеет отношения к этой версии. Ответ get_task_preflight занимает порядка 20 тысяч токенов.

Как отключить. Удалите drift-mcp из конфигурации MCP, шаг drift check из CI и каталог ~/.drift.

Проверка безопасности

  • Работает локально, не меняет исходный код и не отправляет данные на сервер

Коротко о README

README сразу предупреждает о бета-статусе и сборке из исходников, дает команды установки и первого запуска. Отдельный раздел честно ограничивает область: один язык, один фреймворк, одно соглашение. Приведены результаты проверки на семи открытых репозиториях Next.js и объяснено, когда проверка блокирует, а когда предупреждает. Лицензия MIT.

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

Почему нарушения только предупреждают?

Если соглашение нарушает большинство роутов, Drift считает его целью рефакторинга и не блокирует, пока человек не решит иначе.

Может ли агент через MCP менять правила?

Нет, сервер только читает; принятие соглашений и подавление находок остаются за человеком.

Выбор редакции

Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода

ПлагинСредний риск286,6 тыс.
Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

СкиллНизкий риск262 тыс.

Референсные MCP-серверы

Model Context Protocol servers

Выбор редакции

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,3 тыс.
Выбор редакции

Актуальная документация и примеры кода нужной версии библиотеки прямо в контексте агента, через MCP или CLI со скиллом

MCP-серверСредний риск62 тыс.