Script/AGENTS.md

AGENTS.md

1. Objectif

Maintenir ce dépôt de scripts pour TipEdge avec des changements petits, lisibles et directement utiles.

Produire uniquement des modifications nécessaires au besoin demandé.

2. Principes généraux

• Lire les fichiers concernés avant toute modification.
• Respecter strictement les conventions déjà présentes dans le dépôt.
• Faire simple. Réduire la surface de changement.
• Modifier le moins de fichiers possible.
• Expliquer par le code, pas par de la complexité ajoutée.
• Signaler explicitement quand une convention manque au lieu d’en inventer une.

3. Lecture obligatoire avant modification

• Lire en entier chaque fichier que tu modifies.
• Lire les fichiers liés au comportement impacté.
• Vérifier l’état Git avant tout changement.
• Si une instruction existe déjà dans README.md, dans ce fichier ou dans le dépôt, l’appliquer en priorité.

4. Règles de modification

• Faire des changements ciblés.
• Préserver le comportement existant sauf demande explicite.
• Conserver les noms, structures et patterns déjà utilisés.
• Ajouter seulement le code nécessaire au besoin.
• Supprimer le code mort rencontré si sa suppression est sûre et locale.
• Refuser les changements hors sujet.

5. Qualité du code

• Écrire du code lisible, court et testable.
• Éviter la duplication évidente.
• Éviter la complexité inutile, les abstractions prématurées et les couches techniques gratuites.
• Ne pas laisser de code mort, de branche inutilisée, de variable inutile ou de commentaire trompeur.
• Garder des messages, noms et sorties cohérents avec le reste du dépôt.

6. Cohérence architecturale

• Ce dépôt est actuellement minimal. Aucune architecture complexe visible n’est établie.
• Rester sobre tant qu’une structure claire n’existe pas.
• Si un script ou un dossier apparaît, prolonger le pattern existant au lieu d’en créer un nouveau.
• Ne pas introduire de framework, d’outil ou d’organisation lourde sans demande explicite.

7. Sécurité Git

• Ne jamais faire de commit sans demande explicite.
• Ne jamais faire de push sans demande explicite.
• Ne jamais faire de force push.
• Ne jamais réécrire l’historique.
• Ne jamais annuler ou écraser des changements non réalisés par toi sans accord explicite.
• Ne pas créer de branche, de tag ou de merge sans demande explicite.

8. Sécurité

• Ne jamais ajouter de secret, token, mot de passe ou clé privée dans le dépôt.
• Ne jamais exposer une donnée sensible dans un script, un log ou un exemple.
• Demander confirmation avant toute action destructive.
• Limiter les commandes qui modifient massivement des fichiers.

9. Prise de décision

• Commencer par la solution la plus simple.
• En cas d’ambiguïté, choisir l’option la moins risquée pour l’existant.
• Si l’information manque, le signaler clairement.
• Si plusieurs options existent, préférer celle qui minimise l’impact et la maintenance.

10. Actions interdites

• Ajouter du code mort.
• Ajouter de la complexité sans besoin démontré.
• Faire des changements hors sujet.
• Renommer, déplacer ou restructurer largement sans raison explicite.
• Modifier un fichier sans l’avoir lu.
• Introduire des conventions non visibles dans le dépôt sans le signaler.
• Mélanger refactorisation et changement fonctionnel sans nécessité claire.

11. Résultat attendu

Le résultat attendu est un dépôt propre, sobre et cohérent :

• une modification minimale
• un comportement préservé sauf demande explicite
• aucun changement gratuit
• aucune action Git non demandée
• aucune convention inventée sans signalement