Lead / Staff Engineering · prescripteur

Une doc qui ne ment plus à votre code.

Décisions oubliées, débats rejoués, doc qui ment. Noézis rend ces angles morts visibles et actionnables.

Onboarder mon repo d'équipe Documentation
dérive doc ↔ code 2 décisions contradictoires lacune non documentée

Radar de cohérence — ce qui se contredit, dérive ou manque, par signal.

01 · Les angles morts

Trois problèmes que vous connaissez par cœur

1 · DÉRIVE DOC↔CODE

La doc est un mensonge qui s'ignore

Quelqu'un a modifié le comportement, la doc n'a pas suivi. Pendant des mois, les nouveaux arrivent sur une doc qui décrit un système qui n'existe plus. Noézis détecte l'écart (granularité fichier) et le signale.

2 · DÉCISIONS ÉVAPORÉES

Les « pourquoi » partent avec les gens

« Pourquoi on avait choisi cette architecture ? » — la réponse est dans la tête de quelqu'un qui est parti ou a oublié. Noézis capture les décisions avec leur justification, leur date et leur auteur.

3 · DÉBATS REJOUÉS

Les mêmes questions en boucle

Un choix technique a déjà été tranché, mais personne ne le sait — le débat est rejoué en réunion, en PR, en commentaire. Noézis clôt le débat : la décision est là, consultable, sourcée.

02 · La bascule

Ce que Noézis vous apporte concrètement

UNE INFORMATION, DANS LE TEMPS → Sûr ancré à sa source ≠ Contesté deux sources divergent ⌛ Périmé remplacé, ne remonte plus Inconnu « je ne sais pas »

Chaque information porte son état. L'agent ne reçoit jamais du périmé pour du vrai.

Sans Noézis

  • Doc qui dérive en silence — personne ne le capte
  • Décisions non tracées — « tu te souviens pourquoi ? »
  • Contradictions qui s'accumulent sans alerte
  • Onboarding lent — tout est à ré-apprendre
  • Dette de connaissance invisible

Avec Noézis

  • Radar de dérive doc↔code — alerté en cas d'écart
  • Registre ADR — le « pourquoi » persiste, daté, sourcé
  • Détection de contradictions — signalé, pas avalé
  • Base auto-maintenue — watcher + ingestion incrémentale
  • Doc régénérable à la demande — fin des docs périmées

03 · Les capacités

Un système pensé pour le lead technique

RADAR DE COHÉRENCE

Détection de dérive doc↔code

Noézis compare la doc au code source et signale les écarts — granularité fichier. Complété par le rapport de lacunes : ce que le système sait, ce qu'il ignore. Vous passez en revue ce qui est signalé, pas l'intégralité de la base.

REGISTRE ADR

Le « pourquoi » persistant

Chaque décision technique est capturée avec sa date, son acteur, sa justification. Accessible en langage naturel : « pourquoi a-t-on choisi Kafka plutôt que RabbitMQ en mars ? ». La réponse arrive avec la source.

DOC VIVANTE

Documentation régénérable

Une commande, et la synthèse à jour est produite — au lieu d'un document figé qui pourrit dans un coin. Le watcher maintient la doc à jour sans intervention humaine.

REVIEW QUEUE

Revoir ce qui bouge, pas tout

Les signaux (contradiction, dérive, lacune) alimentent une file de revue. Vous ne passez pas en revue la base entière — seulement ce qui a changé ou cloche.

04 · Cas d'usage réels

Ce que les leads techniques en font

Auditer la documentation avant une release

Noézis remonte tous les écarts doc↔code détectés dans le périmètre de la release. Vous corrigez la doc avant la mise en production — pas après, quand le bug est déjà signalé.

Onboarding express d'un nouveau membre

Le nouveau alternant ou développeur arrive. noezis onboard sur le repo. Son agent connaît l'architecture, les décisions, les conventions — il contribue utilement le jour même au lieu de la troisième semaine.

Préparer un comité d'architecture

Une question d'architecture transverse remonte. Noézis retrouve les décisions connexes, les options déjà écartées, les contradictions éventuelles. Le comité gagne une heure de débat préparé.

05 · Objections

« Oui mais… » — les réponses

On a déjà une wiki, des ADR en markdown, est-ce que ça suffit pas ? Un ADR dans un fichier est une trace froide. Noézis la rend vivante : les décisions sont automatiquement capturées, confrontées aux documents, vérifiées contre la dérive du code. Le problème n'est pas l'écriture — c'est la maintenance et la cohérence.
Mes agents (Claude Code, Cursor) ont déjà des projets, pourquoi un outil de plus ? Ces projets sont des snapshots que vous devez manuellement mettre à jour. Noézis fonctionne en continu : watcher + ingestion incrémentale + front-load automatique. Rien à « sauvegarder » ou « synchroniser ».
Ça demande de la discipline d'équipe, et on n'a pas le temps C'est le contraire : Noézis demande moins de discipline, pas plus. Les décisions sont capturées automatiquement pendant le travail des agents. Le watcher ingère les fichiers déposés. La review queue signale ce qui mérite attention — vous n'avez pas à penser à « nourrir la base ».

06 · Le passage à l'échelle

Du lead prescripteur au déploiement équipe

Le lead / staff eng est rarement le payeur direct — mais il est toujours le premier à sentir quand la connaissance de l'équipe se dégrade. Le parcours type :

1 · SOLO GRATUIT

Onboardez votre repo personnellement

Installez en local, onboardez votre repo. Voyez les contradictions que vous ignoriez, les dérives doc↔code que personne n'avait détectées.

2 · ÉQUIPE

Onboardez le repo d'équipe

Le graphe devient partagé. Toute l'équipe accède à la même mémoire vivante — décisions, doc, historique, contradictions.

3 · ENTREPRISE

Multi-équipe et gouvernance

Isolation par projet, registre global, audit Merkle. La connaissance traverse les équipes sans se perdre.

Le meilleur moment pour capturer une décision, c'est quand elle est prise

Onboardez votre repo d'équipe. Voyez ce que votre base se cache à elle-même.

Onboarder mon repo Voir les tarifs équipe