Сопутствующий рабочий процесс Understand Anything

<!-- translations:start -->

English · 한국어 · 中文 · 日本語 · Русский · Español · Français · Deutsch

<!-- translations:end --> Understand Anything и Tesserae — взаимодополняющие проекты.

• Understand Anything хорошо создает граф знаний кодовой базы и интерактивную панель.
• Tesserae сосредоточен на долговременной памяти агентов: документах, компиляции markdown/wiki, статической публикации, истории сессий и экспортах для агентов.

Tesserae не должен встраивать или поглощать Understand Anything. Рассматривайте его как независимый сопутствующий инструмент, который может создавать полезные графовые артефакты.

Зачем использовать оба?

Understand Anything может записывать:

.understand-anything/knowledge-graph.json

Этот граф фиксирует структуру кода: файлы, функции, классы, модули, концепции, зависимости, слои и туры.

Затем Tesserae может сохранить этот артефакт вместе с остальной памятью проекта:

• исходные документы и markdown-страницы;
• файлы репозитория;
• исследовательские заметки;
• локальную историю сессий Claude Code / Codex;
• сгенерированные статические wiki-страницы;
• 2D / 3D представления сайта графа;
• llms.txt, llms-full.txt, search-index.json, graph.json и агентские sibling-файлы для каждой страницы.

Текущий рабочий процесс с низким трением

Рекомендуемый путь — мастер настройки:

tesserae project setup

Выберите Understand Anything на шаге сопутствующих инструментов. Tesserae установит/обновит сопутствующие skills по запросу и запишет управляемую команду обновления в .tesserae/config.json. Последующие вызовы tesserae project compile будут автоматически запускать эту обертку, когда граф UA отсутствует или устарел.

Для неинтерактивной автоматизации используйте:

tesserae project setup \
  --yes \
  --with-understand-anything \
  --install-understand-anything \
  --understand-anything-platform codex
tesserae project compile

Сохраненная команда принадлежит Tesserae, а не является тем, что пользователь должен придумать сам:

tesserae project refresh-understand-anything --platform codex

Во время компиляции Tesserae:

1. проверяет, существует ли .understand-anything/knowledge-graph.json и совпадает ли он с текущим git-коммитом, когда доступны метаданные;
2. запускает настроенную агентскую платформу (codex, opencode или claude) только когда граф отсутствует/устарел или обновление принудительное;
3. проверяет, что граф был записан;
4. материализует .tesserae/external/understand-anything.md;
5. продолжает обычную компиляцию памяти.

Можно принудительно выполнить все настроенные внешние команды обновления перед компиляцией:

tesserae project compile --refresh-external-tools

Нужен также Cognee? Добавьте флаги runtime-памяти в ту же команду setup:

tesserae project setup \
  --yes \
  --with-understand-anything \
  --install-understand-anything \
  --understand-anything-platform codex \
  --run-cognee \
  --install-cognee

Ручной эквивалент

Предпочтителен управляемый путь настройки. Если вы намеренно хотите использовать UA вне Tesserae, сначала запустите Understand Anything в вашей агентской среде:

/understand

Затем выполните tesserae project setup --with-understand-anything, чтобы Tesserae записал источник markdown-проекции. Прямые JSON-файлы сохраняются как сырые сопутствующие артефакты, а не как вручную введенные пути источников.

tesserae project setup --with-understand-anything
tesserae project compile
tesserae project build-site

Если также нужна локальная память агентских сессий:

tesserae project sessions discover --import
tesserae project build-site

Нативная синхронизация графа

Tesserae по-прежнему сохраняет markdown projection для читаемости, но также нативно импортирует граф UA во время compile, когда настроенный инструмент использует sync_mode: native_graph.

Нативный адаптер читает .understand-anything/knowledge-graph.json, сопоставляет узлы/ребра UA с контролируемой ontology Tesserae и записывает sync manifest:

.tesserae/external/understand-anything-sync.json

Текущее сопоставление:

Concept synchronization выполняет canonicalization, а не создает дубликаты вслепую. Если UA выдает Mermaid Rendering, а в Tesserae уже есть Mermaid rendering, compile сохраняет один concept node и добавляет UA provenance в metadata.external_refs.

Tesserae остается memory compiler; UA остается независимым companion graph generator.

Принцип сотрудничества

Не представляйте Tesserae как замену Understand Anything.

Лучшее позиционирование:

• Understand Anything помогает разработчику понять кодовую базу сейчас.
• Tesserae помогает агентам со временем помнить, искать, цитировать, обновлять и публиковать знания проекта.