Codage

Que fait Codage ?

Utilisez cette compétence comme point d'entrée pour le travail logiciel. Gardez ce fichier en contexte, puis chargez le plus petit ensemble de références pertinent pour la tâche.

Routage

• Pour écrire du nouveau code ou étendre un comportement, lisez ./references/implementation.md.
• Pour du refactoring, du nettoyage, de la simplification, de l'extraction, de la restructuration ou des réécritures, lisez ./references/refactoring.md.
• Pour une revue de code, une revue de PR, une critique de diff, ou une évaluation des risques, lisez ./references/review.md.
• Pour du débogage, des tests en échec, des régressions, des erreurs d'exécution, des échecs CI ou des corrections de bugs, lisez ./references/debugging.md.
• Pour l'architecture, la conception d'API, les limites de modules, la direction des dépendances, ou une discussion purement conceptuelle, lisez ./references/design.md.
• Pour les règles de qualité de code partagées, lisez ./references/standards.md à chaque fois que vous écrivez ou modifiez du code, et selon les besoins pendant la revue/la conception.
• Pour la stratégie d'assertion (vérifications d'invariants, décisions d'assertion en débogage vs production, et contrats d'échec rapide), lisez ./references/assertions.md lorsque vous écrivez ou révisez du code qui valide des hypothèses internes.

Ne chargez que les références nécessaires à la demande actuelle de l'utilisateur. Si la tâche comporte plusieurs phases, chargez la référence suivante au début de cette phase.

Règles de Base

• La correction, la sécurité et l'intention de l'utilisateur priment sur les préférences de style.
• Le formateur du projet, le linter, les tests, le système de build, les conventions du framework et les modèles locaux systémiques priment sur les normes par défaut de cette compétence.
• Un modèle local est systémique lorsqu'il apparaît dans plusieurs fichiers voisins, est imposé par des outils, ou fait partie d'une convention claire du framework/de l'application. Ne copiez pas de code faible ponctuel simplement parce qu'il est adjacent.
• En l'absence de modèle de projet systémique, utilisez ./references/standards.md.
• Préservez le comportement public, les API, les contrats de données, les migrations et la sémantique opérationnelle, sauf si l'utilisateur demande explicitement de les modifier.
• Limitez les modifications au périmètre de la tâche. Améliorez le code touché juste assez pour obtenir un résultat cohérent, mais ne normalisez pas le code existant non lié.

Recherche d'Exemples

Utilisez les exemples uniquement lorsqu'une décision de règle n'est pas claire.

• ./examples/README.md indexe des exemples ciblés.
• Ouvrez un seul fichier d'exemple correspondant à la fois.