Wiki North Star
[!lexery-hero] Wiki North Star !_assets/brand/lexery-wordmark-dark-bg.svg|200 !_assets/brand/lexery-icon.svg|46
Навіщо вікі, для кого, як перевіряємо правду. Lexery - Project Brain|Project Brain · Lexery - Index|Index · Lexery - Wiki Quality Contract|Quality · Lexery - Current State|State · Lexery - Authoring Toolchain|Інструменти
SVG бренду:
apps/portal/public/→_assets/brand/.
[!info] Compiled from
- Продуктові пріоритети Legal Agent (Lexery - Legal Agent Quality Priorities)
- Практика «compiled wiki» / LLM Wiki (Karpathy-шар: raw → synthesis → перевірка)
- Операційний досвід maintenance (
truth-audit,lint, Lexery - Wiki Quality Contract)
Lexery - Wiki North Star
Вигляд і структура в Obsidian
[!tip] Щоб не виглядало «сирим»
- Логотипи: канон у
apps/portal/public/; для вставок у вікі —_assets/brand/(оновлюй копії, коли міняється портал).- Граф / canvas: правила охайності — Lexery - Graph Hygiene; таблиці в Lexery - Index зазвичай актуальніші за візуальний граф.
- Правда «хто hub»: не тримай довгі заморожені переліки сторінок у випадкових нотатках — канонічна навігація в Lexery - Index (швидкий старт + таблиці за темами).
- Хто як пише код і вікі: Lexery - Authoring Toolchain (MGX → Cursor → Codex, skills).
Ця сторінка відповідає на три питання, без яких «ідеальна» автоматика лише прикрашає репозиторій: навіщо, для кого, як ми знаємо що воно працює.
1. Навіщо Lexery взагалі тримає цю вікі
Проблема без вікі: код, PR, Linear, Supabase і голова команди живуть у різних площинах. Кожен новий чат з моделлю починається з нуля: контекст дорогий, легко плутати що вже вирішено, що гіпотеза, що застаріло. Маркетинг і кодинг тягнуть різні артефакти, але продукт — один; без спільного compiled шару зростає ризик роз’їхду обіцянок і реалізації.
Рішення: Lexery LLM Wiki — це постійний, перевірюваний шар синтезу між «сирими» джерелами (raw/, репо, БД) і людьми/агентами. Вона не замінює код і не замінює дизайн-док у Notion — вона тримає узгоджену картину системи, щоб:
- Legal Agent рухався в бік живих lawyer-style запитів (Lexery - Legal Agent Quality Priorities) — з ясною картиною pipeline, ризиків і чесних gap’ів (Lexery - Coverage Gap Honesty).
- Будь-який агент (код, маркетинг, ops) міг дешево підняти контекст через навігацію, граф, MCP (Lexery - Automation Architecture) — без повторного «перечитай весь monorepo».
- Команда мала одну хронологію змін (Lexery - Log) і сигнали довіри (trust, drift), а не лише гарні нотатки.
Коротко: вікі — це організаційна пам’ять і контракт на правду, а не щоденник.
2. Karpathy-стек у нашій інтерпретації
Класична схема ingest → query недостатня для продукту з compliance-навантаженням. Ми явно додаємо compile і verify:
flowchart LR
subgraph sources["Джерела правди"]
R[raw exports + repo + APIs]
end
subgraph compile["Compile"]
W[Lexery pages + graph + Index]
end
subgraph use["Використання"]
A[Humans + agents + MCP]
end
subgraph verify["Verify"]
T[truth-audit + lint + contract]
end
R --> compile
compile --> use
use -.->|оновлення змісту| compile
compile --> verify
verify -.->|сигнали| R
| Фаза | Що це для Lexery | Де лежить |
|---|---|---|
| Ingest | Регулярно знімаємо зрізи без ручного копіпасту | scan-codebase, sync-github, raw/ |
| Compile | Перетворюємо шум на сторінки з ролями, шарами, посиланнями | Lexery - *.md, Lexery - Index, auto-fill маркери |
| Query | Шукаємо не «всі чанки», а сторінки + шар + статус | Obsidian, MCP lexery_wiki_context_pack, граф |
| Verify | Ловимо брехню, мовчазну застарілість, дірки в джерелах | Lexery - Wiki Quality Contract, truth-audit, lint |
Навіщо чотири фази, а не дві: якщо залишити лише ingest+query, модель відповідає з RAG по нотатках і може впевнено помилятися. Verify перетворює вікі з декорації на інженерний артефакт з реакцією на роз’їзд raw↔wiki.
3. Для кого саме «ідеально»
| Аудиторія | Що для них означає «краще» |
|---|---|
| Інженерія | Швидко знайти U-етап, env, тестові карти; не плутати гілки та legacy (Lexery - Branch Divergence) |
| Маркетинг / зовнішні комунікації | Одна узгоджена історія продукту й обмежень; посилання на Current State, не на чернетку в чаті |
| Агенти | AGENTS.md + Lexery - Wiki Quality Contract = мінімальний дрейф поведінки між сесіями |
| Операції | Дашборди: trust + Karpathy score (Lexery - Executive Ops Dashboard, Lexery - Data Integrity Dashboard); зрозуміло, коли підключати людину |
Усі вони виграють від одного графа змісту (Obsidian + policy), а не від окремих «внутрішніх вікі» на кожну роль.
4. Критерії успіху (коли можна сказати «це працює»)
- Свіжість узгоджена з raw: немає хронічного raw↔wiki drift без пояснення (Lexery - Data Integrity Dashboard).
- Trust стабільний або зростає після triage, а не «зелений скрізь бо ми вимкнули перевірки».
- Нова людина або агент за 15 хвилин знаходить: pipeline, поточний стан, де шукати невідоме (Lexery - Unknowns Queue).
- Compile не роз’їдає правду:
observedбез джерела — рідкість;inferredне продається як контракт клієнту. - Karpathy score тримається високо (структура
raw/+ канонічні сторінки + AGENTS.md) — див. Lexery - Data Integrity Dashboard.
5. Що свідомо не є ціллю вікі
- Замінити юридичну оцінку або prod SLO — лише підсилюємо узгодженість.
- Бути «єдиним джерелом коду» — код у репо; вікі пояснює і зв’язує.
- Автоматично переписувати історичні рішення без людини — Lexery - Wiki Quality Contract §8.
6. Як це пов’язано з «ідеальним» графом і MCP
- Граф — інтерфейс для людини: кластери за роллю сторінки, не косметика (Lexery - Graph Hygiene).
- MCP — інтерфейс для агента: структурований контекст без копіпасту всього vault (Lexery - Automation Architecture §6).
Обидва сервіси однієї мети: швидше і дешевше потрапити в правильну нотатку з правильним статусом.
7. Довгі прогони (deep maintenance)
Lite прогони тримають щоденний ритм дешево. Deep (кожен 4-й за замовчуванням, або WIKI_MAINTENANCE_MODE=deep) додають link-metrics, suggest-links, maintenance-rollup — саме там «дозріває» граф і forensics по логах.
Перед дописом дельти repair-log-structure.mjs приводить Lexery - Log до канону: один # Lexery - Log одразу після frontmatter (без «втраченого» заголовка в середині файлу).
Після кожного прогону зростають машинні сліди:
truth-history.jsonl— тренд trust (якість тексту й сигналів).karpathy-history.jsonl— тренд Karpathy (чи не розсипалась структура vault).- Lexery - Executive Ops Dashboard і Lexery - Data Integrity Dashboard зводять обидва тренди в таблиці.
- Lexery - Ops Rollup під deep показує останні maintenance-логи + останній Karpathy snapshot.
Якщо робиш «довгий ран» вручну перед важливою демо або релізом: WIKI_MAINTENANCE_MODE=deep node _system/scripts/run-maintenance.mjs, потім відкрий Ops + Integrity + Lexery - Neural Link Hub.
Див. також
- Lexery - Authoring Toolchain
- Lexery - Project Brain
- Lexery - Wiki Quality Contract
- Lexery - Automation Architecture
- Lexery - Ops Rollup
- Lexery - Source Map
- Lexery - Legal Agent Quality Priorities
- Lexery - Contributing