/ Каталог / Песочница / mex
← Все серверы ↗ GitHub
● Сообщество theDakshJaitly ⚡ Сразу

mex

автор theDakshJaitly · theDakshJaitly/mex

Скаффолд памяти проекта + детектор дрейфа — держит AI-агентов привязанными к актуальному состоянию проекта, а не к вчерашнему снапшоту.

mex устанавливает структурированный скаффолд памяти в вашем репозитории (архитектура, конвенции, текущие задачи, блокеры) и поставляет CLI, обнаруживающий дрейф между памятью и реальностью. Когда изменения кода противоречат памяти, CLI сигнализирует об этом для обновления или пересмотра. Лёгкий — предназначен жить в репозитории и путешествовать с командой.

▶ Смотреть демо 📦 Установить 💡 Сценарии

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

готово

Установка

Репозиторий автора · Официальная документация Claude Skills

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

Реальные сценарии: mex

Настройка памяти проекта в начале проекта

👤 Владельцы новых репозиториев ⏱ ~25 min beginner

Когда использовать: День 1 проекта; хотите, чтобы агенты быстро входили в курс.

Поток
  1. Инициализировать
    Use mex. Initialize project memory with sections: architecture, conventions, in-flight, blockers.✓ Скопировано
    → Скаффолд /.mex/ создан с шаблонами
  2. Заполнить начальные данные
    Auto-extract architecture from existing code and a starter convention list.✓ Скопировано
    → Разделы заполнены стартовым контентом
  3. Установить маркеры свежести
    Mark each section verified today.✓ Скопировано
    → Маркеры свежести установлены

Итог: Новый проект начинается с общим контекстом для агентов.

Подводные камни
  • Авто-извлечение захватывает нерелевантные детали — Безжалостно обрезайте — память для принципов, не для grep
Сочетать с: filesystem

Нахождение расхождений между памятью проекта и кодом

👤 Владельцы долгоживущих проектов ⏱ ~30 min intermediate

Когда использовать: Память создана месяцы назад; неясно, насколько она устарела.

Поток
  1. Запустить drift
    Use mex. Run drift detection. Report claims that no longer match reality.✓ Скопировано
    → Отчёт о дрейфе: утверждение ↔ свидетельство
  2. Обновить или удалить
    For each drift, decide: update memory or fix the code (claim was right and reality drifted).✓ Скопировано
    → Решение по каждому пункту; PR открыты для исправлений на стороне кода
  3. Повторно верифицировать
    After resolving, mark sections verified today.✓ Скопировано
    → Память снова выровнена

Итог: Память остаётся надёжным контрактом, а не фольклором.

Подводные камни
  • Детектор дрейфа слишком агрессивен — Настройте --strictness; используйте 'medium' для живых проектов
Сочетать с: github

Передача текущих задач между членами команды

👤 Разработчики, уходящие в отпуск / увольняющиеся ⏱ ~20 min beginner

Когда использовать: У вас 3 фичи в работе и кто-то другой должен их подхватить.

Поток
  1. Зафиксировать текущие задачи
    Use mex. For each open branch, write an in-flight entry: goal, current state, next steps, gotchas.✓ Скопировано
    → Записи в /.mex/in-flight/
  2. Проверить через CLI
    Run drift on in-flight; ensure entries reflect actual branch state.✓ Скопировано
    → Дрейф отсутствует
  3. Передать
    Generate a teammate-ready summary linking each entry to its branch.✓ Скопировано
    → Краткое описание для передачи в Slack/email

Итог: Плавный подхват; без археологических раскопок.

Подводные камни
  • Записи текущих задач расплывчаты («работаю над X») — Требуйте заполнения поля 'next steps' из шаблона; конкретно или это не помогает

Комбинации

Сочетайте с другими MCP — эффект x10

mex-skill + filesystem

Память хранится в репозитории; коммитьте её

Commit /.mex/ to git so memory travels with the codebase.✓ Скопировано
mex-skill + github

Проверка дрейфа в CI на PR

On every PR, run mex drift and post the report as a PR comment.✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
init scaffold_options Один раз на проект 0
drift section?, strictness? Еженедельно / перед слиянием долгоживущих веток 0 (использует локальные проверки + LLM для нечётких утверждений)
verify section После обновления памяти для соответствия реальности 0
in_flight_add branch, goal, next_steps При создании ветки для фичи 0
summary format Передача задач / статус-отчёт 0

Стоимость и лимиты

Во что обходится

Квота API
Нет — локально
Токенов на вызов
Drift использует LLM для нечётких утверждений; ограничен на запуск
Деньги
Бесплатно
Совет
Используйте strict=high в CI для поиска реального дрейфа; medium для ежедневных локальных проверок

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: filesystem-write
Хранение учётных данных: Нет
Исходящий трафик: Нет, если LLM для drift не настроен на удалённый провайдер

Устранение неполадок

Частые ошибки и исправления

Drift сообщает о ложных срабатываниях

Снизьте strictness; или переформулируйте утверждение более проверяемым образом

Память растёт бесконтрольно

У каждого раздела есть мягкий предел; периодически консолидируйте — сохраняйте принципы, архивируйте детали

CLI не может найти /.mex/

Запускайте из корня репозитория; или передайте --root <path>

Авто-извлечение пропускает ключевые инварианты

Авто-извлечение — стартовая точка; пишите несущие инварианты вручную

Альтернативы

mex в сравнении

АльтернативаКогда использоватьКомпромисс
claude-mem-skillНужна непрерывность сессий, а не памяти проектаРазные задачи; mex для инвариантов уровня проекта
Plain CLAUDE.mdМаленький проект, детектор дрейфа не нуженНет структуры; нет автоматических проверок свежести
pilot-shell-skillХотите spec/план/gate плюс персистентность знанийБольший охват воркфлоу; больше мнений

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills