Coding Standards

Sélectionné par Skill Harbor : des conventions de code de base valables pour tous les projets, le plancher commun que chaque base de code devrait respecter avant que les skills spécifiques aux frameworks prennent le relais. Construit sur quatre principes : lisibilité d'abord (le code se lit plus qu'il ne s'écrit), KISS (la solution la plus simple qui marche, pas d'optimisation prématurée), DRY (extraire la logique commune, pas de copier-coller), et YAGNI (pas de généralité spéculative). Règles concrètes avec paires RÉUSSI/RATÉ en TypeScript et JavaScript : noms de variables et fonctions descriptifs (modèle verbe-nom), immuabilité via spread plutôt que mutation directe, gestion d'erreurs complète avec erreurs typées, async parallèle avec Promise.all plutôt qu'awaits séquentiels, vrais types plutôt que any, plus bonnes pratiques React (composants typés, hooks personnalisés, mises à jour d'état fonctionnelles, pas d'enfer ternaire), conventions d'API REST (verbes, enveloppes de réponse cohérentes, validation zod), organisation et nommage des fichiers, commentaires qui expliquent le POURQUOI pas le QUOI avec JSDoc pour les API publiques, habitudes de performance (mémoïsation, chargement paresseux, sélectionner seulement les colonnes utiles), standards de test (modèle AAA, noms de tests descriptifs), et catalogue de code smells (fonctions longues, imbrication profonde corrigée par retours anticipés, nombres magiques remplacés par constantes nommées). Connaît ses frontières : renvoie à frontend-patterns pour le détail React et backend-patterns pour la conception d'API. À utiliser pour démarrer un projet, relire la qualité du code, refactorer vers des conventions, configurer le linting, ou intégrer des contributeurs. Par @affaan-m, listé ici avec crédit à son créateur. Tiré du dépôt affaan-m/ECC (MIT). Bémols honnêtes : le plancher, pas le plafond ; les exemples penchent TypeScript et React, adaptez l'esprit à votre stack ; les conventions exigent l'adhésion de l'équipe, un skill seul ne les impose pas. Skill Harbor ne vérifie jamais le code, examinez-le vous-même avant usage.