Imported from JaviMontano/mao-discovery-framework (skills/cost-estimation/SKILL.md). Install upstream with npx skills add JaviMontano/mao-discovery-framework --skill cost-estimation. Copyright stays with the author.

Cost Estimation: Effort Drivers, Magnitude Indicators & Investment Framing

Translates technical scope into effort drivers, magnitude indicators, team composition models, and risk-adjusted timeline ranges. Produces structured analysis of WHAT drives cost — not WHAT things cost. Every output carries explicit disclaimers separating cost identification from pricing decisions.

Principio Rector

El costeo sin estructura es adivinación con formato de hoja de cálculo. Este skill impone disciplina analítica sobre la estimación: cada driver se identifica, cada magnitud se triangula, cada supuesto se documenta. No producimos precios — producimos la base de conocimiento que hace posible tomar decisiones financieras informadas.

Filosofía de Estimación

1. Drivers, no precios. El valor de este skill no está en producir un número final — está en identificar TODO lo que compone ese número. Los drivers son la verdad; el precio es una decisión posterior.

2. Triangulación obligatoria. Un solo método de estimación es una opinión. Dos métodos son una hipótesis. Tres métodos convergentes son confianza. Siempre triangular.

3. Incertidumbre explícita. Rangos, no puntos. Escenarios, no certezas. El Cone of Uncertainty no es debilidad — es honestidad profesional que genera confianza.

Regla Cardinal

NUNCA producir valores finales de costo, precio o tarifa. Este skill identifica CONDUCTORES de costo, INDUCTORES de esfuerzo, y NOCIONES DE MAGNITUD.

Filosofía de Costeo

1. Costear ≠ Cobrar ≠ Ingresos. El costeo existe para entender qué cuestan las cosas — completamente desconectado de lo que se cobra. El revenue es una decisión comercial posterior e independiente. Este skill vive exclusivamente en el dominio del costeo.

2. Costear para la Excelencia. El propósito del costeo NO es solo presupuestar — es asegurar calidad, excelencia, y un "wow factor" de hospitalidad irracional. Cuando sabes lo que las cosas verdaderamente cuestan, puedes invertir apropiadamente en calidad. Costear bien = habilitar excelencia.

3. Margen de innovación = inversión en futuro. El 5% adicional no es contingencia — es la declaración de que la excelencia no es accidental. Es presupuesto deliberado para sorprender al cliente positivamente.

La diferencia:

Disclaimer Obligatorio

Todo output DEBE incluir al pie:

DISCLAIMER DE COSTEO
═══════════════════
Este análisis identifica conductores de costo e inductores de esfuerzo.
NO constituye una cotización, presupuesto ni compromiso financiero.
Los valores finales requieren: (1) validación de tarifas vigentes,
(2) negociación comercial, (3) aprobación de alcance definitivo.
Costear ≠ Cobrar. Este documento informa lo primero.

Cone of Uncertainty

Estimates narrow as projects progress. At concept phase: 0.25x-4x. After requirements: 0.67x-1.5x. After detailed design: 0.8x-1.25x. Communicate ranges, not points. Re-estimate at each phase gate.

Inputs

Parse $1 as project/initiative name. Detect project context from repo.

Parameters:

• {MODO}: piloto-auto (default) | desatendido | supervisado | paso-a-paso
  • piloto-auto: Automático para rutina, HITL para decisiones críticas (selección de magnitud, aprobación de escenarios). Reporta en milestones.
  • desatendido: Cero interrupciones. Todo auto-resuelto.
  • supervisado: Autónomo con reportes en milestones. Preguntas solo ante ambigüedades genuinas.
  • paso-a-paso: Confirma antes de cada sección.
• {FORMATO}: markdown (default) | html | dual
• {VARIANTE}: ejecutiva (~40% — S1 scope + S4 drivers + S6 magnitude) | técnica (full 7 sections, default)
• {TIPO_SERVICIO}: SDA (default) | QA | Management | RPA | Data-AI | Cloud | SAS | UX-Design
  • Determines sizing methods, team composition templates, and cost driver categories
  • When omitted, defaults to SDA (backward compatible)

Delivery Structure: 7 Sections

S1: Scope Decomposition & Effort Drivers

• WBS: hierarchical decomposition from epic to feature to task
• Feature inventory with complexity classification: simple (<3d), medium (3-10d), complex (10+d)
• Effort drivers identified: cada feature con sus inductores de esfuerzo
  • Integración (# sistemas, protocolos, contratos)
  • Migración de datos (volumen, transformación, validación)
  • Compliance/regulatorio (certificaciones, auditorías)
  • Deuda técnica heredada (refactoring requerido)
  • Curva de aprendizaje (stack nuevo, dominio complejo)
• Dependency mapping and scope boundaries

Service-Type Scope Templates

When {TIPO_SERVICIO} ≠ SDA, use service-appropriate decomposition:

S2: Sizing Methods (Magnitud, no Valor)

• T-shirt sizing: S/M/L/XL con rangos de FTE-meses (no dinero)
• Story points calibrados a throughput, no a tarifa
• Reference-class forecasting: comparación con proyectos similares
• Three-point estimation: optimista/probable/pesimista por feature
• COCOMO II: modelo paramétrico por KSLOC/FP (produce esfuerzo-persona, no costo)
• Triangulación de magnitud: comparar métodos, flag divergencia >30%
• Output: "Magnitud estimada: X-Y FTE-meses" (NUNCA "costo: $Z")

Service-Type Sizing Methods

COCOMO II applies to SDA only. For other service types, use:

• QA: Test case complexity scoring (Simple: 0.5h, Medium: 2h, Complex: 8h) × automation factor (manual: 1x, automated: 3x initial + 0.2x ongoing)
• Management: Engagement-days model (workshops: 2-5 days, sprint coaching: ongoing FTE, assessment: 5-15 days, transformation: 3-12 months)
• RPA: Bot complexity scoring — Simple bot (<10 steps, 1 system): 2-4 weeks; Medium (10-30 steps, 2-3 systems): 4-8 weeks; Complex (>30 steps, 4+ systems): 8-16 weeks
• Data-AI: Pipeline complexity (batch: 1-3 weeks, streaming: 3-8 weeks, ML model: 4-16 weeks per iteration, dashboard: 1-4 weeks)
• Cloud: Workload migration complexity per 7R (Rehost: 1-2 weeks, Replatform: 2-6 weeks, Refactor: 4-16 weeks per workload)
• SAS: Position fill time (standard: 2-4 weeks, specialized: 4-8 weeks, rare: 8-16 weeks) + ramp-up (junior: 8 weeks, mid: 4 weeks, senior: 2 weeks)
• UX-Design: Research study (1-3 weeks), wireframe set (1-2 weeks), interactive prototype (2-4 weeks), design system component (0.5-2 weeks)

Universal methods that apply to ALL service types:

• T-shirt sizing (S/M/L/XL)
• Reference-class forecasting
• Three-point estimation (optimistic/probable/pessimistic)

S3: Team Composition Modeling

• Role mapping: roles requeridos × seniority × % dedicación
• Ramp-up curves: 50% semanas 1-2, 80% semana 4, 100% semana 8
• Communication overhead: Brooks's Law, team topology
• Driver de equipo: build vs hire vs contract, onshore vs nearshore vs offshore
• Allocation patterns: full-time vs fractional, specialists time-boxed
• Output: modelo de equipo por fase (roles y cantidades, NO tarifas)
• Diagrama requerido: Gantt chart (Mermaid) con timeline de ramp-up del equipo por rol y fase

Service-Type Role Templates

S4: Cost Driver Taxonomy

NUEVA SECCIÓN — el corazón del skill evolucionado.

Identifica y clasifica TODOS los drivers de costo:

Service-Type Specific Drivers

Por cada driver:

• Nombre y descripción
• Magnitud relativa: Bajo / Medio / Alto / Crítico
• Fase(s) donde impacta
• Owner responsable de validar el valor real

Diagramas requeridos:

• Mindmap (Mermaid): visualización de taxonomía de cost drivers por categoría
• Flowchart (Mermaid): árbol de decisión para escenarios de magnitud

S5: Risk-Adjusted Timeline Ranges

• PERT: (O + 4M + P) / 6 por feature
• Monte Carlo: P50 / P80 / P95 como rangos de duración (no costo)
• Critical path analysis
• Buffer strategy: 20-30% critical path
• Output: "Timeline estimado: X-Y meses (P80)" — sin valor monetario asociado

S6: Magnitude Framing (replaces Budget Scenarios)

No produce presupuestos. Produce marcos de magnitud.

• Clasificación de magnitud del proyecto:
  • Micro (<20 FTE-meses)
  • Pequeño (20-50 FTE-meses)
  • Mediano (50-150 FTE-meses)
  • Grande (150-500 FTE-meses)
  • Enterprise (>500 FTE-meses)
• Rangos por escenario: optimista / probable / pesimista (en FTE-meses)
• Phased funding structure: esfuerzo por fase con gates
• Indicadores de magnitud comparativa: "Comparable a un equipo de 8 personas por 18 meses"
• Sensitivity analysis: qué drivers mueven más la aguja
• Margen de Innovación (5%): Toda estimación incluye un 5% de sobre-costo explícitamente reservado para invertir en innovación, mejora de experiencia, y mejora continua para usuarios/clientes. Este margen NO es contingencia (que se calcula aparte) — es inversión deliberada en excelencia y hospitalidad irracional.

S7: Costing Governance & Disclaimers

• Accuracy tracking framework (estimate vs actual)
• Re-estimation triggers: scope >10%, team change, tech change, risk materialization
• Cognitive bias mitigation: optimism, anchoring, planning fallacy
• Separación costeo vs cobro: este skill informa COSTEO (qué recursos se necesitan); COBRO (qué se le cobra al cliente) es decisión comercial separada que depende de modelo de negocio, margen, estrategia competitiva, y negociación.

Trade-off Matrix

Assumptions & Limits

• Identifica drivers y magnitudes, NO produce precios finales
• Scope defined at least to feature level
• Team velocity not transferable between teams
• Costear ≠ Cobrar — este skill no define modelo comercial ni margen

Edge Cases

Validation Gate

• WBS with effort drivers identified per feature
• Multiple sizing methods triangulated (magnitud, not price)
• Team composition model without rates (roles × quantity × duration)
• Cost driver taxonomy complete (8+ categories)
• Timeline ranges with P50/P80/P95
• Magnitude framing (not budget) with sensitivity analysis
• Disclaimer de costeo presente
• Zero final prices in output
• Margen de innovación 5% incluido (separado de contingencia)
• Diagramas Mermaid: Gantt (ramp-up), mindmap (drivers), flowchart (escenarios)

Output Format Protocol

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

Output Artifact

Primary: 06_Cost_Drivers_{TIPO_SERVICIO}_{project}.md (o .html si {FORMATO}=html|dual) — Effort drivers, magnitude indicators, team model, timeline ranges, costing governance. Con disclaimer obligatorio.

Diagramas incluidos:

• Gantt chart: timeline de ramp-up del equipo
• Mindmap: taxonomía de cost drivers
• Flowchart: árbol de decisión para escenarios de magnitud

Casos Borde

Decisiones y Trade-offs

Knowledge Graph

graph TD
    subgraph Core["Conceptos Core"]
        WBS["Scope Decomposition"]
        SIZING["Sizing Methods"]
        TEAM["Team Composition"]
        DRIVERS["Cost Driver Taxonomy"]
        TIMELINE["Risk-Adjusted Timeline"]
        MAGNITUDE["Magnitude Framing"]
        GOVERNANCE["Costing Governance"]
    end

    subgraph Inputs["Entradas"]
        ASIS["AS-IS Analysis"]
        TOBE["TO-BE Architecture"]
        SCENARIO["Approved Scenario"]
        TIPO["Service Type"]
    end

    subgraph Outputs["Salidas"]
        REPORT["Cost Drivers Report"]
        GANTT["Ramp-up Gantt"]
        MINDMAP["Driver Taxonomy Mindmap"]
        FLOWCHART["Magnitude Decision Tree"]
    end

    subgraph Related["Skills Relacionados"]
        ASISSK["asis-analysis"]
        TOBEARCHSK["architecture-tobe"]
        SCENARIOSK["scenario-evaluation"]
        FEASIBILITY["feasibility-assessment"]
    end

    ASIS --> WBS
    TOBE --> DRIVERS
    SCENARIO --> MAGNITUDE
    TIPO --> SIZING
    WBS --> SIZING
    SIZING --> TEAM
    TEAM --> DRIVERS
    DRIVERS --> TIMELINE
    TIMELINE --> MAGNITUDE
    MAGNITUDE --> GOVERNANCE
    GOVERNANCE --> REPORT
    REPORT --> GANTT
    REPORT --> MINDMAP
    REPORT --> FLOWCHART
    ASISSK -.-> WBS
    TOBEARCHSK -.-> DRIVERS
    SCENARIOSK -.-> MAGNITUDE
    FEASIBILITY -.-> TIMELINE

Output Templates

Formato Markdown (default):

# Cost Drivers: {project} ({TIPO_SERVICIO})
## S1: Scope Decomposition & Effort Drivers
### WBS
### Feature Inventory
| Feature | Complexity | Effort Drivers | Dependencies |
...
## S2: Sizing Methods
### Triangulacion de Magnitud
| Metodo | Resultado (FTE-meses) | Confianza |
...
## S3: Team Composition Model
### Modelo por Fase (roles y cantidades, NO tarifas)
### Gantt de Ramp-up (Mermaid)
## S4: Cost Driver Taxonomy
### Mindmap (Mermaid)
| Categoria | Driver | Magnitud | Fase(s) | Owner |
...
## S5: Risk-Adjusted Timeline
### PERT: P50 / P80 / P95
## S6: Magnitude Framing
### Clasificacion: {micro|pequeno|mediano|grande|enterprise}
### Margen de Innovacion: 5%
## S7: Costing Governance
> DISCLAIMER DE COSTEO

Formato HTML (bajo demanda):

06_Cost_Drivers_{TIPO_SERVICIO}_{project}_{WIP}.html

HTML self-contained branded (Design System MetodologIA v5). Light-First Technical. Incluye cost driver taxonomy mindmap interactivo, magnitude framing visual, y Gantt de ramp-up del equipo. WCAG AA, responsive, print-ready.

Formato XLSX (bajo demanda):

Sheet 1: WBS — epic, feature, task, complexity, effort drivers, dependencies
Sheet 2: Sizing Triangulation — method, result (FTE-months), confidence, divergence
Sheet 3: Team Model — role, seniority, dedication %, phase, quantity (NO rates)
Sheet 4: Cost Driver Taxonomy — category, driver, magnitude, phase, owner
Sheet 5: Timeline — feature, optimistic, probable, pessimistic, PERT, critical path
Sheet 6: Magnitude Scenarios — optimistic, probable, pessimistic (FTE-months)
Sheet 7: Sensitivity Analysis — driver, impact on magnitude, risk level

Formato DOCX (bajo demanda):

06_Cost_Drivers_{TIPO_SERVICIO}_{project}_{WIP}.docx

Via python-docx con Design System MetodologIA v5. Cover page, TOC auto, headers/footers branded, tablas zebra. Poppins headings (navy), Montserrat body, gold accents.

Formato PPTX (bajo demanda):

• Filename: {fase}_{entregable}_{cliente}_{WIP}.pptx
• Via python-pptx con MetodologIA Design System v5. Slide master con gradiente navy, titulos Poppins, cuerpo Montserrat, acentos gold. Max 20 slides (ejecutiva) / 30 slides (tecnica). Speaker notes con referencias de evidencia. Para comites directivos y presentaciones C-level.

Evaluacion

Umbral minimo: 7/10. Debajo de este umbral, revisar triangulacion de sizing y completeness de driver taxonomy.

Autor: Javier Montano · Comunidad MetodologIA | Ultima actualizacion: 15 de marzo de 2026