Claude

Cog: когнитивная архитектура памяти для Claude Code на чистом тексте

Open-source когнитивная архитектура, которая учит Claude Code управлять собственной памятью через обычные текстовые файлы. 300 звёзд на GitHub за первую неделю.

Зачем ИИ-агенту память

У Claude Code есть проблема, знакомая каждому, кто работает с ИИ-агентами: контекстное окно конечно. Закрыл терминал, и агент забыл всё, что вы обсуждали. Anthropic постепенно решает это через CLAUDE.md и недавний Auto Dream, но разработчик Марсио Пуга (Marcio Puga) пошёл дальше. Он собрал Cog — когнитивную архитектуру, в которой Claude Code сам управляет своей памятью через обычные текстовые файлы.

За несколько дней проект набрал 155 очков на Hacker News и почти 300 звёзд на GitHub.

Репозиторий Cog на GitHub. Источник: github.com/marciopuga/cog

Что такое Cog

Cog — набор соглашений, а не программный код. Нет сервера, рантайма или внешних зависимостей. Вся архитектура описана в markdown-файлах: CLAUDE.md задаёт правила работы с памятью, а скилл-файлы в .claude/commands/ обучают Claude конкретным рабочим процессам.

Файловая система здесь и есть интерфейс. Claude Code работает с памятью теми же Unix-инструментами, которые уже знает: grep, find, git diff. Вы видите каждый файл, можете отредактировать любую запись, а git покажет, что изменилось после последнего цикла обслуживания.

Три уровня памяти

Cog организует информацию в три яруса по степени «горячести»:

Hot Memory — оперативная

Файл до 50 строк, который загружается всегда. Здесь лежат текущие приоритеты, активные задачи и ключевые контексты.

Warm Memory — доменная

Тематические файлы, которые подгружаются по необходимости. Внутри три типа данных:

Observations — хронологический лог событий. Append-only записи вроде: «2026-03-10 [work]: Провёл код-ревью, нашёл утечку памяти в сервисе авторизации»
Action items — задачи с дедлайнами
Entities — реестр людей, проектов, сервисов с ключевыми фактами и датой последнего обновления

Glacier — архив

Холодное хранилище. Устаревшие данные архивируются с YAML-фронтматтером и индексируются. Claude извлекает их по запросу, но не тратит контекстное окно на хранение.

Информация течёт снизу вверх: наблюдения превращаются в паттерны, паттерны уплотняются в горячую память. Каждый следующий ярус меньше и конкретнее предыдущего.

Конвейер обслуживания

Память без ухода деградирует: копятся дубликаты, устаревают факты, рассыпается структура. Cog решает это четырьмя командами, которые можно запускать вручную или по расписанию:

/housekeeping — архивирует устаревшие данные, чистит горячую память, перестраивает индексы
/reflect — анализирует недавние разговоры, извлекает паттерны, находит повторяющиеся темы
/evolve — аудит самой архитектуры: какие правила работают, какие нет, что стоит изменить
/foresight — анализ связей между доменами, стратегические рекомендации на основе накопленного контекста

Марсио Пуга считает /foresight главным отличием от конкурентов: «Самая большая разница — это именно foresight», написал он в обсуждении на Hacker News.

Threads — слой Zettelkasten

Когда тема всплывает в наблюдениях 3 и более раз за две недели, Cog выделяет её в отдельный тред. Тред собирает разрозненные фрагменты в связный файл с тремя секциями:

Current State — перезаписываемое резюме текущего положения дел
Timeline — хронология с датами, только дополнение
Insights — выводы и замеченные закономерности

Оригинальные записи при этом остаются на местах. Тред ссылается на них через вики-ссылки [[domain/filename]], как в классическом Zettelkasten: атомарные заметки, связанные перекрёстными ссылками.

Cog и встроенная память Claude Code

По состоянию на март 2026 года у Claude Code четыре собственных слоя памяти:

CLAUDE.md — инструкции, которые пишет пользователь
Auto Memory — заметки, которые Claude записывает по ходу сессии
Session Memory — непрерывность внутри разговора
Auto Dream — периодическая консолидация накопленных данных

Auto Dream — свежая функция, которую Anthropic начала раскатывать в марте 2026. Раз в 24 часа (после 5+ сессий) подагент просматривает файлы памяти, удаляет устаревшее, объединяет дубликаты и перестраивает индекс MEMORY.md.

Cog работает поверх этих механизмов и добавляет несколько вещей, которых у стандартной памяти нет:

Трёхуровневая иерархия с явной ротацией горячего, тёплого и холодного
Самоэволюция правил через /evolve
Стратегический /foresight с рекомендациями на стыке разных доменов
Zettelkasten-треды для долгосрочных тем
Полная прозрачность через git — каждое изменение памяти отслеживается

Что говорит сообщество

На Hacker News проект вызвал оживлённое обсуждение.

Пользователь rodspeed заметил, что не все сохранённые факты одинаково надёжны. Факт, который агент вывел один раз три месяца назад, должен «затухать» иначе, чем подтверждённый в 20 сессиях. Его предложение — добавить оценки уверенности и механизм затухания.

Несколько разработчиков возразили, что для чисто программистских задач хватает явных правил и документации проекта. cjonas написал: «Явные правила и навыки гораздо конкретнее, менее шумные и проще в поддержке».

zer00eyz сослался на исследования, показывающие рост галлюцинаций при длинном контексте, и выступил за минимальные контексты, сфокусированные на задаче.

Отдельная ирония: несколько комментаторов пожаловались на «мёртвый, бездушный» стиль текстов на сайте проекта. Документация инструмента для ИИ-памяти сама написана ИИ.

Как попробовать

Установка:

git clone https://github.com/marciopuga/cog
cd cog

Откройте папку в Claude Code и запустите /setup. Cog задаст вопросы о вашей работе: компания, проекты, что хотите отслеживать. На основе ответов сгенерирует структуру: доменный манифест, директории памяти, скилл-файлы и таблицу маршрутизации.

Лицензия — MIT. Требуется только Claude Code. Через MCP (Model Context Protocol) можно подключить Google Calendar, Gmail, Slack, GitHub, Linear и другие сервисы.

Зачем это нужно

Cog не заменяет встроенную память Claude Code, а надстраивается над ней. Подход «соглашения вместо кода» делает архитектуру простой в настройке: отредактировал markdown-файл, и поведение агента изменилось. А git-история позволяет наблюдать, как память меняется со временем.

Для тех, кто использует Claude Code как постоянного рабочего помощника, а не инструмент для разовых задач, Cog даёт структуру, которой встроенным средствам пока не хватает. 300 звёзд за первую неделю подтверждают: спрос на такие решения есть.