# 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; правообладатель назван, атрибуция в титрах — просьба, а не условие.
- [ADR-0004: Engine tool surface out of skill content](docs/architecture/decisions/0004-engine-tool-surface-out-of-skill-content.md) — имена тулсетов, мета-тулов и эндпоинтов движка не попадают в `skills/`: слой экспериментальный, а его отказ молчалив. Проверяется правилом гейта P17.
- [ADR-0005: Native transport narrows ADR-0001](docs/architecture/decisions/0005-native-transport-narrows-adr-0001.md) — движок привёз свой MCP-сервер; свой мост, UDP-discovery и heartbeat сняты, контракт живости сохранён. Нашими остаются два слоя: сервер без редактора и тулы в рантайме.

## Лицензия

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; в поставке нет чужого
кода, адресов и дословных выдержек, но заключением о вашем использовании это не
является.