К основному содержанию
скилл CX Codex

brain:update — скилл для Claude Code: что делает и как установить

Скилл brain:update для Claude Code в конце сессии извлекает из разговора решения, задачи, события и связи и записывает их в project_brain.db проекта.

MIT ★ 328 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add coco-research/coco --skill brain:update -a claude-code
Открыть на GitHub

Что делает brain:update

Скилл проходит по всей сессии сверху вниз и вытаскивает из разговора сущности (люди, команды, системы), связи между ними, решения, события, задачи и изменения статусов. Дальше он сверяет найденное с тем, что уже лежит в project_brain.db, и пишет только новое.

Сверка не для красоты. Пользователь часто держит несколько терминалов параллельно, поэтому перед записью скилл читает текущее состояние базы через brain_cli.py context {slug}. Конфликты решает по правилам: задача с более продвинутым статусом побеждает (open < in_progress < blocked < waiting < done < cancelled), решения и события-дубли пропускаются, заметки к задачам дописываются, а не затираются.

Записи идут через Python-модули brain.operations. После них запускается синк в MemPalace и brain.json — если он упадёт, данные в базе остаются на месте. Последний шаг обновляет статьи базы знаний в ~/.coco/knowledge/ и тихо пропускается, когда этого каталога нет. Без project_brain.db в рабочем каталоге или выше скилл просто остановится с ошибкой и отправит вас в /brain init.

Какие задачи решает

  • закрыть сессию так, чтобы ни одно решение не потерялось
  • развести правки двух параллельных терминалов без регресса статусов
  • вытащить из длинного разговора список задач и событий
  • подтянуть свежие данные в MemPalace и brain.json
  • обновить статьи базы знаний по изменённым сущностям

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

  • /brain:update — забери всё из этого разговора в brain и покажи, что нового.
  • Прогони /brain:update и выведи конфликты с другими сессиями, если они есть.
  • /brain:update, только сначала проверь, не продвинула ли другая сессия статус задачи.

Как установить brain:update

1Через Skills CLI (Vercel)

npx skills add coco-research/coco --skill brain:update -a claude-code

2Вручную: положить файлы

~/.claude/skills/brain-update/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/brain-update/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о brain:update

Как установить brain:update в Claude Code?

Выполните npx skills add coco-research/coco --skill brain-update -a claude-code. Файл скилла появится в ~/.claude/skills/brain-update/SKILL.md.

Что делает brain:update?

Читает разговор целиком, вытаскивает новые сущности, решения, задачи, события и связи, сверяет их с текущей базой и записывает то, чего в базе ещё нет.

Что будет, если база ещё не создана?

Скилл ищет project_brain.db в рабочем каталоге и каталогах выше. Не нашёл — останавливается с ошибкой и просит сначала выполнить /brain init.

Исходный текст

SKILL.md · MIT
---
name: brain:update
description: "End-of-session brain flush. Scans the full conversation, extracts all new entities, decisions, tasks, events, relationships, and updates, presents a summary, and writes to project_brain.db after confirmation. Use at end of every session or when you want to capture everything discussed."
---

# /brain:update --- End-of-Session Brain Flush

**This is a forcing function.** When invoked, Claude MUST thoroughly review the entire conversation and write everything learned to the brain DB. No shortcuts, no skipping.

## Procedure

### Step 1: Detect brain DB

Look for `project_brain.db` in the current working directory or parent dirs. If not found, error: "No brain DB found. Run `/brain init` first."

### Step 2: Read current DB state (cross-session awareness)

**CRITICAL --- the user runs multiple terminal sessions in parallel.** Another session may have already written to the brain since this conversation started. Before extracting, read the current DB state:

```bash
python3 ~/.claude/skills/brain/scripts/brain/brain_cli.py context {slug}
```

For each project, note:
- **Existing entities** (names and types) --- so you don't propose adding what's already there
- **Existing decisions** (decision text) --- so you don't duplicate
- **Existing events** (title + date) --- so you don't duplicate
- **Current task statuses** --- so you don't regress a task that another session already advanced (e.g., don't set to "open" if another session set it to "done")

**Conflict rules:**
- **Entity already exists with newer metadata** --- skip your update. The other session's data is fresher.
- **Decision already recorded** --- skip. Match on first 40 chars of decision text.
- **Event already recorded** --- skip. Match on title + date.
- **Task status conflict** --- the MORE ADVANCED status wins. Status order: open < in_progress < blocked < waiting < done < cancelled. Never regress.
- **Task notes** --- if brain has notes that your session doesn't know about, MERGE (append), don't overwrite.
- **New data from this session not in DB** --- these are the writes to propose.

Show any conflicts detected:
```
CROSS-SESSION CONFLICTS
=======================
  Task "Get sandbox access" --- brain says "done" (updated by another session), 
  this session would set "open". KEEPING "done".
  
  Decision "Use Stakeholder role..." --- already in brain. SKIPPING.
```

### Step 3: Scan the full conversation

Go through every message from top to bottom. For EACH project in the brain DB, extract:

| Category | What to look for |
|----------|-----------------|
| **New entities** | Any person, team, role, system, module, or org mentioned for the first time |
| **New relationships** | Connections discovered: X owns Y, A reports to B, team scoped to module |
| **New decisions** | Anything decided, agreed, confirmed, resolved, or ruled out |
| **New events** | Meetings, calls, emails read, milestones, deployments |
| **New tasks** | Action items, to-dos, next steps, follow-ups, blockers identified |
| **Task updates** | Existing tasks that changed status (started, completed, blocked, cancelled) |
| **Entity updates** | New info about existing entities (role change, new metadata, correction) |
| **Thread updates** | New items to link to existing threads, or new threads to create |

### Step 3: Execute writes immediately

**The user invoked `/brain-update` --- that IS the confirmation. Do NOT ask "Write all to brain?" or wait for approval. Just do it.**

Use Python to write all items via the brain operations module:

```python
import sys
sys.path.insert(0, '$HOME/.claude/skills/brain/scripts')
from brain.schema import get_db
from brain.operations import *
```

Write in this order:
1. Entities (upsert --- safe to run repeatedly)
2. Relationships
3. Tasks (new + updates)
4. Threads + thread_items
5. Decisions
6. Events

### Step 6: Report

```
BRAIN UPDATED
=============
Entities:      +3 (total: 47)
Relationships: +1 (total: 37)
Tasks:         +2, ~3 updated (total: 8)
Decisions:     +1 (total: 4)
Events:        +1 (total: 3)
Threads:       1 updated (total: 1)
Synced to:     MemPalace (N drawers), brain.json (N people)
```

### Step 6b: Sync to MemPalace and brain.json

After all brain DB writes complete, run the memory bridge to sync new knowledge to the other memory stores:

```python
from brain.memory_bridge import full_sync
full_sync(db_path, project_slug)
```

This:
1. Copies new entities, decisions, and events to MemPalace as searchable drawers (wing = project slug, room = entity type)
2. Rebuilds brain.json people section from all brain DB person entities across all projects
3. Is best-effort — if MemPalace or brain.json sync fails, brain DB data is still safe

The sync is automatic. No user confirmation needed for this step.

### Step 7: Update knowledge articles

After brain DB writes complete and `full_sync` runs (Step 6b), incrementally update
knowledge articles for entities whose evidence has changed in this session.

**Collect changed entity IDs** from the writes performed in Step 3 (entities upserted,
decisions/events written). Pass these to the knowledge engine for targeted refresh:

```python
import sys, os
sys.path.insert(0, os.path.expanduser("~/.coco/knowledge"))
from engine import KnowledgeEngine

engine = KnowledgeEngine()
# changed_entity_ids = list of brain DB entity IDs written in this session
engine.incremental_update(project_slug, changed_entity_ids)
```

Or equivalently via CLI (re-harvests all entities but only regenerates stale ones):

```bash
python3 ~/.coco/knowledge/cron.py --run --project {slug} --phases 2,3,5
```

Only articles whose `source_hash` changed are regenerated. Expected: 1–5 article
regenerations per typical session. Estimated cost: ~$0.01.

Show result **inline in the existing brain-update summary block**:
```
BRAIN UPDATED
=============
Entities:      +3 (total: 47)
Relationships: +1 (total: 37)
Tasks:         +2, ~3 updated (total: 8)
Decisions:     +1 (total: 4)
Events:        +1 (total: 3)
Threads:       1 updated (total: 1)
Synced to:     MemPalace (N drawers), brain.json (N people)
Knowledge:     N articles refreshed  (N new entities, N updated)
```

**Skip silently if:**
- `~/.coco/knowledge/` does not exist (knowledge engine not installed)
- `cron.py` is unavailable or returns a non-zero exit code
- The knowledge engine step takes more than 60 seconds (non-blocking)

---

## Important Rules

- **Be thorough.** Scan EVERY message. If someone was mentioned by name, they should be an entity. If something was decided, it should be a decision. If there's a next step, it should be a task.
- **Deduplicate.** Check what already exists in the DB before proposing new writes. Use `upsert_entity` which matches on (project_id, type, name) or (project_id, type, external_id).
- **Date everything.** Decisions and events need dates. Use today's date if the exact date isn't clear.
- **Attribute decisions.** Record who decided, not just what was decided.
- **Link to threads.** If a task, decision, or event belongs to an existing thread, link it.

© coco-research · MIT · coco-research/coco

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
DeerDawn hissingspider MCP-сервер DeerDawn хранит контекст сессий, доску задач и карту кодовой базы, чтобы помощник продолжал работу без повторных объяснений. CX Codex +1 2 575установок update официальный anthropics Скилл update для Claude Code сверяет TASKS.md и memory/ с трекером, чатами и почтой — находит пропущенные задачи и пробелы в памяти. CX Codex +1 5 100установок groove-daily-end andreadellacorte Скилл groove-daily-end фиксирует результаты рабочего дня, ведёт журнал в памяти .groove и запускает финальные хуки проекта. CX Codex +1 559установок Obsidian Brain sweir1 Локальный MCP-сервер Obsidian Brain, который даёт агенту семантический поиск, граф связей и запись в хранилище Obsidian. Работает с обычными .md-файлами на диске. CX Codex +1 ★ 14звёзд репо draft-pm-brain idodekerobo Плагин draft-pm-brain для Claude Code: держит контекст продукта и приоритеты загруженными в агента и обновляет их по ходу разговоров. Каждая новая сессия начинается с готовым снимком, а не с нуля. ★ 16звёзд репо compact-praetorian vvkmnn Команда compact-praetorian для Claude Code, которая сохраняет текущий контекст сессии в praetorian-память для использования в следующих сессиях. CX Codex +1 ★ 78звёзд репо

Из того же набора82

Весь набор →
generate-tests Скилл generate-tests пишет тесты для файла, модуля или компонента, сначала определяя фреймворк и конвенции проекта. CX Codex +1 ★ 328звёзд репо m0-handoff Скилл m0-handoff сохраняет состояние сессии в STATE.md и локальный демон M0, чтобы продолжить работу после сжатия контекста или в другой сессии. CX Codex +1 ★ 328звёзд репо goal Хранит активную цель проекта в .goal.md, чтобы агент продолжал работу над задачей между сессиями. CX Codex +1 ★ 328звёзд репо pm-advisor Субагент pm-advisor для управления продуктом: формулирует пользовательские истории, разбивает фичи на задачи и рассчитывает критерии приёмки. CX Codex ★ 328звёзд репо coco-ship Скилл coco-ship помогает оформить ветку, обойти корпоративный git-guard при необходимости, создать пулл-реквест и дождаться CI. Защищает от прямой отправки коммитов в main. CX Codex +1 ★ 328звёзд репо gsd-research-synthesizer Субагент gsd-research-synthesizer сводит результаты четырёх исследовательских субагентов в SUMMARY.md и готовит выводы для дорожной карты проекта. Запускается в процессе /gsd-new-project. CX Codex ★ 328звёзд репо refactoring-specialist Субагент refactoring-specialist для Claude Code пошагово устраняет запахи кода и снижает сложность, проверяя тестами каждое изменение и сохраняя логику системы. CX Codex ★ 328звёзд репо code-reviewer Субагент code-reviewer для ревью кода, архитектуры и безопасности. Проверяет SOLID, DDD, уязвимости, API-дизайн и производительность перед слиянием PR. CX Codex ★ 328звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой