Контекстный фреймворк на хуках для агентов
desk-core решает, что агент видит в контексте и когда.
- Правило — к вызову, последним перед решением
- Запрещённый вызов не проходит
- Правила — твои markdown-файлы
Зачем
Контекст агента — ресурс, а не свалка. Файл инструкций читается один раз на старте, и к двадцатому шагу от него мало что остаётся; правило из прозы может молча не исполниться — и узнаёшь об этом по коммиту с чужой подписью или по правке кода, который стоит денег.
Контекстом можно управлять так же, как веб-фреймворк управляет запросом. Хуки — точки жизненного цикла агента: старт сессии, реплика, вызов инструмента, его результат. desk-core встаёт в каждую и решает, что положить в контекст к этому вызову и что остановить до выполнения — регулярным выражением или десятью строками Python.
Момент важен не меньше содержания. То, что принёс хук, — самое свежее в контексте: короткий текст про то самое действие, которое агент делает прямо сейчас. Это же правило, прочитанное на старте, к этому времени лежит под сотней килобайт кода и вывода команд. Вес у него разный, хотя слова те же.
Как у любого фреймворка, механика отделена от содержания. Он не знает ни одного инструмента, трекера или места работы: всё это написано в твоих файлах, и их можно читать без него.
Как работает
Ты пишешь правило — markdown-файл с шапкой. Дальше работает жизненный цикл агента: в каждой его точке стоит хук фреймворка.
SessionStartстартует сессияСобирает стартовый контекстМесто работы — поgit remoteили каталогу. Файлы ярусаsessionедут содержимым, до первого действия.UserPromptSubmitпришла репликаПодаёт по темеТема названа словами — её правило приезжает вместе с репликой, раньше первого инструмента.PreToolUseагент зовёт инструментПодаёт и решаетВызов сверяется сwhenиguardвсех применимых правил: сработавшее — в контекст, запрещённое — отклонить, спорное — спросить тебя.PostToolUseкоманда выполниласьСверяет с фактомЧто команда изменила на самом деле — и те же правила по изменённым файлам: запись скриптом не проходит мимо.SessionEndсессия закончиласьЗакрывает сессиюСтрока в журнал сессий, если он включён, и событие расширениям.
Все пять — одна точка входа, desk-hook, без вызова модели. После сессий desk measure считает по их записям, дошло ли сработавшее правило до агента и какая доля вызовов прошла запрет.
Сверх доставки правил — дополнения, выключенные, пока не включишь в desk.yml: нити — намерения и разборы, которые живут дольше сессии (каждая сессия начинается со списка открытых); журнал сессий; сигнал «мета», когда настройка desk съедает работу; шапка сессии; свод рабочих деревьев и стеков; возврат простаивающего чекаута к базе; дерево сессии. Без них ядро состояние git не меняет.
Попробовать
Пять минут, ничего не ставя: скелет правил и сухой прогон
git clone https://github.com/dqnison/desk-core ~/desk-corealias desk=~/desk-core/bin/deskdesk init ~/desk-tryexport DESK_HOME=~/desk-trydesk why 'git commit -m "fixed bug"'Живая сессия с хуками — только на этот запуск, конфиг не меняется
claude --plugin-dir ~/desk-coreНасовсем: CLI пакетом, хуки плагином
uv tool install git+https://github.com/dqnison/desk-coreclaude plugin marketplace add dqnison/desk-coreclaude plugin install desk@desk-coredesk doctorУже есть CLAUDE.md — не выбрасывать, а разложить на правила
desk import CLAUDE.mdРазделы ## становятся правилами яруса import — модель видит то же, что раньше. Дальше разделу даёшь свой when:, и он приезжает к действию, а не висит в каждой сессии.
Без плагина: desk init --hooks печатает блок для ~/.claude/settings.json; DESK_HOME — там же, в ключе env. Хуки — только Claude Code; Codex и Cursor получают вход через desk export agents-md, без подачи по действию и запретов. Подробности — руководство, README и решения.
Контекст агента — по правилам, а не по памяти
Markdown-файлы и хуки. Без облака, без зависимостей, без вызова модели.