CtrlK
BlogDocsLog inGet started
Tessl Logo

metodologia-software-viability

Software and technology viability validator — deep forensic analysis of whether proposed software solutions, AI/ML components, and technology choices are viable substance or speculative smoke. Covers service viability, platform viability, methodology viability, tool viability, and vendor assessment for any service type. Use when the user asks to "validate technology viability", "detect vaporware", "verify AI claims", "assess software maturity", "check if this tech actually works", or mentions technology due diligence, software validation, AI feasibility, vendor evaluation, or tech-stack viability. This is the devoted software-specific validator — separate and more critical than the multidimensional feasibility analysis.

The canonical home for this skill is metodologia-software-viability in JaviMontano/mao-discovery-framework

SKILL.md
Quality
Evals
Security

Service & Technology Viability: Substance vs Smoke Validator

Forensic validation of whether proposed software solutions, technology choices, and AI/ML components are viable, mature, and fit-for-purpose — or speculative, overhyped, and risky. This is NOT the multidimensional feasibility analysis (technical-feasibility covers that). This is a devoted, deep-cut software validator that operates at the level of code, APIs, vendor maturity, community health, and real-world production evidence.

Alcance universal: Este skill valida viabilidad de tecnologías de software (SDA), plataformas de automatización (RPA), herramientas de testing (QA), frameworks de gestión (Management), plataformas de datos (Data-AI), servicios cloud (Cloud), y cualquier componente tecnológico o metodológico propuesto en un engagement de servicios.

Principio Rector

Todo en software es una promesa hasta que se demuestra en producción. Este skill separa promesas verificables de humo. Usa evidencia de primera mano: código ejecutable, APIs documentadas, benchmarks reproducibles, postmortems públicos, adoption data. NO usa: marketing decks, feature comparison tables de vendors, demos no reproducibles.

Filosofía de Validación de Software

  1. Evidencia > narrativa. Un benchmark reproducible vale más que diez testimonios de clientes. Si la evidencia no existe, el veredicto es provisional — y se documenta como tal.
  2. El humo se detecta en los detalles. Claims vagos ("state of the art", "enterprise-grade", "AI-powered") sin métricas específicas, datasets documentados, o casos de producción verificables son señales de humo hasta que se demuestre lo contrario.
  3. Viabilidad es contextual. Una tecnología puede ser 🟢 SUBSTANCIA para un equipo con experiencia y 🟠 RIESGO ALTO para otro sin ella. El veredicto siempre se emite en el contexto del proyecto, el equipo, y las restricciones específicas.

Escala de veredicto:

  • 🟢 SUBSTANCIA — producción comprobada, comunidad activa, API estable
  • 🟡 PROMESA VIABLE — early stage pero con fundamentos sólidos
  • 🟠 RIESGO ALTO — dependencia de vendor, lock-in, roadmap incierto
  • 🔴 HUMO — vaporware, hype sin producción, claims no verificables

Inputs

Parse $1 as project name, $2 as technology/solution to validate. Accepts: technology names, vendor products, AI/ML proposals, architectural patterns, library choices.

Parameters:

  • {MODO}: piloto-auto (default) | desatendido | supervisado | paso-a-paso
    • piloto-auto: Auto para inventario y análisis de madurez, HITL para veredictos de AI/ML y evaluación de vendors.
    • desatendido: Cero interrupciones. Scorecard generado automáticamente. Supuestos documentados.
    • supervisado: Autónomo con checkpoint en scorecard antes de entrega.
    • paso-a-paso: Confirma cada tecnología evaluada, cada score, y el veredicto global.
  • {FORMATO}: markdown (default) | html | dual
  • {VARIANTE}: ejecutiva (~40% — S1 inventory + S6 scorecard only) | técnica (full forensic analysis, default)
  • {TIPO_SERVICIO}: SDA (default) | QA | Management | RPA | Data-AI | Cloud | SAS | UX-Design
    • Determines the validation lens and evidence sources

Service-Type Validation Lenses

The SUBSTANCIA/PROMESA/RIESGO/HUMO scale applies universally. What changes is WHAT gets validated:

Service TypeWhat Gets ValidatedKey Evidence Sources
SDALanguages, frameworks, libraries, architectural patternsGitHub stars, npm downloads, Stack Overflow activity, CVE database, production case studies
QATesting tools, automation frameworks, test management platformsGartner MQ, analyst reports, community adoption, plugin ecosystem, CI/CD integrations
ManagementMethodologies (SAFe, DAD, LeSS), PM tools, governance frameworksIndustry adoption rates, certification body health, community activity, case studies
RPARPA platforms (UiPath, AA, Power Automate, Blue Prism), process mining toolsGartner MQ, Forrester Wave, vendor financials, community size, partner ecosystem
Data-AIData platforms (Databricks, Snowflake), ML frameworks, AI modelsBenchmarks, academic citations, production deployments, vendor trajectory, open-source health
CloudCloud services, migration tools, IaC tools, observability platformsCloud provider roadmaps, service maturity, regional availability, compliance certifications
SASTalent platforms, assessment tools, onboarding systemsMarket adoption, integration capabilities, candidate experience ratings
UX-DesignDesign tools (Figma, Sketch), research platforms, prototyping toolsMarket share, plugin ecosystem, collaboration features, enterprise adoption

Delivery Structure: 7 Sections

S1: Technology Inventory & Claim Extraction

Para cada tecnología, framework, vendor, o componente AI/ML propuesto:

TecnologíaClaimFuente del ClaimEvidencia Requerida
{Vendor X AI Platform}"Reduce development time 50%"Vendor deck Phase 3Production case studies, benchmark
{Framework Y}"Handles 100K rps"Architecture decisionLoad test results, community benchmarks
{LLM Integration}"Automates 80% of workflows"Scenario BPilot results, accuracy metrics

S2: Software Maturity Assessment

Por cada pieza de software evaluada:

2a. Lifecycle Stage

IndicadorQué BuscarDónde
Version>=1.0 = GA; <1.0 = pre-production; 0.x = experimentalGitHub releases, docs
Release cadenceRegular = healthy; erratic = riskRelease notes timeline
Breaking changesFrequent = immature API; rare = stableChangelogs, migration guides
Deprecation policyExists = mature; absent = riskyDocumentation
LTS availabilityAvailable = enterprise-ready; absent = riskRelease policy

2b. Community Health

Métrica🟢 Healthy🟠 Warning🔴 Risk
GitHub stars>5K1K-5K<1K
Contributors (12mo)>5010-50<10
Open issues / closed ratio<30% open30-60%>60%
Last commit<30 days30-90 days>90 days
Bus factor>5 maintainers2-51 (single point of failure)
Corporate backingMajor sponsorStartup backedIndividual project

2c. Production Evidence

  • Known production users (verifiable, not "trusted by X")
  • Public postmortems or case studies
  • Stack Overflow activity (questions per month, answer rate)
  • Dependency count in npm/Maven/PyPI (who depends on this?)

S3: AI/ML Specific Validation

SECCIÓN CRÍTICA — la IA es el campo con mayor ratio humo/substancia.

Para cada componente AI/ML propuesto:

3a. Claims vs Reality Matrix

ClaimBenchmark CitadoBenchmark RealGapVeredicto
"95% accuracy"Vendor demoAcademic paper on similar task: 72-85%10-23% gap🟠 RIESGO
"Real-time inference"Marketingp95 latency in benchmarks: 2.3sDepends on SLA🟡 VIABLE

3b. AI Maturity Indicators

IndicadorSustanciaHumo
Training dataDocumented, versioned, representative"Proprietary" sin detalles
Evaluation metricsMultiple metrics, test set documentedSingle accuracy number
Failure modesDocumented, graceful degradation"Works great" sin edge cases
Drift monitoringBuilt-in, documentedNo mention
Human-in-the-loopDesigned for itFully autonomous claims
ExplainabilityInterpretable outputsBlack box
Cost per inferenceDocumentedHidden or "contact sales"
Data privacyClear data handling policyVague "we take privacy seriously"

3c. LLM-Specific Red Flags (si aplica)

  • Hallucination rate not disclosed → 🔴
  • No eval framework for domain-specific accuracy → 🟠
  • "Fine-tuned" without documented training data → 🟠
  • Claimed automation rate without error analysis → 🔴
  • No fallback for model failure/outage → 🔴
  • Vendor lock-in on model (no portability) → 🟠

S4: Vendor & Dependency Risk

4a. Vendor Viability

FactorAssessment
Funding / RevenuePublic financial data, funding rounds, runway
Customer retentionNRR if available, churn indicators
Competitive positionMarket share, differentiation, moat
Acquisition riskLikely acquirer? Product continuity post-acquisition?
Pricing model stabilityHistory of price changes, lock-in mechanisms

4b. Dependency Chain Analysis

  • Direct dependencies: count, maintenance status, license compatibility
  • Transitive dependencies: depth of tree, known vulnerabilities
  • Lock-in assessment: cost of switching to alternative
  • Supply chain risk: dependencies with single maintainer

S5: Proof-of-Concept Design

Para cada tecnología con veredicto 🟡 o 🟠, diseña un PoC mínimo:

TecnologíaPoC ObjectiveSuccess CriteriaEffortTimeline
{AI Platform}Validate accuracy on real data>85% on 100 production samples1 sprintSprint 0
{Framework Y}Load test with production-like data>50K rps at p99 <200ms3 daysSprint 0

Cada PoC debe:

  • Usar datos reales (no demo data)
  • Medir contra criteria del proyecto (no benchmarks genéricos)
  • Tener kill criteria: "Si < X, descartamos esta tecnología"

S6: Technology Viability Scorecard

SOFTWARE VIABILITY SCORECARD
════════════════════════════
Proyecto: {nombre}

| Tecnología | Maturity | Community | Production | AI Score | Vendor | VEREDICTO |
|---|---|---|---|---|---|---|
| {Tech A} | 4/5 | 4/5 | 5/5 | n/a | 4/5 | 🟢 SUBSTANCIA |
| {AI Tool B} | 2/5 | 3/5 | 2/5 | 2/5 | 3/5 | 🟠 RIESGO ALTO |
| {Framework C} | 3/5 | 4/5 | 3/5 | n/a | 5/5 | 🟡 PROMESA VIABLE |

VEREDICTO GLOBAL: [VIABLE / VIABLE CON PoCs / REQUIERE ALTERNATIVAS / NO VIABLE]

ALTERNATIVAS IDENTIFICADAS:
- {AI Tool B} → alternativa: {Open Source X} (🟢 en community, 🟡 en features)

SPIKES OBLIGATORIOS: [N]
TECNOLOGÍAS DESCARTADAS: [lista]

S7: Recommendation & Guardrails

  • Stack recomendado con justificación por componente
  • Guardrails: qué monitorear en producción para detectar degradación temprana
  • Vendor exit strategy: plan de migración si un vendor falla
  • AI governance: si hay componentes AI, framework de monitoreo y compliance
  • Re-evaluation triggers: cuándo re-ejecutar esta validación

Trade-off Matrix

DecisionEnablesConstrainsWhen to Use
Full stack validationMaximum confidence3-5 daysPre-commitment, large investment
AI-only validationFocused on highest riskMisses infra risksAI-heavy proposals
Vendor comparisonObjective selectionNeeds market researchMultiple vendor options
PoC-first approachEvidence-based decisionsDelays commitmentUnproven technologies

Assumptions & Limits

  • WebFetch available for public data (GitHub, docs, benchmarks); gated content requires user provision
  • AI evaluation limited to publicly verifiable claims; proprietary model internals not accessible
  • Vendor financial assessment limited to public information
  • Cannot execute actual PoCs — designs them; execution is Sprint 0 work

Edge Cases

ScenarioResponse
Vendor provides only marketing materialsFlag as 🟠 minimum. Request technical docs, API reference, benchmark methodology
Technology is < 6 months oldAutomatic 🟡 ceiling. Cannot be 🟢 without production evidence
AI claims "state of the art"Verify against published benchmarks (papers, leaderboards). Discount by domain gap
Open source with no corporate backingAssess bus factor and funding sustainability. Flag if bus factor = 1
Client already committed to vendorStill validate — document risks for risk register, design guardrails

Casos Borde

CasoEstrategia de Manejo
Vendor provee exclusivamente materiales de marketing sin documentacion tecnicaFlag como RIESGO ALTO minimo; solicitar API reference, benchmark methodology, production case studies; si no proporcionan, el veredicto no puede ser mejor que PROMESA VIABLE
Tecnologia tiene menos de 6 meses de existenciaTecho automatico de PROMESA VIABLE; no puede ser SUBSTANCIA sin evidencia de produccion; disenar PoC obligatorio con kill criteria
Cliente ya comprometido contractualmente con un vendorValidar igual; documentar riesgos para risk register; disenar guardrails y vendor exit strategy; no omitir problemas porque ya se firmo
Open source sin corporate backing y bus factor = 1Evaluar sostenibilidad de funding y contribuciones; flag como RIESGO ALTO por single point of failure; identificar alternativas con mejor community health

Decisiones y Trade-offs

DecisionAlternativa DescartadaJustificacion
Escala de 4 niveles (SUBSTANCIA / PROMESA VIABLE / RIESGO ALTO / HUMO)Binario (viable / no viable)Los 4 niveles permiten accion graduada: SUBSTANCIA procede, PROMESA necesita PoC, RIESGO necesita alternativa, HUMO se descarta
Seccion dedicada a AI/ML validation (S3) con red flags especificosTratar AI igual que cualquier otra tecnologiaAI tiene el mayor ratio humo/substancia del mercado; requiere validacion especifica de training data, eval metrics, failure modes, drift monitoring
Veredicto siempre contextual (proyecto + equipo + restricciones)Veredicto absoluto de la tecnologiaUna tecnologia puede ser SUBSTANCIA para un equipo experto y RIESGO ALTO para otro sin experiencia; el contexto determina el veredicto
PoC disenado para cada tecnologia con veredicto PROMESA o RIESGOConfiar en benchmarks genericos del vendorLos benchmarks genericos no aplican al contexto especifico; solo un PoC con datos reales y criteria del proyecto valida la tecnologia

Knowledge Graph

graph TD
    subgraph Core["Software Viability Core"]
        A[metodologia-software-viability]
        A1[S1: Technology Inventory]
        A2[S2: Software Maturity]
        A3[S3: AI/ML Validation]
        A4[S4: Vendor & Dependency Risk]
        A5[S5: PoC Design]
        A6[S6: Viability Scorecard]
        A7[S7: Recommendations & Guardrails]
    end
    subgraph Inputs["Inputs"]
        I1[Technology Names / Proposals]
        I2[Vendor Products]
        I3[AI/ML Components]
        I4[Architecture Decisions]
    end
    subgraph Outputs["Outputs"]
        O1[Viability Assessment Report]
        O2[Technology Scorecard]
        O3[PoC Designs]
        O4[Vendor Exit Strategy]
    end
    subgraph Related["Related Skills"]
        R1[metodologia-technical-feasibility]
        R2[metodologia-sector-intelligence]
        R3[metodologia-roadmap-poc]
        R4[metodologia-finops]
    end
    I1 --> A
    I2 --> A
    I3 --> A
    I4 --> A
    A --> A1 --> A2 --> A3 --> A4 --> A5 --> A6 --> A7
    A --> O1
    A --> O2
    A --> O3
    A --> O4
    R1 --- A
    R2 --> A
    A --> R3
    A --- R4

Output Templates

Formato MD (default):

# Software Viability Assessment — {tipo_servicio} — {proyecto}
## Resumen Ejecutivo
> Tecnologias evaluadas: N. Veredicto global: [VIABLE / VIABLE CON PoCs / REQUIERE ALTERNATIVAS / NO VIABLE].
## S1: Technology Inventory
| Tecnologia | Claim | Fuente | Evidencia Requerida |
## S2: Software Maturity
| Tecnologia | Version | Release Cadence | Community | Production Evidence | Score |
## S3: AI/ML Validation (si aplica)
| Claim | Benchmark Citado | Benchmark Real | Gap | Veredicto |
## S4-S7: [secciones completas]
## Viability Scorecard
| Tecnologia | Maturity | Community | Production | AI Score | Vendor | VEREDICTO |

Formato HTML (para comite tecnico):

Header: Logo + proyecto + veredicto global badge
Section 1: Technology Inventory (cards con semaforo por tecnologia)
Section 2: Maturity Dashboard (tabla comparativa con community health indicators)
Section 3: AI/ML Red Flags (si aplica, cards con hallazgos criticos)
Section 4: Vendor Risk Assessment (visual con scoring)
Section 5: PoC Designs (tabla con effort, timeline, success criteria)
Section 6: Viability Scorecard (tabla resumen con veredictos)
Section 7: Recommendations & Guardrails (action items priorizados)
Footer: Attribution MetodologIA + re-evaluation triggers

DOCX (bajo demanda)

  • Filename: {fase}_software_viability_{cliente}_{WIP}.docx
  • Generado 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: Technology Inventory, Maturity Assessment, AI/ML Validation, Vendor Risk, PoC Designs, Viability Scorecard, Recommendations.

XLSX (bajo demanda)

  • Filename: {fase}_software_viability_{cliente}_{WIP}.xlsx
  • Generado via openpyxl con MetodologIA Design System v5. Encabezados con fondo navy y texto Poppins blanco, cuerpo en Montserrat, zebra striping en filas. Hojas: Technology Inventory (tecnología, claim, fuente del claim, evidencia requerida, tipo de servicio), Maturity Assessment (tecnología, versión, release cadence, community health, production evidence, bus factor, score), AI/ML Validation (claim, benchmark citado, benchmark real, gap, veredicto), Vendor Risk (vendor, funding/revenue, competitive position, acquisition risk, pricing stability, lock-in assessment), PoC Designs (tecnología, objetivo PoC, success criteria, kill criteria, esfuerzo, timeline), Viability Scorecard (tecnología, maturity, community, production, AI score, vendor, veredicto). Conditional formatting por veredicto SUBSTANCIA/PROMESA/RIESGO/HUMO. Auto-filters en todas las hojas. Valores directos sin fórmulas.

PPTX (bajo demanda)

  • Filename: {fase}_software_viability_{cliente}_{WIP}.pptx
  • Generado 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 (veredicto global), Technology Inventory, Viability Scorecard (tabla con semáforo SUBSTANCIA/PROMESA/RIESGO/HUMO), AI/ML Red Flags (si aplica), PoC Designs priorizados, Recomendaciones y guardrails, próximos pasos.

HTML (bajo demanda)

  • Filename: {fase}_software_viability_{cliente}_{WIP}.html
  • Estructura: HTML self-contained branded (Design System MetodologIA v5). Light-First Technical. Viability scorecard con badges SUBSTANCIA/PROMESA/RIESGO/HUMO por tecnología, community health indicators visuales y PoC design cards con kill criteria. WCAG AA, responsive, print-ready.

Evaluacion

DimensionPesoCriterioUmbral Minimo
Trigger Accuracy10%El skill se activa ante prompts de viabilidad tecnologica, vaporware detection, AI validation, vendor evaluation, tech due diligence7/10
Completeness25%Todas las tecnologias propuestas inventariadas; maturity assessment por tecnologia; AI validation para componentes AI; PoC disenado para PROMESA/RIESGO7/10
Clarity20%Scorecard con veredicto claro por tecnologia y global; escala SUBSTANCIA/PROMESA/RIESGO/HUMO aplicada consistentemente7/10
Robustness20%Edge cases cubiertos (solo marketing, tech nueva, ya comprometido, OSS sin backing); alternativas identificadas para RIESGO/HUMO7/10
Efficiency10%Variante ejecutiva vs tecnica correctamente aplicada; tipo de servicio determina lens de validacion; no se ejecuta forensic completo cuando solo se necesita screening7/10
Value Density15%Evidence tags en todas las assertions; PoC con kill criteria especificos; vendor exit strategy para dependencias comerciales; guardrails de produccion definidos7/10

Umbral minimo global: 7/10. Si alguna dimension cae por debajo, el entregable requiere revision antes de entrega.

Validation Gate

  • Every proposed technology inventoried with claims extracted
  • Maturity assessment (lifecycle, community, production) per technology
  • AI/ML specific validation for all AI components (with humo/substancia verdict)
  • Vendor risk assessment for all commercial dependencies
  • PoC designed for every 🟡/🟠 technology
  • Viability scorecard complete with global verdict
  • Alternatives identified for every 🟠/🔴 technology
  • Evidence tags on all assertions

Output Format Protocol

FormatDefaultDescription
markdown✅Rich 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: Viability_Assessment_{TIPO_SERVICIO}_{project}.md — Technology inventory, maturity assessment, AI validation, vendor risk, PoC designs, viability scorecard, recommendations.

Diagrams (Mermaid)

  • Flowchart: technology maturity assessment flow
  • State diagram: viability verdict decision process (SUBSTANCIA → PROMESA → RIESGO → HUMO)

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

Repository
JaviMontano/mao-pm-apex
Last updated
First committed

Canonical home

JaviMontano/mao-discovery-framework
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.