claudianus/toss-ux-writing-skill

Redacción UX estilo Toss

Usa esta habilidad para generar, reescribir o revisar microcopia de producto en coreano con un estilo inspirado en Toss. El objetivo no es suplantar a Toss ni copiar sus ejemplos originales; el objetivo es aplicar patrones reutilizables: '해요체' amigable, verbos activos, encuadre positivo primero, respeto casual y excepciones claras.

Contrato principal

Al mejorar una copia UX en coreano:

1. Usa '해요체' en todas partes. Evita el formal 합니다/됩니다/하십시오 y el 반말 (informal).
2. Prefiere redacción activa. Haz que el usuario, el producto o el objeto realicen la acción en lugar de depender de 되다/됐어요/되어요.
3. Encuadra positivamente primero. Di lo que el usuario puede hacer y bajo qué condición antes de decir lo que está bloqueado.
4. Mantén honoríficos casuales. Elimina el excesivo formalismo de ~시겠어요, 시나요, 셨나요, 께, 계시다, 여쭙다 a menos que aplique una excepción.
5. Desnominaliza. Reemplaza las rígidas combinaciones de {sustantivo}+{sustantivo} y sustantivos sino-coreanos por verbos, causas y acciones concretas.
6. Respeta las excepciones. No fuerces la positividad o la voz activa cuando la claridad legal/de políticas, la tranquilidad del usuario, el fin/vencimiento del servicio o la explicación de consecuencias requieran una oración pasiva o negativa.

Flujo de trabajo

1. Clasifica la superficie

Identifica dónde aparece la copia:

• Botón o CTA
• Diálogo / confirmación
• Toast / snack bar
• Mensaje de error / recuperación
• Estado vacío
• Etiqueta de formulario, texto de ayuda, validación
• Aviso de elegibilidad o recompensa de beneficio
• Restricción legal/de política
• Notificación/push
• Privacidad, consentimiento, grabación, uso de datos

Usa references/surface-patterns.md para los valores predeterminados específicos de la superficie.

2. Reescribe con las cinco transformaciones principales

Aplica las transformaciones en este orden:

1. Registro: convierte a '해요체'.
2. Agencia: convierte redacción pasiva/estativa a redacción activa.
3. Valencia: convierte negativos evitables en condiciones posibles.
4. Distancia: reduce la altitud de los honoríficos manteniendo el respeto.
5. Verbos: convierte pilas de sustantivos en verbos o cláusulas causales.

Usa references/vocabulary.md para patrones de reemplazo.

3. Verifica las compuertas de excepción

Antes de finalizar, pregúntate:

• ¿Es una restricción legal/de política/de producto estricta? Si es así, la redacción negativa puede ser más clara.
• ¿Se trata de fin de servicio, vencimiento de plazo, mora, cancelación, aplicación, registro, grabación o recopilación de información? Si es así, la redacción pasiva puede ser más clara.
• ¿La pregunta utiliza el contexto real del usuario, una situación inferida o pide buena voluntad/opinión? Si es así, se puede permitir 시나요/셨나요.
• ¿La redacción positiva podría hacer que el usuario malinterprete que todo el servicio no está disponible? Si es así, especifica el beneficio/función afectado.

Usa references/decision-tree.md.

4. Devuelve un resultado auditable

Para reescrituras, devuelve esta tabla:

원문	개선안	적용 규칙	예외 여부

Para tareas de generación, agrupa por superficie:

1. Copia principal
2. Copia secundaria/de ayuda
3. Etiquetas de CTA
4. Copia de error/vacío/recuperación si corresponde
5. Notas sobre riesgo, excepción o contexto faltante

Para auditorías, devuelve:

1. Veredicto general: 좋음, 수정 필요 o 위험
2. Hallazgos por severidad
3. Reescritura sugerida
4. Referencias a reglas

Reglas estrictas

• No uses 되어요; usa 돼요 si la voz pasiva se permite intencionalmente.
• En diálogos, prefiere el botón izquierdo 닫기 en lugar de 취소 a menos que la acción realmente cancele una operación iniciada por el usuario.
• Evita CTAs genéricos como 확인, 진행, 제출 cuando la acción se pueda nombrar.
• No culpes al usuario. Prefiere limitaciones del sistema/producto y próximos pasos.
• No ocultes restricciones legales/de políticas detrás de una redacción alegre.
• No afirmes que la copia generada es "copia oficial de Toss".
• No redistribuyas ni cites la guía completa de Toss. Resume los patrones y cita la fuente cuando sea necesario.

Patrones rápidos

¿Quieres cancelar la tarjeta?      → ¿Cancelamos la tarjeta?
Se ha configurado la notificación  → Configuré la notificación
No puedes registrarte hasta que el tutor lo apruebe → Puedes registrarte si el tutor lo aprueba
Pago fallido por saldo insuficiente → No pude pagar porque no hay suficiente saldo
¿Tienes coche?  → ¿Tienes coche?

Cuándo usarlo

• La copia de producto de una app/web coreana necesita un tono similar al de Toss.
• La redacción UX para errores, diálogos, botones, beneficios, onboarding, formularios, notificaciones o avisos de políticas se siente rígida.
• Un PR agrega cadenas de UI en coreano y necesita una revisión de estilo.
• Necesitas múltiples variantes en '해요체' amigable.
• Necesitas explicar por qué una frase en coreano se siente demasiado formal, pasiva, negativa o cargada de sustantivos.

Cuándo no usarlo

• Los términos legales deben reproducirse textualmente.
• La voz de la marca utiliza intencionalmente el formal 합니다체.
• La audiencia requiere honoríficos institucionales o de estilo gubernamental.
• La copia no está en coreano.
• Se te pide clonar la UI propietaria de Toss o copiar ejemplos oficiales completos.

Referencias

• references/tone-model.md — análisis profundo del modelo de voz.
• references/decision-tree.md — compuertas de decisión basadas en excepciones.
• references/vocabulary.md — patrones de reemplazo y antipatrones.
• references/surface-patterns.md — recetas de copia específicas para superficies de UI.
• references/examples.md — ejemplos sintéticos de antes/después.
• references/review-rubric.md — rúbrica de puntuación para auditorías.
• scripts/toss_style_lint.py — linter heurístico local.