name: cost-estimation
description: >
Cost driver identification — effort inductors, scope drivers, magnitude estimation, team composition
modeling, risk-adjusted timeline ranges, service engagement sizing, consulting effort, automation ROI,
and staffing model. Use when the user asks to "estimate effort", "identify
cost drivers", "size the project", "plan team composition", "identify effort inductors", or mentions
WBS, sizing, contingency, burn rate, PERT, Monte Carlo, or "Phase 4" cost work. NEVER produces
final prices — produces drivers, ranges, and magnitude indicators with costing disclaimers.
allowed-tools:
- Read
- Write
- Edit
- Glob
- Grep
- Bash

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

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