mao-discovery-framework

This skill should be used when the user asks to "create a Sofka HTML document", "generate a branded report", "build an executive deliverable", "upgrade HTML to brand standards", "fix broken Sofka styles", "convert markdown to HTML", "batch convert deliverables to HTML", or mentions Sofka HTML, entregable, brand deliverable, Design System v5, Dark Authority, or any combination of Sofka + document/report/summary/analysis/roadmap. Also use when batch-upgrading existing HTML files to Sofka brand compliance, even if the user does not explicitly say "brand". Triggers on: convert to HTML, branded HTML, DS v5, markdown to HTML pipeline, Mermaid diagrams in HTML.

WCAG 2.1/2.2 compliance assessment — a11y testing strategy, remediation priorities, inclusive design. Use when the user asks to "audit accessibility", "assess WCAG compliance", "evaluate a11y", "review inclusive design", or mentions screen readers, ARIA, color contrast, keyboard navigation.

Adoption strategy design producing communication plan, training roadmap, resistance management tactics, and reinforcement mechanisms. Use when the user asks to "design adoption strategy", "plan change adoption", "communication plan", "training needs analysis", "resistance management", "adoption roadmap", "change communication", or mentions "post-implementation adoption", "user onboarding strategy", "technology adoption plan".

Use when the user asks to "assess agile maturity", "evaluate agile practices", "run agile readiness check", "benchmark Scrum adoption", or "audit agile capabilities". Activates when a stakeholder needs to measure agile adoption level, evaluate Scrum maturity, diagnose agile anti-patterns, compare agile readiness across teams, or baseline agile capability before a transformation initiative.

Audits existing AI system architectures against best practices — structural integrity, AI quality attributes, pattern adherence, anti-pattern detection, security compliance, and technical debt inventory. This skill should be used when the user asks to "audit AI architecture", "review ML system quality", "assess AI technical debt", "evaluate AI compliance", "detect AI anti-patterns", "review AI security posture", or mentions AI architecture review, AI system assessment, AI quality audit, drift monitoring audit, or AI governance review.

Guides implementation of AI system architectures — technology selection, pipeline implementation, model serving setup, monitoring deployment, and CI/CD automation. This skill should be used when the user asks to "implement AI architecture", "build ML pipeline", "set up model serving", "deploy AI system", "implement MLOps", "configure drift monitoring", "set up feature store", or mentions AI implementation plan, ML infrastructure setup, model deployment guide, RAG implementation, or agent framework setup.

AI Center services discovery — AI readiness assessment using MetodologIA AI SCALE methodology, use case portfolio prioritization, data readiness evaluation, model inventory, AI governance assessment, infrastructure evaluation, MetodologIA AI product integration, and AI adoption roadmap. Use when the user asks to "assess AI readiness", "evaluate AI maturity", "AI discovery", "AI use case prioritization", "MLOps assessment", "AI governance evaluation", "AI adoption roadmap", "AI strategy assessment", "evaluate AI infrastructure", "AI product fit", or mentions "AI SCALE", "responsible AI", "AI pilots", "ML pipeline", "AI Center of Excellence", "LLM adoption", "generative AI strategy".

Concept of Operations (CONOPS) for AI systems — system vision, stakeholder mapping, AI-human interaction spectrum, business value assessment, success metrics, and operational modes. This skill should be used when the user asks to "define the AI operational concept", "map AI stakeholders", "design AI-human interaction levels", "assess AI business value", "define AI success metrics", "plan AI operational modes", or mentions CONOPS, IEEE 1362, AI autonomy levels, AI value matrix, or AI system vision.

AI-specific design patterns and system tactics — Feature Store, Champion-Challenger, Shadow Deployment, Drift Detection, Explainability Wrapper, Canary Deployment, Bulkhead, and traditional patterns adapted for AI. This skill should be used when the user asks to "select AI design patterns", "apply ML patterns", "design drift detection", "implement feature store", "plan shadow deployment", "design champion-challenger", "select availability tactics for AI", or mentions AI anti-patterns, maintainability tactics, fault recovery for models, or pattern selection for ML systems.

AI pipeline architecture design — development pipelines, production pipelines, data stores, model registry, CI/CD for AI, and non-functional requirements. This skill should be used when the user asks to "design AI pipelines", "architect ML pipelines", "select data stores for AI", "design model registry", "implement CI/CD for ML", "define AI pipeline requirements", or mentions MLOps, training pipeline, inference pipeline, feature pipeline, Blue and Gold deployment, or pipeline patterns.

Use when the user asks to "use AI for project management", "augment PM with AI", "implement predictive scheduling", "parse status with NLP", or "design ML risk models". Activates when a stakeholder needs to identify AI augmentation opportunities for PM, build predictive scheduling models, automate status report parsing with NLP, design intelligent resource allocation, or create a human-AI collaboration model for project governance.

AI software architecture design — modules, layers, boundaries, design patterns, ADRs, quality attributes, and technical debt strategy for AI-enabled systems. This skill should be used when the user asks to "design AI system structure", "define AI module boundaries", "select AI architecture patterns", "document AI architecture decisions", "evaluate AI code architecture", or mentions AI pipelines, feature stores, model serving, drift detection, ML quality attributes, explainability architecture, or AI technical debt.

Comprehensive testing strategy for AI systems — testing scope matrix (6 types x 6 layers), model prediction testing, data quality testing, compliance and fairness testing, integration approaches, and CI/CD test automation. This skill should be used when the user asks to "define AI testing strategy", "test ML models", "design data quality tests", "plan fairness testing", "test AI pipelines", "design integration tests for ML", or mentions adversarial testing, drift simulation, model regression testing, bias testing, explainability testing, or AI test automation.

Análisis horizontal de estados financieros (P&L, Balance General, Flujo de Caja, notas/anexos) con comparación YoY de 2 períodos. Genera informes ejecutivos estandarizados para Junta Directiva y C-Level con variaciones absolutas, relativas, drivers de cambio, alertas y recomendaciones estratégicas. Usa esta skill SIEMPRE que el usuario mencione análisis horizontal, comparar estados financieros, variación año contra año, YoY, análisis de tendencias financieras, comparación de períodos, evolución financiera, cambios interanuales, delta financiero, o adjunte cualquier estado financiero y pida análisis comparativo. Trigger: análisis horizontal, comparar estados financieros, YoY, variación interanual, evolución financiera, delta financiero, comparar períodos.

Analytics pipeline design — dbt-style transformations, data modeling, testing, documentation. Use when the user asks to "design analytics models", "set up dbt project", "plan data transformations", "define data contracts", "model star schema", or mentions staging models, marts, incremental strategies, or materializations.

API design & governance — REST/GraphQL/gRPC, versioning, rate limiting, DX, contract-first. Use when the user asks to "design an API", "define API strategy", "implement contract-first", "set up API governance", "design API versioning", "improve developer experience", or mentions REST, GraphQL, gRPC, AsyncAPI, OpenAPI, API gateway, rate limiting, or API catalog.

Target state (TO-BE) architecture design — C4 L2 containers, ADRs, nightmare scenario mitigations, MVP component, phased Strangler Fig migration. Use when the user asks to "design the target architecture", "create a TO-BE architecture", "plan a migration strategy", "define ADRs for a new system", "mitigate nightmare scenarios", or mentions Strangler Fig, C4 diagrams, saga pattern, anti-corruption layer, or legacy modernization.

Universal current-state assessment producing 10-section analysis for ANY MetodologIA service type. Use when the user asks to "analyze the codebase", "assess current architecture", "run AS-IS analysis", "technical audit", "evaluate tech debt", "code quality assessment", "assess current state", "service assessment", "QA maturity", "PMO assessment", "RPA readiness", "data maturity", "cloud readiness", "design maturity", "talent gap analysis", or mentions "Phase 1", "current state", "legacy system review", "technical health check".

Use when the user asks to "track assumptions", "document constraints", "log assumptions", "manage project assumptions", or "validate planning hypotheses". Activates when a stakeholder needs to create an assumption register, document project constraints, link assumptions to risks, establish assumption validation cadence, or audit planning hypotheses across the project lifecycle.

Use when the user asks to "identify PM automation candidates", "automate PM reporting", "reduce manual PM processes", "find automation quick wins", or "design workflow automation". Activates when a stakeholder needs to scan PM processes for automation potential, calculate automation ROI, design automation specifications, prioritize automation backlog, or plan phased automation rollout across the PMO.

Audits AWS AI/GenAI architectures against the Well-Architected GenAI Lens — operational excellence, security, reliability, performance, cost optimization, and sustainability. This skill should be used when the user asks to "audit AWS AI architecture", "review Bedrock configuration", "assess SageMaker security", "optimize AWS AI costs", "evaluate AWS GenAI compliance", "review AWS Well-Architected for AI", or mentions AWS AI audit, Bedrock audit, SageMaker review, AWS GenAI security assessment, or AWS AI cost optimization review.

Designs AWS cloud architectures for AI and GenAI workloads applying the Well-Architected Framework GenAI Lens (6 pillars: GENOPS, GENSEC, GENREL, GENPERF, GENCOST, GENSUS), AWS service selection matrices, RAG/Agent/Fine-Tuning patterns, cost optimization strategies, and enterprise reference architectures. Activated when designing, evaluating, or migrating AI systems on AWS.

Guides implementation of AI/GenAI architectures on AWS — Bedrock setup, SageMaker pipelines, OpenSearch vector stores, API Gateway configuration, security hardening, cost controls, and deployment automation. This skill should be used when the user asks to "implement AI on AWS", "set up Bedrock", "deploy SageMaker pipeline", "configure OpenSearch for RAG", "implement AWS AI security", "set up AWS AI monitoring", or mentions AWS AI deployment, Bedrock Knowledge Base setup, SageMaker endpoint deployment, AWS GenAI implementation, or AWS AI CI/CD pipeline.

Use when the user asks to "plan benefits realization", "define KPIs", "track success metrics", "establish benefits framework", or "measure project value delivery". Activates when a stakeholder needs to link deliverables to business outcomes, define measurable KPIs with targets, design post-project benefit tracking, create a benefits ownership matrix, or establish a sustainability plan for realized benefits.

BI and analytics service discovery — data maturity assessment (DCAM/DMM), dashboard landscape inventory, semantic layer evaluation, self-service analytics readiness, data literacy assessment, analytics use case portfolio, and BI transformation roadmap. Distinct from bi-architecture (design skill); this is the discovery/assessment for BI-as-a-service engagements. Use when the user asks to "assess BI maturity", "evaluate analytics capabilities", "dashboard inventory", "data literacy assessment", "semantic layer review", "self-service analytics readiness", "analytics use case prioritization", "BI transformation roadmap", or mentions BI-as-a-service, analytics maturity, dashboard consolidation, data democratization, DCAM, DMM, or data literacy.

BI solution design — semantic layers, dashboard patterns, self-service analytics, KPI frameworks. Use when the user asks to "design BI architecture", "build a KPI framework", "set up self-service analytics", "design dashboard hierarchy", "create a semantic layer", or mentions metric trees, drill-down patterns, or reporting strategy.

Generates branded DOCX (Word) documents using the MetodologIA Neo-Swiss Design System v6. Uses python-docx to create professional documents with navy headers, gold accents, Poppins headings, and Trebuchet MS body text. Use when the user requests a Word document, DOCX output, or when the ghost menu routes to DOCX.

Generates branded PPTX (PowerPoint) presentations using the MetodologIA Neo-Swiss Design System v6. Uses python-pptx to create slide decks with navy backgrounds, gold accents, Poppins titles, and Trebuchet MS body text. Use when the user requests a presentation, slide deck, PPTX output, or when the ghost menu routes to PPTX format.

Generates branded XLSX (Excel) spreadsheets using the MetodologIA Neo-Swiss Design System v6. Uses openpyxl to create professional spreadsheets with navy headers, gold accent rows, and semantic conditional formatting. Use when the user requests a spreadsheet, XLSX output, or when the ghost menu routes to XLSX.

Use when the user asks to "create a budget", "estimate costs", "define contingency reserves", "build cost breakdown structure", or "establish a cost baseline for EVM". Activates when a stakeholder needs to produce a cost baseline, aggregate bottom-up estimates, calculate contingency and management reserves, generate a time-phased budget with S-curve, or define cost accounts for earned value tracking.

Use when the user asks to "track budget", "monitor costs", "review budget variance", "check contingency burn", or "forecast remaining project costs". Activates when a stakeholder needs to analyze cost variances against baseline, monitor contingency reserve consumption, update budget forecasts, generate burn rate analysis, or produce corrective action recommendations for cost overruns.

Use when the user asks to "plan capacity", "forecast resource demand", "analyze resource availability", "match supply to demand", or "model resource scenarios". Activates when a stakeholder needs to analyze resource supply vs demand, identify capacity gaps, detect over-allocations, build time-phased capacity models, or plan proactive hiring and cross-training decisions before bottlenecks impact delivery.

Use when the user asks to "design ceremonies", "plan meeting cadence", "create facilitation guides", "define ceremony templates", or "optimize meeting calendar". Activates when a stakeholder needs to design a complete ceremony calendar, define time-boxes and agendas per ceremony, create facilitation guides, identify ceremony anti-patterns, or measure ceremony effectiveness across the project lifecycle.

Use when the user asks to "facilitate a ceremony", "run a retrospective", "lead sprint planning", "moderate a meeting", or "design facilitation techniques". Activates when a stakeholder needs facilitation guides for project ceremonies, engagement techniques for team workshops, conflict navigation protocols for heated discussions, anti-pattern recognition during ceremony execution, or ceremony effectiveness measurement.

Use when the user asks to "set up change control", "evaluate change requests", "manage scope changes", "establish CCB governance", or "process a change request". Activates when a stakeholder needs to establish a change control process, create change request templates, define CCB composition and decision criteria, evaluate change impact on scope/schedule/cost, or track change request trends across the project.

Organizational change readiness assessment producing readiness scorecard, resistance map, and intervention plan. Use when the user asks to "assess change readiness", "evaluate organizational readiness", "change impact analysis", "resistance mapping", "ADKAR assessment", "readiness scorecard", or mentions "Phase 5b", "adoption risk", "organizational capacity for change".

CLI interactivo de inicialización que configura el entorno del cliente, pre-puebla discovery/, ejecuta G0 security scan y prepara el contexto para discovery.

Use when the user asks to "audit PM tools visually", "inspect Jira configuration", "review Azure DevOps setup", "check Monday.com boards", or "evaluate tool configuration". Activates when a stakeholder needs to perform a visual audit of PM tool configurations, capture screenshot evidence of misconfigurations, compare tool setup against methodology best practices, identify workflow anti-patterns in PM tools, or produce a remediation roadmap for tool optimization.

Use when the user asks to "close the project", "generate closure report", "document final metrics", "perform administrative closure", or "obtain formal acceptance". Activates when a stakeholder needs to produce a project closure report, compare final actuals vs baseline, compile lessons learned, obtain formal sponsor acceptance, or execute administrative closure including resource release and documentation archiving.

Cloud migration planning -- 7R assessment, workload classification, wave planning, cutover. Use when the user asks to "plan cloud migration", "assess workloads for migration", "design landing zone", "create migration waves", "plan cutover strategy", or mentions 7R, rehost, replatform, refactor, lift-and-shift, or migration factory.