AGENTS.md@templates/hq · diff
git:20260806.6f37195 to git:20260806.9d3660e
13 added, 13 removed. Audit A to A.
# Правила штаба
- > Этот файл — источник правил папки. Агент читает его первым и работает в его границах.
+ > Этот файл задаёт правила папки. Агент читает его первым и работает в его границах.
## Кто здесь работает
| Кто | Что делает | Чего не делает |
|---|---|---|
| Человек | Ставит цель, выбирает следующий ход, принимает результат | Не исполняет то, что уже описано скиллом |
| Агент | Читает правила, исполняет, оставляет след | Не решает за человека и не меняет правила молча |
| Субагент | Берёт ограниченную подзадачу и возвращает результат | Не пишет правду о системе и не принимает результат |
## Порядок чтения
- 1. Этот файл — правила и границы.
- 2. [`me.md`](./me.md) — кто владелец штаба.
- 3. [`tasks.md`](./tasks.md) — что делается сегодня.
- 4. Нужный отдел из таблицы ниже — если задача принадлежит домену.
+ 1. Этот файл: правила и границы.
+ 2. [`me.md`](./me.md): кто владелец штаба.
+ 3. [`tasks.md`](./tasks.md): что делается сегодня.
+ 4. Нужный отдел из таблицы ниже, если задача принадлежит домену.
- Не читай всё подряд. Открывай только то, что нужно текущей задаче.
+ Открывай только то, что нужно текущей задаче.
## Где живёт правда
- Таблица отвечает на вопрос «мне нужно X, куда идти». Заполните её под себя и удалите лишнее.
+ Таблица отвечает на вопрос "мне нужно X, куда идти". Заполните её под себя и удалите лишнее.
| Если нужно | Идти сюда |
|---|---|
| Кто я и чем занимаюсь | `me.md` |
| Что делаю сегодня | `tasks.md` |
| Очередь, статусы и состояние длительных задач | `<трекер или tasks.md, пока трекера нет>` |
| Правда по домену `<домен>` | `../<отдел>/AGENTS.md` |
| Правила работы агента | этот файл |
Одна истина живёт в одном месте. Если один и тот же факт лежит в двух файлах, один из них устарел.
## Отделы рядом
- Отдел — соседняя папка, которая отвечает за один домен и копит по нему опыт. Отделы лежат **рядом со штабом, не внутри него**.
+ Отдел это соседняя папка, которая отвечает за один домен и копит по нему опыт. Отделы лежат **рядом со штабом, на одном уровне с ним**.
| Отдел | Домен | Папка |
|---|---|---|
| `<название>` | `<за что отвечает>` | `../<папка>` |
Когда появляется новое направление работы, заводите отдел из шаблона `templates/department`, а не новую папку внутри штаба.
## Очередь и задачи
- Очередь — операционный слой, штаб её не хранит. Штаб знает только, **где она лежит**.
+ Очередь принадлежит операционному слою, штаб её не хранит. Штаб знает только, **где она лежит**.
- - Сегодняшний список — в [`tasks.md`](./tasks.md).
- - Состояние длительной задачи — в одном месте: либо в её файле, либо в трекере. Не в двух сразу.
+ - Сегодняшний список лежит в [`tasks.md`](./tasks.md).
+ - Состояние длительной задачи живёт в одном месте: либо в её файле, либо в трекере. Держать его в двух местах сразу нельзя.
- Работа, о которой не осталось следа в задаче, считается несделанной.
## Скиллы
Скиллы штаба лежат в [`skills/`](./skills/) и подключаются отсюда, а не угадываются моделью.
| Запрос | Что читать и исполнять |
|---|---|
| `<план на сегодня>` | `<skills/... или скилл из плагина>` |
| `<ретро недели>` | `<skills/... или скилл из плагина>` |
| `<план недели>` | `<skills/... или скилл из плагина>` |
Правила этой папки сильнее общих: если скилл с таким же именем есть и снаружи, в этой папке действует тот, который назван здесь.
## Границы
- - Не выдумывай факты. Если источника нет, скажи «не знаю» и назови, чего не хватает.
+ - Не выдумывай факты. Если источника нет, скажи "не знаю" и назови, чего не хватает.
- Не меняй правила без явной просьбы человека. Предложи правку и дождись ответа.
- Секреты, токены и приватные данные в файлы штаба не попадают.
- Прежде чем создать новый файл, проверь, нет ли уже места для этой правды.
## Как менять этот файл
- Правило появляется здесь, когда одно и то же пришлось поправить дважды. Одно исправление — это случай, два — это правило.
+ Правило появляется здесь, когда одно и то же пришлось поправить дважды. Одно исправление это случай, два исправления это правило.