¿Qué hace Swap Brand?
Propósito
Hacer que el producto sea claramente propio: un nuevo nombre, apariencia y voz decididos desde el principio, y una revisión mecánica antes del lanzamiento que busca en los archivos de texto del código el nombre, dominio y colores del original. Es una verificación acotada, no una prueba: cualquier cosa que no pueda leer, y todo lo que no busque, aún necesita una persona.
Pista completa (venta), pasos 5 (identidad) y 12 (revisión). Lee swap/market.md, swap/recon.md; escribe swap/brand.md, swap/sweep.json.
Tabla de Enrutamiento de Contexto
| Fuente | Dónde | Qué extraer |
|---|---|---|
| Mercado | swap/market.md | Ángulo, audiencia, la brecha evidenciada |
| Reconocimiento | swap/recon.md | El nombre del original, sus dominios, colores de marca (qué evitar) |
| El usuario | Sus preferencias, marca existente, dominios que posee | Restricciones y gusto |
| El código | El repositorio del producto | Lo que escanea la revisión |
Inicio Rápido
Fase de identidad: 1) enumerar qué evitar del reconocimiento; 2) proponer 5 candidatos de nombre vinculados al ángulo; 3) dar las verificaciones a realizar para cada uno; 4) establecer paleta, voz y brief de logo; 5) escribir swap/brand.md.
Fase de revisión: ejecutar python3 -I <carpeta-habilidad>/scripts/sweep.py <repo> --avoid "<nombre original>" --domain <dominio original> --color "<color original>" --exclude swap --json swap/sweep.json desde la raíz del proyecto ( es la carpeta de esta habilidad), arreglar cada coincidencia, volver a ejecutar hasta que quede LIMPIO.
Flujo de Trabajo
- Lista de evitar primero. Del reconocimiento: el nombre del original y cualquier nombre de producto, sus dominios, sus colores de marca, sus eslóganes distintivos. Escríbelos en
brand.mdbajo## Evitar; la revisión no lee ese archivo, así que pasa cada elemento explícitamente como banderas--avoid,--domainy--color. - Candidatos de nombre (5). Cada uno: el nombre, la idea detrás de él, y por qué un cliente no lo confundiría con el original. Ningún nombre que contenga, abrevie o suene igual al del original. No hay "X para Y" construido sobre el nombre del original.
- Verificaciones que el usuario realiza antes de confirmar (Claude no puede verificar la disponibilidad): una búsqueda de marca registrada en el mercado del usuario (registro nacional e internacional), una verificación de dominio y de handles en redes sociales, una búsqueda en tiendas de aplicaciones, y una búsqueda web simple del nombre más la categoría. Registra la fecha y el resultado de cada una. Un conflicto elimina al candidato.
- Identidad. Una paleta claramente diferente de la del original (diferente familia de tonos, no un matiz de ella), una combinación de tipografías de fuentes abiertas o con licencia, una voz en 5 reglas con un hacer y un no hacer cada una, y un brief de logo que ejecuta el usuario o un diseñador. No describas un logo que imite la forma o el concepto del original.
- La revisión (antes del lanzamiento, y de nuevo después del último cambio de código). Ejecútala con la lista de evitar. Encuentra nombres dentro de identificadores (
OriginalAppEmbed,original_app), dominios, valores de color en hexadecimal y rgb, y nombres de archivo o carpeta. Arregla reemplazando, no ocultando. Usa--allowsolo para palabras más largas inofensivas y lista cada uso enbrand.md. La revisión imprime el texto coincidente, el archivo y la línea, nunca el resto de la línea. - Más allá del código. La revisión solo lee archivos de texto. Las imágenes, fuentes, archivos comprimidos, archivos de más de 2 MB y archivos no legibles se listan como no escaneados, y la ejecución NO está LIMPIA mientras exista alguno. Verifica cada uno manualmente (capturas de pantalla, datos de muestra, metadatos, plantillas de correo electrónico, texto alternativo), luego vuelve a ejecutar con
--accept-skipped, lo que registra ensweep.jsonque lo hiciste.--accept-skippednunca oculta una coincidencia.
Anti-Racionalización
| Lo que Claude podría pensar | Por qué está mal |
|---|---|
| "Es una construcción en sala limpia, no necesita renombrarse" | La sala limpia cubre el código. Un nombre o apariencia que confunda a los clientes es un problema aparte. |
| "Suficientemente parecido al original ayuda a que nos encuentren" | La similitud confusa es el riesgo de marca. Distinto a propósito. |
| "La revisión solo encontró un comentario, ignóralo" | Un comentario que nombra al original se incluye en el paquete. Elimínalo. |
| "Verifiqué que el nombre está libre" | Solo una búsqueda en el registro por parte del usuario muestra eso. Registra quién lo hizo y cuándo. |
| "Saltar imágenes y capturas de pantalla" | La revisión no puede leerlas. Revísalas manualmente y di que lo hiciste. |
Formato de Salida
EXACTO. Encabezados de swap/brand.md en orden: ## Evitar, ## Candidatos de nombre (cada uno con idea y verificaciones realizadas, con fechas y resultados), ## Nombre elegido, ## Paleta y tipografía, ## Voz, ## Brief de logo, ## Registro de revisión (cada ejecución: comando, coincidencias, arreglos). swap/sweep.json es la salida del script sin editar.
Salida de Referencia (ejemplo inventado, abreviado):
## Nombre elegido
Skyline. Búsqueda de marca (Reino Unido, UE, EE.UU.): aún no ejecutada. Búsqueda de dominio y tienda: aún no ejecutada.
## Registro de revisión
Ejecución 1: 7 coincidencias (nombre x4, dominio x1, color x1, ruta x1). Reemplazadas todas.
Ejecución 2: LIMPIO, 4 archivos escaneados, 0 no escaneados.
Reglas
- Nombre, paleta, logo, palabras originales. Nunca el logo, marcas registradas, copia o activos del original, en ninguna forma.
- No afirmes que un nombre está disponible o es registrable; eso es verificación del usuario y decisión de un abogado.
- Nunca edites
sweep.jsonmanualmente.
Enrutamiento entre Habilidades
Identidad elegida -> swap-architect luego swap-design (que toma la paleta de aquí). Revisión LIMPIA -> swap-launch. Si la revisión nunca pasa debido a un activo propiedad de un proveedor en el producto -> elimina el activo; no lo incluyas en la lista de permitidos.
Lista de Verificación de Salida
Bloque de prueba con evidencia; luego "no se pudo verificar".
Fase de identidad (antes de que haya código):
-
## Evitarenumera el nombre del original, su(s) dominio(s) y al menos un color de marca - Cada candidato de nombre tiene las cuatro verificaciones registradas con una fecha, o dice "aún no ejecutada"
- Paleta, voz y brief de logo están escritos y difieren de los del original
Fase de revisión (antes del lanzamiento, y de nuevo después del último cambio de código):
-
swap/sweep.jsontiene"passed": true, de una ejecución posterior al último cambio de código - El comando de revisión usó
--exclude swap(o escaneó un árbol sin las notas); cada archivo no escaneado fue verificado manualmente yskipped_acceptedestá en verdadero, o la lista está vacía - Cada uso de
--allowestá listado en el registro de revisión - Las capturas de pantalla, copia y metadatos fueron verificados manualmente y se le dijo al usuario que la revisión no puede leerlos
Auto-Mejora
Después de cada ejecución, preguntar una vez: "¿Algún comentario que capturar para esta habilidad?" Silencio o no significa que nada cambia. Si sí: redactar el patrón, mostrarlo, agregarlo a references/learnings.md solo después de un sí; "actualizar la habilidad" muestra la edición exacta, confirma, escribe, aumenta metadata.version y registra una línea. Nunca promocionar un patrón registrado en este archivo en la misma sesión en que fue capturado. Después de la primera ejecución, nombrar los archivos incluidos utilizados y cualquier cosa creada desde cero que se necesitará de nuevo, y ofrecer guardarla (con la misma restricción).