# mnema: decision records for AI coding agents

mnema: decision records for AI coding agents — MCP-сервер для Claude Code: сохраняет подписанный неизменяемый журнал архитектурных решений в репозитории и передаёт проектные правила в сессии агентов.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 у репозитория
- Автор: mnema-work
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/mnema-work/mnema/tree/HEAD/packages/code
- Обновлён: 2026-11-16
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/mnema-decision-records-for-ai-coding-agents

## Что делает

Пакет объединяет консольную утилиту и MCP-сервер поверх общего журнала в каталоге `.mnema/`. Агент фиксирует принятые договорённости через протокол MCP прямо во время генерации кода, а разработчик просматривает и подтверждает их в терминале. Каждая запись подписывается криптографическим ключом, поэтому сторонний наблюдатель может подтвердить целостность цепочки офлайн, не имея исходных ключей и доступа к сети.

Инструмент поддерживает ведение задач с заметками объёмом до 64 КБ, передачу контекста между исполнителями и наследование правил из связанных репозиториев. Для запуска требуется среда Node.js версии не ниже 24.15.0 или 26.0.0+. Любое автоматическое форматирование ломает проверку подписи, поэтому команда инициализации `mnema init` сразу добавляет каталог `.mnema/` в `.prettierignore` и настройки Biome.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add mnema -- npx -y @mnema/code
```

### Codex

**Командой платформы**
```bash
codex mcp add code -- npx -y @mnema/code
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "code": {
            "command": "npx",
            "args": [
                "-y",
                "@mnema/code"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "code": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@mnema/code"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add code npx -y @mnema/code
```

## Когда брать
- сохранять согласованные архитектурные решения в git в виде подписанного журнала
- проверять неизменность истории решений локально без ключей и подключения к сети
- передавать действующие ограничения проекта в контекст сессий ИИ-агентов
- вести задачи и передачу контекста с прикреплёнными заметками до 64 КБ

## Примеры запросов агенту
- Проверь журнал проектных решений и покажи действующие правила для этого репозитория
- Создай задачу в mnema с описанием архитектурных изменений сервиса авторизации
- Зафиксируй решение о выборе формата хранения данных в дереве проекта

## Похожие
- [architecture-decision-records](https://affpapa.org/nevibecode/skills/architecture-decision-records.md) — скилл · 22036 установок
- [decision-records](https://affpapa.org/nevibecode/skills/decision-records.md) — скилл · 8600 установок
- [coding-agent](https://affpapa.org/nevibecode/skills/coding-agent.md) — скилл · 6500 установок
- [grounding-before-coding](https://affpapa.org/nevibecode/skills/grounding-before-coding.md) — скилл · 25600 установок
- [vibe-coding](https://affpapa.org/nevibecode/skills/jamditis-vibe-coding.md) — скилл · 203 установки
- [decision-map](https://affpapa.org/nevibecode/skills/decision-map.md) — скилл · ★ 937 у репозитория

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
