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

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

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

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

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

•  активное подключение к VPN ВкусВилл (см. п. 6.1. инструкции)
• Доступ к репозиторию Элли (см. п. 3 инструкции)
• установленный 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.

Например:

## Работа с болями

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

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

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

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