ue-toolchain
1277dca615
Acceptance review found four documents describing a state that no longer holds. None of the original text is deleted: the reason a decision was taken is part of the record, so supersession is marked rather than rewritten. - README: license section reflects ADR-0003, ADR-0003 added to the decision list, status line says which component actually ships. - handoff.md: banner marking it historical, with a table of what changed since 2026-09-01 (skills moved, layout, licence, engine version still open). - licensing-options.md: status struck through, pointing at ADR-0003. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
51 lines
4.3 KiB
Markdown
51 lines
4.3 KiB
Markdown
# ue-toolchain
|
||
|
||
Инструменты для разработки на Unreal Engine через LLM-агентов: UE-плагин, MCP-сервер, скиллы, установщик, локальная документация проекта.
|
||
|
||
**Статус:** ранняя разработка. Готов и лицензирован один компонент — бандл скиллов
|
||
`plugins/ue-design-skills/` (17 скиллов, 232 записи о режимах отказа, гейт поставки
|
||
на 16 правилах). Остальные компоненты таблицы ниже — план, кода ещё нет.
|
||
|
||
## Состав (план)
|
||
|
||
| Компонент | Назначение |
|
||
|---|---|
|
||
| `Engine/` | UE-плагин редактора (C++): JSON-RPC сервер, discovery, мониторинг |
|
||
| `mcp-server/` | MCP-сервер на Python: инструменты для агентов (Hermes, Claude Code, Codex) |
|
||
| `plugins/ue-design-skills/` | Скиллы для LLM-агентов: нормы и воспроизводимые рецепты обнаружения. Харнес-нейтральны, индекс — `catalog.json` |
|
||
| `installer/` | CLI: установка плагина, регистрация MCP, копирование скиллов |
|
||
| `docs/` | Архитектурные решения и документация |
|
||
| `examples/` | Минимальный UE-проект для интеграционных тестов |
|
||
|
||
## Архитектурные решения
|
||
|
||
- [ADR-0001: Discovery over PID file](docs/architecture/decisions/0001-discovery-over-pid-file.md) — поиск запущенного редактора через UDP-broadcast, а не через файл-PID.
|
||
- [ADR-0002: Harness-neutral skill bundle](docs/architecture/decisions/0002-harness-neutral-skill-bundle.md) — репозиторий как маркетплейс, `catalog.json` как источник истины, манифест вендора как адаптер. Нейтральность проверяется гейтом, а не обещается.
|
||
- [ADR-0003: Split licensing](docs/architecture/decisions/0003-split-licensing-prose-and-code.md) — проза бандла под CC BY-ND 4.0, код и метаданные под Apache-2.0; правообладатель назван, атрибуция в титрах — просьба, а не условие.
|
||
|
||
## Лицензия
|
||
|
||
Copyright (c) 2026 MagentaDolphin. Издатель — Kodlo.art.
|
||
|
||
| Что | Лицензия |
|
||
|---|---|
|
||
| Код: плагин редактора, MCP-сервер, установщик, гейт поставки, манифесты | [Apache-2.0](LICENSE) |
|
||
| Проза бандла `plugins/ue-design-skills/` | [CC BY-ND 4.0](plugins/ue-design-skills/LICENSE) |
|
||
|
||
Практическая разница: код можно форкать и переиздавать как обычно; **изменённую
|
||
версию текстов публиковать как свой продукт нельзя**. Всё остальное разрешено —
|
||
использование в коммерческой работе, правка под свою студию, дословное
|
||
распространение с указанием авторства, адаптеры формата под другие харнесы и
|
||
переводы.
|
||
|
||
На то, что вы создаёте с помощью инструмента, притязаний нет: ни на игру, ни на
|
||
код, ни на документацию, ни на выручку.
|
||
|
||
Если инструмент помог — упоминание приветствуется, но ничем не обязывает.
|
||
Атрибуция обязательна только при распространении самих материалов.
|
||
|
||
Оговорка: выбор лицензий — не юридическое заключение. Материал бандла получен
|
||
чтением стороннего сэмпла, распространяемого по UE EULA; в поставке нет чужого
|
||
кода, адресов и дословных выдержек, но заключением о вашем использовании это не
|
||
является.
|