Workflow compagnon Understand Anything

<!-- translations:start -->

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

<!-- translations:end --> Understand Anything et Tesserae sont des projets complémentaires.

• Understand Anything est excellent pour produire un graphe de connaissance d'une base de code et un tableau de bord interactif.
• Tesserae se concentre sur la mémoire d'agent durable : docs, compilation markdown/wiki, publication statique, historique de sessions et exports destinés aux agents.

Tesserae ne doit pas intégrer ni absorber Understand Anything. Traitez-le comme un compagnon indépendant pouvant produire des artefacts de graphe utiles.

Pourquoi utiliser les deux ?

Understand Anything peut écrire :

.understand-anything/knowledge-graph.json

Ce graphe capture la structure du code, comme les fichiers, fonctions, classes, modules, concepts, dépendances, couches et visites guidées.

Tesserae peut ensuite conserver cet artefact avec le reste de la mémoire du projet :

• documents sources et pages markdown ;
• fichiers du dépôt ;
• notes de recherche ;
• historique local des sessions Claude Code / Codex ;
• pages wiki statiques générées ;
• vues de site de graphe 2D / 3D ;
• llms.txt, llms-full.txt, search-index.json, graph.json et siblings d'agent par page.

Workflow actuel à faible friction

Le chemin recommandé est l'assistant de configuration :

tesserae project setup

Choisissez Understand Anything à l'étape des outils compagnons. Tesserae installe/met à jour les skills compagnons sur demande et écrit une commande de rafraîchissement gérée dans .tesserae/config.json. Les futurs appels à tesserae project compile exécutent automatiquement ce wrapper lorsque le graphe UA est manquant ou périmé.

Pour l'automatisation non interactive, utilisez :

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

La commande stockée appartient à Tesserae ; ce n'est pas quelque chose que l'utilisateur doit inventer :

tesserae project refresh-understand-anything --platform codex

Pendant la compilation, Tesserae :

1. vérifie si .understand-anything/knowledge-graph.json existe et correspond au commit git courant lorsque les métadonnées sont disponibles ;
2. exécute la plateforme d'agent configurée (codex, opencode ou claude) uniquement lorsque le graphe est manquant/périmé ou que le rafraîchissement est forcé ;
3. vérifie que le graphe a été écrit ;
4. matérialise .tesserae/external/understand-anything.md ;
5. poursuit la compilation normale de la mémoire.

Vous pouvez forcer toutes les commandes de rafraîchissement externes configurées avant une compilation :

tesserae project compile --refresh-external-tools

Besoin aussi de Cognee ? Ajoutez les flags de mémoire d'exécution dans la même commande setup :

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

Équivalent manuel

Le chemin de configuration géré est préférable. Si vous voulez volontairement utiliser UA en dehors de Tesserae, exécutez d'abord Understand Anything dans votre environnement d'agent :

/understand

Puis exécutez tesserae project setup --with-understand-anything afin que Tesserae enregistre la source de projection markdown. Les fichiers JSON directs sont conservés comme artefacts compagnons bruts, et non comme chemins sources saisis à la main.

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

Si vous voulez aussi la mémoire locale des sessions d'agent :

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

Synchronisation native du graphe

Tesserae conserve la markdown projection pour la lisibilité et importe aussi le graphe UA nativement pendant compile quand l’outil configuré utilise sync_mode: native_graph.

L’adaptateur natif lit .understand-anything/knowledge-graph.json, mappe les nœuds/arêtes UA vers l’ontology contrôlée de Tesserae, puis écrit un sync manifest:

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

Mapping actuel:

Concept synchronization est canonicalisée au lieu de créer des doublons aveuglément. Si UA émet Mermaid Rendering et que Tesserae possède déjà Mermaid rendering, compile conserve un seul concept node et ajoute la provenance UA sous metadata.external_refs.

Tesserae reste le memory compiler; UA reste un companion graph generator indépendant.

Principe de collaboration

Ne présentez pas Tesserae comme remplaçant Understand Anything.

Meilleure formulation :

• Understand Anything aide un développeur à comprendre une base de code maintenant.
• Tesserae aide les agents à mémoriser, rechercher, citer, mettre à jour et publier les connaissances du projet dans le temps.