docs: bring status documents in line with the shipped bundle

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>
This commit is contained in:
ue-toolchain
2026-09-05 23:49:01 +07:00
parent dab3f35079
commit 1277dca615
2 changed files with 43 additions and 3 deletions
+29 -3
View File
@@ -2,7 +2,9 @@
Инструменты для разработки на Unreal Engine через LLM-агентов: UE-плагин, MCP-сервер, скиллы, установщик, локальная документация проекта. Инструменты для разработки на Unreal Engine через LLM-агентов: UE-плагин, MCP-сервер, скиллы, установщик, локальная документация проекта.
**Статус:** ранняя разработка. Первый архитектурный документ: [ADR-0001](docs/architecture/decisions/0001-discovery-over-pid-file.md). **Статус:** ранняя разработка. Готов и лицензирован один компонент — бандл скиллов
`plugins/ue-design-skills/` (17 скиллов, 232 записи о режимах отказа, гейт поставки
на 16 правилах). Остальные компоненты таблицы ниже — план, кода ещё нет.
## Состав (план) ## Состав (план)
@@ -10,7 +12,7 @@
|---|---| |---|---|
| `Engine/` | UE-плагин редактора (C++): JSON-RPC сервер, discovery, мониторинг | | `Engine/` | UE-плагин редактора (C++): JSON-RPC сервер, discovery, мониторинг |
| `mcp-server/` | MCP-сервер на Python: инструменты для агентов (Hermes, Claude Code, Codex) | | `mcp-server/` | MCP-сервер на Python: инструменты для агентов (Hermes, Claude Code, Codex) |
| `skills/` | Скиллы для LLM-агентов: правила, шаблоны, плохие примеры | | `plugins/ue-design-skills/` | Скиллы для LLM-агентов: нормы и воспроизводимые рецепты обнаружения. Харнес-нейтральны, индекс — `catalog.json` |
| `installer/` | CLI: установка плагина, регистрация MCP, копирование скиллов | | `installer/` | CLI: установка плагина, регистрация MCP, копирование скиллов |
| `docs/` | Архитектурные решения и документация | | `docs/` | Архитектурные решения и документация |
| `examples/` | Минимальный UE-проект для интеграционных тестов | | `examples/` | Минимальный UE-проект для интеграционных тестов |
@@ -18,7 +20,31 @@
## Архитектурные решения ## Архитектурные решения
- [ADR-0001: Discovery over PID file](docs/architecture/decisions/0001-discovery-over-pid-file.md) — поиск запущенного редактора через UDP-broadcast, а не через файл-PID. - [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; правообладатель назван, атрибуция в титрах — просьба, а не условие.
## Лицензия ## Лицензия
TBD (планируется MIT). 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; в поставке нет чужого
кода, адресов и дословных выдержек, но заключением о вашем использовании это не
является.
+14
View File
@@ -4,6 +4,20 @@
**Сессия:** Hermes, модель mini-max/m3 **Сессия:** Hermes, модель mini-max/m3
**Состояние:** решено зафиксировать, начата реализация **Состояние:** решено зафиксировать, начата реализация
> **Документ исторический. Не читать как текущее состояние.** Он верно описывает
> развилку 2026-09-01 и сохраняется ради причин, по которым решения приняты именно
> так. Что изменилось с тех пор:
>
> | Сказано здесь | Как на 2026-09-05 |
> |---|---|
> | «Скиллы не перенесены», 14 штук | перенесены: 17 скиллов, 232 записи, `plugins/ue-design-skills/` |
> | компонент `skills/` в корне | репозиторий — маркетплейс, бандл на уровень глубже ([ADR-0002](architecture/decisions/0002-harness-neutral-skill-bundle.md)) |
> | «Лицензия TBD, планируется MIT» (вопрос 2) | решено: проза CC BY-ND 4.0, код Apache-2.0 ([ADR-0003](architecture/decisions/0003-split-licensing-prose-and-code.md)) |
> | `docs/licensing-options.md` как открытый выбор | материал к решению, само решение — в ADR-0003 |
> | целевая версия UE открыта (вопрос 5) | бандл измерен на 5.6; платформа исследования переведена на 5.8 (`LyraResearch/plans/ue58-native-mcp-strategy.md`). В поставку решение ещё не доехало — **открыто** |
>
> Открытыми остаются вопросы 1, 3, 4 и 5 из §6.
--- ---
## 1. Что произошло ## 1. Что произошло