Custodios
Kike Vázquez · Eduardo Nepote
DevZen Solutions
Filial de Nümia Group
📌 Internal handbook · DevZen Solutions
Cómo opera DevZen.
Este handbook es la referencia única de cómo operamos como organización. Si algo del día a día no aparece aquí, es señal de que aún no lo hemos formalizado — y vale la pena levantar el ticket para incorporarlo en la próxima versión.
📂 Cómo usar este handbook
- Antes de preguntarle a Kike algo del día a día, busca aquí primero. Si no está, levanta el ticket de handbook-change.
- Onboarding freelancer: handbook va con el Onboarding Pack v1.0. Se firma cada copia.
- Revisión trimestral: Kike + Eduardo revisan inconsistencias entre handbook y operación real.
- Versionado: patch / minor / major según § 7.
Si tienes que preguntarle a Kike algo dos veces, ese algo debería vivir en este handbook. Anchor cultural · uso del handbook
DevZen Solutions
Filial de Nümia Group
§ 1 · 📌
Qué es DevZen.
Posicionamiento institucional
DevZen Solutions es una software house premium · filial técnica de Nümia Group LTD · entidad legal independiente · opera con su propio P&L. Construimos plataformas, sistemas y automatizaciones a la medida para PYMEs y mid-enterprise en LATAM.
Para quién
Fundadores, COOs y directores de tecnología en LATAM que dejaron de querer "una agencia más" — quieren un equipo que entienda su negocio, proponga, y construya software que aguante el crecimiento.
Contra qué
Contra el outsourcing barato que entrega código que nadie puede mantener. Contra los freelancers que desaparecen al go-live. Contra las consultorías grandes que cobran enterprise y entregan PowerPoint. Contra el "ya quedó" sin pruebas, sin documentación, sin handoff.
Las 5 promesas · operativas, no decorativas
1
Superioridad técnica.
La calidad del código no se negocia. Lo que entregamos es lo que nosotros usaríamos en producción.
2
AI-first.
Automatizamos lo que se puede automatizar. El equipo humano se enfoca en lo que solo un humano debe decidir.
3
Sensibilidad de negocio.
Cada decisión técnica se justifica en margen, tiempo, riesgo o flujo. ROI antes que stack.
4
Estrategia, no ejecución ciega.
Si la idea inicial no es la correcta, lo decimos antes, no después.
5
Llevarlo al siguiente nivel.
El cliente sale más grande, más eficiente y más automatizado de lo que entró.
Master tagline · LOCKED
Tu empresa no es plantilla. Tu software tampoco.
Campaign tagline · LOCKED
Diseñamos dentro de tu negocio, no fuera.
DevZen Solutions
Filial de Nümia Group
§ 2 · 🛠
Quién hace qué.
Matriz de responsabilidades por rol. Si un asunto no encaja en ninguno, escala a co-decisión.
| Responsabilidad | Kike · CEO/CTO | Eduardo · COO/CFO | Freelancer activo |
|---|---|---|---|
| Arquitectura técnica | Lead | Informado | Aporta · review |
| Decisiones de stack | Lead | Informado | Propone con justificación |
| Code review senior | Lead | — | Peer review entre freelancers |
| Interlocución cliente senior | Lead | Co-presente | No · vía Kike/Eduardo |
| Operación de pipeline | Informado | Lead | — |
| Administración + facturación | Informado | Lead | — |
| Seguimiento freelancers | Co-decide | Lead | — |
| Cierre comercial <$50K USD | Review final | Lead | — |
| Cierre comercial ≥$50K USD | Lead | Co-firma | — |
| Firma SOW | Firma | Co-firma operativa | — |
| Ejecución técnica | Supervisa | — | Lead según asignación |
| Sprint review semanal | Review | Distribuye al cliente | Redacta |
| Decisiones de marca / voice | Custodio | Aplica | Aplica |
| Escalación a cliente | Co-decide | Primer respondiente | Reporta interno |
Regla de co-decisión
Si una decisión cae entre dos columnas o no encaja en ninguna, se discute en la reunión semanal Kike + Eduardo (lunes 10:00). Sin co-discusión, no hay co-decisión.
DevZen Solutions
Filial de Nümia Group
§ 3 · 📊
Cómo decidimos.
Las 5 promesas no son aspiracionales — son criterios de decisión operativa concretos. Si un PR, propuesta o entregable no pasa estos filtros, no sale.
1
Superioridad técnica · operativa.
Regla dura: ningún PR mergea sin tests pasando + documentación actualizada + runbook si aplica. Cero excepciones bajo presión de tiempo.
2
AI-first · operativa.
Regla dura: si una tarea se repite 2+ veces a mano, se automatiza antes de la 3ª. Levantar ticket de automatización tú mismo · no esperar permiso.
3
Sensibilidad de negocio · operativa.
Regla dura: toda propuesta lleva "Recomendamos X porque Y" + impacto en métrica del cliente (horas/semana · % costo · días de ciclo · tickets). Sin número, no es recomendación — es opinión.
4
Estrategia, no ejecución ciega · operativa.
Regla dura: si el ticket no tiene sentido para el negocio del cliente, se dice antes de empezar. No "implementamos y veremos".
5
Llevarlo al siguiente nivel · operativa.
Regla dura: el cierre de proyecto incluye sugerencia de Fase 2 cuando aplique — articulada en el lenguaje del cliente, no en lenguaje técnico.
Recomendamos X porque Y. Frase firma · estructura de toda recomendación
DevZen Solutions
Filial de Nümia Group
§ 4 · 📂
Procesos canónicos · dónde viven.
Cada proceso DevZen tiene template canónico documentado. Si necesitas ejecutar uno, abre el template correspondiente — no improvises desde cero.
| Proceso | Template canónico | Responsable lead |
|---|---|---|
| Lead → Cotización | DevZen-Lead-to-Cotizacion-Runbook-v1.0.html | Eduardo · Kike review |
| Cold outreach · objections | DevZen-Outbound-Playbook-v1.0.html | Eduardo · Kike |
| Discovery pre-call | DevZen-Discovery-Questionnaire-v1.0.html | Cliente llena |
| Discovery call | DevZen-Discovery-Call-Deck-v1.0.html | Kike conduce |
| Pitch deck cliente | DevZen-Pitch-Deck-Agencia-v1.0.html | Adjuntar post-discovery |
| Cotización + propuesta | DevZen-Aplicaciones-Operativas-v1.0.html | Eduardo · Kike review |
| Contratos | NDA-Mutuo · MSA · SOW · DPA | Kike firma · Eduardo gestiona |
| Kickoff freelancer | DevZen-Freelancer-Onboarding-Pack-v1.0.html | Eduardo envía · Kike kickoff |
| Sprint operativo · semanal | DevZen-Sprint-Review-Template-v1.0.html | Freelancer redacta |
| Cierre proyecto · handoff | DevZen-Project-Runbook-Template-v1.0.html | Kike redacta · Eduardo entrega |
| Case study post-cierre | DevZen-Case-Study-Questionnaire-v1.0.html | Cliente llena · Eduardo procesa |
| Programa de referidos | DevZen-Referral-Program-v1.0.html | Eduardo envía |
| Incidentes producción | DevZen-Incident-Response-Playbook-v1.0.html | Kike · Eduardo + status page |
| Job post freelancer | DevZen-Job-Post-Freelancer-Template-v1.0.html | Eduardo publica |
| Brand & system reference | Constitution v1.0 · Tokens v1.0 | Kike custodio |
Regla de oro
Si vas a ejecutar un proceso recurrente y NO encuentras template, no improvises — levanta ticket de creación de template, ejecuta esta vez con notas detalladas, y la próxima versión del handbook lo incorpora.
DevZen Solutions
Filial de Nümia Group
§ 5 · 🛠
Cómo hablamos internamente vs cliente-facing.
| Eje | Slack/Discord interno | Email · doc · propuesta cliente |
|---|---|---|
| Pronombre | tú / nosotros | usted (default · cliente baja a tú si quiere) |
| Casing | sentence case + abreviaciones | sentence case · sin abreviaciones |
| Emoji | permitidos · neutros (📌 📂 🛠 📊 ✅) | cero emoji |
| Tono | informal pero preciso | formal pero humano |
| Jerga | libre (PR, deploy, SLA, runbook, mergear) | inglés solo si aclara · definir primera aparición |
| Exclamaciones | permitidas con criterio | cero |
Frases firma operativas · usar 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.Reporte de riesgos · sprint review · incidentes
Lo que entregamos hoy es lo que usaríamos en producción mañana.Cierre cultural · garantía técnica
Palabras prohibidas en cliente-facing
"Solución integral 360°" · "Llave en mano" · "Transformación digital" · "Sinergia" · "Disrupción / disruptivo" · "Best in class" · "De clase mundial" · "Súper / mega / ultra X" · "Lo más rápido posible" · "Estamos emocionados" · "Cualquier cosa nos avisa" · franglish-cute (developear · releasear · mergear).
Si una palabra prohibida aparece en draft, es señal de revisión. Referencia: VOCABULARY.md.
DevZen Solutions
Filial de Nümia Group
§ 6 · 📊
Cómo medimos.
DevZen opera con cuatro categorías de métricas internas. Revisión semanal Kike + Eduardo · revisión mensual con tablero · revisión trimestral estratégica.
Pipeline
Leads inbound/mes · % conversión lead → discovery · % conversión discovery → SOW firmado · ciclo medio lead-to-SOW (target {DIAS_LEAD_SOW} días).
Delivery
% proyectos en tiempo · % proyectos en presupuesto · NPS post-cierre · # incidentes SEV-1/SEV-2 por proyecto · uptime % por cliente activo.
Financiero
MRR (de SaaS managed services) · revenue por proyecto · costo por proyecto · margen bruto · DSO (días promedio de cobro).
Equipo
# freelancers activos · % capacidad utilizada · tarifa media interna · % retención freelancer post-proyecto · rotación.
Cadencia de revisión
| Frecuencia | Qué se revisa | Quién asiste |
|---|---|---|
| Semanal · lunes 10:00 | Status pipeline + sprints activos + bloqueadores | Kike + Eduardo |
| Mensual · primer lunes | Tablero completo · 4 categorías · acciones para el mes | Kike + Eduardo + freelancers activos invitados |
| Trimestral · revisión estratégica | Tendencias 3 meses · ICP · pricing · capacidad · roadmap interno | Kike + Eduardo |
Lo que no se mide, se improvisa. DevZen no improvisa. Anchor cultural · § medición
DevZen Solutions
Filial de Nümia Group
§ 7 · ✅
Governance del handbook.
Cuándo se actualiza, quién decide, y cómo se versiona. Referencia: GOVERNANCE.md del sistema v2.1.
| Tipo | Versión | Cuándo aplica | Aprobación |
|---|---|---|---|
| Patch | v1.0.1 · v1.0.2 | Corrección de typo · ajuste menor · clarificación que no cambia significado. | Custodio sólo |
| Minor | v1.1 · v1.2 | Nuevo proceso documentado · nueva regla · nueva sección. Aviso al equipo. | Kike + Eduardo |
| Major | v2.0 | Cambio en valores · roles · estructura. Requiere período de coexistencia de 1 mes con v1.x. | Kike + Eduardo + revisión consensuada |
Cómo proponer un cambio
- Levantar ticket en
{SISTEMA_TICKETS}con labelhandbook-change. - Incluir: sección afectada · cambio propuesto · razón · impacto operativo estimado.
- Revisión semanal de tickets de handbook en el slot lunes 10:00.
- Si aprobado: actualización + bump de versión + aviso al equipo + commit a repo del handbook.
Custodios
Kike Vázquez · lead
Eduardo Nepote · co-custodio
Frecuencia mínima de revisión
Cualquier inconsistencia entre handbook y operación real se atiende en máx 1 mes · si no, el handbook pierde autoridad operativa.
DevZen Solutions
Filial de Nümia Group
§ 8 · 📌
Cierre.
Este handbook es el contrato interno de cómo opera DevZen. Si lees algo que no se parece a la realidad de tu día a día, o detectas una contradicción entre dos secciones, levanta el ticket — esa es la mejor contribución que puedes hacer al equipo.
DevZen es lo que documentamos. Si no está aquí, no es DevZen — es improviso. Anchor cultural · § cierre del handbook
Aceptación interna
Cada miembro activo del equipo DevZen firma su copia del handbook en el onboarding y en cada major bump (v2.0+). Las firmas viven en el repo del handbook.
Kike Vázquez
CEO / CTO · custodio
Fecha: {FECHA_ADOPCION}
Eduardo Nepote
COO / CFO · co-custodio
Fecha: {FECHA_ADOPCION}
{FREELANCER_NOMBRE}
Freelancer activo
Fecha: {FECHA_FIRMA_FREELANCER}
Disclaimer
Template DevZen v1.0 · Documento interno operativo · No se distribuye a cliente · Toda enmienda se versiona conforme § 7 del presente handbook y al GOVERNANCE.md del sistema v2.1.