@warpgogol/forge 1.1.0 → 2.1.0

package/README.uk.md

@@ -12,13 +12,49 @@ Forge підтримує чотири типи проєктів. Ви обира
 | --- | --- | --- |
 | **Вебсайт** | Публічний сайт або вебзастосунок — сторінки, блог, портфоліо, лендінг, інтернет-магазин | Сайт фотостудії, сайт ресторану, лендінг SaaS |
 | **Браузерна гра** | Інтерактивна гра, що працює в браузері — 2D, аркада, головоломка, пригода | Лови зірки, головоломка з плитками, платформер |
-| **Відео** | Програмна відеокомпозиція — анімований логотип, інтро, презентація продукту, motion-дизайн | Брендове інтро, демо продукту, реклама для соцмереж |
 | **Управління / бібліотека** | Бібліотека коду або проєкт лише з управлінською структурою — без сайту, без гри, без відео, лише структура та документація | npm-пакет, внутрішній інструмент, центр документації |
+| **Гра Godot** | Десктопна або мобільна гра на Godot 4.x з C# — 2D, 3D, платформер, RPG | Пригода з виглядом зверху, 3D-платформер, головоломка |
 
 Кожен тип проєкту отримує власний каркас: правильну структуру папок, правильні залежності, правильні інструменти. Вам не потрібно знати, що це таке — Forge налаштує все за вас.
 
 ---
 
+## Forge та рушій Werkstatt
+
+Forge — це **шар управління**: навички, RFC/ADR робочі процеси, угоди про найменування, вендоринг специфікацій та CLI. Він незалежний від фреймворку та не має Runtime-залежностей (тільки `yaml` + `zod`).
+
+Для повного управління життєвим циклом проєкту — місії, релізи, розгортання, сертифікація, перевірки якості, генерація контенту — Forge підключається до **рушія Werkstatt** та **плагінів специфічних для стеку**. Це окремі npm-пакети, які встановлюються разом з Forge, коли потрібні можливості runtime понад управління.
+
+| Пакет | Призначення | Потрібен для |
+| --- | --- | --- |
+| `@warpgogol/werkstatt` | Рушій runtime — місії, релізи, розгортання Leitstand, сертифікація, Bordbuch, сховище артефактів | Усі типи проєктів з управлінням життєвим циклом |
+| `@warpgogol/werkstatt-shared` | Спільна інфраструктура — перевірки, інтеграція, онтологія, паспорт | Встановлюється автоматично з рушієм |
+| `@warpgogol/werkstatt-site` | Плагін Astro-сайту — конвеєр збірки, перевірки контенту, codegen, адаптери розгортання | Вебсайт-проєкти (`astro-typescript-turborepo`) |
+| `@warpgogol/werkstatt-game` | Плагін Phaser-гри — валідатори гри, збірка Vite, адаптери розгортання | Проєкти браузерних ігор (`phaser-turborepo`) |
+| `@warpgogol/werkstatt-godot` | Плагін Godot — валідатори сцен, збірка dotnet, розгортання itch.io, навички Godot | Проєкти ігор Godot (`godot-csharp`) |
+
+### Коли потрібні ці пакети
+
+- **Проєкти лише з управлінням** (RFC, ADR, навички, центри документації) — Forge сам по собі достатній.
+- **Вебсайти, ігри, проєкти Godot** — встановіть `@warpgogol/werkstatt` (рушій) плюс відповідний плагін стеку. Навичка `forge-bootstrap` налаштовує прив'язки автоматично; самі пакети потрібно встановити як devDependencies.
+
+### Встановлення пакунків рушія
+
+```sh
+# Проєкт вебсайту
+pnpm add -D @warpgogol/werkstatt @warpgogol/werkstatt-site
+
+# Проєкт браузерної гри
+pnpm add -D @warpgogol/werkstatt @warpgogol/werkstatt-game
+
+# Проєкт гри Godot
+pnpm add -D @warpgogol/werkstatt @warpgogol/werkstatt-godot
+```
+
+> **Примітка для агентів:** Після створення проєкту командою `forge create` завжди встановлюйте рушій та відповідний плагін стеку. Прив'язки в `forge.yaml` посилаються на команди з цих пакунків (напр. `pnpm exec werkstatt run rfc.validate`), і вони не працюватимуть, якщо пакунки не встановлені.
+
+---
+
 ## Повний посібник зі встановлення (з нуля)
 
 Якщо ви ніколи раніше не програмували, цей розділ проведе вас від абсолютно порожнього комп'ютера до робочого налаштування Forge. Виконайте кроки для вашої операційної системи.
@@ -154,43 +190,27 @@ Forge працює через розмову з ШІ-агентом. Вам по
 
 Можете також використовувати **Cursor** ([cursor.com](https://cursor.com)) або будь-яке IDE, що підтримує навички ШІ-агентів.
 
-### Додатково — Встановлення FFmpeg (лише для відеопроєктів)
+### Додатково — Встановлення Godot та .NET (лише для проєктів ігор Godot)
+
+Якщо ви плануєте створювати **ігри Godot** (профіль `godot-csharp`), вам потрібні два додаткові інструменти:
 
-Якщо ви плануєте створювати **відеопроєкти** (профіль `editframe`), вам потрібен **FFmpeg** — безкоштовний інструмент для обробки відео та аудіо.
+- **Godot 4.x** (з підтримкою .NET) — ігровий рушій. Завантажте його з [godotengine.org/download](https://godotengine.org/download). Обов'язково оберіть версію ".NET" (не стандартну версію).
+- **.NET SDK 8+** — runtime C# та інструменти збірки. Завантажте з [dotnet.microsoft.com/download](https://dotnet.microsoft.com/download).
 
-**Ubuntu:**
+Перевірте, що обидва встановлені:
 
 ```sh
-sudo apt-get install -y ffmpeg
-ffmpeg -version
+godot --version
+dotnet --version
 ```
 
-**Windows:**
-
-1. Відкрийте [ffmpeg.org/download.html](https://ffmpeg.org/download.html) у браузері.
-2. Завантажте збірку для Windows (шукайте «Windows builds» — збірки gyan.dev або BtbN — хороші варіанти).
-3. Розпакуйте завантажений `.zip` файл у папку, наприклад `C:\ffmpeg`.
-4. Додайте FFmpeg до системної змінної PATH:
-   - Відкрийте меню Пуск, знайдіть «Environment Variables» і натисніть «Edit the system environment variables».
-   - Натисніть **Environment Variables**.
-   - У розділі «System variables» (або «User variables») знайдіть **Path**, виберіть його та натисніть **Edit**.
-   - Натисніть **New** і введіть `C:\ffmpeg\bin` (або туди, куди ви розпакували FFmpeg, у підпапку `bin`).
-   - Натисніть **OK** у всіх трьох вікнах.
-5. Закрийте та знову відкрийте PowerShell, потім перевірте:
-
-   ```sh
-   ffmpeg -version
-   ```
-
-Ви маєте побачити інформацію про версію, а не помилку.
-
 ### Усунення проблем
 
 - **«command not found» після встановлення Node.js** — Закрийте та знову відкрийте термінал (Ubuntu) або PowerShell (Windows). Системі потрібно перезавантажити список доступних команд.
 - **«EACCES permission denied» в Ubuntu під час глобального встановлення Forge** — Виконайте `sudo pnpm add -g @warpgogol/forge`.
 - **«corepack: command not found»** — Ваша версія Node.js занадто стара. Встановіть Node.js 24+ за кроками вище.
 - **Windsurf не бачить `forge`** — Закрийте та знову відкрийте Windsurf після встановлення Forge. IDE потрібно перезапустити, щоб підхопити нові глобальні команди.
-- **ШІ-агент не знає про Forge** — Ви відкрили порожню папку, але ШІ-агент не має контексту Forge. Спочатку виконайте `forge create --name my-project --profile editframe` (або відповідний профіль) у терміналі, потім відкрийте створену папку в вашому IDE. Команда `forge create` наповнює папку навичками, конфігурацією та `AGENTS.md` — без цього ШІ-агент не може виявити Forge.
+- **ШІ-агент не знає про Forge** — Ви відкрили порожню папку, але ШІ-агент не має контексту Forge. Спочатку виконайте `forge create --in-place --profile astro-typescript-turborepo` (або відповідний профіль) у терміналі, потім відкрийте папку в вашому IDE. Команда `forge create` наповнює поточну папку навичками, конфігурацією та `AGENTS.md` — без цього ШІ-агент не може виявити Forge.
 
 ---
 
@@ -202,29 +222,27 @@ ffmpeg -version
 
 #### Створення нового проєкту з нуля
 
-1. **Створіть проєкт Forge.** Відкрийте термінал (PowerShell на Windows, Термінал на Ubuntu) і виконайте:
+1. **Створіть папку проєкту та згенеруйте каркас Forge на місці.** Відкрийте термінал (PowerShell на Windows, Термінал на Ubuntu) і виконайте:
 
    ```sh
-   forge create --name my-brand-video --profile editframe
+   mkdir my-site
+   cd my-site
+   forge create --in-place --profile astro-typescript-turborepo
    ```
 
-   Замініть `my-brand-video` на назву вашого проєкту (малі літери та дефіси). Це створить нову папку з усьом, що потрібно Forge — навичками, конфігурацією та структурою проєкту. Для інших типів проєктів використовуйте інший `--profile`:
+   Назва проєкту визначається з назви папки (`my-site` у цьому прикладі). Ви можете перевизначити її прапорцем `--name`. Це наповнює поточну папку усьом, що потрібно Forge — навичками, конфігурацією та структурою проєкту. Для інших типів проєктів використовуйте інший `--profile`:
 
-   | Що ви хочете створити                        | Прапорець профілю                      |
-   | -------------------------------------------- | -------------------------------------- |
-   | Відео (брендове відео, інтро, motion-дизайн) | `--profile editframe`                  |
-   | Вебсайт (лендінг, блог, портфоліо)           | `--profile astro-typescript-turborepo` |
-   | Браузерна гра (2D, аркада, головоломка)      | `--profile phaser-turborepo`           |
-   | Бібліотека або проєкт лише з управлінням     | `--profile forge-shell`                |
+   | Що ви хочете створити                    | Прапорець профілю                      |
+   | ---------------------------------------- | -------------------------------------- |
+   | Вебсайт (лендінг, блог, портфоліо)       | `--profile astro-typescript-turborepo` |
+   | Браузерна гра (2D, аркада, головоломка)  | `--profile phaser-turborepo`           |
+   | Гра Godot (десктоп, мобільний, 2D/3D)    | `--profile godot-csharp`               |
+   | Бібліотека або проєкт лише з управлінням | `--profile forge-shell`                |
 
-2. **Відкрийте папку проєкту в вашому IDE.** Відкрийте папку, створену на кроці 1, у Windsurf або вашому IDE.
+2. **Відкрийте папку проєкту в вашому IDE.** Відкрийте папку з кроку 1 у Windsurf або вашому IDE.
 
 3. **Скажіть ШІ-агенту, що ви хочете створити.** Просто напишіть це в чаті своїми словами. Наприклад:
 
-   > Я хочу створити брендове відео для своєї кав'ярні. Воно має мати анімований логотип, коротке інтро та презентацію продукту.
-
-   Або:
-
    > Я хочу зробити вебсайт для своєї фотостудії.
 
    Або:
@@ -236,35 +254,37 @@ ffmpeg -version
    > Я хочу створити TypeScript-бібліотеку для розрахунку астрологічних карт.
 
    Це все. ШІ-агент зробить усе інше:
-   - Налаштує структуру проєкту залежно від того, що ви описали (відео, вебсайт, гра, бібліотека тощо)
+   - Налаштує структуру проєкту залежно від того, що ви описали (вебсайт, гра, бібліотека тощо)
    - Налаштує мовні вподобання та параметри проєкту
-   - Запустить живий попередній перегляд, щоб ви бачили свою роботу (для вебсайтів, ігор та відео)
+   - Запустить живий попередній перегляд, щоб ви бачили свою роботу (для вебсайтів та ігор)
    - Скаже вам URL для відкриття в браузері
 
-4. **Дивіться попередній перегляд.** Для вебсайтів, ігор та відео ШІ-агент дасть вам посилання localhost. Натисніть його — ваш проєкт уже запущений. Коли ви описуєте зміни, агент оновлює проєкт, а попередній перегляд оновлюється автоматично.
+4. **Дивіться попередній перегляд.** Для вебсайтів та ігор ШІ-агент дасть вам посилання localhost. Натисніть його — ваш проєкт уже запущений. Коли ви описуєте зміни, агент оновлює проєкт, а попередній перегляд оновлюється автоматично.
 
    Для проєктів управління та бібліотек візуального попереднього перегляду немає — агент налаштує структуру проєкту та скаже, коли все готово.
 
-5. **Створюйте разом.** Далі ви просто розмовляєте. Хочете інший колір? Хочете додати сцену? Хочете змінити музику? Хочете додати нову функцію до бібліотеки? Просто скажіть. Агент виконає всю технічну роботу.
+5. **Створюйте разом.** Далі ви просто розмовляєте. Хочете інший колір? Хочете додати сцену? Хочете додати нову функцію до бібліотеки? Просто скажіть. Агент виконає всю технічну роботу.
 
 #### Перенесення наявного проєкту у Forge
 
 Якщо ви вже маєте проєкт десь інше і хочете перенести його у Forge:
 
-1. **Створіть проєкт Forge.** Відкрийте термінал і виконайте:
+1. **Створіть проєкт Forge.** Відкрийте термінал, створіть папку і виконайте:
 
    ```sh
-   forge create --name my-project
+   mkdir my-project
+   cd my-project
+   forge create --in-place --profile forge-shell
    ```
 
-   Потім відкрийте створену папку в вашому IDE.
+   Потім відкрийте папку в вашому IDE.
 
 2. **Скажіть ШІ-агенту:**
 
    > Я хочу перенести свій наявний проєкт у Forge. Він знаходиться за шляхом /path/to/my/project.
 
    Агент:
-   - Визначить, який це тип проєкту (вебсайт, відео, гра, бібліотека тощо)
+   - Визначить, який це тип проєкту (вебсайт, гра, бібліотека тощо)
    - Перемістить усі ваші файли у новий проєкт Forge — включно з прихованими файлами на кшталт `.env`
    - За бажанням перенесе вашу історію git
    - Перевірить, чи все коректно збирається
@@ -278,24 +298,33 @@ ffmpeg -version
 
 ### Для розробників — CLI-команди
 
-#### Створення нового проєкту
+#### Створення нового проєкту (на місці)
 
 ```sh
-# Створити новий проєкт (каркас + ініціалізація + навички + AGENTS.md однією командою)
-forge create --name my-project
+# Створіть папку проєкту, потім згенеруйте каркас Forge на місці
+mkdir my-project
+cd my-project
+forge create --in-place --profile forge-shell
 
 # З конкретним профілем стеку
-forge create --name my-site --profile astro-typescript-turborepo
-forge create --name my-game --profile phaser-turborepo
-forge create --name my-video --profile editframe
-forge create --name my-library --profile forge-shell
+mkdir my-site && cd my-site
+forge create --in-place --profile astro-typescript-turborepo
 
+mkdir my-game && cd my-game
+forge create --in-place --profile phaser-turborepo
+
+mkdir my-godot-game && cd my-godot-game
+forge create --in-place --profile godot-csharp
+
+# Перевизначити назву проєкту (за замовчуванням визначається з назви папки)
+forge create --in-place --profile forge-shell --name my-custom-name
 ```
 
 Якщо Forge не встановлено глобально, використовуйте `pnpm dlx`:
 
 ```sh
-pnpm dlx @warpgogol/forge create --name my-project
+mkdir my-project && cd my-project
+pnpm dlx @warpgogol/forge create --in-place --profile forge-shell
 ```
 
 #### Перенесення наявного проєкту у Forge
@@ -303,15 +332,16 @@ pnpm dlx @warpgogol/forge create --name my-project
 CLI-команди для перенесення немає — це інтерактивний процес під керівництвом ШІ:
 
 ```sh
-# 1. Створіть новий порожній проєкт Forge
-forge create --name my-project
+# 1. Створіть новий порожній проєкт Forge (на місці)
+mkdir my-project && cd my-project
+forge create --in-place --profile forge-shell
 
 # 2. Відкрийте проєкт у Windsurf (протестовано з Forge) або вашому IDE
 
 # 3. Запустіть навичку /forge-bootstrap і оберіть режим "transplant"
 #    Навичка:
 #    - Запитає шлях до вашого наявного коду
-#    - Автоматично визначить стек (Astro, Phaser, Editframe тощо)
+#    - Автоматично визначить стек (Astro, Phaser, Godot тощо)
 #    - Перенесе всі файли (включно з .env та git-ігнорованими)
 #    - За бажанням перенесе історію git
 #    - Перевірить збірку
@@ -339,16 +369,14 @@ forge skill.list
 | `forge-shell` | Управління / бібліотека | Мінімальний каркас Forge (за замовчуванням) | — | Проєкти лише з управлінням, бібліотеки, невеб-проєкти |
 | `astro-typescript-turborepo` | Вебсайт | Astro + TypeScript + pnpm + Turborepo | `sites/my-site` | Вебсайти, вебзастосунки, контентні сайти |
 | `phaser-turborepo` | Браузерна гра | Phaser + TypeScript + pnpm + Turborepo | `games/my-game` | Браузерні ігри, інтерактивні досвіди |
-| `editframe` | Відео | Editframe React + Vite + TailwindCSS | `compositions/my-first-video` | Відеокомпозиції, брендові відео, motion-дизайн |
-
-Профіль `editframe` також підтримує **HTML-шаблон** (замість React) для користувачів, які віддають перевагу веб-компонентам замість JSX. Оберіть між ними під час налаштування проєкту.
+| `godot-csharp` | Гра Godot | Godot 4.x + C# + pnpm + Turborepo | `games/my-game` | Десктопні/мобільні ігри, інтерактивні проєкти на Godot |
 
 ```sh
 # Список доступних профілів (після встановлення)
 forge profile.validate
 ```
 
-Коли ви переносите наявний проєкт через режим `/forge-bootstrap` transplant, Forge автоматично визначає відповідний профіль, перевіряючи файли-маркери (`astro.config.*`, `phaser.config.*`, `editframe.config.*` тощо).
+Коли ви переносите наявний проєкт через режим `/forge-bootstrap` transplant, Forge автоматично визначає відповідний профіль, перевіряючи файли-маркери (`astro.config.*`, `phaser.config.*`, `project.godot` тощо).
 
 ## Процес оновлення
 
@@ -369,7 +397,7 @@ forge doctor
 
 ## Що дає Forge
 
-- **44 навички** (fo-pipeline, grilling, preferences, написання навичок, Editframe відеокомпозиція) — розгортаються у `.agents/skills/` командою `forge create`
+- **44 навички** (fo-pipeline, grilling, preferences, написання навичок) — розгортаються у `.agents/skills/` командою `forge create`
 - **RFC робочий процес** — створення, валідація, список, граф, архівування, acceptance-зондування, журнали рішень, DNA-трасування
 - **ADR робочий процес** — легковісні архітектурні записи рішень
 - **Вендоринг специфікацій** — вендоринг зовнішніх пакетів специфікацій як незмінних знімків з маніфестами цілісності
@@ -382,7 +410,7 @@ forge doctor
 
 Типовий життєвий цикл проєкту Forge:
 
-1. **Створення** — `forge create` ініціалізує новий проєкт з forge.yaml, навичками та директоріями документації
+1. **Створення** — `forge create --in-place --profile <профіль>` генерує каркас нового проєкту в поточній директорії з forge.yaml, навичками та директоріями документації
 2. **IDE** — відкрийте проєкт у Windsurf (протестовано з Forge) або вашому IDE
 3. **Bootstrap** — запустіть `/forge-bootstrap` для інтерактивного налаштування проєкту. Навичка підтримує два режими:
    - **Greenfield** — створення нового проєкту з нуля: оберіть стек, заповніть прив'язки, ініціалізуйте git

package/package.json

@@ -1,12 +1,24 @@
 {
   "name": "@warpgogol/forge",
-  "version": "1.1.0",
+  "version": "2.1.0",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
   "description": "Framework for documenting and implementing ideas — RFC/ADR governance, skills, and project bootstrapping.",
-  "keywords": ["rfc", "adr", "governance", "skills", "ai-agent", "documentation", "framework"],
+  "keywords": [
+    "rfc",
+    "adr",
+    "governance",
+    "skills",
+    "ai-agent",
+    "documentation",
+    "framework"
+  ],
   "homepage": "https://warpgogol.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/syrokomskyi/forge.git"
+  },
   "main": "./src/index.ts",
   "types": "./src/index.ts",
   "bin": {
@@ -291,5 +303,6 @@
         "default": "./dist/os/program/program.module.js"
       }
     }
-  }
+  },
+  "packageManager": "pnpm@11.10.0"
 }

package/profiles/astro-typescript-turborepo.yaml

@@ -11,6 +11,9 @@ workspace:
     - packages
     - services
     - scripts
+    - tools
+    - missions
+    - systems-cache
   files:
     - path: pnpm-workspace.yaml
       content: |
@@ -201,8 +204,152 @@ workspace:
         }
 
         console.log(`Cleaned ${toDelete.length} directories.`);
+    - path: tools/kernel.config.ts
+      content: |
+        import { defineKernelConfig } from "@warpgogol/werkstatt/kernel/types";
+        import { werkstattSitePlugin } from "@warpgogol/werkstatt-site";
+
+        export default defineKernelConfig({
+          name: "__PROJECT_NAME__",
+          description: "__PROJECT_NAME__ workshop",
+          moduleLoaders: {
+            "forge-core": async () => (await import("@warpgogol/forge/os/core")).forgeCoreModule,
+            "forge-rfc": async () => (await import("@warpgogol/forge/os/rfc-module")).forgeRfcModule,
+            "forge-adr": async () => (await import("@warpgogol/forge/os/adr-module")).forgeAdrModule,
+            "forge-plan": async () => (await import("@warpgogol/forge/os/plan-module")).forgePlanModule,
+            "forge-audit": async () => (await import("@warpgogol/forge/os/audit-module")).forgeAuditModule,
+            "forge-compass": async () => (await import("@warpgogol/forge/os/compass")).forgeCompassModule,
+            "forge-naming": async () => (await import("@warpgogol/forge/os/naming-module")).forgeNamingModule,
+            "forge-workflow": async () => (await import("@warpgogol/forge/os/workflow-module")).forgeWorkflowModule,
+            "forge-session": async () => (await import("@warpgogol/forge/os/session-module")).forgeSessionModule,
+            "forge-mission": async () => (await import("@warpgogol/forge/os/mission-module")).forgeMissionModule,
+            "forge-spec": async () => (await import("@warpgogol/forge/os/spec-module")).forgeSpecModule,
+            "forge-exploration": async () => (await import("@warpgogol/forge/os/exploration")).forgeExplorationModule,
+            "forge-program": async () => (await import("@warpgogol/forge/os/program")).forgeProgramModule,
+            "forge-werkstatt": async () => (await import("@warpgogol/forge/os/werkstatt")).forgeWerkstattModule,
+            mission: async () => (await import("@warpgogol/werkstatt/mission-module")).createMissionModule(),
+            sternsystem: async () => (await import("@warpgogol/werkstatt/sternsystem-module")).createSternsystemModule(),
+            bordbuch: async () => (await import("@warpgogol/werkstatt/bordbuch-module")).createBordbuchModule(),
+            "artifact-store": async () => (await import("@warpgogol/werkstatt/artifact-store-module")).createArtifactStoreModule(),
+            release: async () => (await import("@warpgogol/werkstatt/release-module")).createReleaseModule(),
+            leitstand: async () => (await import("@warpgogol/werkstatt/leitstand-module")).createLeitstandModule(),
+            notausgang: async () => (await import("@warpgogol/werkstatt/notausgang-module")).createNotausgangModule(),
+            evidence: async () => (await import("@warpgogol/werkstatt/evidence-module")).createEvidenceModule(),
+            "werkstatt-plugin": async () => (await import("@warpgogol/werkstatt/os/werkstatt-plugin-module")).forgeWerkstattPluginModule,
+            "werkstatt-autonomy": async () => (await import("@warpgogol/werkstatt/os/werkstatt-autonomy-module")).werkstattAutonomyModule,
+            "__PROJECT_NAME__-plugin": async () => werkstattSitePlugin,
+          },
+        });
+    - path: .npmrc
+      content: |
+        # @warpgogol scoped registry — replace YOUR_NPM_TOKEN with a valid npm read token
+        @warpgogol:registry=https://registry.npmjs.org/
+        //registry.npmjs.org/:_authToken=YOUR_NPM_TOKEN
+    - path: eslint.config.js
+      content: |
+        export default [
+          {
+            rules: {},
+          },
+        ];
+    - path: .prettierrc.mjs
+      content: |
+        export default {
+          semi: true,
+          singleQuote: false,
+          trailingComma: "all",
+          printWidth: 100,
+          tabWidth: 2,
+        };
+    - path: .gitattributes
+      content: |
+        # Git LFS patterns for site stack media
+        *.mp4 filter=lfs diff=lfs merge=lfs -text
+        *.webm filter=lfs diff=lfs merge=lfs -text
+        *.png filter=lfs diff=lfs merge=lfs -text
+        *.jpg filter=lfs diff=lfs merge=lfs -text
+        *.jpeg filter=lfs diff=lfs merge=lfs -text
+        *.webp filter=lfs diff=lfs merge=lfs -text
+    - path: hooks/pre-commit
+      content: |
+        #!/bin/sh
+        # Platform-scope pre-commit guard
+        # Runs werkstatt autonomy and plugin validation before commits
+        echo "Pre-commit: running platform checks..."
+        pnpm exec werkstatt run werkstatt.autonomy.validate || exit 1
+        pnpm exec werkstatt run werkstatt.plugin.validate || exit 1
+    - path: systems-cache/.gitkeep
+      content: |
+        # Sternsystem cache directory (RFC-0790)
+        # Per-system config and state files live in systems-cache/<id>/
+    - path: missions/.gitkeep
+      content: ""
+    - path: .forge/pinned.yaml
+      content: |
+        # Pinned foundation files (DNA-62, RFC-0733)
+        # Protect mode: warns on delete/move. Freeze mode: blocks modify too.
+        entries:
+          - path: tools/kernel.config.ts
+            mode: protect
+          - path: forge.yaml
+            mode: protect
+          - path: pnpm-workspace.yaml
+            mode: protect
+          - path: turbo.json
+            mode: protect
+          - path: tsconfig.base.json
+            mode: protect
+          - path: systems-cache/.gitkeep
+            mode: protect
+    - path: README.md
+      content: |
+        # __PROJECT_NAME__
+
+        A Warpgogol workshop powered by the Werkstatt engine and the @warpgogol/werkstatt-site plugin.
+
+        ## Prerequisites
+
+        - Node.js 24+
+        - pnpm 10+
+        - Git LFS
+
+        ## Setup
+
+        ### 1. Configure npm token
+
+        This workshop depends on private @warpgogol packages. Edit `.npmrc` and replace `YOUR_NPM_TOKEN` with a valid npm read token:
+
+        ```sh
+        sed -i 's/YOUR_NPM_TOKEN/your_actual_token/' .npmrc
+        ```
+
+        ### 2. Install dependencies
+
+        ```sh
+        pnpm install
+        ```
+
+        ### 3. Verify the workshop
+
+        ```sh
+        pnpm exec werkstatt run forge.doctor
+        pnpm exec werkstatt run werkstatt.plugin.validate
+        pnpm exec werkstatt run werkstatt.autonomy.validate
+        ```
+
+        ## Create your first project
+
+        ```sh
+        pnpm exec werkstatt run onboarding.scaffold --system my-first-project --title "My First Project"
+        ```
+
+        ## Stack
+
+        - Engine: @warpgogol/werkstatt
+        - Plugin: @warpgogol/werkstatt-site
+        - Stack profile: astro-typescript-turborepo
 install:
-  - pnpm add -D typescript turbo @warpgogol/forge prettier
+  - pnpm add -D typescript turbo @warpgogol/forge @warpgogol/werkstatt @warpgogol/werkstatt-shared @warpgogol/werkstatt-site prettier
 firstWorkspace:
   path: sites/my-site
   files:

package/profiles/forge-shell.yaml

@@ -8,6 +8,9 @@ workspace:
   dirs:
     - docs
     - scripts
+    - tools
+    - missions
+    - systems-cache
   files:
     - path: .gitignore
       content: |
@@ -149,6 +152,122 @@ workspace:
           console.log("deleted", p.replace(repoRoot + "/", ""));
         }
 
-        console.log(`Cleaned ${toDelete.length} directories.`);
+        console.log(`Cleaned ${toDelete.length} directories.`)
+    - path: tools/kernel.config.ts
+      content: |
+        import { defineKernelConfig } from "@warpgogol/werkstatt/kernel/types";
+
+        export default defineKernelConfig({
+          name: "__PROJECT_NAME__",
+          description: "__PROJECT_NAME__ workshop",
+          moduleLoaders: {
+            "forge-core": async () => (await import("@warpgogol/forge/os/core")).forgeCoreModule,
+            "forge-rfc": async () => (await import("@warpgogol/forge/os/rfc-module")).forgeRfcModule,
+            "forge-adr": async () => (await import("@warpgogol/forge/os/adr-module")).forgeAdrModule,
+            "forge-plan": async () => (await import("@warpgogol/forge/os/plan-module")).forgePlanModule,
+            "forge-audit": async () => (await import("@warpgogol/forge/os/audit-module")).forgeAuditModule,
+            "forge-compass": async () => (await import("@warpgogol/forge/os/compass")).forgeCompassModule,
+            "forge-naming": async () => (await import("@warpgogol/forge/os/naming-module")).forgeNamingModule,
+            "forge-workflow": async () => (await import("@warpgogol/forge/os/workflow-module")).forgeWorkflowModule,
+            "forge-session": async () => (await import("@warpgogol/forge/os/session-module")).forgeSessionModule,
+            "forge-mission": async () => (await import("@warpgogol/forge/os/mission-module")).forgeMissionModule,
+            "forge-spec": async () => (await import("@warpgogol/forge/os/spec-module")).forgeSpecModule,
+            "forge-exploration": async () => (await import("@warpgogol/forge/os/exploration")).forgeExplorationModule,
+            "forge-program": async () => (await import("@warpgogol/forge/os/program")).forgeProgramModule,
+            "forge-werkstatt": async () => (await import("@warpgogol/forge/os/werkstatt")).forgeWerkstattModule,
+          },
+        });
+    - path: .npmrc
+      content: |
+        # @warpgogol scoped registry — replace YOUR_NPM_TOKEN with a valid npm read token
+        @warpgogol:registry=https://registry.npmjs.org/
+        //registry.npmjs.org/:_authToken=YOUR_NPM_TOKEN
+    - path: eslint.config.js
+      content: |
+        export default [
+          {
+            rules: {},
+          },
+        ];
+    - path: .prettierrc.mjs
+      content: |
+        export default {
+          semi: true,
+          singleQuote: false,
+          trailingComma: "all",
+          printWidth: 100,
+          tabWidth: 2,
+        };
+    - path: .gitattributes
+      content: |
+        # No LFS patterns for this stack
+    - path: hooks/pre-commit
+      content: |
+        #!/bin/sh
+        # Platform-scope pre-commit guard
+        # Runs forge validation before commits
+        echo "Pre-commit: running platform checks..."
+        pnpm exec forge run forge.validate || exit 1
+    - path: systems-cache/.gitkeep
+      content: |
+        # Sternsystem cache directory (RFC-0790)
+        # Per-system config and state files live in systems-cache/<id>/
+    - path: missions/.gitkeep
+      content: ""
+    - path: .forge/pinned.yaml
+      content: |
+        # Pinned foundation files (DNA-62, RFC-0733)
+        # Protect mode: warns on delete/move. Freeze mode: blocks modify too.
+        entries:
+          - path: tools/kernel.config.ts
+            mode: protect
+          - path: forge.yaml
+            mode: protect
+          - path: pnpm-workspace.yaml
+            mode: protect
+          - path: turbo.json
+            mode: protect
+          - path: tsconfig.base.json
+            mode: protect
+          - path: systems-cache/.gitkeep
+            mode: protect
+    - path: README.md
+      content: |
+        # __PROJECT_NAME__
+
+        A Warpgogol workshop powered by the Forge engine.
+
+        ## Prerequisites
+
+        - Node.js 24+
+        - pnpm 10+
+
+        ## Setup
+
+        ### 1. Configure npm token
+
+        This workshop depends on private @warpgogol packages. Edit `.npmrc` and replace `YOUR_NPM_TOKEN` with a valid npm read token:
+
+        ```sh
+        sed -i 's/YOUR_NPM_TOKEN/your_actual_token/' .npmrc
+        ```
+
+        ### 2. Install dependencies
+
+        ```sh
+        pnpm install
+        ```
+
+        ### 3. Verify the workshop
+
+        ```sh
+        pnpm exec forge run forge.doctor
+        pnpm exec forge run forge.validate
+        ```
+
+        ## Stack
+
+        - Engine: @warpgogol/forge
+        - Stack profile: forge-shell
 install:
   - pnpm add -D @warpgogol/forge prettier vitest