rentoo

Les agents de Gladoo

Des agents Claude spécialisés aident à développer, vérifier et livrer Gladoo. Ils proposent ; Pierre-Louis valide à trois moments : choisir le chantier, valider la maquette, fusionner puis mettre en ligne. Aucun agent ne fusionne, ne met en production ni ne dépense.

Les règles communes à tous sont dans CLAUDE.md, à la racine du dépôt.

Les trois briques

Brique À quoi elle sert Où elle vit
CLAUDE.md Règles et principes produit, lus par chaque session et chaque agent Racine du dépôt
Agents spécialisés Un fichier par agent : mission, outils, ce qu’il ne fait jamais .claude/agents/
Routines Lancent un agent à heure fixe ou à chaque demande de fusion claude.ai/code/routines

Tout tient dans l’abonnement Claude : chaque passage compte dans l’usage, sans service payant en plus. Les routines sont encore en aperçu (elles peuvent évoluer).

Les agents en place (étape 1 : qualité et livraison)

Agent Fichier Quand Ce qu’il rend
Gardien UX gardien-ux.md Chaque demande de fusion qui touche un écran ou un texte « Conforme » ou la liste des écarts aux principes produit
Relecteur sécurité relecteur-securite.md Chaque demande de fusion « Conforme » ou les points bloquants (migrations, RLS, clés, données envoyées à Roo)
Livreur Git livreur-git.md Fin de chaque chantier Une demande de fusion verte, décrite en langage simple
Testeur nocturne testeur-nocturne.md Chaque matin Le tri des tests rouges de la nuit, et une correction ou un ticket pour chacun
Contrôleur de mise en ligne controleur-mise-en-ligne.md Après chaque mise en ligne « Bonne » ou « à reprendre », avec la cause et quoi faire

Dans une session Claude ouverte sur le dépôt, on les appelle par leur nom : « demande au gardien-ux de relire cette branche ».

Les agents en place (étape 2 : produit et veille)

Agent Fichier Quand Ce qu’il rend
Écoute clients ecoute-clients.md Chaque lundi Les 5 irritants de la semaine au plus, avec leurs preuves, en tickets besoin-client
Chef de produit chef-de-produit.md Chaque lundi après l’écoute, et avant tout chantier Une fiche par chantier dans docs/fiches/ (modèle dans docs/fiches/README.md)
Designer designer.md Quand une fiche qui touche un écran est validée Planches ordinateur et téléphone dans docs/maquettes/<sujet>/
Veille réglementaire veille-reglementaire.md Chaque mois, et chaque janvier pour la fiscalité Un rapport docs/veille/AAAA-MM.md et un ticket reglementation par changement
Relecteur juridique relecteur-juridique.md Chaque demande de fusion qui touche un texte ou un calcul juridique ou fiscal La règle appliquée, sa source, et ce qu’un professionnel doit vérifier

Les agents en place (étape 3 : usage réel, documentation, coordination)

Agent Fichier Quand Ce qu’il rend
Testeur bailleur testeur-bailleur.md Chaque mercredi, et chaque demande de fusion qui touche un écran Les parcours de docs/parcours/README.md notés « fluide », « hésitant » ou « bloqué », captures à l’appui, en tickets ux
Documentaliste documentaliste.md Chaque vendredi « Documentation à jour » ou une demande de fusion qui corrige les écarts (jamais le code)
Coordinateur coordinateur.md Chaque vendredi en fin de journée Un seul ticket « Point de la semaine » : à valider, rouge, 3 priorités proposées, fait, trouvé

Le Designer n’a pas de routine : on l’appelle quand une fiche qui touche un écran est validée (« demande au designer la maquette de la fiche … »).

La boîte aux lettres : les tickets GitHub

Les agents se transmettent leurs retours par des tickets (issues) du dépôt, avec une étiquette :

Étiquette Déposée par Lue par
bug Testeur nocturne, Contrôleur de mise en ligne, Relecteur sécurité Développeur
ux Gardien UX, Testeur bailleur Designer, Chef de produit
besoin-client Écoute clients, Testeur bailleur Chef de produit, Coordinateur
reglementation Veille réglementaire (étape 2) Chef de produit, Relecteur juridique, Pierre-Louis
a-valider Tous Pierre-Louis
point-semaine Coordinateur Pierre-Louis

Les étiquettes sont créées à la première exécution d’une routine (gh label create … --force).

Les routines

À créer sur claude.ai/code/routines › New routine, dépôt Piedzo/rentoo, environnement Default (sauf la veille, qui a le sien). Retirer les connecteurs dont la routine n’a pas besoin.

1. Relecture des demandes de fusion

Relis la demande de fusion qui a déclenché cette session. Lis d’abord CLAUDE.md. Lance l’agent relecteur-securite sur le changement, puis l’agent gardien-ux si des fichiers de src/app, src/components ou des textes affichés changent, puis l’agent relecteur-juridique si le changement touche un des fichiers sensibles listés dans .claude/agents/relecteur-juridique.md, puis l’agent testeur-bailleur sur les parcours de docs/parcours/README.md que le changement touche si des fichiers de src/app ou src/components changent. Publie un seul commentaire sur la demande de fusion (gh pr comment), en français simple : le verdict de chaque relecteur, puis les écarts, les points bloquants d’abord. Ne modifie aucun fichier, ne fusionne rien. Si un point bloquant concerne la sécurité, ajoute l’étiquette a-valider à la demande de fusion.

2. Testeur nocturne

Lis CLAUDE.md, puis lance l’agent testeur-nocturne sur la dernière exécution de nuit du workflow « Vérifications ». Crée d’abord les étiquettes si elles manquent : gh label create bug –force ; gh label create ux –force ; gh label create besoin-client –force ; gh label create reglementation –force ; gh label create a-valider –force. Pour chaque test rouge : ticket pour une régression de l’application ; pour un test périmé ou un problème d’environnement, corrige sur une branche claude/tests-nuit- et ouvre une demande de fusion avec l'agent livreur-git. Si la nuit est verte, ne fais rien. Ne fusionne rien, ne modifie jamais .env.

3. Contrôle de mise en ligne

Lis CLAUDE.md, puis lance l’agent controleur-mise-en-ligne sur la dernière exécution du workflow « Mise en ligne ». Si elle est rouge pour une raison technique du workflow, corrige-le sur une branche claude/mise-en-ligne- et ouvre une demande de fusion avec l'agent livreur-git. Si la cause est un réglage (secret, mot de passe, droits), explique-le dans un ticket étiqueté a-valider, sans jamais demander la valeur d'un secret.

4. Point produit du lundi (étape 2)

Lis CLAUDE.md. Lance l’agent ecoute-clients sur les 7 derniers jours, puis l’agent chef-de-produit sur les irritants qu’il a trouvés : une fiche dans docs/fiches/ pour chacun des deux plus importants au plus. Livre les fiches avec l’agent livreur-git sur une branche claude/point-produit-, et mets l'étiquette a-valider sur leurs tickets. Ne réponds à aucun e-mail, n'en envoie aucun, ne recopie aucune adresse. Ne modifie pas le code de l'application.

5. Veille réglementaire (étape 2)

Lis CLAUDE.md et docs/veille/README.md, puis lance l’agent veille-reglementaire sur le mois écoulé. En janvier, ajoute la loi de finances de l’année. Livre le rapport docs/veille/.md avec l'agent livreur-git sur une branche claude/veille-, et ouvre un ticket reglementation par changement à traiter. Ne modifie pas le code de l'application.

6. Testeur bailleur du mercredi (étape 3)

Lis CLAUDE.md et docs/parcours/README.md, puis lance l’agent testeur-bailleur sur les dix parcours. Crée l’étiquette si elle manque : gh label create ux –force. Ouvre un ticket ux par problème nouveau, un commentaire sur le ticket existant sinon. Ne modifie aucun fichier, n’utilise ni le site en ligne ni un vrai compte.

7. Documentaliste du vendredi (étape 3)

Lis CLAUDE.md, puis lance l’agent documentaliste sur les 7 derniers jours de master. S’il y a des écarts, livre les corrections de documentation avec l’agent livreur-git sur une branche claude/docs-, en une seule demande de fusion. Ne modifie aucun fichier de src/, supabase/ ni .github/, et jamais .env.

8. Point de la semaine (étape 3)

Lis CLAUDE.md, puis lance l’agent coordinateur sur les 7 derniers jours. Publie le ticket « Point de la semaine du <JJ/MM> » avec l’étiquette point-semaine et ferme celui de la semaine précédente. Ne modifie aucun fichier, ne fusionne rien, ne lance aucune mise en ligne.

GitHub vous envoie un e-mail à chaque nouveau ticket si vous suivez le dépôt (bouton Watch › All Activity, ou Custom › Issues) : le point du vendredi arrive alors dans votre boîte.

L’environnement « Veille »

La veille lit des sites officiels que l’environnement Default ne laisse pas passer. Sur claude.ai/code, ouvrez le sélecteur d’environnement (l’icône nuage sous la zone de texte) et créez un environnement nommé Veille. Dans Network access, choisissez Custom, cochez « Also include default list of common package managers », puis dans Allowed domains ajoutez : legifrance.gouv.fr, www.legifrance.gouv.fr, service-public.fr, www.service-public.fr, www.impots.gouv.fr, bofip.impots.gouv.fr, www.anil.org, www.cnil.fr, www.insee.fr, www.data.gouv.fr, www.ecologie.gouv.fr.

En plus : la correction automatique des demandes de fusion

Sur une demande de fusion ouverte par Claude, la correction automatique (« Auto-fix ») peut être activée depuis la session : Claude corrige alors seul une vérification GitHub rouge sur la même branche. Elle demande l’application GitHub de Claude installée sur le dépôt.

Ce qui reste interdit à tous les agents