Agents de codage IA & AGENTS.md

Les assistants de codage IA — Claude, GitHub Copilot, Cursor et d’autres — peuvent construire et personnaliser un portail PowerPortalsPro bien plus précisément lorsqu’ils comprennent les conventions du framework. Pour que cela soit automatique, chaque projet généré à partir d’un modèle PowerPortalsPro envoie un AGENTS.md fichier à sa source.

Qu’est-ce que AGENTS.md ?

AGENTS.md est un fichier d’instructions Markdown simple que les outils de codage IA lisent automatiquement pour apprendre les conventions d’un projet avant d’écrire du code. C’est une norme émergente inter-outils — le même fichier est capté par Claude, GitHub Copilot, Cursor et d’autres — donc vous maintenez un seul ensemble de directives, pas un par outil. Les modèles PowerPortalsPro génèrent un AGENTS.md outil adapté au framework afin qu’un agent sache assembler les fonctionnalités à partir des composants et services du framework, plutôt que de générer manuellement l’accès aux données, l’authentification ou la logique de sauvegarde.

Note

Les directives sont spécifiques à chaque stack : un projet généré à partir du modèle React propose un modèle axé AGENTS.mdsur React, et un projet Blazor propose un projet axé sur Blazor. Chacun décrit les composants, services et motifs pour cette pile.

Là où il vit

Le fichier se trouve à la racine de votre solution générée, à côté de vos projets, donc tout outil d’IA ouvert sur le dépôt le trouve sans configuration :

Qu’y a-t-il à l’intérieur

Le généré AGENTS.md distille les conventions couvertes par ce site de documentation en une référence toujours en contexte qu’un agent lit sur chaque tâche :

• Règles d’or — ne pas rouler à la main l’accès aux données, l’authentification ou la logique de sauvegarde ; lier les éditeurs à un contexte de disque ; Jamais de code dur des couleurs ou des chaînes orientées utilisateur.
• Architecture et mise en page des projets — comment les projets hôte et client s’intègrent et où se trouvent vos pages et composants.
• Données et motifs d’édition — chargement des enregistrements, modèle contexte-enregistrement + éditeur de champs, et les composants de la grille.
• Une référence composante compacte — les props/paramètres pour les composants que vous ciblez le plus, avec des pointeurs vers les types et IntelliSense pour le reste.
• Sécurité — filtrer les données à la source pour une pagination et des performances précises ; Les gestionnaires de permissions sont la couche d’application.
• Localisation et thèmation — les conventions des string-keys et les règles du design-token.
• Workflow développeur & pièges — comment gérer le projet et les erreurs à éviter.

L’utiliser efficacement

Quelques habitudes tirent le meilleur parti du guide :

• Laissez l’agent le lire d’abord. La plupart des outils se chargent AGENTS.md automatiquement ; sinon, pointez votre assistant dessus avant de demander une fonctionnalité.
• Misez-vous sur les types et IntelliSense. Le guide est délibérément concis — pour toute la surface de tout composant ou service, l’agent peut lire les définitions TypeScript (React) ou l’IntelliSense (Blazor) en XML-doc.
• Référez ce site. Pointez l’agent vers les exemples en temps real et la référence API ici sur la démo pour trouver des patterns qu’il peut copier.
• Examinez la sortie. Le guide rend un agent plus précis, mais il ne remplace pas votre avis — vérifiez en particulier les règles de sécurité générées et le filtrage des données.

Par exemple, une requête comme celle-ci donne à un agent tout ce dont il a besoin pour produire du code idiomatique :

Fais-le à toi

AGENTS.md est un fichier ordinaire dans votre dépôt — éditez-le. Ajoutez vos propres tables et relations, règles de domaine, conventions de nommage et motifs spécifiques au projet afin que l’agent apprenne votre portail, pas seulement le framework. Plus le fichier reflète bien votre base de code, meilleur le code généré.

Conseil

Considérez AGENTS.md comme une documentation vivante : lorsque vous établissez une nouvelle convention ou rencontrez une erreur récurrente, ajoutez une ligne au fichier pour que chaque session IA future en bénéficie.