401
Штаб
Штаб это обычная папка на компьютере, по устройству такая же, как остальные. Для вас она главная: в ней лежит всё, что агент должен знать о вас и вашей работе.
Зачем нужен штаб
Штаб от английского headquarters, штаб-квартира. Идея Personal Corp в том, что есть главная комната, откуда вы управляете отделами и агентами. Как штаб-квартира у девелопера: там не строят, там видно все стройки.
Агент видит ту папку, из которой его запустили. Запущенный из штаба, он знает, кто вы и чем занимаетесь. В идеале правила и инструменты штаба покрывают всё, что нужно для работы.
Что лежит в штабе
- Файл правил AGENTS.md: кто вы, как работать, где что лежит. Как агент его читает, разобрано в главе «Как работает агент на компьютере».
- Файл о вас me.md: ваш контекст. Агент доходит до него по ссылке из AGENTS.md в каждой сессии.
- Задачи. Они живут в issues, списке задач репозитория штаба на GitHub.
- План дня. Это один файл со ссылками на задачи, его пишет скилл daily.
- План недели. Он получается из ретро в конце недели, подробно в главе «Операционный цикл недели».
Штаб один
Штаб один на человека. Это единая точка входа для вас и для агента: отсюда начинается день, отсюда видно все дела.
Отделы и проекты лежат рядом, в своих папках. Штаб знает о каждой по строке в своём файле правил. Главное в правилах штаба это навигация: где что лежит, чтобы агент находил нужное за меньшее число шагов.
Штаб бэкапится в GitHub
Штаб хранят в приватном репозитории GitHub. Это бэкап с историей каждой правки: любой шаг агента откатывается к прошлому чекпоинту, а копия штаба открывается с любого компьютера и с телефона.
Штаб проходит три уровня. Сначала он живёт на вашем компьютере. Потом его копия уезжает в приватный репозиторий GitHub. После этого с теми же папками работают ноутбук, телефон, сервер и облачные агенты.
Перенос делает агент. Откройте его в папке штаба и отправьте промпт. Агент поставит GH CLI, программу GitHub для работы из терминала, и попросит подтвердить вход: откроется страница GitHub, где вы введёте одноразовый код.
Опубликуй в ПРИВАТНОМ репозитории на GitHub эту папку. Используй GH CLI, если доступен, если нет, установи доступным образом. Настрой авторизацию через HTTP.Источник: урок 6 программы Personal Corp.
Сделал первый коммит на ветке main: в нём все файлы штаба, содержимое не менял.
Создал приватный репозиторий и отправил туда коммит. Ссылка: github.com/<вы>/hq.
Файлы из .gitignore не отправлял: .env и временные.
Источник ответа: Office Hours 2 второго потока, 22:11–22:43: ведущий читает ответ агента на тот же запрос; ссылка, хеш коммита и список исключённых файлов взяты из конспекта встречи.
Репозиторий должен быть приватным: публичный открыт всему интернету, и ключи из него утекают за минуту.
Как часто синхронизировать
Так часто, как вам нужно. Синхронизация это просьба к агенту: сохранить правки коммитом и отправить их в GitHub. Её можно просить словами или вызывать скиллом.
Удобный ручной вариант: заканчиваете работу за компьютером и вызываете скилл manager. Скилл запишет итог в задачу. Сохранить правки и отправить их в GitHub попросите агента отдельно. После этого свежая версия штаба доступна с телефона и с других устройств. Нужно чаще, попросите агента синхронизировать штаб после каждой задачи.
Как откатывать правки, работать с ветками и проверять работу агента, разобрано в главах «Git: история и откат», «Ветки и рабочие деревья» и «Проверяющий в новой сессии».
Рядом со штабом живут отделы, каждый в своей папке. Из чего состоит отдел и как его завести одной фразой из штаба, разобрано в следующей главе «Отделы».