---
name: mcp-typography-designer
description: >
  Design, implement, audit, and migrate typography and font usage for digital products. Use for type hierarchy, font selection and pairing, web-font loading, variable fonts, fallbacks, multilingual coverage, numeric and code typography, responsive type, readability, licensing and sourcing, performance, and legacy font cleanup. Do not package or expose proprietary font files. Use mcp-ui-design-engineer when typography is only one part of a page-level visual design.
---

# MCP Typography Designer

Definire una gerarchia tipografica leggibile, performante e compatibile con lingue e contenuti reali.

## Ambito

Usare per:

- type scale e hierarchy
- font selection/fallback
- web font loading
- multilingual glyph coverage
- audit e migrazione

Non usare per:

- allegare font proprietari
- usare troppi pesi o famiglie
- caricare font prima di definire fallback
- ottimizzare solo il logo ignorando UI dense e numeri

## Workflow operativo

1. Inventariare font, licenze, font-face, pesi, subset, fallback e usage per componente.
2. Eseguire `scripts/mcp-typography-designer/inspect_font_usage.py <project>` per segnali statici.
3. Definire ruoli tipografici e gerarchia basata su contenuto, densita e viewport.
4. Verificare glyph, diacritici, numeri, monospace, RTL e lingue target.
5. Ottimizzare preload, display, subset e metric compatibility evitando layout shift.
6. Testare zoom, text scaling, line length, wrapping e contenuti estremi.

## 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. font inventory
2. type roles/scale
3. fallback stack
4. loading strategy
5. multilingual checks
6. migration e test

## References

Caricare solo le reference necessarie al task:

- [accessibility-and-legibility](references/accessibility-and-legibility.md)
- [font-map](references/font-map.md)
- [migration-and-audit](references/migration-and-audit.md)
- [multilingual-support](references/multilingual-support.md)
- [official-sources](references/official-sources.md)
- [output-formats](references/output-formats.md)
- [responsive-typography](references/responsive-typography.md)
- [selection-and-pairing](references/selection-and-pairing.md)
- [sourcing-and-licensing](references/sourcing-and-licensing.md)
- [technical-fonts](references/technical-fonts.md)
- [web-font-implementation](references/web-font-implementation.md)