# Agent Coherence — Stale Write Guard (FS)

MCP-сервер блокирует устаревшие перезаписи общих файлов вроде plan.md и memory.json. Помогает избежать тихой потери данных при одновревнованной работе нескольких агентов.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Автор: cohexa-ai
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/cohexa-ai/agent-coherence
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/agent-coherence-stale-write-guard-fs

## Что делает

Когда два агента параллельно редактируют общий файл вроде `plan.md` или `memory.json`, возникает коллизия. Один читает старый снимок, а второй уже сохранил изменения. По умолчанию побеждает последняя запись. Сервер перехватывает подобные попытки и возвращает явный отказ вместо тихой потери правок.

Механизм использует принципы протокола MESI и схему оптимистичной фиксации `write_cas`. Каждое чтение фиксирует версию артефакта. Если файл обновился до завершения записи, коммит отклоняется. Инварианты безопасности проверены через девять спецификаций TLA+.

Серверу требуется Python 3.11 или новее. Он координирует файлы только внутри одного хоста и не защищает от побочных эффектов во внешнем мире вроде отправки вебхуков.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

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

**Командой платформы**
```bash
claude mcp add stale-write-guard-fs -- uvx agent-coherence
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-coherence <команда>

### Codex

**Командой платформы**
```bash
codex mcp add agent-coherence-stale-write-guard-fs -- uvx agent-coherence
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-coherence <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agent-coherence-stale-write-guard-fs": {
            "command": "uvx",
            "args": [
                "agent-coherence"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-coherence <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "agent-coherence-stale-write-guard-fs": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "agent-coherence"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-coherence <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add agent-coherence-stale-write-guard-fs uvx agent-coherence
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-coherence <команда>

## Когда брать
- блокировать перезапись `plan.md` устаревшими данными
- отклонять неактуальные изменения через оптимистичный CAS
- координировать доступ агентов к общим файлам на одном хосте
- предотвращать тихую потерю состояния в `memory.json`

## Примеры запросов агенту
- Прочитай `plan.md` через guard перед тем, как обновлять задачи.
- Зафиксируй изменения в `memory.json` с проверкой актуальности версии.

## Похожие
- [write-swift](https://affpapa.org/nevibecode/skills/write-swift.md) — скилл · 119300 установок
- [cleaning-up-stale-feature-flags](https://affpapa.org/nevibecode/skills/cleaning-up-stale-feature-flags.md) — скилл · 434 установки
- [session-guard](https://affpapa.org/nevibecode/skills/session-guard.md) — скилл · 2800 установок
- [write-plan](https://affpapa.org/nevibecode/skills/write-plan.md) — скилл · 524 установки
- [write-issue](https://affpapa.org/nevibecode/skills/write-issue.md) — скилл · 405 установок
- [gws-docs-write](https://affpapa.org/nevibecode/skills/gws-docs-write.md) — скилл · 50200 установок

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