Reformatea un proyecto Next.js (y NestJS)
Trabaja en los pasos en orden. Cada paso termina con una comprobación: ejecútala, corrige lo que encuentre, y solo entonces continúa. COMPROBAR significa este comando, desde la raíz del proyecto:
node ${CLAUDE_SKILL_DIR}/scripts/rebrand-check.mjs check \
--old "Nombre Antiguo" --old "Nombre antiguo en cada otro script" \
--new "Nombre Nuevo" --new "Nombre nuevo en cada otro script"
Añade --case cuando el nombre antiguo sea una palabra común (TIENDA), y --allow <ruta> para un
archivo que conserve intencionadamente el nombre antiguo. Nunca ejecutes una búsqueda y reemplazo a ciegas.
0. Resumen, mapeo y línea base
- Escribe el nombre antiguo en cada forma que use el proyecto (cada idioma, slug, dominio de correo) y el nombre nuevo en cada idioma, el color de la marca, los archivos de logotipo y el tono. Si la solicitud omite alguno, elige un valor sensato, continúa y enumera la elección en el informe.
- Ejecuta
node ${CLAUDE_SKILL_DIR}/scripts/rebrand-check.mjs map. - Ejecuta el comando de compilación de cada aplicación del mapeo una vez, antes de realizar cualquier edición.
Comprobación: tienes el mapeo, un recuento de COMPROBAR para reducir, y un resultado para cada compilación. Una compilación que ya fallaba se anota como no causada por el cambio de marca.
1. Nombres y logotipo
Archivos de configuración de la marca, el componente de logotipo, el manifiesto de la aplicación web y cualquier fila de configuración que los datos semilla escriban (un nombre de remitente de correo suele estar ahí). Deja los nombres de paquetes, variables de entorno, nombres de bases de datos, volúmenes Docker y prefijos de almacenamiento a menos que se te pida lo contrario: cambiarlos rompe instalaciones y datos existentes.
Comprobación: COMPROBAR muestra 0 aciertos en "configuración de marca". Los aciertos de infraestructura que mantengas irán en el informe.
2. Colores
Tokens de marca en los archivos de tema que enumera el mapeo, tanto claro como oscuro, además del color del tema del navegador en el manifiesto o la ventana gráfica. No se escribe ningún color en un componente.
Comprobación: COMPROBAR con --old "#hexviejo" para cada color de marca antiguo muestra 0 aciertos, y el texto
sobre el nuevo color mantiene un contraste 4.5:1 en ambos temas.
3. Archivos de logotipo e icono
Reemplaza el logotipo tipográfico, la marca, el favicon, los iconos de la aplicación y la imagen para compartir que enumera el mapeo. Mantén los nombres y tamaños de archivo, o actualiza cada referencia. Abre cada archivo nuevo y míralo.
Comprobación: COMPROBAR informa 0 rutas de imagen faltantes en public/, y ningún nombre de archivo o carpeta con el nombre antiguo excepto aquellos que mantengas intencionadamente.
4. Textos en cada locale
Reescribe, no solo renombres: texto principal, acerca de, pie de página, legales, soporte, SEO y cualquier frase que describa el negocio anterior. Mismas claves en cada locale, cada idioma escrito nativamente.
Comprobación: COMPROBAR muestra 0 aciertos en "mensajes", y ningún archivo de locale o mensaje tiene el nombre nuevo en un idioma pero no en otro.
5. Metadatos y SEO
Raíz y diseños de página, generateMetadata, plantillas de título, campos Open Graph y Twitter,
JSON-LD, sitemap, robots, name y short_name del manifiesto.
Comprobación: COMPROBAR muestra 0 aciertos en "metadatos y SEO".
6. Correos electrónicos
Nombre del remitente, asuntos, encabezado y pie de página, enlaces, en cada idioma que la API envíe. La dirección del remitente y el dominio provienen de las variables de entorno: enuméralos en el informe.
Comprobación: COMPROBAR muestra 0 aciertos en "correos electrónicos".
7. Datos semilla y de prueba
Seeders, fixtures y catálogos de prueba: productos, categorías, filas de configuración, dominios de correo de cuentas de demostración, rutas de imágenes. Los datos semilla de la API y cualquier dato de prueba del frontend coinciden.
Comprobación: COMPROBAR muestra 0 aciertos en "datos semilla".
8. Compilación y comprobación final
Vuelve a ejecutar el comando de compilación de cada aplicación. Corrige errores hasta que cada una pase. No inicies un servidor de desarrollo o producción a menos que se te pida.
Comprobación: cada compilación sale con código 0, luego COMPROBAR imprime Resultado: APROBADO.
Informe
Archivos modificados por paso, las elecciones realizadas para cualquier cosa que el resumen omitió, cada acierto permitido y por qué, los resultados de la compilación y lo que queda para una persona: dominio, DNS, remitente de correo, textos legales.