Travailler avec un assistant IA
Un assistant de programmation peut lire les fichiers d’un projet, proposer des changements et exécuter des commandes. Pour qu’il contribue à un modèle financier de façon prévisible, donnez-lui le contexte nécessaire et créez des contrôles que vous pouvez examiner.
Les noms de fichiers et les mécanismes varient selon les outils. Les principes restent les mêmes : décrire le projet, préciser les règles métier, automatiser les vérifications répétitives et garder une revue humaine des décisions financières.
Les éléments constitutifs
| Élément | Rôle | Quand il est utile |
|---|---|---|
| Fichier d’instructions | Présente le projet, ses dossiers et ses conventions | Au début d’une session de travail |
| Règles ciblées | Donne des consignes à certains fichiers ou répertoires | Quand l’assistant modifie une partie précise |
| Compétence réutilisable | Décrit les étapes d’une tâche récurrente | Pour une opération qu’on répète, comme ajouter un ratio |
| Crochets automatiques | Exécute un contrôle à un moment déterminé | Après une modification ou avant un enregistrement Git |
| Serveur MCP | Relie l’assistant à des outils ou à des données externes | Quand un accès externe approuvé est nécessaire |
Ces mécanismes se distinguent surtout par le moment où ils interviennent. Les instructions générales sont souvent lues à chaque session et doivent rester courtes. Les règles et compétences sont chargées selon le contexte et peuvent décrire davantage de détails. Les crochets automatiques lancent des commandes sans demander à l’assistant de s’en souvenir.
Fichiers d’instructions
Le fichier d’instructions est la première fiche de repères du dépôt. Selon l’outil, il peut s’appeler AGENTS.md, CLAUDE.md ou être rangé dans un répertoire de configuration. Lorsque plusieurs assistants sont utilisés, gardez une source commune et faites pointer les autres fichiers vers elle.
Décrivez en quelques lignes :
- le but du modèle et les données qu’il utilise ;
- l’emplacement des calculs, contrôleurs, vues et tests ;
- les conventions financières comme les unités, les signes et la forme des pourcentages ;
- les commandes d’installation, de test et de vérification ;
- les règles de sécurité et les données qu’il ne faut pas transmettre à un service externe.
Exemple de consignes concises :
Objectif : calculer des indicateurs de rentabilité à partir d’états financiers.
Les fonctions de calcul ne lisent pas de fichiers et ne produisent pas de graphiques.
Les taux sont stockés comme fractions : 0,25 représente 25 %.
Chaque nouvelle formule a un test avec une valeur vérifiée indépendamment.
Avant de terminer, lancer les tests et résumer les fichiers modifiés.Gardez le fichier assez court pour qu’il reste consultable. Les choix propres à une formule ou à un sous-module peuvent être décrits dans une règle plus ciblée.
Règles
Une règle s’applique à un périmètre, par exemple aux fichiers de calcul ou aux tests. Elle permet d’éviter de charger chaque détail dans les consignes générales.
Périmètre : modules de calcul financier
- Les fonctions n’accèdent ni aux fichiers ni au réseau.
- Elles reçoivent les données déjà sélectionnées.
- Elles ne remplacent pas les valeurs absentes sans le signaler.
- La docstring indique la formule et les conventions retenues.Les règles de domaine doivent venir de la personne responsable du modèle : quelle définition de marge employer, comment combiner les périodes, quelles sources sont approuvées et quel traitement appliquer aux valeurs absentes. L’assistant ne devrait pas choisir ces éléments en silence.
Compétences
Une compétence décrit une tâche récurrente étape par étape. Elle peut inclure des exemples, une liste de fichiers à consulter et des critères de fin. Les outils qui prennent en charge un format structuré de compétences pour assistants rangent souvent ce type de ressource dans un dossier propre au projet.
Pour l’ajout d’un indicateur, une compétence pourrait demander de confirmer la définition financière, d’ajouter le calcul au bon module, de créer un test contrôlable, de lancer les commandes du projet et de résumer la formule et les fichiers modifiés.
Les compétences conviennent aux procédures détaillées qui ne s’appliquent qu’à une tâche précise. Elles ne remplacent pas les instructions générales du dépôt.
Crochets automatiques
Un crochet est une commande exécutée automatiquement après un événement défini par l’outil : après une modification, avant un enregistrement Git ou lorsqu’une session se termine. Il peut lancer un formateur, un outil d’analyse statique ou une suite de tests.
Utilisez cette automatisation pour les contrôles reproductibles, pas pour décider si une formule est financièrement correcte. Si un crochet reformate des fichiers, examinez la différence. Les contrôles automatiques réduisent le travail répétitif ; ils ne remplacent ni la revue ni la validation des valeurs de référence.
Serveurs MCP
Le protocole MCP permet à un assistant compatible de communiquer avec un service externe, comme une base de données ou un outil interne. Une connexion peut aider à récupérer des données autorisées ou à interroger une source de documentation.
Traitez cette connexion comme toute autre dépendance : examinez les autorisations, la provenance des données et les actions que le serveur peut exécuter. Ne connectez que des services approuvés et ne transmettez pas de données financières confidentielles sans autorisation. Pour commencer, un jeu d’exemple local ou synthétique évite d’exposer des données réelles.
Un flux de travail qui vous laisse le contrôle
Une tâche bien délimitée réduit les modifications difficiles à examiner. Demandez à l’assistant de préciser son plan, puis vérifiez les points financiers avant qu’il n’écrive le code. Après sa proposition, examinez la liste des changements, consultez les résultats des commandes et décidez si le changement doit être conservé.
Pour chaque modification, vérifiez :
- la formule, les unités, les périodes et les hypothèses ;
- le traitement des valeurs manquantes et des cas limites ;
- l’emplacement du nouveau code dans l’architecture ;
- la présence d’un test dont la référence a une origine indépendante ;
- l’absence de secrets ou de données sensibles dans les fichiers modifiés.
Gardez les tâches petites. « Ajouter le calcul de la marge opérationnelle et son test » est plus facile à contrôler que « refondre tout le modèle ». Demandez d’abord une proposition, faites exécuter les contrôles, puis transformez en instruction écrite toute correction qui revient souvent.
L’assistant peut effectuer une grande partie de la rédaction. La définition de l’indicateur, la plausibilité des résultats et l’acceptation du changement restent sous votre responsabilité.
Pour continuer
Revenez au début du parcours, puis appliquez ces principes à une petite analyse : définissez une question, séparez le calcul de l’accès aux données, vérifiez une valeur à la main et automatisez les contrôles répétitifs.