cto-advisor

Visão geral da skill cto-advisor

Para que serve cto-advisor

cto-advisor é uma skill de liderança técnica para transformar preocupações de engenharia confusas em orientações estruturadas no nível de um CTO. Ela é mais indicada para decisões de arquitetura, priorização de dívida técnica, métricas de engenharia, avaliação de tecnologia, escala de times e planejamento estratégico quando a resposta precisa trazer tradeoffs, sequência de execução e raciocínio pronto para discussão executiva, não apenas conselhos no nível de código.

Usuários e decisões mais adequados

A skill cto-advisor faz sentido para founders, CTOs, VPs de Engenharia, staff engineers, líderes de plataforma e gestores técnicos com visão de produto que precisam decidir o que corrigir, construir, comprar, medir ou reorganizar. Ela é especialmente útil quando você tem contexto parcial: um gargalo de escala, uma escolha de arquitetura pouco clara, um backlog de dívidas ou uma demanda de liderança como “crie um roadmap de tecnologia para 12 meses”.

O que a diferencia de um prompt genérico

Um prompt comum pode gerar recomendações amplas. Esta skill acrescenta frameworks reutilizáveis de CTO: registros de decisão no estilo ADR, métricas DORA e de produtividade, matrizes de avaliação de tecnologia, categorias de dívida técnica e cálculos de escala de equipe. O valor prático não é apenas “dar conselhos”; ela ajuda a converter ambiguidade de engenharia em opções ranqueadas, riscos mensuráveis e próximos passos.

Onde cto-advisor é mais forte

Use cto-advisor para Strategic Planning quando o problema envolve tecnologia, pessoas, custo, confiabilidade e velocidade de entrega. Ela funciona melhor quando você consegue fornecer contexto do sistema, restrições atuais, objetivos de negócio e sintomas de falha. É menos indicada para depuração de implementação altamente especializada, ajustes profundos específicos de um fornecedor ou decisões jurídicas/de compliance que exigem revisão autorizada.

Como usar a skill cto-advisor

Instalação do cto-advisor e arquivos para ler primeiro

Instale a skill com:

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

Depois da instalação, comece por SKILL.md para entender o escopo de ativação e os fluxos de trabalho de liderança. Em seguida, leia estes arquivos conforme a sua tarefa:

• references/architecture_decision_records.md para escolhas de arquitetura e formato de saída em ADR
• references/engineering_metrics.md para métricas DORA, qualidade, produtividade e confiabilidade
• references/technology_evaluation_framework.md para decisões de build-vs-buy ou seleção de fornecedores
• scripts/tech_debt_analyzer.py para a lógica de pontuação de dívida técnica
• scripts/team_scaling_calculator.py para planejamento de headcount e estrutura de engenharia

O repositório não depende de um runtime grande, mas os scripts auxiliares são arquivos Python. Portanto, garanta que Python 3 esteja disponível se quiser executá-los localmente.

Entradas que melhoram o uso do cto-advisor

A skill funciona melhor quando seu prompt inclui o objetivo de negócio, o estado atual da engenharia, as restrições, as opções em avaliação e o prazo para decisão. Evite perguntar “Qual deveria ser nossa arquitetura?” sem contexto. Em vez disso, forneça os fatores que orientam a decisão.

Padrão de prompt mais forte:

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.

Isso dá à skill informação suficiente para raciocinar sobre tradeoffs, em vez de cair em recomendações de arquitetura da moda.

Fluxo de trabalho prático para decisões

Para a maioria das decisões de liderança, use um fluxo em quatro etapas:

1. Enquadre a decisão: defina o problema, o resultado de negócio esperado, o horizonte de tempo e as restrições inegociáveis.
2. Peça uma análise estruturada: solicite um ADR, uma matriz de avaliação de tecnologia, um plano de remediação de dívida, um modelo de escala de equipe ou um dashboard de métricas, dependendo da decisão.
3. Valide as premissas: verifique se a saída depende de fatos não confirmados, como frequência de incidentes, dados de deploy, habilidades do time ou estimativas de custo.
4. Converta em ação: peça um plano de 30/60/90 dias, responsáveis, marcos, riscos e critérios mensuráveis de sucesso.

Para trabalho com dívida técnica, execute ou inspecione scripts/tech_debt_analyzer.py para entender como as categorias de dívida são ponderadas entre arquitetura, qualidade de código, infraestrutura, segurança e performance. Para crescimento de equipe, revise scripts/team_scaling_calculator.py antes de aceitar proporções sugeridas de papéis.

Exemplos de prompt por tarefa a resolver

Para dívida 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 avaliação de tecnologia:
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 engenharia:
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 da skill cto-advisor

cto-advisor é adequado para iniciantes?

Sim, se o usuário precisa de um framework de decisão em vez de uma estratégia executiva pronta. Iniciantes devem pedir definições, exemplos e raciocínio passo a passo. Ainda assim, as recomendações precisam ser revisadas por alguém que entenda o sistema, a organização e as restrições de negócio.

Quando não devo usar cto-advisor?

Não use cto-advisor como autoridade final para aprovação de segurança, conformidade legal, previsão financeira ou aprovação de arquitetura de produção. Ela pode estruturar a análise, explicitar tradeoffs e rascunhar registros de decisão, mas decisões reais devem ser validadas com dados do sistema, contribuição dos stakeholders e revisão de especialistas.

Como cto-advisor difere de uma skill de arquitetura?

Uma skill focada apenas em arquitetura geralmente se concentra em design de sistemas. A skill cto-advisor trata arquitetura como uma parte de uma decisão de liderança mais ampla: alinhamento com roadmap, capacidade do time, dívida técnica, métricas de entrega, implicações de contratação, custo, risco e governança. Isso a torna mais útil para planejamento multifuncional do que para diagramas de design isolados.

Ela funciona para times pequenos e startups?

Sim. Times pequenos podem usá-la para evitar over-engineering, comparar decisões de build-vs-buy, planejar contratações e decidir quais dívidas vale tolerar. O ponto principal é declarar claramente as restrições de startup: runway, tamanho do time, urgência dos clientes, tolerância operacional e o que precisa continuar simples.

Como melhorar a skill cto-advisor

Melhore as respostas do cto-advisor com contexto mais preciso

A forma mais rápida de melhorar os resultados do cto-advisor é trocar objetivos vagos por contexto pronto para decisão. Inclua tamanho atual do time, arquitetura, cadência de deploy, histórico de incidentes, limites de custo, crescimento de clientes, necessidades de compliance e restrições conhecidas. Se você não tem métricas, diga isso e peça à skill para identificar quais dados coletar antes de decidir.

Modos de falha comuns para observar

O principal risco é receber recomendações idealizadas demais para a capacidade do seu time. Fique atento a planos que pressupõem mais maturidade de plataforma, automação, equipe ou orçamento do que você tem. Também questione saídas que recomendem microservices, governança pesada ou programas amplos de métricas sem conectá-los a um problema de negócio.

Itere da estratégia para a execução

Depois da primeira saída, faça perguntas de acompanhamento que forcem priorização:

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

Isso transforma o uso de cto-advisor de uma recomendação pontual em um fluxo de decisão.

Valide com os frameworks e scripts do repositório

Use as referências incluídas como checklists antes de adotar a resposta. Compare recomendações de arquitetura com references/architecture_decision_records.md, sugestões de métricas com references/engineering_metrics.md e comparações de fornecedores com references/technology_evaluation_framework.md. Para planejamento quantitativo, inspecione ou adapte os scripts Python em vez de tratar números gerados como autoridade final.