docs: add repository documentation

AGENTS.md

@@ -0,0 +1,90 @@
+# 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