Bienvenido al equipo DevZen.
Este documento es tu manual de operación durante el proyecto. Tómate 30 minutos para leerlo completo antes del kickoff. Si algo no queda claro, pregunta directo a Kike — no asumas.
- § 1 — Cómo operamos. Las 5 promesas DevZen aterrizadas a tu día a día.
- § 2 — Cómo hablamos. Brand voice · pronombres · frases firma · anti-patterns.
- § 3 — Ritmos y entregas. Sprint cadence · status update · code review · comunicación cliente.
- § 4 — Herramientas y accesos. Stack interno · reglas de seguridad · manejo de credenciales.
- § 5 — NDA freelancer. Mini-NDA compacto · 8 cláusulas · firmable.
- § 6 — Checklist día 1. 9 items para arrancar el proyecto sin fricción.
Buscamos personas que sigan diciendo "Recomendamos X porque Y" cuando ya nadie las está escuchando. DevZen · cultura técnica
Cómo operamos.
Las cinco promesas DevZen ratificadas en el manifiesto. Aquí no van como filosofía abstracta — van con su aterrizaje práctico a tu día a día como freelancer del equipo.
La calidad del código no se negocia. Lo que entregamos es lo que nosotros usaríamos en producción.
Tu día a día: no se entrega código sin tests · sin documentación · sin runbook. Cada PR pasa code review antes de merge.Automatizamos lo que se puede automatizar. El equipo humano decide lo que solo un humano debe decidir.
Tu día a día: si una tarea repetitiva puede automatizarse, se automatiza antes de hacerla manual la segunda vez. Levanta el ticket de automatización tú mismo.Cada decisión técnica se justifica en margen, tiempo, riesgo o flujo.
Tu día a día: toda recomendación se cierra con "Recomendamos X porque Y" donde Y contiene un número o un riesgo concreto.Si la idea inicial no es la correcta, lo decimos antes, no después.
Tu día a día: si el ticket no tiene sentido para el negocio del cliente, lo dices antes de empezar. No "implementas y veremos".El cliente sale más grande, más eficiente y más automatizado de lo que entró.
Tu día a día: cada PR debería mover al cliente en esa dirección. Si un cambio solo "deja igual", probablemente sobra.Cómo hablamos.
La voz no es preferencia · es contrato. Aplica a tus PRs, tus mensajes en Slack, tus notas en tickets y cualquier comunicación al cliente cuando esté autorizada.
Pronombres y casing.
| Contexto | Forma |
|---|---|
| Con cliente | usted · formal |
| Con equipo DevZen | tú · informal preciso |
| Headers | sentence case · nunca Title Case |
| Emoji | permitidos internamente · cero en cliente-facing |
Vocabulario · sí / no.
| Sí decimos | No decimos |
|---|---|
| Construimos · desarrollamos | Hacemos · armamos |
| Plataforma · sistema | App (excepto móvil) |
| Recomendamos | Sugerimos · creemos |
| Ingeniero · equipo de ingeniería | Programador · coder · dev (con cliente) |
| Construir · publicar · integrar | Developear · releasear · mergear |
Frases firma DevZen · úsalas literal.
Recomendamos X porque Y.Estructura de toda recomendación
Fuera de alcance: …Línea de cierre de todo scope
Riesgo identificado · Mitigación · Owner.Cómo se reporta un riesgo
Lo que entregamos hoy es lo que usaríamos en producción mañana.Cierre cultural
Anti-patterns · reglas duras.
Developear · releasear · mergear · franglish-cute en general. Excepción interna en Slack: PRs y mergear son aceptables. Con cliente: nunca.
"Estamos súper emocionados" · "Solución integral 360°" · "Llave en mano" · "Transformación digital" · "Sinergia" · "Disrupción".
"Lo más rápido posible" · "Muy pronto" · "Súper fácil" · "Cualquier cosa nos avisa". Sustituir por fechas y siguiente paso explícito.
Cero exclamaciones cliente-facing · cero Title Case · cero emoji en propuestas, contratos o entregables. Internamente se permiten emoji neutros (📌 📂 🛠 📊 ✅).
Ritmos y entregas.
Sprints de 2 semanas. Planning lunes, demo viernes, retro al cierre. Tickets vivos en Linear/Notion del proyecto.
Sprint Review template DevZen cada viernes. Si surge bloqueador antes, levantarlo inmediato en #proyecto-{cliente} de Slack/Discord.
Todo PR requiere review de Kike o senior asignado. Sin merge directo a main. Tests pasando + documentación actualizada antes del merge.
El freelancer no contacta al cliente directamente salvo autorización explícita. Todo va vía Kike o Eduardo. La interfaz con cliente es DevZen.
Si vas atrasado, dilo el viernes, no el lunes siguiente. Si descubres un bug en algo ya entregado, repórtalo antes de que el cliente lo encuentre. "Lo que entregamos hoy es lo que usaríamos en producción mañana" aplica también a admitir errores.
Herramientas y accesos.
| Herramienta | Para qué | Acceso |
|---|---|---|
| GitHub | Repos del proyecto · branch protections activadas | Invitación por SSO + MFA |
| Slack / Discord | Canal #proyecto-{cliente} · standups asíncronos | Invitación al workspace DevZen |
| 1Password | Credenciales compartidas del proyecto | Vault acceso por proyecto |
| Linear / Notion | Tickets · documentación · roadmap | Member del workspace |
| Figma | Diseño si aplica · view-only por default | Según rol del proyecto |
| Vercel / Cloudflare | Deployment · preview environments | Según rol del proyecto |
Credenciales del cliente nunca se comparten fuera del 1Password vault del proyecto. Datos del cliente nunca se copian a equipos personales sin cifrar. Si manejas datos sensibles (clínicos · financieros · biométricos), aplica el DPA · Anexo B del MSA. Reportar incidente de seguridad inmediato a kike@numia.group · máximo 72h para reporte formal.
NDA freelancer · mini.
Acuerdo compacto firmable. Coherente con — y subordinado a — el NDA Mutuo DevZen-Cliente v1.0 cuando aplica. Las Partes: DevZen Solutions (Parte A) y {NOMBRE_FREELANCER} (Parte B · "el Freelancer").
Se considera Información Confidencial toda información, en cualquier soporte, que DevZen o sus clientes compartan con el Freelancer con motivo del proyecto: código fuente, arquitectura, credenciales, datos de cliente, propuestas comerciales, runbooks, métricas operativas, contratos y comunicación interna.
El Freelancer se obliga a usar la Información Confidencial únicamente para la ejecución del proyecto acordado. Ningún uso comercial propio, ni reutilización en otros clientes, ni publicación parcial (blog, redes, portfolio público) sin autorización previa y por escrito de DevZen.
El Freelancer no divulgará la Información Confidencial a terceros, incluyendo otros clientes propios, sin autorización previa y por escrito de DevZen. La obligación se extiende a personal subcontratado por el Freelancer, quienes deberán firmar acuerdos equivalentes.
Durante la vigencia del proyecto y por un periodo de doce (12) meses posteriores a su término, el Freelancer no podrá contratar ni ser contratado directamente por el cliente final del proyecto sin autorización previa y por escrito de DevZen.
La obra entregada por el Freelancer a DevZen en el marco del proyecto se considera work-for-hire · propiedad de DevZen al pago completo. DevZen, a su vez, licencia los entregables al cliente conforme al MSA firmado con éste. El Freelancer renuncia a derechos morales en los entregables específicos del proyecto, conservando autoría sobre técnicas y patrones generales aplicables a futuros trabajos para otros clientes.
Las obligaciones de confidencialidad subsisten por tres (3) años posteriores al término del proyecto. Información sensible bajo categoría de secreto industrial: vigente mientras mantenga dicha calidad.
Al término del proyecto, el Freelancer devuelve o destruye toda Información Confidencial en su poder, incluyendo copias locales, exports, y derivados, dentro de los diez (10) días hábiles siguientes. Certificación escrita de destrucción a solicitud de DevZen.
El presente acuerdo se rige por las leyes de los Estados Unidos Mexicanos. Para su interpretación y ejecución, las Partes se someten a los tribunales competentes de {ENTIDAD_FEDERATIVA}. Precedencia: en caso de conflicto con el NDA Mutuo DevZen-Cliente, prevalece el NDA Mutuo.
Checklist día 1.
Nueve items para arrancar el proyecto sin fricción. Marca cada uno al completar. Si algo te toma más de 30 minutos sin avanzar, escribe a Kike.
- Leer este onboarding pack completo. 30 minutos. Sin saltar la sección de brand voice.
- Firmar el NDA freelancer. Página anterior · firma digital o física, devolver escaneado a kike@numia.group.
- Recibir invitación a GitHub. Confirmar acceso a repos del proyecto y permisos correctos · clonar repo principal.
- Recibir credenciales del 1Password vault. Acceso al vault del proyecto · validar que puedes leer las entradas críticas.
- Unirse al canal Slack/Discord. #proyecto-{CLIENTE} · presentarte brevemente en el thread de bienvenida.
- Setup de ambiente local. Clonar repo · instalar dependencias · correr tests · confirmar que pasan en verde.
- Leer README y runbook del proyecto si ya existen. Anotar dudas para el kickoff.
- Agendar kickoff de 30 minutos con Kike (más PM del cliente cuando aplique). Confirmar fecha por email.
- Confirmar tarifa, modalidad de factura y datos fiscales para emisión de invoice mensual.
Buscamos personas que sigan diciendo "Recomendamos X porque Y" cuando ya nadie las está escuchando. DevZen · cultura técnica