1. Lire le code par trajet d’exécution

Lire un dépôt fichier par fichier est lent. Suis plutôt un trajet réel : entrée, orchestration, appel du modèle, outil, résultat et sortie.

Méthode

1. Choisis une action observable, par exemple l’appel d’un outil.
2. Trouve son point d’entrée dans la CLI, le Gateway ou l’API.
3. Repère la fonction qui assemble le contexte et les schémas d’outils.
4. Suis la décision d’appel, l’exécution, la gestion d’erreur et la restitution.
5. Note les contrôles de permissions rencontrés.

Exercice OpenClaw

Dans le dépôt openclaw/openclaw, dessine le trajet d’un message entrant jusqu’à une réponse. Pour chaque étape, note le fichier, la fonction, l’entrée, la sortie et le contrôle de sécurité.

Exercice Hermes Agent

Dans NousResearch/hermes-agent, pars d’un point d’entrée puis relie-le à la boucle de conversation, à la découverte des outils et à leur dispatch. La documentation officielle d’architecture donne la carte générale ; vérifie ensuite chaque liaison dans le code.

Petite modification encadrée

Ajoute uniquement une trace locale non sensible à un point de passage, lance les tests concernés, puis retire-la. L’objectif est de comprendre le flux sans modifier le comportement métier.