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

База представляет собой обычную папку с 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/` доступна только для чтения.

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

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

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