Full parallel English and Russian text: what the bundle is and why, repository
map, all 17 skills, the catalog, the 17-rule delivery gate and its self-test,
the five MADR records, installation for Claude Code and other harnesses,
split licensing, and an explicit statement of what the repository does not
contain (no editor bridge, MCP server, installer or UE module).
All 229 runnable recipes were executed against a second tree one major version
newer. Nothing was one-sided -- no recipe answered in one version and fell
silent in the other. 176 matched exactly, 14 differed in size, 39 returned
nothing in either tree.
The README states two cautions with the numbers, because the numbers alone
would overclaim. Matching counts mean the search surface did not move, not that
a claim still holds; anything semantic is untested by counting lines. And the
comparison was worthless before the trees were made comparable: 41 of the 55
apparent differences in the first pass were generated build output in one tree
and a tooling plugin in the other, a distortion large enough that one query
reported 122 files before exclusions and 1 after.
Full method, per-entry data and the follow-up list live in the research archive
(note 27 and _tools/run_detect_recipes.py), not here.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The engine now ships an MCP server, a toolset registry and skill assets --
measured against a live editor rather than read about. Building a second
transport beside it is not a contest this project can win.
ADR-0001 is narrowed, not withdrawn. Its liveness reasoning survives intact:
process over file, tools that vanish honestly, recovery without a restart.
Three mechanisms are dropped (own JSON-RPC server, UDP-broadcast discovery, own
heartbeat) and discovery becomes a probe of the documented endpoint, which the
measurement showed gives a fast negative -- HTTP 404 with a routing error body,
no hang. That is the property the PID file could not provide.
Two layers stay ours: a server that runs without the engine, and tools that run
in a live game outside the editor, the layer the registry's editor-only
declaration leaves uncovered.
The load-bearing claim is flagged as not yet attempted: a runtime tool answering
in a packaged build. Until that runs it is derived, not measured.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The first-party agent-tool layer is Experimental and its surface moves between
builds. A recipe that names a toolset does not fail loudly on the next build --
the tool is simply absent, the search finds nothing, and "nothing found" reads
as "no problem here". That is the exact confusion this bundle documents, so the
tokens are barred rather than discouraged.
Grounded in measurement against a live editor, not in reading:
- the aggregator plugin lists 21 dependencies; the server reported 53
registered toolsets from 22 plugins, one dependency contributing none;
- the visible tool count flips between 3 meta-tools and every tool registered
natively, on one project setting.
- gate.py: ENGINE_TOOL_TOKENS and check_engine_tool_surface, registered in
CHECKS; rule floor raised to 17.
- test_gate.py: one poison naming a toolset, a meta-tool and a host:port.
- ADR-0004 records the decision, its confirmation criteria and what is
deliberately deferred.
- README and CONTRIBUTING state the rule where a contributor meets it.
Verified: gate.py 0 violations over 17 rules; test_gate.py 17/17 redden on
their fixtures, baseline clean, surface coverage intact. The token list matches
nothing under skills/ today, checked before the rule landed.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
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>
Phase 0 of the handoff plan, as a marketplace rather than a flat skills/
directory. Content moved out of the LyraResearch archive and depersonalised:
addresses stay in the archive, recipes ship.
- plugins/ue-design-skills: 17 skills, 232 failure-mode entries, each with the
six required fields; catalog.json as the harness-neutral source of truth and
.claude-plugin/ as one adapter over it.
- _gate: 16 rules, one poisoned fixture per rule, plus surface coverage so a
declared file cannot silently miss the line rules.
- ADR-0002 (harness-neutral bundle behind a marketplace) and ADR-0003 (split
licensing: CC BY-ND 4.0 prose, Apache-2.0 code and metadata).
- LICENSE files at both levels, CONTRIBUTING.md, docs/licensing-options.md as
the material the licence decision grew from.
Verified: gate.py 0 violations; test_gate.py 16/16 rules redden on their
fixtures with a clean baseline and 2 root files reaching the line rules.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Фиксирует состояние проекта на момент завершения сессии 2026-09-01:
что сделано (ADR-0001, репозиторий), что не сделано (фазы 0-5),
открытые вопросы и порядок следующих шагов.
Документ нужен, чтобы продолжить работу через неделю/месяц без
необходимости перечитывать всю сессию.
Убрана отсылка к 'ADR-0002-candidate' про удалённый транспорт, которая
была вставлена для красоты аргумента, но не подкреплена реальным запросом.
Заменено на честную формулировку: loopback-only — это ограничение
v0.1, удалённый сценарий будет рассмотрен отдельным ADR при появлении
конкретной потребности, а не упреждающе.
Соответствует принципу YAGNI: ADR фиксируют принимаемые решения, а не
гипотетические.
Зафиксировано архитектурное решение о замене PID-файла на UDP-broadcast
discovery с graceful degradation: MCP-сервер остаётся полезным без
запущенного редактора (файловые и аналитические инструменты работают),
а редакторные инструменты появляются в tools/list только при живом
соединении.
Это ответ на повседневную боль VibeUE: 60-секундные зависания tools/call
после закрытия редактора, конфликты при двух инстансах, жёсткая связка
с файлом-маркером на диске.
2026-09-01 20:55:15 +07:00
3 changed files with 301 additions and 42 deletions
Инструменты для разработки на Unreal Engine через LLM-агентов: UE-плагин, MCP-сервер, скиллы, установщик, локальная документация проекта.
[English](#english) · [Русский](#русский)
**Статус:** ранняя разработка. Готов и лицензирован один компонент — бандл скиллов
`plugins/ue-design-skills/` (17 скиллов, 232 записи о режимах отказа, гейт поставки
на 16 правилах). Остальные компоненты таблицы ниже — план, кода ещё нет.
## English
## Состав (план)
### What this is
| Компонент | Назначение |
Design-review skills for Unreal Engine 5.6 projects, written for LLM agents such as Claude Code and other agent harnesses.
The repository currently ships one self-contained bundle: norms for designing UE systems plus reproducible recipes for detecting silent architectural failures. The skills are Markdown with YAML frontmatter, indexed by a vendor-neutral JSON catalog. They can be read directly, loaded as agent context, or routed by a harness; the Claude Code manifest is only one distribution adapter.
### Why it exists
Many costly architecture defects do not crash, fail compilation, or announce themselves in the editor. A tag typo can produce an empty lookup, a feature can activate correctly but fail to roll back, a client can own a fact that only the server should trust, and a quality setting can be silently overridden. The bundle turns those failure shapes into review invariants, observable symptoms, runnable detection recipes, and guardrails intended to prevent recurrence.
Each failure-mode entry separates six questions: mechanism, why the failure is silent, why the obvious check misses it, symptom, detection, and guardrail. An empty search result is evidence about the search pattern—not proof that a defect is absent.
### Repository contents
```text
.
├── .claude-plugin/
│ └── marketplace.json Claude Code marketplace adapter
│ ├── catalog.json harness-neutral source of truth
│ ├── skills/ design-review skill directories
│ ├── _gate/ delivery gate, clean fixture, and self-test
│ ├── README.md bundle-level usage and provenance
│ └── LICENSE prose license and additional permissions
├── docs/
│ ├── architecture/decisions/ accepted MADR decision records
│ ├── handoff.md historical project handoff and plan
│ └── licensing-options.md analysis that preceded ADR-0003
├── CONTRIBUTING.md evidence and contribution requirements
├── LICENSE repository-level Apache-2.0 boundary
└── README.md this bilingual overview
```
Every skill directory contains a `SKILL.md` entry point and `references/failure-modes.md`; supporting documents such as `patterns.md` are listed by that skill's catalog entry when present.
### Skills
This table contains every current directory under `plugins/ue-design-skills/skills/`. Its summaries follow `catalog.json` and the corresponding `SKILL.md` frontmatter.
| `docs/` | Архитектурные решения и документация |
| `examples/` | Минимальный UE-проект для интеграционных тестов |
| `ue-reference-project-adoption` | Classifies borrowed sample or reference-project elements as defects, showcase stubs, scope narrowing, architecture tax, or foreign legacy, then supports a copy/close/skip decision. |
| `ue-multiplayer-authority` | Ownership of networked facts, prediction, replication, validation, RPC discipline, hit registration, relevancy, replication cost, and the cheat surface. |
| `ue-gameplay-cues` | GameplayCue forms and addressing, static versus actor notifies, dedicated-server exclusion, discovery and loading, feature-plugin paths, teardown, and tag-to-asset validation. |
| `ue-gameplay-tag-governance` | Tag declaration sources, namespaces, constrained inputs, exact versus hierarchical matching, redirects, replicated tag sets, counters, and inventory audits. |
| `ue-modular-gameplay` | Experience definitions, feature plugins, action sets and rollback, actor extensions, initialization states, asset bundles, activation, and deactivation. |
| `ue-gas-architecture` | Production Gameplay Ability System structure: grant packages and receipts, buffered input, activation policy, attributes, effect contexts, tag policy, phases, health, and death. |
| `ue-input-architecture` | Enhanced Input layers, mapping contexts and actions, semantic tags, native and ability paths, buffering, rebinding, device switching, and feature-owned input. |
| `ue-data-driven-architecture` | Definition and composition layers, data assets, class defaults, instanced fragments, reference semantics, asset bundles, validation, and the code/data boundary. |
| `ue-cosmetics-and-teams` | Replicated cosmetic intent and local realization, selection ownership, server exclusion, mesh and animation choice, authoritative teams, and shared damage policy. |
| `ue-evidence-discipline` | Evidence quality: measured versus derived versus open claims, negative-search limits, independent verification, delegated findings, and recipes that have actually been run. |
## Архитектурные решения
### Catalog
- [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 сняты, контракт живости сохранён. Нашими остаются два слоя: сервер без редактора и тулы в рантайме.
`plugins/ue-design-skills/catalog.json` uses schema `ue-skills-catalog/1`. It is the harness-neutral source of truth for bundle identity and routing: each entry provides an ID, path, Markdown entry point, description, usage condition, and reference paths. The catalog contains **17 entries**, matching the **17 skill directories**.
python3 -c 'import json; from pathlib import Path; p=Path("plugins/ue-design-skills"); print(len(json.loads((p/"catalog.json").read_text())["skills"]), sum(x.is_dir() for x in (p/"skills").iterdir()))'
```
| Что | Лицензия |
To add a skill, create a kebab-case directory under `skills/`, add `SKILL.md` with matching `name` and a non-empty `description`, add and link `references/failure-modes.md`, and add a matching catalog entry with the required routing fields. Failure-mode IDs must be sequential and their prefixes unique across skills. Run the delivery gate and its self-test before proposing the change; the contribution guide asks that a new skill be discussed first and that every detection recipe be run against a real tree.
### Delivery gate
`plugins/ue-design-skills/_gate/gate.py` declares **17 rules** (`P01`–`P17`). They reject:
- missing or invalid skill frontmatter, missing or unlinked failure-mode documents, incomplete six-field entries, broken or escaping relative links, non-sequential entry IDs, and duplicate entry-ID prefixes;
- unexpected top-level bundle files, junk or binary artifacts, harness/vendor names inside skills, catalog/directory mismatches, and names from the experimental engine tool surface inside skill content.
The gate also validates the Claude Code manifest shape. Its scan surface is a whitelist, and an unexpected top-level path is itself a violation. A green result proves delivery form, links, structure, and portability constraints; it does **not** prove that a technical claim is true.
The self-test starts from `_gate/fixtures/clean`, applies one deliberate poison for every declared rule, and requires that rule to turn red. It separately verifies that each declared root file reaches the line-level checks. These poisoned fixtures exist because a validator that cannot be made to fail provides no protection.
### Architecture decisions
There are **5 accepted MADR records**. Reproduce the count with `find docs/architecture/decisions -maxdepth 1 -type f -name '*.md' | wc -l`.
- [ADR-0001 — Discovery over PID file](docs/architecture/decisions/0001-discovery-over-pid-file.md): establishes process liveness, automatic recovery, and graceful editor-less operation instead of trusting a stale PID file; its custom transport design is narrowed by ADR-0005.
- [ADR-0002 — Harness-neutral skill bundle](docs/architecture/decisions/0002-harness-neutral-skill-bundle.md): makes the catalog authoritative, vendor manifests adapters, and harness neutrality an enforced property of skill content.
- [ADR-0003 — Split licensing](docs/architecture/decisions/0003-split-licensing-prose-and-code.md): places bundle prose under CC BY-ND 4.0 and code and metadata under Apache-2.0, with explicit additional permissions.
- [ADR-0004 — Engine tool surface stays out of skills](docs/architecture/decisions/0004-engine-tool-surface-out-of-skill-content.md): keeps experimental, version-bound toolset, meta-tool, and endpoint names out of skill content through gate rule P17.
- [ADR-0005 — Native transport narrows ADR-0001](docs/architecture/decisions/0005-native-transport-narrows-adr-0001.md): drops the planned custom editor server, UDP discovery, and heartbeat in favor of probing the engine's own transport while retaining the liveness contract.
### Installation and use
For Claude Code, add this repository as a marketplace and then install the single plugin:
For another harness, no Claude-specific adapter is required. Read `plugins/ue-design-skills/catalog.json`, match a task against each entry's `use_when`, and load its `entry`; alternatively load a selected skill directory as context or open its `SKILL.md` directly. This works because ADR-0002 keeps vendor vocabulary outside `skills/` and the gate enforces that boundary.
### Licensing
Copyright is held under the pseudonym **MagentaDolphin**; `catalog.json` names **Kodlo.art** as publisher.
| Root documentation and repository software or machine-readable material outside the prose bundle | [Apache License 2.0](LICENSE) |
| `plugins/ue-design-skills/skills/**`, reference prose, and the bundle README | [CC BY-ND 4.0](plugins/ue-design-skills/LICENSE) |
| `catalog.json`, `.claude-plugin/plugin.json`, and everything under `_gate/` | Apache-2.0 under the bundle's explicit carve-outs |
| Shell commands inside `Detect` fields | Apache-2.0; the surrounding prose remains CC BY-ND 4.0 |
Практическая разница: код можно форкать и переиздавать как обычно; **изменённую
версию текстов публиковать как свой продукт нельзя**. Всё остальное разрешено —
использование в коммерческой работе, правка под свою студию, дословное
распространение с указанием авторства, адаптеры формата под другие харнесы и
переводы.
The bundle license permits reading and commercial use, private adaptation, and unchanged redistribution with attribution. Its additional permissions allow publication of format adapters and faithful, clearly marked unofficial translations under the stated conditions, as well as forks or patches made to contribute changes back. It does not permit publishing modified prose as a separate product. Nothing in either license claims a user's game, source code, documentation, internal standards, or revenue. Credit for use is welcomed but is not a license condition; attribution is required when redistributing the material itself. Read the license files for the governing terms; the repository does not present its licensing analysis as legal advice.
На то, что вы создаёте с помощью инструмента, притязаний нет: ни на игру, ни на
код, ни на документацию, ни на выручку.
### Requirements and boundaries
Если инструмент помог — упоминание приветствуется, но ничем не обязывает.
Атрибуция обязательна только при распространении самих материалов.
- **Engine scope:** the shipped skills target Unreal Engine **5.6**. They are design-review material, not an engine plugin, and do not need the editor to be open in order to be read or routed.
- **For Claude Code:** install Claude Code with plugin marketplace support, then use the two commands above. No minimum Claude Code version is documented in this repository.
- **For other harnesses:** the harness must be able to read Markdown and JSON context. No agent runtime is required for direct reading.
- **For maintainers:** Python 3 runs the delivery gate and self-test. A minimum Python minor version is not documented.
Оговорка: выбор лицензий — не юридическое заключение. Материал бандла получен
чтением стороннего сэмпла, распространяемого по UE EULA; в поставке нет чужого
кода, адресов и дословных выдержек, но заключением о вашем использовании это не
является.
This repository does **not** currently contain an editor bridge, an MCP server, an installer, a UE C++ module, or a sample UE project. The marketplace description mentions an editor bridge and an MCP server, but their implementations are absent from this tree; ADR-0005 also records that the custom bridge design was dropped before it was built. The remaining standalone file/analysis server and runtime-game tool layer are architectural work still to be built, not shipped features.
The bundle does not execute reviews automatically, modify a UE project, prove that an architecture is correct, certify performance or security, or guarantee that a detection recipe covers a user's codebase. The gate checks packaging and form, not the truth of the claims. The material records reusable failure shapes derived from a source-reading research process; it is not a defect list for every UE project or engine version.
- Author: **Kodlo (MagentaDolphin)**; publisher recorded by the catalog: **Kodlo.art**
## Русский
### Что это
Скиллы для архитектурного design review проектов на Unreal Engine 5.6, рассчитанные на LLM-агентов — Claude Code и другие агентные харнесы.
Сейчас репозиторий поставляет один самодостаточный бандл: нормы проектирования систем UE и воспроизводимые рецепты поиска тихих архитектурных отказов. Скиллы написаны на Markdown с YAML-фронтматтером и собраны в нейтральном к конкретному вендору JSON-каталоге. Их можно читать напрямую, загружать в контекст агента или маршрутизировать средствами харнеса; манифест Claude Code — лишь один адаптер поставки.
### Зачем
Многие дорогие архитектурные дефекты не приводят к падению, не ломают компиляцию и никак не проявляются в редакторе. Опечатка в теге может дать пустой результат, фича — корректно активироваться, но не откатиться, клиент — владеть фактом, которому должен доверять только сервер, а настройка качества — молча проиграть более приоритетному значению. Бандл превращает такие формы отказов в инварианты для ревью, наблюдаемые симптомы, запускаемые рецепты обнаружения и защитные правила против повторения дефекта.
Каждая запись о режиме отказа отвечает на шесть отдельных вопросов: механизм, почему отказ остаётся тихим, почему очевидная проверка его пропускает, симптом, способ обнаружения и защитное правило. Пустой результат поиска считается свидетельством о поисковом шаблоне, но не доказательством отсутствия дефекта.
### Состав репозитория
```text
.
├── .claude-plugin/
│ └── marketplace.json адаптер маркетплейса Claude Code
├── CONTRIBUTING.md требования к доказательствам и вкладам
├── LICENSE граница Apache-2.0 на уровне репозитория
└── README.md этот двуязычный обзор
```
В каждом каталоге скилла есть точка входа `SKILL.md` и `references/failure-modes.md`; дополнительные справочные документы, например `patterns.md`, перечислены в записи конкретного скилла в каталоге, если они присутствуют.
### Скиллы
В таблице перечислены все текущие каталоги из `plugins/ue-design-skills/skills/`. Краткое назначение сверено с `catalog.json` и фронтматтером соответствующего `SKILL.md`.
| Скилл | Что проверяет |
|---|---|
| `ue-reference-project-adoption` | Классифицирует заимствования из примеров и референсных проектов как дефекты, демонстрационные заглушки, сужение области, архитектурный налог или чужое наследие и помогает решить: копировать, завершать или пропускать. |
| `ue-multiplayer-authority` | Владение сетевыми фактами, предсказание, репликацию, валидацию, дисциплину RPC, регистрацию попаданий, relevancy, стоимость репликации и поверхность для читов. |
| `ue-gameplay-cues` | Формы и адресацию GameplayCue, static- и actor-notify, исключение dedicated server, обнаружение и загрузку, пути feature-плагинов, teardown и валидацию связи тегов с ассетами. |
| `ue-gameplay-tag-governance` | Источники объявления тегов, пространства имён, ограничения ввода, точное и иерархическое сопоставление, редиректы, реплицируемые наборы тегов, счётчики и аудит инвентаря. |
| `ue-gameplay-messaging` | Типизированную publish/subscribe-шину с адресацией тегами: область жизни, проверку payload, сопоставление каналов, владение listener-ами, паритет C++/Blueprint и границу локального и сетевого. |
| `ue-modular-gameplay` | Experience-описания, feature-плагины, action set и откат действий, расширения акторов, состояния инициализации, asset bundle, активацию и деактивацию. |
| `ue-gas-architecture` | Промышленную архитектуру Gameplay Ability System: пакеты выдачи и квитанции отзыва, буферизованный ввод, политики активации, атрибуты, контексты эффектов, теги, фазы, здоровье и смерть. |
| `ue-input-architecture` | Слои Enhanced Input, mapping context и input action, семантические теги, нативные и ability-пути, буферизацию, переназначение, смену устройства и ввод, которым владеет фича. |
| `ue-ui-architecture` | Корневые layout для каждого локального игрока, стеки слоёв с тегами, точки расширения фич, политику фокуса и ввода, экраны загрузки, порядок и teardown. |
| `ue-data-driven-architecture` | Слои определений и композиции, data asset, значения по умолчанию классов, инстансированные фрагменты, семантику ссылок, asset bundle, валидацию и границу кода и данных. |
| `ue-cosmetics-and-teams` | Реплицируемое намерение косметики и локальную реализацию, владение выбором, исключение сервера, выбор мешей и анимации, авторитетные команды и общую политику урона. |
| `ue-game-settings-architecture` | Независимые от виджетов модели настроек, reflection-пути, условия редактирования, транзакцию apply/cancel, хранение, scalability, device profile, бенчмарки и выборочную статистику. |
| `ue-asset-loading-and-memory` | Идентификаторы Asset Manager, семантику ссылок, bundle и cook-правила, владение load handle, синхронные задержки, порядок старта, сборку мусора, удержание и выгрузку. |
| `ue-streaming-and-platform-budgets` | Границы диска, CPU-памяти, видеопамяти и streaming pool; группы текстур, scalability, device profile, приоритет консольных переменных и время жизни загруженных уровней. |
| `ue-runtime-allocation-and-caching` | Аллокации, пулы, ограниченные кеши, указатели в память контейнеров, удержание, структуры репликации, dormancy, relevancy и исключения dedicated server. |
| `ue-architecture-guardrails` | Межсистемное владение, транзакции жизненного цикла, контекст, валидацию графа данных, временные зависимости, наблюдаемость, ложную универсальность и риск-ориентированные интеграционные гейты. |
| `ue-evidence-discipline` | Качество доказательств: измеренные, выведенные и открытые утверждения, пределы отрицательного поиска, независимую проверку, делегированные находки и реально запущенные рецепты. |
### Каталог
`plugins/ue-design-skills/catalog.json` использует схему `ue-skills-catalog/1`. Это харнес-нейтральный источник истины о составе и маршрутизации бандла: каждая запись содержит ID, путь, точку входа Markdown, описание, условие применения и пути к справочным материалам. В каталоге **17 записей**, соответствующих **17 каталогам скиллов**.
Обе цифры можно воспроизвести из корня репозитория:
```bash
python3 -c 'import json; from pathlib import Path; p=Path("plugins/ue-design-skills"); print(len(json.loads((p/"catalog.json").read_text())["skills"]), sum(x.is_dir() for x in (p/"skills").iterdir()))'
```
Чтобы добавить скилл, создайте каталог с kebab-case-именем внутри `skills/`, добавьте `SKILL.md` с совпадающим полем `name` и непустым `description`, добавьте и свяжите ссылкой `references/failure-modes.md`, затем внесите в каталог соответствующую запись с обязательными полями маршрутизации. ID режимов отказа должны идти последовательно, а их префиксы — быть уникальными между скиллами. Перед предложением изменения запустите гейт поставки и его самотест; руководство для контрибьюторов просит сначала обсудить новый скилл и запускать каждый рецепт обнаружения на реальном дереве.
### Гейт поставки
`plugins/ue-design-skills/_gate/gate.py` объявляет **17 правил** (`P01`–`P17`). Они запрещают:
- абсолютные пути рабочих машин, ссылки вида «исходный файл и строка», имя донорского проекта вне раздела происхождения, кириллицу и неразрешимые wiki-ссылки;
- отсутствующий или некорректный фронтматтер скилла, отсутствующий или не связанный ссылкой документ с режимами отказа, неполные записи из шести полей, сломанные или выходящие за каталог относительные ссылки, непоследовательные ID и повторяющиеся префиксы ID;
- неожиданные файлы верхнего уровня бандла, мусорные и бинарные артефакты, имена харнесов и вендоров внутри скиллов, расхождение каталога с каталогами скиллов и имена экспериментальной поверхности инструментов движка в содержимом скиллов.
Гейт также проверяет форму манифеста Claude Code. Поверхность сканирования задана белым списком, а неожиданный путь верхнего уровня сам считается нарушением. Зелёный результат подтверждает форму поставки, ссылки, структуру и ограничения переносимости, но **не** истинность технических утверждений.
Вывести набор правил и воспроизвести их количество:
Самотест начинает с `_gate/fixtures/clean`, вносит по одному намеренному «яду» для каждого объявленного правила и требует, чтобы это правило покраснело. Отдельно он проверяет, что каждый заявленный корневой файл действительно доходит до построчных проверок. Отравленные фикстуры нужны потому, что валидатор, который невозможно заставить упасть, ничего не защищает.
### Архитектурные решения
В репозитории **5 принятых решений MADR**. Количество воспроизводится командой `find docs/architecture/decisions -maxdepth 1 -type f -name '*.md' | wc -l`.
- [ADR-0001 — Discovery over PID file](docs/architecture/decisions/0001-discovery-over-pid-file.md): фиксирует живость процесса, автоматическое восстановление и корректную работу без редактора вместо доверия устаревающему PID-файлу; проект собственного транспорта сужен ADR-0005.
- [ADR-0002 — Harness-neutral skill bundle](docs/architecture/decisions/0002-harness-neutral-skill-bundle.md): назначает каталог источником истины, вендорские манифесты — адаптерами, а нейтральность скиллов к харнесу — проверяемым свойством.
- [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 stays out of skills](docs/architecture/decisions/0004-engine-tool-surface-out-of-skill-content.md): через правило P17 не допускает в скиллы экспериментальные и привязанные к версии имена тулсетов, мета-инструментов и эндпоинтов.
- [ADR-0005 — Native transport narrows ADR-0001](docs/architecture/decisions/0005-native-transport-narrows-adr-0001.md): отказывается от запланированных собственного сервера в редакторе, UDP-discovery и heartbeat в пользу проверки нативного транспорта движка, сохраняя контракт живости.
### Установка и использование
В Claude Code добавьте репозиторий как маркетплейс, затем установите единственный плагин:
Другому харнесу адаптер Claude не нужен. Прочитайте `plugins/ue-design-skills/catalog.json`, сопоставьте задачу с полем `use_when` каждой записи и загрузите её `entry`; другой вариант — целиком загрузить каталог выбранного скилла в контекст или открыть его `SKILL.md`. Это работает потому, что ADR-0002 оставляет вендорскую лексику за пределами `skills/`, а гейт контролирует эту границу.
### Лицензирование
Правообладатель указан под псевдонимом **MagentaDolphin**; издателем в `catalog.json` назван **Kodlo.art**.
| Область | Лицензия или разрешение |
|---|---|
| Корневая документация, код и машиночитаемые материалы репозитория вне текстового бандла | [Apache License 2.0](LICENSE) |
| `catalog.json`, `.claude-plugin/plugin.json` и всё внутри `_gate/` | Apache-2.0 по явным исключениям лицензии бандла |
| Shell-команды внутри полей `Detect` | Apache-2.0; окружающая их проза остаётся под CC BY-ND 4.0 |
Лицензия бандла разрешает чтение и коммерческое использование, внутреннюю адаптацию и неизменённое распространение с указанием авторства. Дополнительные разрешения позволяют публиковать адаптеры формата и точные, явно помеченные неофициальные переводы на указанных условиях, а также форки и патчи ради передачи изменений обратно в проект. Публиковать изменённую прозу как отдельный продукт нельзя. Ни одна из лицензий не предъявляет прав на игру пользователя, её исходный код, документацию, внутренние стандарты или выручку. Упоминание при использовании приветствуется, но не является условием лицензии; атрибуция обязательна при распространении самих материалов. Юридическую силу имеют тексты лицензий; репозиторий не выдаёт анализ лицензирования за юридическую консультацию.
### Требования и границы
- **Версия движка:** поставляемые скиллы рассчитаны на Unreal Engine **5.6**. Это материалы для design review, а не плагин движка; для чтения и маршрутизации открытый редактор не нужен.
- **Для Claude Code:** установите Claude Code с поддержкой маркетплейса плагинов и выполните две команды выше. Минимальная версия Claude Code в репозитории не задокументирована.
- **Для других харнесов:** харнес должен уметь читать Markdown и JSON как контекст. Для прямого чтения среда агента не требуется.
- **Для сопровождающих:** гейт поставки и самотест запускаются на Python 3. Минимальная минорная версия Python не задокументирована.
В этом репозитории сейчас **нет** моста редактора, MCP-сервера, установщика, C++-модуля UE и тестового UE-проекта. В описании маркетплейса упомянуты мост редактора и MCP-сервер, но их реализаций в дереве нет; ADR-0005 также фиксирует, что проект собственного моста был снят до реализации. Отдельный сервер файловых и аналитических инструментов и слой инструментов для запущенной вне редактора игры остаются архитектурным планом, а не поставляемыми функциями.
Бандл не запускает ревью автоматически, не изменяет UE-проект, не доказывает корректность архитектуры, не сертифицирует производительность или безопасность и не гарантирует, что рецепт обнаружения покрывает конкретную кодовую базу. Гейт проверяет упаковку и форму, а не истинность утверждений. Материал описывает переносимые формы отказов, полученные в процессе исследования исходников; это не список дефектов для любого проекта или любой версии движка.
**Проблема:** проект был жёстко завязан на Overmind (NextGenium) — пути `D:\Work\NG\...`, Perforce-правила, конфигурация под конкретный редактор. Скиллы и инструменты не переносились в чужие проекты без переписывания.
**Проблема:** проект был жёстко завязан на конкретный студийный проект — пути к его дереву, Perforce-правила, конфигурация под конкретный редактор. Скиллы и инструменты не переносились в чужие проекты без переписывания.
**Решение:** сделать из LyraResearch **самостоятельный публичный продукт**`ue-toolchain`, не зависящий от NextGenium и от конкретного проекта.
**Решение:** сделать из LyraResearch **самостоятельный публичный продукт**`ue-toolchain`, не зависящий от студии и от конкретного проекта.
## 2. Целевой продукт
@@ -126,7 +126,7 @@ VibeUE (текущий MCP-сервер для UE) привязан к **PID-ф
### Фаза 0 — Перенос существующего (1-2 недели)
- Переписать 14 скиллов из `LyraResearch/.claude/skills/local/` под публичный формат.
- Убрать упоминания NG, Overmind, Perforce.
- Убрать упоминания студийных проектов и Perforce.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
MagentaDolphin