cto-review

Resumen de la skill cto-review

Qué hace cto-review

cto-review es una skill de revisión estratégica de ingeniería para poner a prueba decisiones de arquitectura, escalabilidad, deuda técnica, contratación y build-vs-buy antes de que se conviertan en compromisos costosos. Está diseñada en torno al patrón de comando /cs:cto-review <plan> y plantea preguntas de presión al estilo CTO: dónde se rompe el sistema, qué deuda empieza a bloquear el avance, si el equipo puede escalar el plan y si comprar resulta más racional que construir.

Mejor encaje para decisiones de Strategic Planning

La skill cto-review resulta más útil cuando ya tienes un plan concreto, no solo una idea difusa. Buenos casos de uso incluyen aprobar una nueva base de datos, planificar para multiplicar el tráfico por 10, decidir si reconstruir un sistema legacy, evaluar una migración de plataforma o preparar una revisión de estrategia técnica para liderazgo. Es especialmente relevante para Strategic Planning cuando las decisiones de ingeniería afectan el presupuesto, la contratación, la confiabilidad y el riesgo de ejecución a largo plazo.

Qué la diferencia de un prompt genérico

Un prompt genérico de IA puede producir recomendaciones amplias de arquitectura. cto-review centra la conversación en seis preguntas de decisión que sacan a la luz puntos de quiebre de escalabilidad, el costo semanal de la deuda técnica, las restricciones de incorporación del equipo y el costo total de propiedad a tres años. Esa estructura la hace más útil para revisiones ejecutivas, aprobación de arquitectura y análisis de riesgos antes de asumir compromisos que una lluvia de ideas abierta.

Notas importantes de adopción

La ruta del repositorio contiene un único SKILL.md para esta skill, sin README.md, metadata.json, reglas, recursos ni scripts auxiliares empaquetados dentro de la carpeta de la skill. La fuente referencia scripts de análisis mediante rutas relativas dentro de un área más amplia de cto-advisor, así que verifica la disponibilidad de esos scripts en tu entorno instalado antes de depender de esos comandos. El valor principal de cto-review es el marco de revisión; la automatización puede requerir configuración adicional.

Cómo usar la skill cto-review

Instalación de cto-review y revisión del repositorio

Instálala desde la colección de skills de GitHub con tu gestor de skills, por ejemplo:

npx skills add alirezarezvani/claude-skills --skill cto-review

Después de instalarla, abre:

c-level-advisor/c-level-agents/skills/cto-review/SKILL.md

Lee primero este archivo porque contiene el comando, las condiciones de activación y las seis preguntas de CTO. Revisa también el repositorio circundante si tu entorno de agente conserva rutas relativas, porque la skill referencia scripts fuera de la carpeta local, como cto-advisor/scripts/tech_debt_analyzer.py y cto-advisor/scripts/team_scaling_calculator.py.

Datos de entrada que necesita la skill

Para usar cto-review con buenos resultados, proporciona un plan con suficiente detalle operativo como para que la skill pueda cuestionar los supuestos. Incluye:

• Escala actual: usuarios, solicitudes por segundo, volumen de datos, tenants, regiones o conteo de transacciones
• Escala objetivo: crecimiento esperado, escenario 10x, evento de lanzamiento, expansión enterprise o fecha límite de migración
• Arquitectura: servicios, elecciones de datastore, colas, dependencias, modelo de despliegue y objetivos de confiabilidad
• Restricciones: presupuesto, tamaño del equipo, plan de contratación, compliance, límites de proveedores, plazos y SLOs
• Decisión en revisión: aprobar, retrasar, comprar, construir, reconstruir, migrar o ejecutar un experimento

Entrada débil: “Review our new architecture.”

Entrada más sólida: “Use cto-review for Strategic Planning. We are moving from a monolith on PostgreSQL to event-driven services before expanding from 50k to 500k monthly active users. Current p95 API latency is 700ms during peak, writes are concentrated on one primary DB, the team has 8 engineers and plans to hire 4 more. Review scaling cliffs, tech debt cost, team ramp risk, and whether managed event streaming is better than building our own platform.”

Flujo práctico para usar cto-review

Empieza pegando el plan después del estilo de comando que usa la skill:

/cs:cto-review <your plan>

Pide una salida orientada a la decisión, no un ensayo general. Algunos formatos útiles son:

• “List the top 5 approval blockers.”
• “Identify the first scaling cliff and the evidence needed to confirm it.”
• “Compare build vs buy over three years.”
• “Separate reversible experiments from irreversible commitments.”
• “Give the questions I should ask the engineering lead before approval.”

Si la primera respuesta resulta demasiado especulativa, añade los datos que faltan en lugar de pedirle al modelo que “try again”. La skill está diseñada para interrogar un plan; gana valor a medida que aportas datos reales de carga, estimaciones de costos, supuestos de dotación e historial de incidentes.

Archivos y comandos que conviene verificar primero

El único archivo confirmado de la skill es SKILL.md. Incluye ejemplos de llamadas a scripts, pero esta carpeta específica de la skill no incluye scripts locales. Antes de incorporar esos scripts a tu flujo de trabajo, comprueba si estas rutas existen después de la instalación:

../../../skills/cto-advisor/scripts/tech_debt_analyzer.py

../../../skills/cto-advisor/scripts/team_scaling_calculator.py

Si no existen, aún puedes usar la guía de cto-review manualmente aportando tu propio inventario de deuda técnica y supuestos de incorporación del equipo en el prompt.

Preguntas frecuentes sobre la skill cto-review

¿cto-review es adecuada para principiantes?

Sí, si la persona usuaria tiene una decisión de ingeniería concreta que revisar. No es un tutorial para principiantes sobre diseño de sistemas, arquitectura cloud o selección de bases de datos. Una persona fundadora junior o líder de producto puede usarla bien si aporta objetivos de negocio y pide al agente que traduzca los riesgos técnicos en preguntas de decisión, pero el juicio final debería involucrar a una persona con experiencia en ingeniería.

Cuándo no conviene usar cto-review

No uses cto-review para pequeñas decisiones de implementación, revisiones rutinarias de código, refinamiento de tickets o depuración de un defecto acotado. Tampoco encaja bien cuando todavía no existe un plan. Úsala cuando el costo de equivocarse sea relevante: migración de plataforma, decisión costosa sobre un proveedor, inversión en escalabilidad, rediseño de confiabilidad, plan de contratación o propuesta de reconstrucción.

Cómo se compara con un prompt de revisión de arquitectura

Un prompt de revisión de arquitectura suele evaluar patrones de diseño, componentes y tradeoffs. La skill cto-review añade presión ejecutiva: costo semanal de la deuda, escalabilidad del equipo, umbrales de fallo y economía de build-vs-buy. Por eso funciona mejor para una revisión de go/no-go que para producir desde cero una arquitectura de referencia completa.

¿cto-review requiere los scripts referenciados?

No. La skill cto-review principal es un método de revisión estructurado en SKILL.md. Los scripts referenciados pueden mejorar el análisis si están disponibles, pero la skill puede ejecutarse solo con prompts. Trata el soporte de scripts como opcional hasta confirmar que los archivos existen en tu instalación local.

Cómo mejorar la skill cto-review

Mejora las entradas de cto-review antes de pedir un juicio

El modo de fallo más común es pedir una revisión de CTO sin números. Añade aunque sea rangos aproximados: “current write rate is 2k/min,” “expected peak is 10x after launch,” “vendor quote is $180k/year,” o “team has two backend engineers with no Kafka experience.” Estos detalles permiten que cto-review identifique puntos de quiebre reales de escalabilidad en lugar de riesgos genéricos.

Pide brechas de evidencia, no solo recomendaciones

Una buena guía de cto-review debe decirte qué hay que medir antes de aprobar. Pregunta: “What evidence is missing?” o “Which assumptions need a load test, cost model, prototype, or vendor reference call?” Esto convierte la salida en un plan de acción y reduce la falsa confianza que pueden generar consejos de arquitectura plausibles pero no verificados.

Itera con restricciones de decisión

Después de la primera revisión, acota la decisión. Por ejemplo: “Assume we cannot hire until Q3,” “Assume downtime must stay under 30 minutes,” o “Assume build-vs-buy must be justified over three years.” Las restricciones obligan a la skill a priorizar los tradeoffs que importan a liderazgo, en lugar de enumerar todas las posibles preocupaciones técnicas.

Extiende la skill para tu organización

Para mejorar cto-review en un entorno de equipo, añade checklists internas de SLOs, historial de incidentes, umbrales de costos cloud, proveedores aprobados, requisitos de seguridad y plantillas de architecture decision records. Si usas los scripts de análisis referenciados, documenta sus rutas y entradas esperadas cerca de la skill para que futuros usuarios no queden bloqueados por archivos relativos ausentes.