qvib.pro
EN

~4 мин чтения · новичок

Как установить движок по ссылке — пошагово под каждый инструмент

Что это

После оплаты вы получаете ссылку на установку (/install/<token>) — hosted-страницу, с которой скачиваете пакет своего движка вайб-кодинга под нужную цель и берёте готовый промт-установщик. Дальше установка — это распаковать архив в папку проекта и один раз нажать Trust. Всё остальное — субагенты, команды, правила, хуки-предохранители, MCP и слои модулей, которыми вы расширили движок, — уже разложено внутри архива.

1Открой install-ссылкупришла после оплаты2Скачай zip под свой инструментClaude Code / Cursor / AGENTS.md3Распакуй в папку проектапустую или существующую4Нажми Trust в Claude Codeактивирует хуки и MCP5Проверь: /engine-doctor → /questдвижок отвечает
От ссылки до рабочего /quest — один ручной шаг (Trust)

Почему так

Пакет приходит с уже готовой раскладкой под целевой инструмент: файлы лежат ровно там, где их читает Claude Code (.claude/…), Cursor (.cursor/…) или любой агент через AGENTS.md. Вам не нужно понимать внутренности и вручную собирать конфиги — движок разложен так, что подхватывается автоматически. Есть и INSTALL-PROMPT.md — вербатим-инструкция целевой модели, если вы хотите, чтобы установку и проверку прогнала она.

Общие шаги (одинаковы для всех)

  1. Откройте install-ссылку. Страница проверяет, что заказ оплачен (order.status='paid') — при chargeback ссылка инвалидируется.
  2. Выберите цель: Claude Code, Cursor или VS Code / любой агент (AGENTS.md).
  3. Скачайте zip под цель.
  4. Распакуйте в папку проекта (пустую или существующую), нажмите Trust и проверьте, что /quest отвечает.

Секреты (например GITHUB_MCP_PAT) задаются в окружении, не в файлах — движок укажет только имена. Никакой строки подключения к БД пакет не требует: в базовый Quest серверы БД не входят.

Под каждый инструмент

Claude Code

  1. Распакуйте архив в папку проекта. Внутри уже готовые .claude/ (agents, commands, skills, hooks, settings.json), .mcp.json, AGENTS.md и CLAUDE.md. Ничего перекладывать вручную не нужно.
  2. Откройте папку в Claude Code и нажмите Trust в диалоге доверия — это единственный ручной шаг. Он активирует хуки-предохранители и MCP из пакета.
  3. Если у вас УЖЕ был свой CLAUDE.md — не перезаписывайте его: просто допишите строку @AGENTS.md (упакованный CLAUDE.md — это тонкий шим, который и делает @AGENTS.md).
  4. Проверка: /quest <задача> отвечает; /hooks показывает guard-dangerous; субагенты видны в /agents. Если /quest нет — файлы легли не в .claude/commands/.

Cursor

  1. Распакуйте так, чтобы .cursor/rules/*.mdc и .cursor/mcp.json легли в корень проекта. Cursor понимает .mdc-правила нативно (always / auto-glob / agent / manual).
  2. Секреты MCP — в окружение, .cursor/mcp.json ссылается на них плейсхолдерами.
  3. Честно: guard-денилист в Cursor — это строгая инструкция (ADVISORY). Жёсткая ENFORCED-блокировка на этой цели — через переносимый safety floor: он уже входит в пакет (см. ниже).

VS Code (и любой другой агент — через AGENTS.md)

  1. Положите AGENTS.md в корень репозитория — его понимают VS Code/Copilot, Codex, Jules, Zed, Cursor и др.
  2. Настройте MCP-серверы из секции «MCP» в вашем клиенте (значения секретов — из окружения).
  3. Guard-денилист здесь тоже ADVISORY; ENFORCED-слой даёт переносимый safety floor из пакета.

Портируемый safety floor — уже в пакете (не roadmap)

Независимо от цели пакет кладёт переносимый ENFORCED-слой, который работает и вне Claude Code:

  • .engine/hooks/pre-commit — самодостаточный POSIX git-hook (чистый sh + grep, без Node): сканирует staged-файлы и блокирует коммит при попадании секрета или деструктивного маркера. Вооружается один раз: git config core.hooksPath .engine/hooks && chmod +x .engine/hooks/pre-commit.
  • .github/workflows/engine-guard.yml — CI, который прогоняет тот же скан на каждый push/PR — enforced независимо от того, вооружён ли локальный hook.
  • .engine.json — манифест пакета с детерминированным contentHash (sha256 по всей раскладке файлов): по нему видно, что именно установлено и не менялся ли пакет.

То есть блокировка опасного — не «обещание на потом»: локальный hook + CI отгружаются в архиве уже сейчас.

Worked-пример (Claude Code)

Вход: оплатили Quest, открыли install-ссылку, скачали forge-core-claude-code.zip, распаковали в папку проекта.

Что вы делаете: открываете папку в Claude Code, нажимаете Trust. Если хотите — вставляете INSTALL-PROMPT.md, и модель сама прогонит чеклист готовности. Текст промта выглядит так (сокращённо):

«Установи движок «Quest» (forge-core@2.0.0), цель — Claude Code. Файлы уже разложены в .claude/ — проверь, что они на месте. Создай рабочие папки движка (.engine/…), которых нет в архиве. Если для GitHub-MCP понадобится доступ — запроси имя секрета (GITHUB_MCP_PAT), объясни зачем, и дождись значения в окружении; в файлы значение НЕ записывай. Прогони чеклист готовности и покажи результат по каждому пункту. Дальше работай по движку quest, фазы: Анализ → Спека → План → Реализация → Сдача → Обучение.»

Результат: движок установлен и живой после Trust. Подхвачена команда из 8 специалистов (product-owner, analyst, architect, designer, engineer, reviewer, security, quest-verifier) и 13 призм ревью, .mcp.json проводит инструменты (секреты — плейсхолдерами). Можно давать первую задачу через /quest.

Честные оговорки

  • ENFORCED-блок опасных команд «в моменте» (PreToolUse-hook) сегодня — только в Claude Code. В Cursor и через AGENTS.md денилист — ADVISORY, но переносимый safety floor (pre-commit + CI) даёт ENFORCED-границу на любой цели уже сейчас.
  • Пакет — это plaintext на вашем диске: его видно и можно читать. Мы этого не скрываем.
  • Учёт установок (лимит на покупку, вотермарк) — серверная механика страницы установки; сам движок после установки автономен: задачи, решения и бэклог ведутся локально в .engine/.
← вся документация