# Отдел ИТ

Общие правила и карта отделов лежат в штабе: ../<HQ>/AGENTS.md.

Отдел отвечает за машины человека: ноутбуки, серверы, сеть и доступы. Про каждую машину он знает, что это, что на ней стоит, как на неё зайти и какую работу она делает. Работу ведёт агент-инженер из `agents/engineer.md`: он настраивает и объясняет.

Отдел начинается с одной машины, вашего ноутбука. Вторая машина и сервер добавляются тем же порядком.

## Канон

- `devices/` — опись: один файл на устройство. Правила описи лежат в `devices/README.md`.
- `CONTEXT.md` — словарь отдела: устройство, доступ, разрешение, роль устройства.
- `agents/engineer.md` — агент-инженер: как он работает и чего не делает.
- `.agents/skills/device-inventory/` — снимок устройства скриптом только для чтения и порядок обновления описи.
- `.agents/skills/machine-access/` — как записать доступ к машине в скилл один раз, без секретов.
- Скиллы доступа к конкретным машинам, `.agents/skills/enter-<устройство>/`, появляются по мере заведения машин.

## Правила

1. Любая задача про машину начинается с описи: прочитай `devices/<устройство>.md`. Опись это карта. Перед действием имя хоста и доступность сверь вживую.
2. Устройства нет в `devices/`: заведи опись скиллом `device-inventory`, потом работай.
3. Доступ к машине записывается в скилл один раз (`machine-access`): алиас входа, команда проверки, что делать после входа. Новое окно агента заходит на машину по этому скиллу. Секретов в скилле нет.
4. Сначала чтение. Снимок и проверки идут без повышения прав. Установка, настройка, sudo, перезагрузка, удаление и смена доступов идут после слова человека.
5. Секреты не хранить и не печатать: пароли, приватные ключи, токены, recovery-ключи. В описи и в скиллах стоит имя секрета и место, где он лежит. Приватный ключ не открывай, не копируй и не показывай в чате и в логах.
6. В опись не идут: MAC-адреса, серийные номера, UUID, имя Wi-Fi, точный адрес, окружение процессов, живые числа до байта. Классами: RAM "16 GB", диск "занято 70%".
7. У каждого раздела описи есть дата проверки. Опись обновляется после обновления ОС, смены сети или роутера, установки или удаления агента, смены роли устройства, перед задачей, которая зависит от раздела, и не реже двух раз в год.
8. Пустое не значит "нет". Поле, которое команда не дала, и машина, которая не ответила, записываются в "Не проверено" с причиной и тем, что нужно для проверки.
9. После настройки агент объясняет простыми словами: что изменилось, как проверить и как откатить. Человек должен суметь повторить без агента.
10. Роль устройства для другого отдела описана в том отделе. В файле устройства стоит строка со ссылкой на файл-владелец.

## Словарь

Слова отдела и что они значат лежат в `CONTEXT.md`. Читай его перед работой. Договорились о новом слове или человек поправил слово: сразу допиши определение туда.

## Задачи

Задачи отдела лежат в `tasks/`. Типичные: "подключись к серверу", "создай ключи для входа", "почини принтер", "выдай ноутбук новому сотруднику", "почему ноутбук тормозит", "можно ли оставить машину на ночь".

## Границы

- Секреты, токены, пароли и платёжные данные не хранить.
- Видео, аудио, архивы и секреты в git не идут, их отсекает `.gitignore`. Файл больше 50 МБ другого типа: допиши его в `.gitignore` и скажи человеку, коммит с ним не повторяй.
- Не копировать содержимое отдела в другие папки; ставить ссылку на файл-владелец.
- Карту отделов не дублировать: она живёт в штабе.

## Проверка

```bash
git diff --check
```