CtrlK
BlogDocsLog inGet started
Tessl Logo

metodologia-staff-augmentation-discovery

Staff augmentation discovery — talent gap analysis, skills matrix profiling, team composition modeling, onboarding and ramp-up design, retention framework, and staffing roadmap. Use when the user asks to "assess staffing needs", "analyze talent gaps", "design team composition", "plan staff augmentation", "evaluate team skills", "create staffing roadmap", "onboarding plan", "ramp-up strategy", "retention framework", or mentions talent gap, skills matrix, team topology, augmentation, nearshore, offshore, or staffing plan.

SKILL.md
Quality
Evals
Security

Staff Augmentation Discovery — Talent Gap Analysis & Staffing Roadmap

Genera un análisis integral de necesidades de staff augmentation que cubre talent gap analysis, skills matrix profiling, team composition modeling, onboarding & ramp-up design, retention framework, y staffing roadmap. Diseñado para engagements donde el cliente necesita aumentar su capacidad con profesionales externos, ya sea nearshore, offshore, o on-site.

Principio Rector

El staff augmentation no es llenar sillas — es construir capacidad. Cada profesional añadido debe multiplicar, no solo sumar, la capacidad del equipo.

  1. Capacidad sobre headcount. El número de personas es una métrica vanidosa. Lo que importa es la capacidad de entrega: velocidad, calidad, y sostenibilidad. Un senior bien integrado aporta más que tres juniors sin onboarding.
  2. Integración antes que incorporación. Añadir talento sin plan de integración crea fricción, no productividad. El onboarding, mentoring, y acceso a herramientas determinan el time-to-productivity más que la experiencia previa.
  3. Retención es la mejor estrategia de staffing. El costo de reemplazar un profesional (recruiting + onboarding + ramp-up + knowledge loss) supera 3-6 meses de salario. Prevenir la rotación es más rentable que cubrirla.

Inputs

The user provides a project or client name as $ARGUMENTS. Parse $1 as the project/client name used throughout all output artifacts.

Parameters:

  • {MODO}: piloto-auto (default) | desatendido | supervisado | paso-a-paso
    • piloto-auto: Auto para análisis de gaps y skills matrix, HITL para decisiones de composición de equipo y roadmap.
    • desatendido: Cero interrupciones. Análisis completo automatizado. Supuestos documentados.
    • supervisado: Autónomo con checkpoint al completar cada sección.
    • paso-a-paso: Confirma antes de cada sección del análisis.
  • {FORMATO}: markdown (default) | html | dual
  • {VARIANTE}: ejecutiva (~40% — S1 + S3 + S6 only) | técnica (full 6 sections, default)

If reference materials exist, load them:

Read ${CLAUDE_SKILL_DIR}/references/

When to Use

  • El cliente necesita aumentar su equipo con talento externo (nearshore, offshore, on-site)
  • Se requiere analizar brechas de talento contra las capacidades necesarias para un proyecto
  • Es necesario diseñar la composición de un equipo augmentado
  • Se necesita un plan de onboarding y ramp-up para personal externo
  • Se busca establecer un framework de retención y performance para el equipo augmentado

When NOT to Use

  • Diseño organizacional completo (restructuración, re-org) --> requiere consultoría de management
  • Assessment de estado actual del equipo sin intención de augmentation --> use asis-analysis con {TIPO_SERVICIO}=SAS
  • Transformación digital que incluye staffing como un componente --> use digital-transformation-discovery
  • Recruiting interno o employer branding --> fuera del scope de MetodologIA services

Delivery Structure: 6 Sections

S1: Talent Gap Analysis

Análisis de capacidades actuales del equipo versus capacidades requeridas para el proyecto/programa.

Dimensiones del análisis:

  • Capacidades actuales: Inventario de roles, skills, y experiencia del equipo existente del cliente
  • Capacidades requeridas: Skills técnicos, de dominio, y soft skills necesarios según el scope del proyecto
  • Identificación de gaps: Delta por rol/skill entre lo actual y lo requerido
  • Scoring de criticidad: Clasificación de cada gap como blocker (sin este skill el proyecto no avanza), important (impacta velocidad o calidad), nice-to-have (mejora pero no bloquea)
  • Disponibilidad en mercado: Assessment de qué tan fácil o difícil es encontrar cada perfil en el mercado (alta demanda, nicho, abundante)

Output: Tabla de gaps con scoring de criticidad y disponibilidad en mercado.

S2: Skills Matrix & Profiling

Matriz detallada de skills requeridos para el engagement.

Categorías de skills:

  • Technical skills: Lenguajes de programación, frameworks, herramientas, plataformas cloud, bases de datos
  • Soft skills: Comunicación (idioma, escrita/oral), liderazgo, colaboración, resolución de conflictos, autonomía
  • Domain knowledge: Conocimiento de industria, regulaciones, procesos de negocio específicos del cliente

Niveles de proficiencia:

NivelDescripciónIndicadores
LearningEn proceso de adquisiciónPuede ejecutar con supervisión constante
CapableFuncional e independienteEjecuta tareas estándar sin guía, necesita apoyo en edge cases
ExpertDominio avanzadoResuelve problemas complejos, mentora a otros, define estándares

Certificaciones: Estado de certificaciones relevantes por perfil (AWS, Azure, GCP, Scrum, PMP, ISTQB, etc.).

Output: Skills matrix con proficiency levels por rol y certificaciones requeridas vs deseables.

S3: Team Composition Modeling

Modelo de composición del equipo augmentado.

Dimensiones del modelo:

  • Roles: Definición de cada rol con responsabilidades, skills requeridos, y nivel de seniority
  • Distribución de seniority: Ratio junior/mid/senior. Regla general: mínimo 30% senior para equipos nuevos, 20% para equipos maduros
  • Allocation percentages: Dedicación por recurso (100%, 75%, 50%). Evitar <50% — la fragmentación reduce productividad
  • Team topology: Clasificación según Team Topologies (Skelton & Pais):
    • Stream-aligned: Entrega valor de negocio directamente
    • Platform: Provee capacidades internas que aceleran a los stream-aligned
    • Enabling: Asiste a otros equipos a adoptar nuevas capacidades
    • Complicated-subsystem: Gestiona subsistemas que requieren expertise especializado
  • Conway's Law alignment: Análisis de si la estructura propuesta del equipo se alinea con la arquitectura del sistema que van a construir/mantener

Output: Organigrama propuesto con roles, seniority, allocation, y team topology classification.

S4: Onboarding & Ramp-Up Design

Plan de integración para el personal augmentado.

Componentes del plan:

  • Knowledge transfer: Sesiones de transferencia de conocimiento del dominio, arquitectura, procesos de negocio
  • Mentoring structure: Asignación de buddies/mentores del equipo del cliente para cada recurso augmentado
  • Documentation needs: Documentación mínima requerida antes del Day 1 (arquitectura, estándares de código, procesos de deployment, accesos)
  • Tooling access: Checklist de accesos a herramientas (repositorios, CI/CD, cloud, comunicación, gestión de proyectos)
  • Cultural integration: Ceremonias del equipo, normas de comunicación, horarios, zonas horarias, idioma de trabajo

Ramp-up timeline por seniority:

SeniorityRamp-UpSemana 1Semana 2-4Semana 4-8
Senior2 semanasContexto + codebase reviewContribuciones independientesProductividad plena
Mid4 semanasContexto + pairingTareas guiadasContribuciones independientes
Junior8 semanasContexto + trainingTareas con supervisiónTareas guiadas, inicio de autonomía

Output: Plan de onboarding con timeline, checklist de accesos, y estructura de mentoring.

S5: Retention & Performance Framework

Framework de retención y evaluación de performance para el equipo augmentado.

KPI definition:

  • Delivery KPIs: Velocity, throughput, cycle time, defect rate
  • Integration KPIs: Participación en ceremonias, code review contributions, knowledge sharing
  • Quality KPIs: Code review feedback, adherencia a estándares, test coverage de contribuciones

Feedback cadence:

  • Semanal: 1:1 de 15 minutos con team lead (blockers, satisfacción)
  • Mensual: Review de performance contra KPIs con el delivery manager
  • Trimestral: Evaluación 360 (peers del cliente + MetodologIA delivery manager)

Growth opportunities:

  • Acceso a certificaciones y training
  • Rotación entre proyectos para ampliar experiencia
  • Path de crecimiento (junior → mid → senior → lead)

Satisfaction monitoring:

  • eNPS mensual (promotores, pasivos, detractores)
  • Exit interviews estructuradas
  • Encuesta de clima trimestral

Early warning indicators for attrition risk:

  • Caída en participación en ceremonias
  • Reducción de throughput sin causa técnica
  • Feedback negativo recurrente en 1:1s
  • Solicitud de cambio de proyecto

Output: Framework de performance con KPIs, feedback cadence, y early warning system.

S6: Staffing Roadmap

Plan de staffing faseado con curvas de ramp-up.

Phased hiring plan:

  • Fase 1 (Foundation): Roles críticos (blockers del S1). Seniors primero para establecer estándares y mentorear
  • Fase 2 (Growth): Roles importantes. Mids que se integran al equipo ya estabilizado
  • Fase 3 (Scale): Roles nice-to-have. Juniors que se benefician del equipo maduro y mentoring establecido

Ramp-up curves: Visualización de la capacidad del equipo en el tiempo, mostrando la curva de productividad real (no es lineal — sigue una curva S).

Contingency positions: Perfiles pre-identificados para cubrir rotación o ausencias. Regla: 10-15% de contingencia sobre el equipo total.

Succession planning: Identificación de single points of failure y plan de cross-training para mitigar.

Budget magnitude indicators:

  • Expresado en posiciones x duración (e.g., "3 seniors x 12 meses + 2 mids x 8 meses")
  • NUNCA precios. Solo magnitudes de esfuerzo
  • Incluir costo de onboarding como overhead (típicamente 15-20% del primer mes por recurso)

Output: Roadmap visual con fases, ramp-up curves, y contingency plan.


Trade-off Matrix

DecisiónHabilitaRestringeCuándo Usar
100% seniorVelocidad inmediata, autonomíaCosto alto, mercado escasoProyectos cortos (<6 meses), alta complejidad
Mix senior/mid/juniorBalance costo-capacidad, growthRequiere inversión en mentoringProyectos >6 meses, equipo estable
NearshoreZona horaria compatible, costo moderadoPool limitado vs offshoreOverlap de horarios requerido, comunicación frecuente
OffshorePool amplio, costo optimizadoDiferencia horaria, cultural gapTareas bien definidas, equipos autónomos
Dedicated teamIntegración profunda, ownershipCosto fijo, flexibilidad reducidaProgramas >12 meses, producto propio
Time & MaterialsFlexibilidad, ajuste dinámicoMenos predictibilidad presupuestalScope variable, discovery/R&D

Assumptions

  • El cliente tiene claridad sobre el scope del proyecto o programa que requiere augmentation
  • Existe un equipo base del cliente con quien se integrará el personal augmentado
  • Los roles y responsabilidades del equipo del cliente están documentados o son accesibles vía entrevistas
  • El cliente puede proporcionar acceso a herramientas y documentación en tiempo razonable para el onboarding
  • El mercado laboral permite cubrir los perfiles identificados en los tiempos del roadmap

Limits

  • No reemplaza la consultoría de diseño organizacional (restructuración, cambio de org chart)
  • No incluye recruiting operativo (búsqueda, filtrado, entrevistas de candidatos)
  • No define precios — solo magnitudes de esfuerzo (posiciones x duración)
  • No cubre aspectos legales de contratación (clasificación contractor vs employee, regulaciones laborales locales)
  • El análisis de disponibilidad en mercado es una estimación basada en tendencias — no es un market study formal

Edge Cases

Cliente sin equipo base (greenfield team): Se requiere un Tech Lead o Architect senior del lado de MetodologIA que establezca cultura, estándares, y procesos. El onboarding se convierte en team building. Incrementar ratio senior a 50%.

Rotación alta en el equipo del cliente: La integración del personal augmentado se dificulta si el contexto cambia constantemente. Priorizar documentación exhaustiva sobre conocimiento tribal. Incluir knowledge management como responsabilidad explícita.

Skills de nicho (mainframe, SAP, legacy): Lead times de recruiting más largos (8-12 semanas vs 2-4 semanas estándar). Considerar training de perfiles cercanos como alternativa. Documentar el riesgo de mercado escaso.

Multi-timezone distributed team: Definir core hours de overlap mínimo (4 horas). Ceremonias asíncronas para lo que no requiere interacción en tiempo real. Documentación como ciudadano de primera clase.

Ramp-down planning: Cuando el engagement tiene fecha de finalización, planear la transferencia de conocimiento inversa (del equipo augmentado al equipo del cliente) con al menos 4 semanas de anticipación.

Casos Borde

CasoEstrategia de Manejo
Cliente sin equipo base (greenfield team)Tech Lead o Architect senior de MetodologIA establece cultura y estandares; onboarding se convierte en team building; incrementar ratio senior a 50%
Rotacion alta en el equipo del clientePriorizar documentacion exhaustiva sobre conocimiento tribal; incluir knowledge management como responsabilidad explicita; buddy system reforzado
Skills de nicho (mainframe, SAP, legacy)Lead times de recruiting mas largos (8-12 semanas); considerar training de perfiles cercanos como alternativa; documentar riesgo de mercado escaso
Multi-timezone distributed teamDefinir core hours de overlap minimo (4 horas); ceremonias asincronas para lo que no requiere interaccion real-time; documentacion como ciudadano de primera clase
Ramp-down planning con fecha de finalizacionPlanear transferencia de conocimiento inversa con al menos 4 semanas de anticipacion; documentar runbooks y decision logs antes del offboarding

Decisiones y Trade-offs

DecisionAlternativa DescartadaJustificacion
Capacidad de entrega sobre headcountMedir exito por numero de personas incorporadasEl numero de personas es una metrica vanidosa; lo que importa es velocidad, calidad y sostenibilidad de entrega
Integracion antes que incorporacionIncorporar primero, integrar despuesAnadir talento sin plan de integracion crea friccion; onboarding, mentoring y acceso a herramientas determinan el time-to-productivity
Retencion como estrategia primaria de staffingCubrir rotacion reactivamenteEl costo de reemplazar (recruiting + onboarding + ramp-up + knowledge loss) supera 3-6 meses de salario; prevenir es mas rentable que cubrir
Seniors primero para establecer estandaresJuniors primero por menor costoLos seniors establecen cultura, estandares y mentorias; sin ese foundation, los juniors no tienen framework de crecimiento

Knowledge Graph

graph TD
    subgraph Core["Core: Staff Augmentation"]
        TGA[Talent Gap Analysis]
        SKM[Skills Matrix & Profiling]
        TCM[Team Composition Modeling]
        ONB[Onboarding & Ramp-Up]
        RET[Retention & Performance]
        ROAD[Staffing Roadmap]
    end

    subgraph Inputs["Inputs"]
        SCOPE[Project Scope]
        TEAM[Current Team]
        ROLES[Role Requirements]
        MARKET[Market Availability]
    end

    subgraph Outputs["Outputs"]
        GAP[Gap Analysis Report]
        COMP[Team Composition Model]
        PLAN[Onboarding Plan]
        SROAD[Phased Staffing Plan]
    end

    subgraph Related["Related Skills"]
        ASIS[asis-analysis]
        CHANGE[change-management]
        TRAIN[mentoring-training]
        DISC[discovery-orchestrator]
    end

    SCOPE --> TGA
    TEAM --> SKM
    ROLES --> TCM
    MARKET --> TGA
    TGA --> SKM --> TCM --> ONB --> RET --> ROAD
    ROAD --> GAP
    ROAD --> COMP
    ROAD --> PLAN
    ROAD --> SROAD
    ASIS --> TGA
    ONB --> TRAIN
    RET --> CHANGE
    ROAD --> DISC

Output Templates

FormatoNombreContenido
MarkdownStaff_Augmentation_Discovery_{project}.mdAnalisis completo de 6 secciones: talent gap, skills matrix, team composition, onboarding plan, retention framework y staffing roadmap con ramp-up curves. Diagramas Mermaid embebidos.
XLSXStaff_Augmentation_Skills_Matrix_{project}.xlsxSkills matrix interactiva con proficiency levels por rol, heatmap de gaps current vs required, certificaciones requeridas vs deseables, y scoring de criticidad por perfil.
HTML{fase}_staff_augmentation_{cliente}_{WIP}.htmlMismo contenido en HTML branded (Design System MetodologIA v5). Self-contained, WCAG AA, responsive. Incluye talent gap heatmap con criticidad por rol, team composition org chart visual y staffing roadmap con curvas de ramp-up.
DOCX{fase}_staff_augmentation_{cliente}_{WIP}.docxGenerado con python-docx y MetodologIA Design System v5. Portada con nombre del proyecto y fecha, TOC automático, encabezados Poppins navy, cuerpo Montserrat, acentos dorados, tablas zebra. Secciones: Talent Gap Analysis, Skills Matrix, Team Composition Model, Onboarding Plan, Retention Framework, Staffing Roadmap.
PPTX{fase}_staff_augmentation_{cliente}_{WIP}.pptxGenerado con python-pptx y MetodologIA Design System v5. Slide master con gradiente navy, títulos Poppins, cuerpo Montserrat, acentos dorados. Máximo 20 slides (ejecutiva). Speaker notes con referencias de evidencia. Slides: Portada, Resumen ejecutivo, Talent Gap Analysis (tabla de gaps con criticidad), Skills Matrix (heatmap), Team Composition (org chart visual), Onboarding & Ramp-Up timeline, Retention Framework (KPIs), Staffing Roadmap faseado, próximos pasos.

Evaluacion

DimensionPesoCriterio
Trigger Accuracy10%Descripcion activa triggers correctos (staffing, talent gap, team composition, onboarding, augmentation) sin falsos positivos con organizational design o recruiting operativo
Completeness25%Las 6 secciones cubren gap analysis, skills matrix, composition, onboarding, retention y roadmap sin huecos; todos los roles requeridos evaluados
Clarity20%Instrucciones ejecutables sin ambiguedad; cada gap tiene scoring de criticidad; ramp-up timelines especificos por seniority; KPIs medibles
Robustness20%Maneja greenfield team, rotacion alta, skills de nicho, multi-timezone y ramp-down con estrategias diferenciadas
Efficiency10%Proceso no tiene pasos redundantes; variante ejecutiva reduce a S1+S3+S6 sin perder decisiones criticas de composicion y roadmap
Value Density15%Cada seccion aporta valor practico directo; talent gap scoring y ramp-up curves son herramientas de decision inmediata para delivery managers

Umbral minimo: 7/10.


Validation Gate

Before finalizing delivery, verify:

  • Talent gap analysis cubre todos los roles y skills requeridos por el proyecto
  • Cada gap tiene scoring de criticidad (blocker/important/nice-to-have) documentado
  • Skills matrix incluye technical, soft, y domain skills con proficiency levels
  • Team composition alineada con team topologies y Conway's Law
  • Distribución de seniority justificada con rationale (no arbitraria)
  • Plan de onboarding tiene timeline específico por seniority level
  • KPIs de performance son medibles y tienen cadencia de review definida
  • Early warning indicators de attrition documentados
  • Staffing roadmap faseado con contingency positions (10-15%)
  • Budget expresado en magnitudes (posiciones x duración), NUNCA en precios
  • Ramp-up curves reflejan productividad real (curva S, no lineal)

Output Format Protocol

FormatDefaultDescription
markdownYesRich Markdown + Mermaid diagrams. Token-efficient.
htmlOn demandBranded HTML (Design System). Visual impact.
dualOn demandBoth formats.

Default output is Markdown with embedded Mermaid diagrams. HTML generation requires explicit {FORMATO}=html parameter.

Output Artifact

Primary: Staff_Augmentation_Discovery_{project}.md -- Talent gap analysis, skills matrix, team composition model, onboarding plan, retention framework, and phased staffing roadmap with ramp-up curves and contingency plan.

Diagramas incluidos:

  • Team composition diagram: roles, seniority distribution, team topology
  • Ramp-up curve: capacity over time per phase
  • Staffing roadmap: Gantt-style phased hiring plan
  • Skills gap heatmap: current vs required by role

Autor: Javier Montaño | Última actualización: 14 de marzo de 2026

Repository
JaviMontano/mao-discovery-framework
Last updated
First committed

Also appears in

JaviMontano/mao-pm-apex
In sync

since Aug 28, 2026

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.