cto-advisor
por alirezarezvanicto-advisor es una skill de liderazgo CTO para decisiones de arquitectura, deuda técnica, métricas de ingeniería, evaluación de tecnología, escalado de equipos y planificación estratégica. Incluye ADR, DORA, frameworks de evaluación y herramientas en Python para análisis de deuda y escalado de equipos.
Esta skill obtiene 82/100, por lo que es una candidata sólida para el directorio. Los usuarios encuentran una skill de asesoría para CTO bien delimitada, con disparadores claros, frameworks reutilizables y scripts prácticos, aunque su adopción sería más sencilla con instrucciones de instalación más claras y rutas de ejecución más acotadas para distintos escenarios de CTO.
- Alta capacidad de activación: la descripción del frontmatter menciona explícitamente casos de uso como deuda técnica, escalado de equipos, decisiones de arquitectura, evaluación de tecnología, métricas de ingeniería, métricas DORA y estrategia tecnológica.
- Buen soporte operativo: la skill incluye una guía SKILL.md amplia, además de frameworks de referencia para ADRs, métricas de ingeniería y evaluación de tecnología.
- Aporta más valor que un prompt genérico gracias a dos herramientas en Python para análisis de deuda técnica y escalado de equipos de ingeniería, con una sección de comandos de inicio rápido.
- No se proporciona ningún comando de instalación ni README en la ruta de la skill, por lo que los usuarios deben deducir la instalación a partir del contexto general del repositorio.
- El alcance es amplio —estrategia de CTO, arquitectura, métricas, escalado de equipos y deuda técnica—, así que los agentes pueden necesitar contexto específico del usuario para evitar recomendaciones de liderazgo demasiado genéricas.
Descripción general de la skill cto-advisor
Para qué sirve cto-advisor
cto-advisor es una skill de liderazgo técnico para convertir problemas de ingeniería desordenados en orientación estructurada de nivel CTO. Encaja mejor en decisiones de arquitectura, priorización de deuda técnica, métricas de ingeniería, evaluación de tecnologías, escalado de equipos y planificación estratégica cuando la respuesta necesita compensaciones, secuenciación y razonamiento listo para dirección, no solo recomendaciones a nivel de código.
Usuarios y decisiones para los que encaja mejor
La skill cto-advisor es útil para fundadores, CTOs, VPs of Engineering, staff engineers, responsables de plataforma y managers técnicos con visión de producto que necesitan decidir qué arreglar, construir, comprar, medir o reorganizar. Es especialmente útil cuando el contexto es parcial: un cuello de botella de escalado, una elección de arquitectura poco clara, una acumulación de deuda o una petición de liderazgo como “crear un roadmap tecnológico de 12 meses”.
Qué la diferencia de un prompt genérico
Un prompt normal puede generar recomendaciones amplias. Esta skill añade marcos reutilizables de CTO: registros de decisión al estilo ADR, métricas DORA y de productividad, matrices de evaluación tecnológica, categorías de deuda técnica y cálculos para escalar equipos. Su valor práctico no es simplemente dar “consejos”; ayuda a convertir la ambigüedad de ingeniería en opciones priorizadas, riesgos medibles y próximos pasos.
Dónde cto-advisor aporta más valor
Usa cto-advisor para Strategic Planning cuando el problema combina tecnología, personas, coste, fiabilidad y velocidad de entrega. Funciona mejor cuando puedes aportar contexto del sistema, restricciones actuales, objetivos de negocio y síntomas de fallo. Es menos adecuada para depuración de implementación muy especializada, ajustes profundos específicos de un proveedor o decisiones legales/de compliance que requieren una revisión autorizada.
Cómo usar la skill cto-advisor
Instalación de cto-advisor y archivos que conviene leer primero
Instala la skill con:
npx skills add alirezarezvani/claude-skills --skill cto-advisor
Después de la instalación, empieza por SKILL.md para entender el alcance de activación y los flujos de trabajo de liderazgo. Luego lee estos archivos según tu tarea:
references/architecture_decision_records.mdpara decisiones de arquitectura y formato de salida ADRreferences/engineering_metrics.mdpara métricas DORA, de calidad, productividad y fiabilidadreferences/technology_evaluation_framework.mdpara decisiones build-vs-buy o selección de proveedoresscripts/tech_debt_analyzer.pypara la lógica de puntuación de deuda técnicascripts/team_scaling_calculator.pypara planificación de headcount y estructura de ingeniería
El repositorio no depende de un runtime grande, pero los scripts auxiliares son archivos Python, así que asegúrate de tener Python 3 disponible si quieres ejecutarlos localmente.
Inputs que mejoran el uso de cto-advisor
La skill funciona mejor cuando tu prompt incluye el objetivo de negocio, el estado actual de ingeniería, las restricciones, las opciones en evaluación y la fecha límite de decisión. Evita preguntar “¿Cuál debería ser nuestra arquitectura?” sin contexto. En su lugar, aporta los factores que impulsan la decisión.
Patrón de prompt más sólido:
Use cto-advisor to evaluate whether our SaaS platform should move from a modular monolith to services. Current team: 18 engineers, 2 platform engineers, weekly deploys, 99.5% uptime target, PostgreSQL bottlenecks, customer growth from 200 to 1,000 accounts in 12 months. Constraints: 6-month roadmap, limited DevOps capacity, compliance audit in Q3. Produce an ADR-style recommendation with options, risks, migration phases, and metrics to track.
Esto da a la skill suficiente información para razonar sobre compensaciones, en lugar de recurrir por defecto a consejos de arquitectura de moda.
Flujo de trabajo práctico para tomar decisiones
Para la mayoría de decisiones de liderazgo, usa un flujo de cuatro pasos:
- Enmarca la decisión: define el problema, el resultado de negocio, el horizonte temporal y las restricciones no negociables.
- Pide un análisis estructurado: solicita un ADR, una matriz de evaluación tecnológica, un plan de remediación de deuda, un modelo de escalado de equipo o un dashboard de métricas según la decisión.
- Valida los supuestos: comprueba si la salida depende de datos no verificados, como frecuencia de incidentes, datos de despliegue, habilidades del equipo o estimaciones de coste.
- Convierte el análisis en acción: pide un plan de 30/60/90 días, responsables, hitos, riesgos y criterios de éxito medibles.
Para trabajo de deuda técnica, ejecuta o inspecciona scripts/tech_debt_analyzer.py para entender cómo se ponderan las categorías de deuda entre arquitectura, calidad de código, infraestructura, seguridad y rendimiento. Para crecimiento del equipo, revisa scripts/team_scaling_calculator.py antes de aceptar ratios de roles sugeridos.
Ejemplos de prompts según el trabajo a realizar
Para deuda técnica:
Use cto-advisor to prioritize technical debt across architecture, infrastructure, security, and performance. Our main pain points are manual deployments, low test coverage, slow queries, and outdated dependencies. Create a severity-ranked remediation plan with business impact, effort, dependencies, and first 3 actions.
Para evaluación tecnológica:
Use cto-advisor to compare Kafka, RabbitMQ, and managed cloud queues for event-driven order processing. Include functional requirements, non-functional requirements, TCO, operational burden, team expertise, exit risk, and a scoring matrix.
Para métricas de ingeniería:
Use cto-advisor to design an engineering metrics dashboard for a 35-person product engineering org. Include DORA metrics, quality indicators, reliability metrics, measurement method, target ranges, and behaviors to avoid incentivizing.
FAQ de la skill cto-advisor
¿cto-advisor es adecuada para principiantes?
Sí, si la persona usuaria necesita un marco de decisión más que una estrategia ejecutiva ya cerrada. Los principiantes deberían pedir definiciones, ejemplos y razonamiento paso a paso. Aun así, las recomendaciones deben revisarlas personas que entiendan el sistema, la organización y las restricciones de negocio.
¿Cuándo no debería usar cto-advisor?
No uses cto-advisor como autoridad final para aprobar seguridad, cumplimiento legal, previsiones financieras o arquitectura de producción. Puede estructurar el análisis, revelar compensaciones y redactar registros de decisión, pero las decisiones reales deben validarse con datos del sistema, aportes de stakeholders y revisión experta.
¿En qué se diferencia cto-advisor de una skill de arquitectura?
Una skill centrada solo en arquitectura suele enfocarse en diseño de sistemas. La skill cto-advisor cubre la arquitectura como una parte de una decisión de liderazgo más amplia: alineación con el roadmap, capacidad del equipo, deuda técnica, métricas de entrega, implicaciones de contratación, coste, riesgo y gobernanza. Eso la hace más útil para planificación transversal que para diagramas de diseño aislados.
¿Encaja en equipos pequeños y startups?
Sí. Los equipos pequeños pueden usarla para evitar sobreingeniería, comparar decisiones build-vs-buy, planificar contratación y decidir qué deuda conviene tolerar. La clave es expresar con claridad las restricciones de una startup: runway, tamaño del equipo, urgencia de clientes, tolerancia operativa y qué debe mantenerse simple.
Cómo mejorar la skill cto-advisor
Mejora los resultados de cto-advisor con más contexto
La forma más rápida de mejorar los resultados de cto-advisor es reemplazar objetivos vagos por contexto listo para decidir. Incluye tamaño actual del equipo, arquitectura, cadencia de despliegue, historial de incidentes, límites de coste, crecimiento de clientes, necesidades de compliance y restricciones conocidas. Si no tienes métricas, dilo y pide a la skill que identifique qué datos conviene recopilar antes de decidir.
Fallos habituales que conviene vigilar
El principal riesgo es recibir recomendaciones demasiado idealizadas para la capacidad real de tu equipo. Vigila planes que asumen más madurez de plataforma, automatización, personal o presupuesto del que tienes. También cuestiona salidas que recomienden microservices, gobernanza pesada o programas amplios de métricas sin conectarlos con un problema de negocio.
Itera desde la estrategia hasta la ejecución
Después de la primera salida, haz preguntas de seguimiento que obliguen a priorizar:
What assumptions would change this recommendation?What is the smallest reversible next step?Which option is best if we optimize for 6-month delivery speed?Which risks need executive approval?Turn this into an ADR with negative consequences included.
Esto convierte el uso de cto-advisor de una recomendación puntual en un flujo de trabajo de decisión.
Valida con los frameworks y scripts del repositorio
Usa las referencias incluidas como checklists antes de adoptar la respuesta. Compara las recomendaciones de arquitectura con references/architecture_decision_records.md, las sugerencias de métricas con references/engineering_metrics.md y las comparaciones de proveedores con references/technology_evaluation_framework.md. Para planificación cuantitativa, inspecciona o adapta los scripts de Python en lugar de tratar los números generados como autoridad final.