Souvent, architecture et documentation se décalent avec le temps. Entre refactors, nouvelles features et décisions prises rapidement, le README et les ADR (Architecture Decision Records) ne suivent plus toujours le code. Résultat : onboarding plus lent, revues plus longues, et agents de codage IA qui décrochent.
Face à ce décalage, on a mis en place un relais entre le dev, l’agent, l’équipe. Trois skills l'outillent, trois procédures qu'un agent déclenche à la demande. Une pour capter une décision d'archi, mémoire du projet et règle pour l'agent. Une pour aligner la doc sur le code. Et une pour auditer la branche avant merge. Le dev tranche, la doc suit, l'équipe challenge.
Je partage ce retour d'expérience depuis une codebase d'entreprise. Vous repartirez avec une méthode éprouvée, qui transforme les décisions en ADR exploitables, et garde la doc vivante pour les développeurs comme pour les agents, au bénéfice de la vélocité de l'équipe.
format_quote
