---
name: mcp-ui-internationalization
description: >
  Design, implement, audit, test, and migrate internationalized and localized web interfaces. Use for locale architecture, translation catalogs, ICU messages, plural and gender rules, dates, numbers, currencies, time zones, RTL and bidirectional text, language switching, locale routing, SEO metadata, asset localization, pseudo-localization, responsive stress, and incremental extraction of hard-coded strings from legacy applications. Use mcp-product-experience-designer when terminology and information architecture require broader product decisions.
---

# MCP UI Internationalization

Rendere contenuti, layout e interazioni corretti per lingue, formati e direzioni di scrittura diverse.

## Ambito

Usare per:

- cataloghi e locale routing
- date/number/currency/timezone
- RTL/bidi
- pseudo-localization
- migrazione stringhe hardcoded

Non usare per:

- concatenare frasi tradotte
- assumere che lingua e paese coincidano
- salvare date locali ambigue
- testare solo inglese e una lingua corta

## Workflow operativo

1. Inventariare locale, cataloghi, hard-coded strings, formatter, route e persistenza.
2. Eseguire `scripts/mcp-ui-internationalization/inspect_internationalization.py <project>` per segnali statici.
3. Definire ownership di locale, fallback, negotiation e URL strategy.
4. Usare messaggi completi con plural/gender e formatter locale-aware.
5. Gestire timezone, parsing, storage e display separatamente.
6. Verificare RTL/bidi, icone direzionali, layout, form, tabelle e asset.
7. Eseguire pseudo-localization e test con contenuti lunghi e glyph non latini.

## Regole permanenti

- Separare sempre fatti osservati, inferenze, preferenze e assunzioni.
- Conservare compatibilita legacy e comportamento esistente salvo modifica esplicitamente approvata.
- Preferire modifiche piccole, verificabili e reversibili a refactor estesi.
- Citare file, linee, selector, schermate, task o altra evidenza disponibile.
- Dichiarare limiti, aree non testate e dipendenze da validazione runtime o utente.
- Non dichiarare verificato cio che non e stato effettivamente testato.

## Output predefinito

1. i18n inventory
2. locale architecture
3. message strategy
4. format/timezone contract
5. RTL plan
6. migration e test matrix

## References

Caricare solo le reference necessarie al task:

- [bidi-rtl-and-layout](references/bidi-rtl-and-layout.md)
- [dates-times-and-time-zones](references/dates-times-and-time-zones.md)
- [fonts-input-and-accessibility](references/fonts-input-and-accessibility.md)
- [foundations-and-locale-model](references/foundations-and-locale-model.md)
- [frameworks-routing-and-ssr](references/frameworks-routing-and-ssr.md)
- [legacy-migration-and-governance](references/legacy-migration-and-governance.md)
- [messages-pluralization-and-content](references/messages-pluralization-and-content.md)
- [numbers-currencies-units-and-collation](references/numbers-currencies-units-and-collation.md)
- [official-sources](references/official-sources.md)
- [testing-pseudolocalization-and-regression](references/testing-pseudolocalization-and-regression.md)
- [unicode-text-and-security](references/unicode-text-and-security.md)