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

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

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

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

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

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/... или скилл из плагина>` |

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

## Границы

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

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

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