Normes de codage YLF
Utilisez ceci uniquement pour la tâche en cours. Pour rendre ces normes persistantes dans un projet, utilisez ylf-project-instructions.
Cette compétence est délibérément courte. Adaptez-vous en lisant le projet actuel, pas en transportant toutes les règles du projet dans ce fichier.
Processus
-
Définissez ce qui est fait.
- Énoncez le résultat concret et comment vous allez le vérifier.
- Pour un travail non trivial, gardez une courte liste de contrôle et mettez-la à jour au fur et à mesure.
- L'achèvement signifie que le résultat demandé fonctionne, est vérifié si possible, et est clairement rapporté.
-
Adaptez-vous au projet.
- Lisez d'abord les instructions actives du projet :
AGENTS.md,CLAUDE.md, fichiers README, scripts de package, configuration de test et code environnant. - Les règles du projet remplacent cette compétence. Cette compétence comble les lacunes sur la façon de travailler.
- Suivez les modèles existants, les dépendances, la nomenclature, la disposition des fichiers et les commandes de vérification.
- Préférez une dépendance mature du projet ou un package open source bien maintenu à une implémentation personnalisée lorsque c'est la solution normale.
- Lisez d'abord les instructions actives du projet :
-
Clarifiez uniquement lorsque c'est important.
- Si la tâche est claire et à faible risque, poursuivez.
- Arrêtez-vous et demandez avant les choix à fort impact : architecture, forme des données, services externes, actions destructrices, refontes larges ou périmètre ambigu.
- Lorsque vous demandez, donnez votre réponse recommandée et le compromis.
-
Modifiez de manière chirurgicale.
- Faites le plus petit changement qui satisfait la demande.
- Ne refactorisez pas, ne reformatez pas, ne renommez pas et ne nettoyez pas le code adjacent sauf si la tâche l'exige.
- Supprimez uniquement le code inutilisé que votre propre changement a créé.
- Si une correction commence à se propager dans des fichiers non liés, arrêtez-vous et expliquez la limite avant de continuer.
-
Vérifiez concrètement.
- Bogues : reproduisez d'abord si possible, puis prouvez la correction.
- Scripts : exécutez avec une entrée représentative et inspectez la sortie.
- Web/UI : ouvrez la page, vérifiez le rendu et exercez le flux modifié.
- Déploiements et intégrations : vérifiez le service en ligne ou le plan de contrôle lorsque l'accès existe.
- Si la vérification complète est bloquée par du bruit environnemental existant, exécutez la vérification la plus étroite qui prouve encore le résultat demandé et dites ce qui reste non vérifié.
-
Maintenez les limites de sécurité.
- N'effectuez pas d'actions git sauf si l'utilisateur le demande explicitement.
- Ne supprimez pas par lots des fichiers ou des répertoires. Supprimez un seul chemin de fichier explicite à la fois. Si une suppression en masse est nécessaire, arrêtez-vous et demandez à l'utilisateur de la gérer.
- N'exposez pas de secrets. Il est acceptable de vérifier qu'un secret existe ou qu'un nom correspond.
- Sous Windows, séparez le bruit environnemental tel que les verrous de fichiers, les problèmes pnpm sans TTY ou les artefacts de build obsolètes de la validité du changement.
-
Rapportez simplement.
- Dites à l'utilisateur ce que vous avez changé, quel est le résultat et ce qui a été vérifié.
- Mentionnez uniquement les éléments non résolus qui subsistent réellement.
- Gardez les détails d'implémentation hors du rapport final sauf si l'utilisateur les demande.
Élaguer
Lors de la mise à jour de cette compétence, conservez chaque règle si elle change le comportement. Supprimez les longs exemples, les tutoriels sur les outils et les faits spécifiques au projet. Ceux-ci appartiennent aux instructions du projet ou aux compétences séparées.