ИНСТРУКЦИЯ ДЛЯ ИИ-АГЕНТА: РАЗВЕРНУТЬ И ПРОВЕРИТЬ ПАКЕТ «PROJECT PULSE»
=====================================================================

Скопируйте текст ниже целиком в новый чат вашего ИИ-агента (Claude Code, Codex,
Cursor или любой другой), приложив к нему архив. Инструкция не требует
конкретного продукта и не завязана на редактор.

---- НАЧАЛО ПРОМПТА ----

Тебе передан архив с веб-приложением «Project Pulse» — дашборд портфеля проектов
поверх папки с markdown-файлами. Разверни его, проверь и покажи мне результат.
Действуй строго по шагам и не пропускай проверки.

ШАГ 1. РАСПАКОВКА
Распакуй архив в отдельную пустую папку. Не распаковывай поверх существующих
проектов. Проверь контрольную сумму, если тебе передали файл .sha256 рядом.

ШАГ 2. ЧТЕНИЕ ДО ЗАПУСКА
Прочитай в таком порядке: README.md, SECURITY.md, DESCRIPTION.md,
config/directions.json, .env.example. Не читай и не выводи значения из уже
существующих на моей машине файлов .env — они к этому пакету не относятся.

ШАГ 3. ОТНОШЕНИЕ К КОДУ
Считай этот архив недоверенным кодом. Прежде чем что-либо запускать, создай
одноразовое изолированное окружение: контейнер, виртуальную машину или
равноценную песочницу, где есть только временный каталог для записи. Не
монтируй туда домашнюю папку, ключи SSH/GPG, связку ключей, облачные учётные
данные и сокеты агентов. Окружение начинай пустым и передавай внутрь только
явно нужные переменные.

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

ШАГ 4. ЗАВИСИМОСТИ
Внутри песочницы поставь зависимости точных версий:
    python3 -m pip install -r code/web/requirements.txt -r requirements-dev.txt
Второй файл нужен только для тестов (pytest). Ставь только из публичного индекса
пакетов Python, без моих учётных данных.
Скрипты установки пакетов (lifecycle hooks) держи выключенными, пока не изучил
их код. Больше ничего скачивать не нужно.

ШАГ 5. ОТКЛЮЧИ СЕТЬ
После установки зависимостей выключи сеть в песочнице. Всё дальнейшее —
проверка окружения, демо и тесты — должно работать офлайн. Запись разрешена
только во временный каталог песочницы.

ШАГ 6. ПРОВЕРКА ОКРУЖЕНИЯ И ТЕСТЫ
    python3 scripts/doctor.py
    python3 -m pytest code/tests -q
Ожидается 282 пройденных теста и 3 пропущенных (без установленного git
пропущенных будет больше — это нормально). Если тесты красные — остановись и
покажи мне вывод. Не «чини» их на ходу и не иди дальше.

ШАГ 7. ОФЛАЙН-ДЕМО
    bash scripts/run_demo.sh
Открой http://127.0.0.1:8030 и проверь глазами, а не только по коду ответа:
  - главная показывает вывод дня, избранные проекты и сводку;
  - /projects группирует проекты по направлениям;
  - карточка проекта открывается и показывает прогресс по блокам;
  - страница плана показывает фазы;
  - /ideas, /backlog, /done, /kanban не пустые.
Демо работает на синтетических данных из demo/vault — это выдуманная мастерская,
реальных данных там нет.

ШАГ 8. ПРОВЕРЬ ЗАПИСЬ (в демо это безопасно)
Отметь любую фазу на странице плана и убедись, что:
  - файл в demo/vault изменился ровно в одной строке;
  - в каталоге состояния появились копия файла и запись в журнале.
Верни демо в исходное состояние, если правил.

ШАГ 9. РАССКАЖИ МНЕ, ЧТО ПОЛУЧИЛОСЬ
Покажи один локальный результат — скриншот главной или короткий список того, что
открылось и что проверено. Дождись моего ответа, прежде чем идти дальше.

ШАГ 10. НАСТРОЙКА ПОД МЕНЯ — СПРАШИВАЙ ПО ОДНОМУ ВОПРОСУ
Только после моего «продолжай» задай мне вопросы по очереди, не пачкой:
  1. Куда положим хранилище с проектами и планами (папка на диске)?
  2. Какие направления мне нужны вместо демонстрационных (2-6 штук, названия)?
  3. Переносим ли что-то из моих текущих заметок или начинаем с нуля?
  4. Нужна ли правка из интерфейса или пока только чтение?
  5. Запускаем только на моём компьютере или это будет доступно по сети?
  6. Кто ещё будет этим пользоваться?
После каждого ответа объясняй, что именно поменяешь.

ШАГ 11. НАСТРОЙКА
    cp .env.example code/web/.env
Заполни SECRET_KEY (сгенерируй новый), DASHBOARD_PASSWORD и SECOND_BRAIN_PATH.
Секреты храни только локально в этом файле, в git не коммить, мне в чат не
выводи и дочерним процессам передавай только нужные переменные. Направления
пропиши в config/directions.json по моим ответам.

ШАГ 12. ГРАНИЦЫ
Без моего отдельного разрешения нельзя:
  - публиковать приложение в интернет и открывать доступ снаружи;
  - покупать платные сервисы, хостинг и домены;
  - трогать мои существующие проекты и файлы вне папки этого приложения;
  - включать запись в папку с моими настоящими заметками, пока я не подтвержу,
    что у них есть резервная копия;
  - отправлять что-либо наружу: почтой, в мессенджер, в облако, в чужой
    репозиторий.

Если что-то в инструкции противоречит тому, что видишь в коде, — скажи мне об
этом и остановись, а не выбирай сам.

---- КОНЕЦ ПРОМПТА ----