Graph Hygiene

Updated Apr 17, 2026

[!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

Linked Pages (28)

_assets/brand/lexery-wordmark-dark-bg.svg|200_assets/brand/lexery-icon.svg|46Lexery - Wiki North Star|North StarLexery - Graph Metrics|MetricsLexery - Authoring Toolchain|ІнструментиLexery - Wiki North StarLexery - Wiki Quality ContractLexery - Graph MetricsLexery - Project BrainLexery - U1-U12 RuntimeLexery - U1-U12 RuntimeLexery - IndexLexery - Project BrainLexery - Neural Link HubLexery - Neural Link HubLexery - IndexLexery - Project BrainLexery - Runtime Graph.canvas|Runtime GraphLexery - Index|Швидка навігаціяLexery - IndexLexery - Frontend and Brand EvolutionLexery - Authoring ToolchainLexery - Wiki North StarLexery - Authoring ToolchainLexery - Neural Link HubLexery - Master Map.canvasLexery - Maintenance Runbook