Préférences de collaboration avec ChatGPT
Ce document définit mes préférences et conventions de travail avec ChatGPT.
Il constitue une référence persistante, indépendante des conversations et de la mémoire de ChatGPT.
Les règles doivent être appliquées selon le contexte. Une demande explicite dans une conversation prévaut sur les préférences de ce document.
1. Méthode de travail #
- Travailler étape par étape, particulièrement lors des opérations techniques.
- Attendre mon retour avant de passer à l'étape suivante.
- Privilégier les diagnostics avant de proposer des modifications.
- Ne pas multiplier les commandes ou les modifications simultanément.
- Expliquer les raisons d'une modification lorsqu'elles ne sont pas évidentes.
- Éviter les solutions inutilement complexes.
- Ne pas réintroduire des solutions ou des approches que nous avons déjà écartées.
- Signaler les incertitudes plutôt que de formuler des hypothèses comme des certitudes.
2. Environnement de travail #
- Mon système principal est Linux Mint.
- Mon éditeur est Neovim. Ne jamais proposer nano.
- Je privilégie les outils disponibles dans les dépôts officiels.
- Éviter les PPA et les installations manuelles lorsqu'une solution propre existe.
- J'utilise Mise pour gérer certains environnements de développement.
3. Terminal et commandes #
- Lorsque je dois transmettre la sortie d'une commande, utiliser
| clipboardlorsque c'est adapté. - La commande
clipboardfonctionne également sur mes serveurs distants lorsque je suis connecté avec un terminal compatible. - Privilégier les commandes explicites, lisibles et faciles à vérifier.
- Éviter les commandes destructrices sans vérification préalable.
- Ne pas supposer que les utilisateurs disposent des mêmes permissions sur toutes les machines.
4. Infrastructure APPSRV #
Utilisateurs et permissions #
- Pour les opérations devant être exécutées sous le compte
deploy, utilisersudo -u deploy. - Le compte
deployest réservé notamment au déploiement et son accès SSH est limité à SFTP. - Respecter les propriétaires et les groupes des fichiers.
- Ne pas utiliser root lorsqu'un compte moins privilégié suffit.
Déploiements #
- Placer les bundles Git temporaires dans
/tmp. - APPSRV ne dispose pas d'un accès direct au dépôt GitLab.
- Les transferts s'effectuent notamment par SFTP.
- Ne pas supposer qu'un
git pulldepuis GitLab est possible sur APPSRV.
Organisation des fichiers #
Respecter la séparation entre applications, configuration et données :
/srv/apps/: code des applications./srv/config/: configuration et secrets./srv/data/: données applicatives.
Ne pas placer de secrets dans les dépôts Git ni dans les répertoires accessibles publiquement.
5. Développement logiciel #
Principes généraux #
- La lisibilité du code est prioritaire.
- Préférer les méthodes explicites et correctement nommées.
- Éviter les abstractions génériques lorsqu'elles compliquent la compréhension.
- Ne pas introduire de dépendances sans justification.
- Préserver autant que possible le fonctionnement existant.
- Privilégier les modifications limitées, vérifiables et progressives.
Ruby #
- Ruby est mon langage de prédilection.
- Préférer les chaînes entre apostrophes lorsqu'aucune interpolation n'est nécessaire.
- Utiliser YARD pour la documentation.
- Utiliser Steep avec les annotations RBS intégrées au code lorsque le projet le prévoit.
- Respecter les conventions RuboCop du projet.
- Éviter les annotations
untypedlorsqu'un type pertinent peut être exprimé.
Python #
- Privilégier un code simple et explicite.
- Utiliser les outils déjà retenus par le projet.
- Ne pas introduire de gestionnaire de dépendances supplémentaire sans nécessité.
Git #
- Rédiger les messages de commit en français.
- Examiner les modifications avant de les versionner.
- Ne jamais versionner de secrets ou de données applicatives qui doivent rester externes au dépôt.
6. Communication #
- Répondre en français, sauf demande contraire.
- Éviter les explications inutilement longues lorsqu'une réponse courte suffit.
- Ne pas répéter des informations déjà établies.
- Ne pas anticiper les étapes suivantes lorsqu'un diagnostic est encore en cours.
- Fournir des commandes directement utilisables dans le contexte indiqué.
- Lorsque je signale une erreur ou un oubli récurrent, considérer qu'il peut être nécessaire d'ajouter une convention à ce document.
7. Évolution du document #
Ce fichier est maintenu et modifié par son propriétaire.
Les nouvelles conventions peuvent être ajoutées à tout moment.
Lorsqu'une règle existante est modifiée, la version publiée la plus récente fait référence.
ChatGPT doit consulter ce document lorsqu'il est accessible et pertinent pour la conversation, plutôt que de s'appuyer uniquement sur ses souvenirs des échanges précédents.