projectrules.ai

Communication technique précise

Technical CommunicationCode ReviewDocumentationBest PracticesSoftware Development

Description

Guidelines for technical-precise-communication

Globs

**/*
---
description: Guidelines for technical-precise-communication
globs: **/*
---


# Communication technique précise

## Context
- Dans les revues de code et discussions techniques
- Pour la documentation des décisions architecturales
- Lors de l'explication des approches proposées

## Requirements
- Utiliser une terminologie technique précise et cohérente
- Référencer des concepts, patterns ou principes spécifiques plutôt que des généralités
- Structurer les explications de façon logique (problème → approches → solution → justification)
- Utiliser des preuves concrètes plutôt que des opinions (performances mesurées, non ressenties)
- Donner des références à des parties spécifiques du code (numéros de ligne, noms de fichiers)
- Éviter le jargon non spécifique ou les métaphores ambiguës

## Examples
<example>
**Communication technique précise**:

"L'implémentation actuelle du composant `OrderList` présente un problème de performance lié à des re-rendus excessifs. Analyse:

1. **Identification du problème**: Les logs de performance React DevTools montrent que chaque mise à jour d'état dans le parent `OrderPage` déclenche 200+ re-rendus des items enfants, même si les props n'ont pas changé.

2. **Approches évaluées**:
   - Mémoisation avec React.memo: Simple mais ne résout pas les problèmes de référence
   - Virtualisation avec FlatList: Efficace mais nécessite une refonte de la structure
   - Stratégie d'immutabilité avec Immer: Résout le problème de référence sans changement structurel

3. **Solution proposée**: Implémenter Immer dans le reducer d'orders pour garantir l'immutabilité tout en préservant l'identité des références non modifiées, puis appliquer React.memo sur OrderItem.

4. **Résultats attendus**: Réduction de 80% des re-rendus inutiles basée sur les tests de performance initiaux."
</example>

<example type="invalid">
**Communication imprécise**:

"Le code est lent et plein de bugs. On devrait tout refaire avec une approche plus moderne et meilleure. J'ai vu ça dans un projet précédent et ça marchait super bien."
</example>