Understand-Anything-Companion-Workflow

<!-- translations:start -->

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

<!-- translations:end -->

Understand Anything und Tesserae sind komplementäre Projekte.

• Understand Anything ist stark darin, einen Codebase-Knowledge-Graph und ein interaktives Dashboard zu erzeugen.
• Tesserae konzentriert sich auf langlebige Agent-Memory: Docs, Markdown-/Wiki-Kompilation, statisches Publishing, Session-History und agent-orientierte Exports.

Tesserae sollte Understand Anything weder vendoren noch absorbieren. Behandle es als unabhängigen Companion, der nützliche Graph-Artefakte produziert.

Warum beides nutzen?

Understand Anything kann Folgendes schreiben:

.understand-anything/knowledge-graph.json

Dieser Graph erfasst Code-Struktur wie Dateien, Funktionen, Klassen, Module, Konzepte, Abhängigkeiten, Layer und Touren.

Tesserae kann dieses Artefakt dann neben dem restlichen Projektgedächtnis aufbewahren:

• Quell-Docs und Markdown-Seiten;
• Repository-Dateien;
• Research-Notizen;
• lokale Claude Code- / Codex-Session-History;
• generierte statische Wiki-Seiten;
• 2D-/3D-Graph-Website-Sichten;
• llms.txt, llms-full.txt, search-index.json, graph.json und Per-Page-Agent-Geschwister.

Aktueller reibungsarmer Workflow

Empfohlen ist der Setup-Wizard:

tesserae project setup

Wähle im Schritt „Companion-Tools“ Understand Anything aus. Tesserae installiert/aktualisiert die Companion-Skills auf Wunsch und schreibt einen verwalteten Refresh-Befehl in .tesserae/config.json. Künftige tesserae project compile-Aufrufe führen diesen Wrapper automatisch aus, wenn der UA-Graph fehlt oder veraltet ist.

Für nicht-interaktive Automatisierung:

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

Der hinterlegte Befehl gehört Tesserae — nichts, was sich der Nutzer ausdenken muss:

tesserae project refresh-understand-anything --platform codex

Während des Compiles geht Tesserae so vor:

1. prüft, ob .understand-anything/knowledge-graph.json existiert und mit dem aktuellen git-commit übereinstimmt, sofern Metadaten verfügbar sind;
2. führt die konfigurierte Agent-Plattform (codex, opencode oder claude) nur dann aus, wenn der Graph fehlt/veraltet ist oder ein Refresh erzwungen wurde;
3. verifiziert, dass der Graph geschrieben wurde;
4. materialisiert .tesserae/external/understand-anything.md;
5. setzt die normale Memory-Kompilation fort.

Du kannst vor einem Compile alle konfigurierten externen Refresh-Befehle erzwingen:

tesserae project compile --refresh-external-tools

Cognee zusätzlich nötig? Füge die Runtime-Memory-Flags im selben Setup-Befehl hinzu:

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

Manuelles Äquivalent

Der verwaltete Setup-Pfad ist vorzuziehen. Wenn du UA absichtlich außerhalb von Tesserae nutzen willst, starte Understand Anything zuerst in deiner Agent-Umgebung:

/understand

Führe danach tesserae project setup --with-understand-anything aus, damit Tesserae die Quelle der Markdown-Projektion festhält. Direkte JSON-Dateien werden als rohe Companion-Artefakte gehalten, nicht als handgepflegte Source-Pfade.

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

Wenn du zusätzlich lokale Agent-Session-Memory möchtest:

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

Native Graph-Synchronisation

Tesserae behält die Markdown-Projektion jetzt für die Lesbarkeit bei und importiert den UA-Graphen zusätzlich nativ während des Compiles, sofern das konfigurierte Tool sync_mode: native_graph verwendet.

Der native Adapter liest .understand-anything/knowledge-graph.json, mappt UA-Nodes/Edges in die kontrollierte Ontologie von Tesserae und schreibt ein Sync-Manifest:

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

Aktuelles Mapping:

Die Synchronisation von Concepts erfolgt kanonisiert statt blind dupliziert. Wenn UA Mermaid Rendering ausgibt und Tesserae bereits Mermaid rendering kennt, behält der Compile einen Concept-Node und ergänzt UA-Provenance unter metadata.external_refs.

Tesserae bleibt der Memory-Compiler; UA bleibt ein eigenständiger Companion-Graph-Generator.

Kollaborationsprinzip

Tesserae nicht als Ersatz für Understand Anything framen.

Eine bessere Rahmung:

• Understand Anything hilft einem Entwickler, eine Codebase jetzt zu verstehen.
• Tesserae hilft Agenten, Projektwissen über die Zeit zu erinnern, zu durchsuchen, zu zitieren, zu aktualisieren und zu publizieren.