project-brain — плагин
Плагин Claude Code: структура папки brain и протокол передачи, чтобы агент в новой сессии продолжал проект без потери контекста
- 174 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Плагин создает и обновляет файлы Markdown в папке `brain/` вашего проекта
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/project-brainОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Плагин создает и обновляет файлы Markdown в папке `brain/` вашего проекта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
project-brain вводит в проект папку `brain/` из пяти основных файлов, разделенных по частоте изменений. `PROJECT.md` описывает суть проекта и то, чем он явно не занимается, `MAP.md` служит картой модулей и указателем документов, `STATUS.md` хранит текущее состояние (мягкий предел 80 строк), `DECISIONS.md` ведет журнал решений с обязательными отклоненными вариантами, `HANDOFF.md` содержит отчет смены для следующего окна. Прошлые отчеты лежат в `handoffs/`, а разборы по темам в `topics/`. Плагин добавляет навык с пятью сценариями: запуск нового проекта, возобновление, передача при смене окна (работает и без `brain/`), обновление с одобрением каждого пункта и передача между параллельными потоками работ. Навык включается только по явной просьбе: «set up project brain», «resume this project», «hand off», «update the project brain».
Для кого. Тем, кто ведет долгий проект с ИИ-ассистентом через много сессий и окон и устал каждый раз объяснять, что здесь происходит.
Подходит, если
- Контекст окна заканчивается, и перед сменой нужен отчет для следующей сессии
- Решения тонут в коммитах и переписке, а позже нужно понять, почему выбрано такое решение
- Один README смешивает описание, статус, историю и инструкцию запуска
- Над проектом идут параллельные потоки работ, и они путают, кто чем занят
Не подходит, если
- Проект на один вечер: структура из пяти файлов даст больше затрат, чем пользы
- Нужна автоматическая память без участия человека: обновления навык подсказывает, а вы одобряете
- Вам нужен продукт для командной работы с доступом и ролями: методика локальна и держится на файлах
Пример запроса к агенту
Я меняю окно, подготовь передачу смены для следующей сессии.Ограничения
Это методика и набор шаблонов, автоматической памяти тут нет: структуру нужно поддерживать, обновления навык подсказывает с причинами, одобряете вы каждый пункт. Навык включается только по явной просьбе и не срабатывает оттого, что в проекте есть папка `brain/`. Основной вариант установки рассчитан на Claude Code, а для других ассистентов структуру копируют вручную. В репозитории есть пример `examples/small-saas`. Последний коммит в репозитории датирован октябрем 2026 года.
Как отключить. Выполните `/plugin uninstall project-brain@sprout-labs` и `/plugin marketplace remove Ethan-YS/project-brain`. Папка `brain/` в вашем проекте остается как обычные файлы Markdown.
Частые вопросы
Как установить project-brain?
В Claude Code выполните `/plugin marketplace add Ethan-YS/project-brain` и `/plugin install project-brain@sprout-labs`. В терминале то же делают команды `claude plugin ...`.
Какие фразы запускают навык?
«set up project brain» создает структуру, «resume this project» загружает карту и статус, «hand off» пишет отчет смены, «update the project brain» подсказывает обновления с причинами.
Зачем разделять файлы по частоте изменений?
Редкие и частые данные в одном файле мешают друг другу: читать приходится много, найти нужное трудно. Разделение дает читать два или три файла и сразу работать.
Можно ли использовать без Claude Code?
Да, структура и протокол обычные файлы Markdown. Копируйте шаблон `brain/` и просите ассистента читать `MAP.md` и `STATUS.md` в начале сессии.
Есть ли пример?
Да, в `examples/small-saas` лежит заполненная папка `brain/` небольшого SaaS: PROJECT, MAP, DECISIONS и HANDOFF.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныСкилл ведет память проекта в обычных Markdown-файлах: журнал сессий, вики, правила, список дел и заметка о том, откуда продолжить
Плагин для Claude Code, который хранит память между сессиями в одном локальном файле, без базы, облака и ключей API
Скилл Claude Code собирает контекст продукта в Markdown и связывает решения с интервью, документами и гипотезами
Каркас проекта для Claude Code и Codex: задачи в файлах, роли разработчика и QA, ручное одобрение и общее состояние.
Набор из 58 команд для продакт-менеджера в Claude Code, Codex и Cursor: от идеи и PRD до запуска и анализа роста
ALIVE дает Claude Code память в обычных папках на вашем компьютере, чтобы каждая сессия продолжала работу предыдущей
Коротко о README
В README разобрана проблема длинных проектов с ассистентом, затем показывает структуру папки `brain/`, принципы разделения по времени изменений и установку плагином. Отдельно перечислены сценарии навыка и примеры.