docs: initial ADR-0001 (discovery over PID file) and project skeleton

Зафиксировано архитектурное решение о замене PID-файла на UDP-broadcast
discovery с graceful degradation: MCP-сервер остаётся полезным без
запущенного редактора (файловые и аналитические инструменты работают),
а редакторные инструменты появляются в tools/list только при живом
соединении.

Это ответ на повседневную боль VibeUE: 60-секундные зависания tools/call
после закрытия редактора, конфликты при двух инстансах, жёсткая связка
с файлом-маркером на диске.
This commit is contained in:
ue-toolchain
2026-09-01 20:55:15 +07:00
commit cec48f686b
3 changed files with 271 additions and 0 deletions
+24
View File
@@ -0,0 +1,24 @@
# ue-toolchain
Инструменты для разработки на Unreal Engine через LLM-агентов: UE-плагин, MCP-сервер, скиллы, установщик, локальная документация проекта.
**Статус:** ранняя разработка. Первый архитектурный документ: [ADR-0001](docs/architecture/decisions/0001-discovery-over-pid-file.md).
## Состав (план)
| Компонент | Назначение |
|---|---|
| `Engine/` | UE-плагин редактора (C++): JSON-RPC сервер, discovery, мониторинг |
| `mcp-server/` | MCP-сервер на Python: инструменты для агентов (Hermes, Claude Code, Codex) |
| `skills/` | Скиллы для LLM-агентов: правила, шаблоны, плохие примеры |
| `installer/` | CLI: установка плагина, регистрация MCP, копирование скиллов |
| `docs/` | Архитектурные решения и документация |
| `examples/` | Минимальный UE-проект для интеграционных тестов |
## Архитектурные решения
- [ADR-0001: Discovery over PID file](docs/architecture/decisions/0001-discovery-over-pid-file.md) — поиск запущенного редактора через UDP-broadcast, а не через файл-PID.
## Лицензия
TBD (планируется MIT).