T-Forge
T-Forge, Training Forge (Кузня навчання) від Erebros, за адресою /t-forge. У ньому два інструменти: Course Studio, який навчає системі, і Interactive Diagrams, який її малює.
Що він робить
Section titled “Що він робить”- Course Studio (
/t-forge/course-studio), один промпт або ваші власні матеріали перетворюються на повноцінний клас: план, озвучені сцени, тести й живу аудиторію, у якій можна посидіти. Побудований на вбудованому рушії openmaic. - Interactive Diagrams (
/t-forge/diagrams), модель пише типізований документ (IR), що описує систему, і цей документ перевіряється перш ніж щось малюється. Сам рушій діаграм вбудований (vendored) і не викликає модель, він лише перевіряє й малює те, що написала модель.
Course Studio
Section titled “Course Studio”Що він створює
Section titled “Що він створює”Клас, а не набір слайдів. Кожна сцена, один із чотирьох видів:
| Сцена | Що це |
|---|---|
| Slides | Озвучений слайд, викладач підсвічує те, про що каже |
| Quiz | Питання з вибором і письмові, оцінюються по мірі відповіді |
| Interactive | Симуляція, діаграма, гра або 3D-сцена, згенерована під цей урок |
| Project | Ролі, віхи й мікрозадачі, проходяться разом із класом |
Навчає його викладач плюс двоє-троє однокласників, згенерованих під цей курс, зі своїми іменами, персонами й голосами. Вони розповідають, обговорюють і відповідають на підняту руку, спираючись на те, що показано на екрані.
Compose
Section titled “Compose”Одне питання: чого має навчити клас? Можна прикріпити вже наявні документи, PowerPoint, PDF, Word, OpenDocument, EPUB, таблиці, Markdown або звичайний текст. Вони конвертуються в текст тим самим рушієм, що використовує D-Forge, і планувальник читає їх перш ніж щось написати, тож курс будується на вашому матеріалі, а не на загальних знаннях моделі. Вставка тексту теж працює, окремо або разом із вкладеннями.
Перш ніж щось буде написано, ви обираєте:
- Шаблон (Template),
maritime.studio(кожен рядок проходить через humanizer і лінтер нарації) абоgeneral(текст конвеєра як є, швидше й дешевше, без проходу переписування). - Мова, англійська, російська або українська (для цих трьох у humanizer є свої навички), або будь-яка інша, яку ви впишете самі. Вона потрапляє в планувальник, у кожну сцену, у нарацію та в діалог самого класу, тож український курс пишеться українською, а не перекладається наприкінці.
- Тривалість, від 30 хвилин до трьох днів. Після приблизно години студія спочатку планує модулями, а потім сцени всередині кожного.
Два перемикачі: веб-пошук (Tavily або Firecrawl) і deep interactive, який дозволяє планувальнику використовувати симуляції та 3D-сцени замість того, щоб триматися слайдів. Підходить будь-яка модель, яку підтримує ця інсталяція.
План, збірка, аудиторія
Section titled “План, збірка, аудиторія”План, редагований план курсу: змінюйте назву, змінюйте вид сцени, переставляйте, видаляйте, додавайте, перш ніж сцени буде реально побудовано, адже виправити план набагато дешевше, ніж виправляти вже зібраний курс. Поруч із планом показано склад класу.
Збірка триває у фоні: залишаєте сторінку, повертаєтесь, курс продовжує будуватися. Кожна сцена записується на диск одразу після завершення, тож перерваний запуск не втрачає нічого до моменту зупинки, а Continue building продовжує з того місця, де зупинились, замість повторної оплати. Сцена займає пару викликів моделі й кілька хвилин; Build може будувати від однієї до восьми сцен одночасно, кожна зі своєю моделлю, що корисно і для швидкості, і щоб розподілити довгий запуск за лімітами кількох акаунтів.
Аудиторія (classroom), місце, де курс викладається. Сцена несе список дій (verbs), які аудиторія виконує по порядку: промовити рядок, підсвітити елемент, спрямувати указку, викотити дошку, малювати на ній, редагувати або очистити блок коду, поставити запитання класу, поштрикати симуляцію. Нарація записується під час збірки курсу, а не під час першого відтворення, тож готовий курс починає говорити тієї миті, коли ви натискаєте play; безкоштовний локальний голос Supertonic покриває англійську, російську та українську. Питання посеред уроку отримує справжню відповідь, прив’язану до того, що на екрані, а викладач чесно каже, якщо чогось немає в матеріалі, замість того щоб це вигадувати.
Експорт
Section titled “Експорт”- Page, клас як один офлайн HTML-файл, плеєр, а не документ: одна сцена на екрані за раз, вбудована нарація, тести, на які можна відповідати, інтерактивні сцени й далі в пісочниці та працюють. Без сервера, без мережі, відтворюється з спільного диска або USB-накопичувача.
- Deck, слайди у вигляді
.pptx, нарація в нотатках доповідача, а відповіді в нотатках, а не на самому слайді.
Де це зберігається
Section titled “Де це зберігається”~/Obsidian/Erebros/T-Forge/Courses/<назва>/:
course.json, клас: його агенти, його план, те, що ви попросили.scenes/01-….jsonі далі, по одному файлу на сцену, у порядку викладання.audio/, нарація, кешується за промовленими словами.
Interactive Diagrams
Section titled “Interactive Diagrams”Що він створює
Section titled “Що він створює”Типізований документ і, з нього, самодостатню HTML-сторінку з діаграмою всередині. П’ять видів:
| Тип | Для чого |
|---|---|
| Architecture | Компоненти, сервіси, хмарні та security-межі |
| Workflow | Процеси, точки узгодження, runbook’и, CI/CD |
| Sequence | Ланцюги викликів, життєвий цикл запиту, асинхронні траси |
| Data flow | Конвеєри, ETL/ELT, походження даних, споживачі |
| Lifecycle | Стани, повтори, очікування та кінцеві стани |
Свіжа інсталяція починається з п’яти діаграм-прикладів, по одній на тип, які можна редагувати або видалити, щоб побачити, як виглядає кожен тип. Усе зберігається під T-Forge/Diagrams/<назва>/ як ir.json плюс останній відрендерений артефакт.
Описати, згенерувати, перевірити
Section titled “Описати, згенерувати, перевірити”Опишіть, що робить система, простими реченнями або ланцюжком на кшталт Browser -> API -> Redis -> Postgres. Оберіть тип діаграми, оберіть модель, натисніть Generate:
- Ваш текст іде до моделі разом зі схемою для цього типу й одним готовим прикладом, і вона відповідає документом.
- Рушій його перевіряє: спочатку схему, потім розкладку, далі рендерить сторінку й прогонює дев’ять іменованих перевірок.
- Якщо перевірка не проходить, власна скарга рушія (яка мітка, який вузол, що б це виправило) повертається до моделі, і та лагодить документ. До трьох раундів, і процес зупиняється раніше, якщо два раунди поспіль не покращують найкращий із уже отриманих результатів.
Генерація йде як фонове завдання, тож можна піти й повернутися до результату. У рушія є строгий профіль представлення showcase, який також забороняє перетини зв’язків і спільні коридори; діаграма може не пройти його і все одно залишатися коректною, і в такому разі T-Forge перевіряє її повторно за м’якшим профілем standard і зберігає вже в ньому.
Сам документ редагується вручну як JSON, і Validate & apply розкладає його на канву, ніколи не відмовляючи у збереженні недописаної діаграми.
Канва малює ту саму проєкцію, що поділяють усі типи: доріжки збоку, ранги впоперек, тож документ можна досліджувати просто під час написання. П’ять режимів: Select, клік по вузлу відкриває його паспорт і дозволяє простежити вгору чи вниз по потоку; Route (R), найкоротший авторський маршрут між двома вузлами; Lens (L), скільки вузлів і зв’язків залишаються всередині однієї чи двох обраних доріжок; Story (P), покроковий прохід по авторських видах, які несе документ; Delta (D), що змінилося з останнього збереження документа.
Нічого не додумується: висхідні й низхідні зв’язки, маршрути та лічильники lens ідуть лише за авторськими ребрами, а два компоненти без ребра між ними вважаються незв’язаними, а не пов’язаними за здогадом.
Експорт
Section titled “Експорт”- Render the artifact now, створює сторінку й зберігає її поряд із документом.
- Open the rendered page, самодостатня сторінка розміром близько 700 КБ, що несе власний експорт у PNG, SVG і WebM всередині себе.
- Diagram source (.json), сам документ.
Редагування документа видаляє відрендерений із нього артефакт, тож експорт ніколи не виявляється застарілою діаграмою.
Налаштування та залежності
Section titled “Налаштування та залежності”Обидва інструменти працюють на будь-якій моделі, налаштованій у цій інсталяції; окремий ключ для самих рушіїв не потрібен. Голосовий рушій Course Studio йде за тим, що ви налаштували для нарації в решті Erebros; безкоштовний локальний голос Supertonic покриває англійську, російську та українську без ключа. Веб-пошук у Compose потребує TAVILY_API_KEY або налаштований Firecrawl.
Конвеєр Course Studio належить OpenMAIC (MIT), вбудований у vendor/openmaic; він володіє контрактом уроку й промптами та звертається до обраної вами моделі через одну ін’єктовану функцію. Рушій діаграм, archify (MIT), вбудований у vendor/archify без runtime npm-залежностей, тож працює офлайн і переноситься просто в архіві релізу.
Поради
Section titled “Поради”- Накидайте план курсу, перш ніж витрачатися на повну збірку, виправити шість рядків дешевше, ніж виправляти вже зібраний курс.
- Для нарації не англійською безкоштовний локальний голос Supertonic вже покриває російську та українську.
- Якщо діаграма не проходить строгі перевірки
showcase, спершу перевірте, чи не збереглася вона в режиміstandard, перш ніж вважати, що потрібна переробка. - Два компоненти без лінії між ними на діаграмі не пов’язані; канва так і скаже, замість того щоб натякати на зв’язок, якого ніхто не написав.