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:
@@ -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; в поставке нет чужого
|
||||||
|
кода, адресов и дословных выдержек, но заключением о вашем использовании это не
|
||||||
|
является.
|
||||||
|
|||||||
@@ -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. Что произошло
|
||||||
|
|||||||
Reference in New Issue
Block a user