AGENTS.md@templates/hq git:20260806.9d3660eA

Immutable. This exact content is served forever at /api/v1/blob/44342cafd172682b.

# Правила штаба

> Этот файл задаёт правила папки. Агент читает его первым и работает в его границах.

## Кто здесь работает

| Кто | Что делает | Чего не делает |
|---|---|---|
| Человек | Ставит цель, выбирает следующий ход, принимает результат | Не исполняет то, что уже описано скиллом |
| Агент | Читает правила, исполняет, оставляет след | Не решает за человека и не меняет правила молча |
| Субагент | Берёт ограниченную подзадачу и возвращает результат | Не пишет правду о системе и не принимает результат |

## Порядок чтения

1. Этот файл: правила и границы.
2. [`me.md`](./me.md): кто владелец штаба.
3. [`tasks.md`](./tasks.md): что делается сегодня.
4. Нужный отдел из таблицы ниже, если задача принадлежит домену.

Открывай только то, что нужно текущей задаче.

## Где живёт правда

Таблица отвечает на вопрос "мне нужно X, куда идти". Заполните её под себя и удалите лишнее.

| Если нужно | Идти сюда |
|---|---|
| Кто я и чем занимаюсь | `me.md` |
| Что делаю сегодня | `tasks.md` |
| Очередь, статусы и состояние длительных задач | `<трекер или tasks.md, пока трекера нет>` |
| Правда по домену `<домен>` | `../<отдел>/AGENTS.md` |
| Правила работы агента | этот файл |

Одна истина живёт в одном месте. Если один и тот же факт лежит в двух файлах, один из них устарел.

## Отделы рядом

Отдел это соседняя папка, которая отвечает за один домен и копит по нему опыт. Отделы лежат **рядом со штабом, на одном уровне с ним**.

| Отдел | Домен | Папка |
|---|---|---|
| `<название>` | `<за что отвечает>` | `../<папка>` |

Когда появляется новое направление работы, заводите отдел из шаблона `templates/department`, а не новую папку внутри штаба.

## Очередь и задачи

Очередь принадлежит операционному слою, штаб её не хранит. Штаб знает только, **где она лежит**.

- Сегодняшний список лежит в [`tasks.md`](./tasks.md).
- Состояние длительной задачи живёт в одном месте: либо в её файле, либо в трекере. Держать его в двух местах сразу нельзя.
- Работа, о которой не осталось следа в задаче, считается несделанной.

## Скиллы

Скиллы штаба лежат в [`skills/`](./skills/) и подключаются отсюда, а не угадываются моделью.

| Запрос | Что читать и исполнять |
|---|---|
| `<план на сегодня>` | `<skills/... или скилл из плагина>` |
| `<ретро недели>` | `<skills/... или скилл из плагина>` |
| `<план недели>` | `<skills/... или скилл из плагина>` |

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

## Границы

- Не выдумывай факты. Если источника нет, скажи "не знаю" и назови, чего не хватает.
- Не меняй правила без явной просьбы человека. Предложи правку и дождись ответа.
- Секреты, токены и приватные данные в файлы штаба не попадают.
- Прежде чем создать новый файл, проверь, нет ли уже места для этой правды.

## Как менять этот файл

Правило появляется здесь, когда одно и то же пришлось поправить дважды. Одно исправление это случай, два исправления это правило.