translation-review

Revisión de traducciones, un idioma a la vez

translation-check prueba que cada clave exista con los marcadores de posición correctos. Este skill lee las palabras.

1. Alcance y contexto

• Qué textos: las claves que un cambio añadió o editó (diff de los archivos de locale contra la rama base), o bien todo un espacio de nombres o archivo si se solicita. Obtén el valor de referencia y el valor de cada idioma lado a lado.
• Dónde aparecen: busca el uso de cada clave en el código (git grep "<clave>"). ¿Es un botón, un título, un correo, un error, un tooltip? ¿Cuánto espacio tiene? ¿Está en una oración con otras claves, o usa {{count}}, un nombre, una fecha?
• Reglas del proyecto: AGENTS.md y .claude/translations.json, para palabras evitar, nombres de productos y planes que permanecen sin traducir, formalidad, y quién es el lector (cliente, distribuidor, administrador).
• Glosario existente: cómo se traducen ya los mismos términos en otras partes de los archivos de ese idioma. Usa git grep para buscar un término en la carpeta de ese locale. La consistencia prevalece sobre tu propia preferencia.

2. Revisar cada idioma por separado

Para cada idioma, revisa cada texto según:

1. Significado: dice lo mismo que la referencia. Nada añadido, nada omitido, sin falsos amigos. Los marcadores de posición se usan en la función gramatical correcta.
2. Natural: se lee como el texto de producto propio de ese idioma, no palabra por palabra del inglés. Cuida el orden de las palabras, los artículos y las mayúsculas (sustantivos en alemán en mayúscula; no usar Title Case inglés en otros idiomas).
3. Términos: la misma cosa tiene el mismo nombre en todas partes (informe, pedido, crédito, VIN, nombres de planes), y coincide con el glosario del paso 1.
4. Formalidad: un mismo registro en todo el producto, por ejemplo Sie o du en alemán, ви en ucraniano, vous en francés, Vy en checo, Pan/Pani o las formas neutras en polaco. No mezclarlos.
5. Gramática con variables: formas plurales correctas para cantidades reales (1, 2, 5, 21, 22, 25 en uk, pl y cs); caso después de preposiciones; concordancia de género cuando un marcador de posición es un sustantivo.
6. Longitud: botones, pestañas y etiquetas se mantienen aproximadamente tan cortos como la referencia. Marca cualquier cosa aproximadamente un 40% más larga en un espacio ajustado.
7. Convenciones locales: unidades (км, кВт, к.с. en uk/bg), coma decimal, orden de fecha, posición de la moneda, comillas („…“ en de, « … » en fr, «…» en uk).
8. Reglas del proyecto: palabras prohibidas, ortografía de marca, nombres de planes.

3. Informe

Agrupa por idioma y da a cada hallazgo la clave, el texto actual, el problema y un texto sugerido:

uk — 2 hallazgos
- reportPage:upgrade.cta — "Оновити до Complete звіту" — el orden de las palabras parece inglés; Complete es un nombre de plan → "Перейти на звіт Complete"
- ...
de — sin hallazgos

• Indica qué idiomas puedes evaluar con confianza. Para aquellos que no puedas, dilo en lugar de adivinar, y sugiere una revisión nativa.
• Si te piden corregir: aplica las sugerencias en los archivos de locale, ejecuta i18n:translation-check de nuevo, y haz commit con el cambio.
• En una revisión de PR, publica estos como Nits, a menos que el significado sea incorrecto o aparezca una palabra prohibida: entonces es Important.