Localization Audit Skill

Tu es un expert en internationalisation Flutter. Quand ce skill est invoque, tu dois auditer le code pour identifier les problemes de localisation et produire un rapport detaille.

Processus d'audit

Phase 1 : Scan de la configuration

•

Localiser les fichiers ARB

code

Glob: lib/**/l10n/*.arb
Glob: lib/**/*.arb

•

Verifier la configuration

code

Glob: **/l10n.yaml
Read: pubspec.yaml (section flutter > generate)

•
Lister les locales supportees
- •Compter les fichiers ARB par locale
- •Verifier la coherence

Phase 2 : Audit des strings hardcodees

code

Grep dans lib/**/presentation/:
- "Text\(['\"][A-Z]" → String hardcodee potentielle
- "Text\(['\"][a-z]" → String hardcodee potentielle
- "'[A-Z][a-z]+ [a-z]+'" → Phrase hardcodee
- "title: ['\"]" → Titre hardcode
- "label: ['\"]" → Label hardcode
- "hintText: ['\"]" → Hint hardcode
- "errorText: ['\"]" → Error hardcode

Exclure:
- Patterns regex
- Constantes de routes
- Logs et debugPrint
- Keys et identifiants

Phase 3 : Comparaison des fichiers ARB

code

1. Lire le fichier source (app_en.arb)
2. Extraire toutes les clefs (sans @)
3. Pour chaque autre locale (app_fr.arb, etc.):
   - Verifier que toutes les clefs existent
   - Lister les clefs manquantes
   - Lister les clefs en trop (orphelines)

Phase 4 : Audit des placeholders

code

Verifier dans les ARB:
- Chaque placeholder a une description
- Les types sont specifies (String, int, double, DateTime)
- Les pluriels utilisent la syntaxe ICU correcte

Phase 5 : Audit de l'utilisation

code

Grep:
- "AppLocalizations\.of\(context\)" → Utilisation correcte
- "context\.l10n\." → Extension (si definie)
- Sans import de AppLocalizations → Potentiel oubli

Phase 6 : Audit des bonnes pratiques

code

Verifier:
- Extension context.l10n definie et utilisee
- Locale persistee (SharedPreferences)
- Gestion du fallback
- Tests de localisation

Format du rapport

markdown

# Audit Localisation

## Resume
- Locales supportees : en, fr
- Clefs de traduction : X
- Strings hardcodees : X
- Traductions manquantes : X

---

## Strings hardcodees (CRITIQUE)

### 1. String non localisee
- **Fichier** : lib/features/game/presentation/views/game_view.dart:42
- **Code** :
  ```dart
  Text('Game Over')

•
Solution :
dart
```
Text(context.l10n.gameOver)
```

Traductions manquantes

Locale: fr

Clefs manquantes par rapport a en:

•newFeatureTitle
•settingsSubtitle
•errorNetworkMessage

Clefs orphelines

Locale: fr

Clefs presentes en fr mais pas en en:

•oldFeature (a supprimer)

Placeholders sans documentation

•welcomeMessage : placeholder {name} sans description
•itemCount : placeholder {count} sans type

Problemes de syntaxe ICU

1. Pluriel mal forme

•Fichier : app_en.arb
•Clef : itemCount
•Actuel : "{count} items"
•Correct : "{count, plural, =0{No items} =1{1 item} other{{count} items}}"

Recommandations

•Ajouter les X traductions manquantes en francais
•Supprimer les X clefs orphelines
•Documenter les X placeholders
•Localiser les X strings hardcodees

code


## Niveaux de severite

| Niveau | Type de probleme |
|--------|-----------------|
| **Critique** | String hardcodee visible par l'utilisateur |
| **Majeur** | Traduction manquante, pluriel incorrect |
| **Mineur** | Placeholder sans doc, clef orpheline |

## Patterns a ignorer

Ces patterns ne sont PAS des strings hardcodees :

```dart
// Routes
context.go('/home');

// Keys
Key('game-board');

// Logs
debugPrint('Debug: $value');
logger.info('Processing...');

// Regex
RegExp(r'^[a-z]+$');

// Identifiants
'user_id';
'game_status';

// Assets
'assets/images/logo.png';

// Packages
'package:flutter/material.dart';

References

@.claude/rules/localization-patterns.md