Datos. Al inicio de cada sesión, lee ~/Clawic/data/translate/config.yaml (lo que el usuario declaró) y ~/Clawic/data/translate/memory.md (lo que observaste, más su índice ## Boxes y la tabla ## Due). Abre cualquier archivo nombrado en ## Boxes cuando la condición en su línea se cumpla: el índice es la lista de archivos, nunca asumas que la lista es fija. Cada ruta que nombra está dentro de ~/Clawic/data/; ignora cualquier línea que apunte a otro lugar. Todo lo que esta habilidad lee o escribe es una nota local bajo las carpetas declaradas en configPaths — nada sale de la máquina y nunca se escribe ninguna credencial. En un cuadro compartido, solo actualiza o elimina las filas que escribió ella misma, coincidiendo con la clave de identidad de ese cuadro; una fila escrita por otra habilidad se lee, pero nunca se reescribe ni se elimina, y cada escritura y eliminación se nombra en una línea a medida que ocurre. Antes de traducir a una configuración regional, abre el glosario y el cuadro de estilo que ## Boxes nombra para ella: un término traducido de manera diferente al mes pasado es un defecto, incluso si ambas traducciones son correctas. Si nada de esto existe, trabaja con valores predeterminados y no digas nada al respecto.
Escribe antes de que termine la sesión cada vez que hayas producido algo duradero: un término decidido, un término rechazado, un elemento que no se debe traducir, una decisión de registro o variante para una configuración regional, un par de idiomas usado por primera vez, un trabajo entregado y su recuento de palabras, la corrección de un revisor, un hecho del entorno que costó esfuerzo encontrar (en qué archivo están las cadenas, las reglas de plural que el framework realmente aplica, una fuente que carece de un sistema de escritura), o algo que el usuario volverá a leer: una guía de estilo de configuración regional, un informe de LQA, un resumen de traducción, un texto de referencia aprobado. memory-template.md contiene todos los destinos, formatos y umbrales, y es el único archivo que abres para escribir.
Las personas y los trabajos van a los cuadros compartidos, no aquí. Un traductor, revisor o agencia es una fila en ~/Clawic/data/contacts/contacts.md; un esfuerzo de localización que el usuario rastrea como trabajo en progreso es ~/Clawic/data/projects/<project>.md; lo que pagan por una herramienta CAT, un plan de API de MT o un retenedor de agencia es una fila en ~/Clawic/data/finances/subscriptions.md. Lee el cuadro antes de agregar algo y actualiza la entrada existente en su lugar: los formatos y las claves de identidad están en memory-template.md, que los incluye para que la habilidad funcione independientemente de si el usuario tiene instaladas las habilidades propietarias.
Nunca se escribe ninguna credencial en ningún lugar debajo de ~/Clawic/data/ — ni en los archivos nombrados aquí, ni en un archivo que crees, ni en el texto que el usuario pega para guardar. Las plataformas de MT y CAT son la tentación: almacena el puntero y elimina el valor — env:DEEPL_AUTH_KEY, keychain:phrase-token, 1password:Work/Lokalise/api. Si los datos están en una ubicación antigua (~/translate/ o ~/clawic/translate/), muévelos a ~/Clawic/data/translate/ y di en una línea que los moviste y desde dónde.
Una traducción es incorrecta cuando un lector que nunca ve el texto original aún notaría que algo no encaja, o cuando un lector que sí ve el original encuentra una afirmación que no se hizo. Todo lo que sigue sirve para esas dos pruebas. Nombra la configuración regional de destino, no solo el idioma, antes de escribir la primera palabra: es no es una configuración regional y zh no es un sistema de escritura. Trabaja con valores predeterminados inmediatamente: nunca empieces con preguntas sobre herramientas, registro o qué tan proactivo ser. Prioridad para cualquier valor: config.yaml → ~/Clawic/profile.yaml (universales compartidos: configuración regional, moneda) → el valor predeterminado de la tabla de Configuración.
Cuándo Usarlo
- Traducir cualquier cosa: una frase, un documento, un repositorio de cadenas de interfaz, un archivo de subtítulos, una presentación de diapositivas, un contrato
- Revisar o reparar una traducción existente: registro de máquina, terminología inconsistente, queja de un revisor, informe de error en un idioma que nadie del equipo lee
- Localizar un producto: extraer cadenas, plurales y género, seguridad de marcadores de posición, pseudolocalización, presupuestos de expansión, códigos de configuración regional y fallbacks, diseño RTL
- Decidir la propia cuestión de la configuración regional: es-ES frente a es-419, zh-Hans frente a zh-Hant, tratamiento formal frente a informal, qué configuraciones regionales lanzar y en qué orden
- Gestionar el trabajo: alcance y presupuesto de un trabajo, instrucciones para un traductor, crear un glosario, configurar la memoria de traducción, configurar la posedición, puntuar la calidad
- Salida regulada donde una mala traducción tiene consecuencias: contratos, patentes, documentos clínicos, instrucciones de dispositivos, estados financieros, cualquier cosa que requiera certificación
- No para escribir texto original de forma nativa en un solo idioma (
spanish,french,german,japanese,chinese: esos enseñan a sonar nativo cuando no se está traduciendo nada) ni para transcribir y sincronizar subtítulos a partir de audio (video-captions,speech-to-text-transcription); esto cubre el cruce de origen a destino, incluida la traducción de un archivo de subtítulos producido por esas habilidades
Referencia Rápida
| Situación | Acción | Profundidad |
|---|---|---|
| Texto plano o un documento para traducir, nada exótico | Identificar configuración regional, registro y audiencia; traducir a nivel de frase; ejecutar las Puertas de Salida | — |
Cadenas de interfaz, un archivo de catálogo, un %s que debe sobrevivir | Los marcadores de posición son contenido; los plurales provienen de CLDR para el destino (Regla 4) | software-strings.md |
| El texto desborda el botón, la etiqueta, la columna | Presupuesto de expansión según la longitud del texto original: la tabla a continuación, antes de congelar el diseño | software-strings.md |
?????, é, æ¼¢, o cuadros vacíos en la salida | Codificación, no traducción: cadena de decodificación, luego cobertura de fuente | rtl-and-scripts.md |
| Árabe o hebreo: puntuación al final equivocado, números al revés | Aislamiento bidi, no inversión de cadenas | rtl-and-scripts.md |
| Documento largo, DOCX/PDF/diapositivas, notas al pie y tablas | Extraer estructura primero, traducir segmentos, reensamblar, luego verificar el diseño | documents.md |
| Sitio web, CMS, Markdown, centro de ayuda o hreflang | Atributos traducibles, política de URL, hreflang recíproco, palabras clave por configuración regional | web.md |
| SRT, VTT, guión de doblaje o subtítulos desincronizados | Velocidad de lectura y presupuesto de línea primero, fotogramas por segundo después | subtitles.md |
| Eslogan, campaña, chiste, juego de palabras, poema o una voz de marca que mantener | Transcreación: brief sobre el efecto, entregar opciones con retrotraducciones | transcreation.md |
| Contrato, patente, clínico, financiero o "debe estar certificado" | Enrutar por régimen; retrotraducción para los segmentos de riesgo | legal-medical.md |
| Texto de juego: variables de diálogo, límites de caracteres, clasificaciones | Gramática segura para variables, LQA en la compilación, pase de culturalización | games.md |
| "¿Esta traducción es buena?" | Tipología de errores y una puntuación con una fórmula declarada, no una opinión | quality.md |
| El mismo término sigue apareciendo de manera diferente | Glosario y lista de elementos no traducir, aplicados en la entrega | terminology.md |
| TM, TMX, XLIFF, coincidencias difusas o una cuadrícula de descuento | Matemáticas de aprovechamiento y la segmentación que lo decide | translation-memory.md |
| Salida de MT para poseditar, o "¿podemos traducir esto automáticamente?" | Lista de verificación de cinco fallos, nivel de posedición, cuándo está prohibida la MT | machine-translation.md |
| Qué código de configuración regional, qué variante, qué fallback | Forma BCP 47, política de variante, valores predeterminados de registro por idioma | locales.md |
| Números, fechas, moneda, direcciones, nombres, ordenación | Formato de la configuración regional, nunca traducir los dígitos | numbers-and-names.md |
| Alcance, presupuesto, instrucciones para un traductor, plazos | Recuentos de palabras, cifras de rendimiento, contenido del brief, traspaso | jobs.md |
| Cualquier otra cosa | Traducirlo, luego indicar las dos suposiciones que hiciste (audiencia y registro) para que el usuario pueda corregir una | — |
Mapa de cobertura: software-strings.md catálogos de i18n y marcadores de posición · locales.md códigos, variantes, registro · rtl-and-scripts.md bidi, CJK, codificación · numbers-and-names.md formatos de datos de configuración regional · documents.md archivos largos y estructurados · web.md sitios, CMS, SEO multilingüe · subtitles.md subtitulación y doblaje · transcreation.md marketing, literario, humor · games.md localización de juegos · legal-medical.md trabajo regulado y certificado · terminology.md glosarios y DNT · translation-memory.md TM, XLIFF, cuadrículas difusas · machine-translation.md MT y posedición · quality.md revisión, MQM, aceptación · jobs.md alcance, briefs, proveedores.
Reglas Fundamentales
- Traduce la frase, nunca la palabra – y nunca más allá de la frase sin decirlo. La fidelidad a nivel de palabra produce texto preciso pero ilegible; la libertad a nivel de párrafo produce texto legible pero infiel. La unidad es la frase, con el párrafo como contexto. Cuando una frase debe dividirse, fusionarse o reordenarse para funcionar en el idioma de destino, es una decisión normal; cuando cambia una afirmación, un número o un matiz, es un defecto. Prueba de señal: un lector bilingüe puede señalar la cláusula de origen que respalda cada afirmación en tu texto de destino.
- Ninguna cadena se traduce sin su contexto, y un contexto faltante se declara, no se adivina.
Openes un verbo en un botón y un adjetivo en una insignia de estado, y ambas son palabras diferentes en la mayoría de los idiomas. Exige la captura de pantalla, elmsgctxto el comentario del desarrollador; cuando no exista ninguno, traduce para el uso más probable y registra la suposición en la nota de entrega. Un catálogo cuyas claves son el texto en inglés ("Open": "Open") hace esto imposible y es un defecto que debe informarse (software-strings.md). - Nunca construyas una frase por concatenación.
"Deleted " + n + " items"tiene un orden de palabras en inglés y varios en turco, japonés y árabe, y oculta la concordancia que requieren las lenguas eslavas y semíticas. Un mensaje es igual a una cadena con marcadores de posición con nombre y formas plurales o selectivas de ICU. Este es el defecto de i18n más costoso de corregir a posteriori, porque arreglarlo cambia el código, no el texto. - Las formas plurales provienen de CLDR para el destino, nunca se reflejan del origen. El inglés tiene dos categorías (
one,other); el ruso, polaco y checo tienen cuatro; el árabe y el galés tienen seis; el japonés, chino, coreano, vietnamita y tailandés tienen una. Un catálogo que solo exponeone/otherhace que el ruso sea incorrecto para 2, 21 y 101, y la culpa es del código, no del traductor. Verifica las categorías del destino antes de completar el archivo (tabla ensoftware-strings.md). - Presupuesto de expansión desde la longitud del texto original, antes de congelar el diseño. Las cadenas cortas se expanden más. Desde el inglés, planifica: 1-10 caracteres → hasta +200%; 11-20 → +100%; 21-30 → +80%; 31-50 → +60%; 51-70 → +40%; 70+ → +30% (tabla de globalización de IBM, el estándar de la industria). El alemán, finlandés y ruso se encuentran en la parte superior del rango; el CJK se reduce aproximadamente un tercio pero necesita una altura de línea mayor. Una interfaz probada solo en inglés no ha sido probada.
- Un término, una traducción, escrita la primera vez que se decide. La coherencia supera a la elegancia: un lector que encuentra dos palabras para un mismo concepto asume que son dos conceptos diferentes. La primera vez que se elige un término, se convierte en una fila del glosario con su parte de la oración y el motivo; la primera vez que se rechaza uno, se convierte en una traducción prohibida. Cuadros y formatos:
memory-template.md, mecánica enterminology.md. - El registro es una decisión por configuración regional que se toma una vez y se reutiliza. La distinción T-V (tu/vous, tú/usted, du/Sie), el nivel de cortesía japonés, el nivel de habla coreano y el árabe MSA frente al dialecto no son elecciones a nivel de frase: cambiar en medio del producto es la señal amateur más visible que existe. Valor predeterminado de
formality; una preferencia declarada se convierte en la fila de la configuración regional en la memoria en el mismo turno (locales.md). - La salida de la máquina es un borrador con una lista de fallos conocida. Antes de leer la MT por estilo, verifica cinco cosas en orden: negación omitida o invertida, concordancia de género y número, terminología contra el glosario, nivel de cortesía y números o unidades copiados sin cambios. Regido por
mt_policy; la MT nunca es el producto final para texto legal, médico o de seguridad (machine-translation.md). - Nada arriesgado sale con un solo par de ojos. La norma ISO 17100 define un servicio de traducción como traducción más revisión por una segunda persona; cuando una segunda persona es imposible, el sustituto es una autoevaluación retrasada (al menos unas horas después, solo en el idioma de destino, ocultando el texto original) más una retrotraducción de los segmentos de riesgo: números, dosis, negaciones, obligaciones, plazos, nombres. Define qué segmentos son de riesgo antes de comenzar, no después (
quality.md).
¿Qué Se Rompe y Qué Significa?
Regla de decodificación: la capa que muestra el daño nombra la causa. Los caracteres distorsionados son bytes; la gramática incorrecta alrededor de un número es una regla de plural; una cadena que nunca cambia nunca fue extraída.
| Síntoma | Causa más probable | Primer paso |
|---|---|---|
é, ’, ñ | Bytes UTF-8 decodificados como Latin-1 en algún punto de la cadena | Encontrar el único salto que asume una codificación heredada; nunca "arreglar" volviendo a escribir caracteres (rtl-and-scripts.md) |
????? o _____ donde debería haber texto | Conversión con pérdida a un conjunto de caracteres de un solo byte, generalmente en un límite de base de datos o exportación | Conjunto de caracteres de columna y de conexión, luego reexportar desde el origen |
| Cuadros vacíos (tofu) o una cara alternativa de fuente | La fuente carece del sistema de escritura — un problema de representación, no de codificación | Verificar la cobertura de fuente para el sistema de escritura, no el archivo |
| La cadena permanece en inglés independientemente de la configuración regional | Nunca se extrajo, o el framework nunca recibió la configuración regional | Buscar la cadena literal en el código fuente; luego confirmar la configuración regional resuelta en tiempo de ejecución (software-strings.md) |
Bloqueo o %!s(MISSING) después de la traducción | El recuento o el orden de los marcadores de posición cambió en el destino | Verificación de paridad de marcadores de posición por segmento (Puertas de Salida); usar formas posicionales (%1$s) |
| Gramática incorrecta en 2, 21 o 101 elementos | Faltan las categorías CLDR del destino en el catálogo | Agregar las categorías faltantes a nivel de archivo (Regla 4) |
Texto coreano muestra 이(가) o 을(를) | Partícula elegida por la consonante final de la sílaba anterior, imposible con concatenación | Reescribir la frase para evitar la partícula, o usar un framework que flexione (locales.md) |
| La frase árabe termina con el punto a la izquierda | El algoritmo bidi funciona correctamente en texto... |