Cómo crear tu propio CRM para tu negocio, paso a paso

Por qué se rompen las apps armadas a la carrera

Hoy cualquiera arma una app con IA en una tarde, y en la demo funciona. El problema llega el día 30: cuando entra el segundo vendedor y ve la cartera completa del primero, cuando alguien borra lo que no debía y no hay cómo volver atrás, o cuando la URL le llega a quien no tenía que llegar.

Casi siempre es por lo mismo:

• Una API sin autenticación. El login existe en la pantalla, pero las rutas le responden a cualquiera que conozca la dirección.
• Claves en el frontend. La clave de un servicio queda en el JavaScript que descarga el navegador, y alguien la usa a tu nombre.
• SQL armado pegando texto. Alguien escribe algo raro en el buscador y ve datos ajenos.
• Roles que solo esconden botones. El servidor le responde igual a todos.
• Sin validación y sin respaldos. El primer dato raro da error, y el primer borrado masivo no tiene vuelta.
• Todo en un archivo de 2.000 líneas donde cada cambio rompe otra cosa, y sin manejo de errores: pantalla en blanco y datos guardados a medias.

La diferencia entre "la IA me hizo una app" y una app hecha como debe ser está en esas reglas, no en la pantalla. Esta skill las trae puestas.

Qué construye la skill

Tu CRM a la medida de tu negocio: contactos, embudo tipo kanban, notas, tareas y usuarios con roles. Todo en un solo Worker de Cloudflare con la API en /api, una base de datos D1, una app en React con Vite y Tailwind servida por ese mismo Worker y, más adelante, R2 para archivos. Un comando para publicar, una URL y ningún servidor que mantener.

La ruta es un MVP en 90 minutos, en ocho pasos. Cada uno termina funcionando, probado y guardado con un commit de git, y con un guion de prueba de un minuto para ti: "abre esto, toca aquello, deberías ver esto otro".

1. Descubrimiento. Qué reemplaza, quién lo usa, las etapas reales de tu embudo y qué quieres ver cada lunes. Sale la Ficha del CRM, que queda en CLAUDE.md para que cualquier sesión futura de Claude Code sepa qué se decidió.
2. Modelo de datos, explicado como hojas de Excel conectadas. El dinero va en centavos para que los totales nunca den 99,99, y nada se borra de verdad: se marca como borrado y se puede recuperar.
3. Esqueleto: el proyecto, la base local y un diseño que ya sirve en el celular, con barra lateral en escritorio y barra inferior en móvil.
4. Acceso seguro: contraseñas guardadas con hash, la sesión en una cookie que ningún script de la página puede leer, límite de intentos y los roles admin y vendedor decididos en el servidor.
5. Contactos y notas: una búsqueda que encuentra "José" aunque escribas "jose", filtros, línea de tiempo y borrar con opción de deshacer.
6. Embudo: una columna por etapa con cantidad y total en dinero. Mueves las tarjetas arrastrando o con un menú que funciona en el celular y con teclado.
7. Tareas y búsqueda: vencidas, de hoy y próximas, y un buscador global.
8. Revisión y despliegue: la lista de por qué se rompen las apps, punto por punto, la app en producción verificada y el primer respaldo.

Diseño para algo que abres veinte veces al día

Un CRM se abre veinte veces al día, muchas desde el celular y con prisa. La meta no es que se vea bonito en una captura: es que registrar una llamada tome diez segundos y que entiendas tu embudo de un vistazo.

La skill trae tokens de diseño con modo oscuro, el color de tu marca como único acento, estados pensados (cargando, vacío, error, sin permiso), confirmación antes de borrar, contraste accesible y botones del tamaño del pulgar. Y evita lo que delata una app genérica: degradados morados, la paleta por defecto de Tailwind, emojis como íconos y tarjetas dentro de tarjetas.

Para que no arranques de una hoja en blanco, trae además un dashboard de referencia con los patrones de xytask.com, la plataforma de operaciones que construimos sobre el mismo stack de Cloudflare: navegación por módulos, tablas con estados, vistas de kanban, lista y día, y gestión de usuarios con roles.

Paso 1. Instala la skill

Necesitas Node.js 22 LTS o más reciente, git (cada paso se guarda con un commit) y una cuenta de Cloudflare.

Descarga el archivo, descomprímelo y copia la carpeta dentro de tus skills:

~/.claude/skills/crm-propio/

En Windows es C:\Users\TU-USUARIO\.claude\skills\, con SKILL.md directo dentro de la carpeta.

Un dato honesto antes de empezar: para un CRM con login en producción te recomiendo el plan Workers Paid (5 dólares al mes por cuenta). El plan gratis limita el CPU a 10 ms por solicitud, y guardar contraseñas de forma segura gasta alrededor del doble, así que el login puede fallar con el error 1102. Si por ahora te quedas en el plan gratis, la skill trae un plan temporal, solo con datos de prueba, y te explica lo que cuesta en seguridad.

Paso 2. Pega este primer prompt

Abre Claude Code en una carpeta vacía y pega algo así, con los datos de tu negocio:

Usa la skill crm-propio. Quiero construir el CRM de mi negocio.

Mi negocio: inmobiliaria en Ciudad de Panamá, somos yo y 3 asesores.
Hoy uso: un Excel con nombre, teléfono, propiedad de interés, presupuesto, estado y notas.
Lo que más me duele: se nos olvida dar seguimiento y no sé cuánto dinero hay por cerrar.
Quién lo usa: yo como administrador y los asesores, casi siempre desde el celular.
Lo que quiero ver cada lunes: el dinero en cada etapa y las tareas vencidas por asesor.

Empecemos por el descubrimiento: hazme las preguntas que falten, de dos o tres a la vez.
Después muéstrame la Ficha del CRM y el plan por pasos. No escribas código hasta que te diga
"adelante". Explícame cada decisión en una frase sencilla y pídeme permiso antes de tocar mi
cuenta de Cloudflare.

Mientras construyes, usa datos de prueba inventados. Nunca pegues datos reales de tus clientes en el chat.

Qué tienes al final

El MVP está listo cuando pasa esta lista, y la skill te la hace probar:

• La app abre en tu URL de workers.dev y en el celular se usa sin hacer zoom.
• Sin sesión, la API responde 401: nadie lee tu cartera por conocer la dirección.
• Entran el admin y dos vendedores, y un vendedor no ve lo del otro, ni cambiando el número en la URL.
• Cada cambio de etapa queda en la línea de tiempo del contacto.
• La búsqueda encuentra con o sin tildes, y borrar pide confirmación y se puede deshacer.
• Hay un respaldo exportado y guardado fuera de la carpeta del proyecto.

Después del MVP, la skill trae los prompts listos para seguir: importar desde CSV, botón de WhatsApp, plantillas de mensajes, reportes, exportar a CSV, adjuntos, un resumen diario por correo y campos propios de tu negocio. Y cuando quieras que Claude consulte tu CRM directamente, el siguiente paso es crear un servidor MCP.

Errores típicos

• "En local funciona." Todo pasa en tu computadora y en producción falla el login: producción rechaza el hash de contraseña con más de 100.000 iteraciones y en local no falla, o la migración se aplicó en local y no en remoto. Por eso se verifica en producción después de cada despliegue.
• Abres una ruta de la API y te devuelve la app. La configuración de aplicación de una sola página atrapa todo; la API tiene que ir primero.
• Una importación grande revienta. D1 acepta 100 parámetros por consulta y 50 consultas por invocación en el plan gratis: se importa en lotes.
• Desplegaste, se cayó y el rollback no lo arregla. wrangler rollback regresa el código, no los datos. Por eso las migraciones solo agregan; lo viejo se limpia semanas después.
• El CRM deja de responder un día sin haber cambiado nada. Las cuotas gratis diarias son de toda la cuenta y otro proyecto puede agotarlas. Se reinician a las 00:00 UTC, que en Panamá son las 7:00 de la noche.

Para quién es

Para dueños de negocio con un equipo que da seguimiento a clientes: una inmobiliaria, una clínica, una agencia, una consultora. Para quien está cansado del Excel compartido que todos tocan y nadie actualiza. Y para quien ya armó una app con IA y quiere revisarla contra los quince motivos por los que se rompen: esa lista sola vale la descarga.

No es para quien quiere que se haga solo. Tú decides, pruebas y apruebas cada paso; Claude construye, explica y verifica. Así se hace bien.

Si prefieres hacerlo acompañado

En el taller presencial hay un bloque entero para esto: cómo se estructura una app por dentro, por qué se rompen las que se arman sin pensar, y montas la tuya. Si necesitas un CRM o una app interna para tu empresa, agenda una conversación y lo vemos con tu operación en la mano.