cto-review

Visão geral do skill cto-review

O que o cto-review faz

cto-review é um skill de revisão estratégica de engenharia para testar, sob pressão, decisões de arquitetura, escalabilidade, dívida técnica, contratação e build-vs-buy antes que elas virem compromissos caros. Ele é estruturado em torno do padrão de comando /cs:cto-review <plan> e faz perguntas no estilo de um CTO: onde o sistema quebra, qual dívida está começando a bloquear a execução, se o time consegue escalar o plano e se comprar é mais racional do que construir.

Melhor uso para decisões de Strategic Planning

O skill cto-review é mais útil quando você já tem um plano concreto, não apenas uma ideia vaga. Bons casos de uso incluem aprovar um novo banco de dados, planejar para tráfego 10x maior, decidir se vale reconstruir um sistema legado, avaliar uma migração de plataforma ou preparar uma revisão de estratégia técnica para a liderança. Ele é especialmente relevante para Strategic Planning quando escolhas de engenharia afetam orçamento, contratação, confiabilidade e risco de execução no longo prazo.

O que o diferencia de um prompt genérico

Um prompt genérico de IA pode produzir recomendações amplas de arquitetura. cto-review direciona a conversa para seis perguntas de decisão que expõem pontos de ruptura de escala, custo semanal da dívida técnica, restrições de ramp-up do time e custo total de propriedade em três anos. Essa estrutura o torna mais adequado para revisão executiva, aprovação de arquitetura e análise de risco antes do compromisso do que para brainstorming aberto.

Observações importantes antes de adotar

O caminho do repositório contém um único SKILL.md para este skill, sem README.md, metadata.json, regras, recursos ou scripts auxiliares empacotados na pasta local do skill. A fonte referencia scripts de análise por caminhos relativos em uma área mais ampla de cto-advisor, portanto verifique a disponibilidade dos scripts no seu ambiente instalado antes de depender desses comandos. O valor central do cto-review está no framework de revisão; a automação pode exigir configuração adicional.

Como usar o skill cto-review

Instalação do cto-review e checagem do repositório

Instale a partir da coleção de skills no GitHub usando seu gerenciador de skills, por exemplo:

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

Depois de instalar, abra:

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

Leia esse arquivo primeiro, porque ele contém o comando, as condições de acionamento e as seis perguntas de CTO. Inspecione também o repositório ao redor se o ambiente do seu agente preservar caminhos relativos, pois o skill referencia scripts fora da pasta local, como cto-advisor/scripts/tech_debt_analyzer.py e cto-advisor/scripts/team_scaling_calculator.py.

Entradas de que o skill precisa

Para um uso forte do cto-review, forneça um plano com detalhe operacional suficiente para que o skill questione premissas. Inclua:

• Escala atual: usuários, requisições por segundo, volume de dados, tenants, regiões ou quantidade de transações
• Escala-alvo: crescimento esperado, cenário 10x, evento de lançamento, expansão enterprise ou prazo de migração
• Arquitetura: serviços, escolhas de datastore, filas, dependências, modelo de deploy e metas de confiabilidade
• Restrições: orçamento, tamanho do time, plano de contratação, compliance, limites de fornecedores, prazos e SLOs
• Decisão em revisão: aprovar, adiar, comprar, construir, reconstruir, migrar ou rodar um experimento

Entrada fraca: “Review our new architecture.”

Entrada mais forte: “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.”

Fluxo prático de uso do cto-review

Comece colando o plano após o estilo de comando usado pelo skill:

/cs:cto-review <your plan>

Peça uma saída orientada a decisão, não um ensaio genérico. Formatos úteis incluem:

• “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.”

Se a primeira resposta estiver especulativa demais, adicione os fatos que faltam em vez de pedir ao modelo para “try again”. O skill foi desenhado para interrogar um plano; ele se torna mais valioso conforme você fornece dados reais de carga, estimativas de custo, premissas de equipe e histórico de incidentes.

Arquivos e comandos para verificar primeiro

O único arquivo confirmado do skill é SKILL.md. Ele inclui exemplos de chamadas de script, mas esta pasta específica do skill não inclui scripts locais. Antes de incorporar os scripts ao seu fluxo de trabalho, verifique se estes caminhos existem após a instalação:

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

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

Se eles estiverem ausentes, você ainda pode usar o guia do cto-review manualmente fornecendo seu próprio inventário de dívida técnica e suas premissas de ramp-up do time no prompt.

FAQ do skill cto-review

O cto-review é indicado para iniciantes?

Sim, desde que a pessoa tenha uma decisão concreta de engenharia para revisar. Ele não é um tutorial introdutório de system design, arquitetura cloud ou escolha de banco de dados. Um founder júnior ou líder de produto pode usá-lo bem ao fornecer objetivos de negócio e pedir ao agente que traduza riscos técnicos em perguntas de decisão, mas o julgamento final deve envolver uma pessoa experiente em engenharia.

Quando não devo usar o cto-review?

Não use cto-review para pequenas escolhas de implementação, revisão de código de rotina, refinamento de tickets ou debugging de um defeito pontual. Ele também não é uma boa opção quando ainda não existe um plano. Use quando o custo de errar for relevante: migração de plataforma, decisão cara de fornecedor, investimento em escala, redesenho de confiabilidade, plano de contratação ou proposta de reconstrução.

Como ele se compara a um prompt de revisão de arquitetura?

Um prompt de revisão de arquitetura costuma verificar padrões de design, componentes e tradeoffs. O skill cto-review adiciona pressão executiva: custo semanal da dívida, escalabilidade do time, limites de falha e economia de build-vs-buy. Isso o torna melhor para uma revisão de go/no-go do que para produzir do zero uma arquitetura de referência completa.

O cto-review exige os scripts referenciados?

Não. O skill cto-review central é um método estruturado de revisão em SKILL.md. Os scripts referenciados podem melhorar a análise se estiverem disponíveis, mas o skill ainda pode funcionar apenas por prompts. Trate o suporte a scripts como opcional até confirmar que os arquivos existem na sua instalação local.

Como melhorar o skill cto-review

Melhore as entradas do cto-review antes de pedir um julgamento

O modo de falha mais comum é pedir uma revisão de CTO sem números. Acrescente mesmo intervalos aproximados: “current write rate is 2k/min,” “expected peak is 10x after launch,” “vendor quote is $180k/year,” ou “team has two backend engineers with no Kafka experience.” Esses detalhes permitem que o cto-review identifique pontos reais de ruptura de escala em vez de riscos genéricos.

Peça lacunas de evidência, não apenas recomendações

Um bom guia de cto-review deve dizer o que precisa ser medido antes da aprovação. Pergunte: “What evidence is missing?” ou “Which assumptions need a load test, cost model, prototype, or vendor reference call?” Isso transforma a saída em um plano de ação e reduz a falsa confiança gerada por conselhos de arquitetura plausíveis, mas não verificados.

Itere com restrições de decisão

Depois da primeira revisão, estreite a decisão. Por exemplo: “Assume we cannot hire until Q3,” “Assume downtime must stay under 30 minutes,” ou “Assume build-vs-buy must be justified over three years.” Restrições forçam o skill a priorizar os tradeoffs que importam para a liderança, em vez de listar toda preocupação técnica possível.

Estenda o skill para a sua organização

Para melhorar o cto-review em um contexto de equipe, adicione checklists internos de SLOs, histórico de incidentes, limites de custo de cloud, fornecedores aprovados, requisitos de segurança e templates de architecture decision record. Se você usar os scripts de análise referenciados, documente os caminhos e as entradas esperadas perto do skill para que futuros usuários não sejam bloqueados por arquivos relativos ausentes.