| name | metodologia-developer-experience |
| description | Developer experience (DX) platform assessment, inner loop optimization, toolchain evaluation, and onboarding friction analysis. Use when the user asks to "assess developer experience", "optimize inner loop", "evaluate toolchain", or mentions DX scorecard, developer productivity, or cognitive load reduction.
|
| author | Javier Montaño · Comunidad MetodologIA |
| argument-hint | <proyecto-u-organizacion> [equipo-o-plataforma] |
| version | 1.0.0 |
| tags | ["developer-experience","dx","productivity","toolchain","inner-loop","moat"] |
| allowed-tools | ["Read","Write","Edit","Glob","Grep","Bash","WebFetch"] |
Evaluacion de Developer Experience
Assessment integral de la experiencia del desarrollador, optimizacion del inner loop,
evaluacion de toolchain y analisis de friccion en onboarding.
TL;DR
- Evalua DX actual con metricas de inner loop (code-build-test-debug cycle time)
- Identifica puntos de friccion en toolchain, procesos y cognitive load
- Benchmarca contra estandares de industria (DORA, SPACE framework)
- Prioriza mejoras por impacto en productividad y satisfaccion
- Genera scorecard DX con improvement backlog accionable
Inputs
Parse $1 como nombre del proyecto/organizacion, $2 como equipo o plataforma a evaluar.
Parameters:
{MODO}: piloto-auto (default) | desatendido | supervisado | paso-a-paso{FORMATO}: markdown (default) | html | dual{VARIANTE}: ejecutiva (~40%) | tecnica (full, default)
Entregables
- DX Scorecard — Evaluacion cuantitativa por dimension (inner loop, toolchain, docs, onboarding, CI/CD)
- Improvement Backlog — Lista priorizada de mejoras con impacto estimado
- Toolchain Map — Mapa visual de herramientas actuales con gaps y redundancias
- Friction Analysis — Puntos de friccion identificados con root cause y solucion propuesta
- Benchmark Report — Comparacion contra estandares DORA/SPACE
Proceso
- Medicion de Inner Loop — Evaluar tiempos de ciclo:
| Metrica | Excelente | Aceptable | Problema |
|---|
| Build time (local) | <30s | 30s-3min | >3min |
| Test suite (unit) | <1min | 1-5min | >5min |
| Hot reload | <2s | 2-10s | >10s o inexistente |
| PR to merge | <4h | 4-24h | >24h |
| Deploy to staging | <15min | 15-60min | >60min |
- Evaluacion de Toolchain — Inventariar herramientas por categoria (IDE, VCS, CI/CD, observability, collaboration), detectar gaps y redundancias
- Analisis de Cognitive Load — Evaluar complejidad de setup local, numero de herramientas, context switching, documentacion disponible
- Assessment de Onboarding — Medir tiempo de primer commit productivo, gaps en documentacion, dependencia de conocimiento tribal
- Benchmarking DORA/SPACE — Comparar metricas clave contra percentiles de industria
- Priorizacion de Mejoras — Scoring por impacto en productividad x esfuerzo de implementacion
Criterios de Calidad
Supuestos y Limites
- Metricas de inner loop son estimadas si no existen herramientas de medicion instaladas
- Benchmarks DORA/SPACE son referenciales; la posicion exacta del equipo requiere medicion continua
- No reemplaza encuestas de satisfaccion de desarrolladores — las complementa con datos objetivos
- Evaluacion de cognitive load es cualitativa salvo que existan datos de context switching
Casos Borde
| Escenario | Estrategia de Manejo |
|---|
| Equipo full-remote con toolchains heterogeneos | Evaluar por developer archetype (frontend, backend, mobile) en lugar de un solo inner loop; documentar variaciones |
| Organizacion sin CI/CD pipeline | Clasificar como nivel 0 en esas dimensiones; priorizar setup basico antes de optimizacion |
| Monorepo con +50 desarrolladores | Evaluar build times segmentados por modulo; friction de code ownership y merge conflicts como dimension adicional |
| Equipo en transicion de tecnologia | Medir DX de stack actual y target por separado; plan de mejora enfocado en reducir dual-stack friction |
Decisiones y Trade-offs
| Decision | Habilita | Restringe | Justificacion |
|---|
| DORA/SPACE como benchmark default | Comparabilidad con industria | Metricas pueden no capturar contexto local | Son los frameworks mas adoptados y con mayor base de datos comparativa |
| Scorecard cuantitativo por dimension | Priorizacion objetiva de mejoras | Requiere estimacion donde no hay datos | Permite tracking de progreso en assessments sucesivos |
| Inner loop como eje central | Foco en lo que mas impacta productividad diaria | Puede sub-representar DX de procesos (PR review, on-call) | El inner loop es donde el desarrollador pasa 60-80% del tiempo productivo |
Knowledge Graph
graph TD
subgraph Core["Developer Experience"]
A[DX Assessment] --> B[Inner Loop Metrics]
A --> C[Toolchain Evaluation]
A --> D[Cognitive Load Analysis]
A --> E[Onboarding Friction]
end
subgraph Inputs["Inputs"]
F[Pipeline Metrics] --> B
G[Tool Inventory] --> C
H[Team Interviews] --> D
end
subgraph Outputs["Outputs"]
A --> I[DX Scorecard]
A --> J[Improvement Backlog]
C --> K[Toolchain Map]
end
subgraph Related["Related Skills"]
L[release-strategy] -.-> B
M[maturity-assessment] -.-> A
N[documentation-architecture] -.-> E
end
Output Templates
Formato 1 — Markdown (default)
- Filename:
DX_Assessment_{project}_{WIP|Aprobado}.md
- Estructura: Scorecard > Inner Loop Metrics > Toolchain Map > Friction Analysis > Improvement Backlog > Benchmark DORA/SPACE
- Incluye tablas de scoring y diagramas Mermaid inline
Formato 2 — HTML (dashboard ejecutivo)
- Filename:
DX_Assessment_{project}_{WIP|Aprobado}.html
- Estructura: Scorecard radar visual > Top 5 friction points > Quick wins > Roadmap de mejoras
- Optimizado para presentacion a engineering leadership
Formato 3 — DOCX (circulación formal)
- Filename:
{fase}_{entregable}_{cliente}_{WIP}.docx
- Generado via python-docx con MetodologIA Design System v5. Portada con metadata del engagement, TOC automático, encabezados/pies de página con marca. Tablas con zebra striping, tipografía Poppins en headings (navy), Montserrat en cuerpo, acentos dorados. Para circulación formal y auditoría.
Formato 4 — XLSX (bajo demanda)
- Filename:
{fase}_{entregable}_{cliente}_{WIP}.xlsx
- Via openpyxl con MetodologIA Design System v5. Headers con fondo navy y tipografía Poppins en blanco, conditional formatting por DX score y nivel de fricción, auto-filters en todas las columnas, valores directos sin fórmulas.
Formato 5 — PPTX (bajo demanda)
- Filename:
{fase}_{entregable}_{cliente}_{WIP}.pptx
- Via python-pptx con MetodologIA Design System v5. Navy gradient slide master, Poppins titles, Montserrat body, gold accents. Máx 20 slides ejecutivo / 30 técnico. Speaker notes con referencias de evidencia.
Evaluacion
| Dimension | Peso | Criterio |
|---|
| Trigger Accuracy | 10% | Activa triggers correctos ante keywords de DX, inner loop, toolchain, onboarding |
| Completeness | 25% | Cubre todas las dimensiones: inner loop, toolchain, cognitive load, onboarding, CI/CD |
| Clarity | 20% | Metricas con thresholds claros; mejoras con impacto estimado en tiempo |
| Robustness | 20% | Maneja equipos sin CI/CD, monorepos, transiciones de stack |
| Efficiency | 10% | Proceso no duplica pasos entre dimensiones de evaluacion |
| Value Density | 15% | Improvement backlog es directamente accionable con ROI estimado |
Umbral minimo: 7/10 en cada dimension para considerar el skill production-ready.
Cross-References
- metodologia-release-strategy: Pipeline CI/CD y deployment patterns que impactan inner loop
- metodologia-maturity-assessment: Evaluacion de madurez complementa DX scorecard
- metodologia-documentation-architecture: Documentacion como dimension clave de onboarding DX
Autor: Javier Montaño · Comunidad MetodologIA | Version: 1.0.0
