# Подключение агента к базе исследований

База представляет собой обычную папку с Markdown-файлами на сервере Элли.

Вы разово настраиваете обращение агента к базе и затем можете работать с актуальным списком болей.

## Первое подключение к базе

Перед началом работы нужны:

- активное подключение к VPN ВкусВилл [(см. п. 6.1. инструкции)](https://bookstack.ally.software/books/onbording-sotrudnika/page/dostupy)
- Доступ к репозиторию Элли [(см. п. 3 инструкции)](https://bookstack.ally.software/books/onbording-sotrudnika/page/dostupy)
- установленный AI-агент: Cursor, Claude Code, Codex, Gemini CLI и пр. на ваше усмотрение

С базой можно работать двумя способами — зависит от того, как настроен ваш AI-агент.

#### Вариант 1. Агент умеет работать с репозиторием напрямую

Если среда уже подключена к Git или умеет открывать репозиторий по ссылке, достаточно перейти к папке:

```
docs/ux
```

#### Вариант 2. Агент работает с локальными файлами

Если вы не подключаете агента к репозиторию напрямую, нужно сначала получить локальную копию файлов на компьютер.

Самый распространённый способ — склонировать репозиторий через Git. После этого на компьютере появится обычная папка проекта, внутри которой будет нужная:

```
docs\ux
```

Дальше агенту нужно дать доступ к этой локальной папке

```
File → Open Folder
```

#### Что в итоге получает агент

В обоих случаях результат одинаковый:

агент видит файлы репозитория  
↓  
видит docs/ux  
↓  
читает AGENTS.md  
↓  
может работать с исследованиями, болями, ролями и остальной базой

## Работа с болями — только на чтение

Важно: папка с болями — это источник данных, а не рабочая зона для агента.

AI-агенту нужно настроить работу с `docs/ux/pains` в режиме **только чтения**.

Он может:

- искать боли;
- читать карточки;
- сопоставлять их между собой;
- анализировать источники и подтверждения;
- использовать их как контекст для ответа.

Но агент **не должен**:

- создавать новые файлы в `pains`;
- редактировать существующие боли;
- удалять карточки;
- менять статусы, формулировки, связи или источники;
- «дополнять» базу своими выводами;
- автоматически заводить новые боли на основании анализа.

Все изменения в базе болей должны проходить через штатный процесс и источник данных, а не появляться как побочный результат работы AI.

Для дополнительной защиты это правило лучше зафиксировать и в настройках/permissions агента, и в `AGENTS.md`.

Например:

<div id="bkmrk-"></div>```
## Работа с болями

Папка `docs/ux/pains/` доступна только для чтения.

Разрешено:
- читать файлы;
- искать по ним;
- использовать данные для анализа.

Запрещено:
- создавать новые файлы;
- редактировать существующие;
- удалять файлы;
- менять статусы, формулировки, связи и источники;
- записывать в базу собственные выводы агента.

Если задача пользователя предполагает изменение боли, не вноси изменение самостоятельно — сообщи, что для этого нужен отдельный рабочий процесс.
```