Graph Hygiene
[!lexery-hero] Graph hygiene !_assets/brand/lexery-wordmark-dark-bg.svg|200 !_assets/brand/lexery-icon.svg|46
Читабельний граф Obsidian, embeds і бренд. Lexery - Wiki North Star|North Star · Lexery - Graph Metrics|Metrics · Lexery - Authoring Toolchain|Інструменти
SVG бренду:
apps/portal/public/→_assets/brand/.
Lexery - Graph Hygiene
Контекст «навіщо» і сигнали автоматики: Lexery - Wiki North Star · Lexery - Wiki Quality Contract · Lexery - Graph Metrics.
Obsidian Graph view малює всі wikilink-зв’язки одразу — без фільтрів він виглядає як «куля з вузлів». Нижче — практичні кроки, щоб граф був читабельним і корисним для навігації.
1. Почни з вузла, а не з усього vault
- Відкрий Local graph з контекстного меню нотатки (наприклад Lexery - Project Brain або Lexery - U1-U12 Runtime).
- Увімкни Depth 1–2, не глобальну глибину 4+.
2. Приховай шум у налаштуваннях графа
У панелі Graph (шестерня):
- Hide attachments — так зникають дрібні технічні файли, якщо вони колись з’являться в корені.
- Orphans — вимкни, якщо хочеш бачити лише зв’язний острів навколо поточної нотатки.
- Unresolved — можна сховати, якщо граф засмічений майбутніми посиланнями.
3. Кольори за роллю (.obsidian/graph.json)
У репо задані color groups у порядку від найконкретнішого до загального (Obsidian бере перший збіг):
| Колір (орієнтир) | Що покриває |
|---|---|
| Насичений синій | U1–U12 + Lexery - U1-U12 Runtime (для U1–U9 у запиті є пробіл після цифри, щоб U10 не ловився як U1) |
| Бірюза | Хаби: Lexery - Index, Lexery - Project Brain, Lexery - Neural Link Hub |
| Бірюзово-зелений | Дашборди: Ops, Data Integrity, Pipeline Health, Graph Metrics, Ops Rollup |
| Фіолетовий | Governance-кластер: Decision Registry, Wiki Quality Contract, Drift, Unknowns, Open Questions |
| Помаранчевий / бурштин | Lexery - Branch*, Lexery - Legacy* |
| Далі за тегами | brain, product, data, meta, team |
Теги в запитах — tag:brain, не tag:#brain (YAML-теги без #). Теги як вузли графа вимкнені (showTags: false), щоб не дублювати шум; кольори все одно застосовуються до файлів за їхніми тегами.
Сніпет lexery-wiki додає змінні --graph-* (лінії, фокус, текст) і легкий glass на панелі керування графа — перезавантаж сніпет після pull.
4. Не перетворюй Neural Hub на «зірку» посилань
Сторінка Lexery - Neural Link Hub навмисно містить мало wikilinkів у тілі — ідеї зв’язків лежать у _system/logs/link-suggestions-*.md. Так граф лишається охайнішим.
5. Сила зв’язку
- Пріоритетно лінкуй вгору до hub-ів: Lexery - Index, Lexery - Project Brain, відповідний U-stage або product surface.
- Уникай взаємних «павутин» між десятками сторінок одного рівня без ієрархії — для цього є Canvas-и (
Lexery - Master Map.canvas, Lexery - Runtime Graph.canvas|Runtime Graph).
6. Фізика графа
У graph.json за замовчуванням: менший centerStrength, трохи вищий repelStrength і linkDistance, щоб менше «ком у центрі»; scale трохи піднятий для читабельності. Якщо на слабкому Mac все ще тісно — тимчасово зменш scale у UI й натисни Save для запису в файл.
7. Embeds, бренд і «картинка» сторінки
- Канон логотипів у коді:
apps/portal/public/(lexery-logo.svg,lexery-icon.svg, …). У вікі для!…— дзеркало_assets/brand/; після ребренду в порталі скопіюй SVG у vault, інакше Obsidian покаже застарілий вектор. - Hero
[!lexery-hero]на генерованих дашбордах (Ops, Integrity, Neural, …) і на статичних hub-сторінках тримає один візуальний ряд: wordmark + icon + рядок про шлях SVG (apps/portal/public/→_assets/brand/), щоб vault не виглядав як «кілька різних продуктів». - Правдивість списків: склад hub-ів з hero змінюється разом із vault. Щоб документація не відставала від реальності, не покладайся на повний перелік назв у випадкових нотатках — канонічна навігація та «хто hub» живуть у Lexery - Index|Швидка навігація і тематичних таблицях Lexery - Index; тут ми лишаємо лише правило патерну, а не копію переліку.
- Canvas (
*.canvas): у вузлах типуfileполеfileмає бути шляхом від кореня vault (наприкладLexery - Project Brain.md). Подвійний префікс на кшталтLexery/Lexery - …дає зламані посилання в Obsidian — це виглядає як «дірки» на карті, хоча ноти існують. - Деталі еволюції бренду: Lexery - Frontend and Brand Evolution. Хто й чим пише вікі: Lexery - Authoring Toolchain.
Див. також
- Lexery - Wiki North Star
- Lexery - Authoring Toolchain
- Lexery - Neural Link Hub
- Lexery - Master Map.canvas
- Lexery - Maintenance Runbook