VC-Forge

VC-Forge (VIBECODING) - це повноцінний робочий простір для вайбкодингу за адресою /vc-forge. Опишіть, що вам потрібно, оберіть модель і навички - і він запише проєкт у теку, яку ви потім можете редагувати вручну, запускати й розгортати.

Що робить

VC-Forge - це робочий простір для коду, побудований навколо трьох панелей: кросплатформний Explorer ліворуч, центральний редактор із вкладками CODE / PREVIEW / DIFF / TERM і права панель DISPATCH, де ви будуєте. Ви описуєте «вайб», обрана модель пише файли, а ви доопрацьовуєте - повторним промптом, ручним редагуванням у справжньому редакторі або в інтегрованому терміналі. Gemini через проксі Antigravity - протестований рушій.

Проєкти зберігаються в ~/Obsidian/maven-os/vibecoding/<date>-<slug>/, якщо ви не вкажете для проєкту іншу теку. Кожен проєкт - це тека з транскриптом session.md.

Explorer

Переглядає сховище (vault) Obsidian VIBECODING або будь-яку теку на диску - Linux, Windows чи macOS. Файли, відкриті з диска через Explorer, можна редагувати й зберігати так само, як і власні файли проєкту.

Вкладки редактора

• CODE - справжній редактор. Коли модель завершить, відредагуйте будь-який файл вручну й збережіть кнопкою Save або Ctrl/⌘-S. Працює і для власних файлів проєкту, і для будь-якого файлу, відкритого з диска через Explorer.
• PREVIEW - живий попередній перегляд проєкту.
• DIFF - перегляд змін.
• TERM - живий термінал у проєкті (дивіться «Термінал» нижче).

Кнопка ⤢ розгортає весь редактор на весь екран.

Панель DISPATCH - збірка

Тут ви налаштовуєте й запускаєте збірку:

• Model - Gemini, Claude, ChatGPT, Grok, Kimi, Qwen або DeepSeek, кожна маршрутизується до того бекенду, який доступний у цій установці. Gemini (через проксі Antigravity) - протестований рушій.
• Skills - той самий пікер ⚡ Skills, що й у консолях AI-моделей: вкладка Installed (вибір із встановленого) і вкладка Find new (живий пошук на skills.sh із встановленням в один клік через шлюз безпеки). Фіксованого списку пресетів немає - лише навички, які ви встановлюєте чи обираєте. Інструкції обраних навичок вбудовуються в промпт моделі, тож вони формують те, що вона будує.
• Vibe - довільний текстовий опис того, що треба побудувати.
• Settings - стиль, ціль збірки, фронтенд, бекенд, база даних і мова текстів.

Режими

• AUTO - пише файли за один прохід.
• STEP - спершу повертає план і застосовує його після вашого OK.
• SPEC - конвеєр, керований специфікацією: requirements → design → tasks, кожна фаза виконується обраною вами моделлю (CLI, проксі або OAuth). Далі детермінований шлюз перевіряє, що кожен id вимоги (REQ-n.m) покритий задачею, і позначає нерозв’язані відкриті питання, перш ніж ви перейдете до реалізації. SPEC записує requirements.md, design.md і tasks.md у проєкт для перегляду; розв’яжіть усе, що позначив шлюз, і запустіть знову. Конвеєр SPEC і шлюз - чистий TypeScript; лише необов’язкова навичка property-тестів потребує Python venv (дивіться «Налаштування»).

Термінал

Інтегрований ≡ Terminal має дві вкладки, кожна - окрема сесія:

• Shell - звичайна оболонка в директорії проєкту.
• Herdr - мультиплексор агентів.

⧉ Клонування сайту

Вставте URL у поле Clone a website угорі DISPATCH (або в діалог New project) і натисніть Scan & clone.

• Спершу сканування безпеки. M.A.V.E.N сканує сторінку та її скрипти на PHP-вебшели, самодекодований JavaScript, криптомайнери, скімери карток, приховані iframe та відкриті .env/.git. Вердикт dangerous зупиняє клонування й перелічує знайдене; ви все одно можете натиснути Clone anyway, якщо знаєте, що робите.
• Кількість сторінок. Оберіть, скільки PAGES витягнути - 1 (лише вказана сторінка) або 10 / 25 / 50 / 100. Далі він іде за посиланнями в межах сайту, захоплює кожну сторінку за її справжнім шляхом і переписує посилання між ними, щоб копія переглядалася офлайн. docs/pages.md перелічує, що було й що не було захоплено.
• Результат. Сторінка, її ассети (CSS, JS, зображення, шрифти - зокрема ті, на які посилаються стилі) та видобуті дизайн-токени зберігаються в ~/Obsidian/maven-os/vibecoding/<site-name>/. Проєкт відкривається з готовими до редагування index.html, CLONE.md і docs/. Захоплення - це звичайний код, тож далі з ним може працювати будь-яка модель.

Клонуйте лише те, що маєте право копіювати.

Проєкти

NEW PROJECT і випадний список історії проєктів працюють як у S-Forge - кожен проєкт є текою з транскриптом session.md. Експортуйте будь-який проєкт як .zip або JSON.

Розгортання

Запускайте локально, надсилайте на Vercel/Netlify (коли виконано вхід) або відправляйте на самостійно розгорнутий інстанс Openship; кнопка показує активний контекст.

Перед розгортанням спершу виконується сканування секретів по проєкту. Якщо воно знаходить закомічені облікові дані (API-ключі, приватні ключі, токени, заповнені значення env), розгортання призупиняється й показуються замасковані збіги (file:line · rule) з кнопками Cancel / Deploy anyway. Це попередження, яке можна проігнорувати - перенесіть ключ у змінну оточення або розгортайте попри все. Сканування локальне й ніколи не покидає вашу машину.

Налаштування

Інтегрований термінал і розгортання в один клік використовують нативні @homebridge/node-pty-prebuilt-multiarch + @xterm/xterm, які npm install підтягує з готовими бінарниками для Linux/macOS/Windows (у звичайному випадку компілятор не потрібен). Необов’язкова навичка property-тестів режиму SPEC потребує Python 3.11+ із hypothesis/pytest в окремому venv (.maven/vcforge/spec/.venv); самим конвеєру SPEC і шлюзу нічого з цього не потрібно. Кожній моделі в пікері DISPATCH потрібен той бекенд, до якого вона прив’язана (вхід CLI, проксі Antigravity або OAuth/API-ключ).

Поради

• Gemini через проксі Antigravity - рушій, на якому тестується VC-Forge, - беріть його першим.
• Використовуйте SPEC, коли хочете, щоб шлюз покриття вимог виявив прогалини до написання коду; використовуйте AUTO для швидкого одного проходу.
• Вкажіть для проєкту теку на диску (через Explorer або New project), щоб працювати поза сховищем.

Дивіться також

• S-Forge - має таку саму модель «тека проєкту + транскрипт».
• Local-first
• Оркестрація