Como usar o Claude como tech lead: guia de skill

Atualizado em 14 min de leitura KissMySkills
Nesta página
  1. Question one: esta é uma porta pela qual você pode voltar?
  2. Question two: essa equipe consegue operá-lo às 3h da manhã?
  3. Revisões: o problema da lista sem hierarquia
  4. Defendendo a proposta junto à liderança
  5. Desbloqueando sem se tornar um roteador
  6. Onde falha
  7. Como você instala a Skill do Dante?
  8. Para quem é isso?
  9. Guias de Skills relacionados
Skill · .md

A skill por trás deste guia: Dante - Skill de AI para Tech Leads. Armazena sua stack, a experiência operacional real da sua equipe e suas decisões em andamento, para que as recomendações sejam filtradas pelo que sua equipe consegue operar, e não pelo que é tecnicamente melhor - $19, um único pagamento, sua para sempre.

Ver a skill Dante →

Duas perguntas resolvem a maioria das decisões técnicas, e um modelo não oferece nenhuma delas espontaneamente: quanto custa desfazer isso e essa equipe consegue operá-lo às três da manhã. Pergunte a um modelo qual banco de dados, qual framework ou qual arquitetura escolher, e ele escolherá uma opção e a defenderá bem - com exatamente o mesmo nível de confiança, independentemente de a resposta errada custar uma semana ou três anos, e sem saber quem está de plantão. A metade não relacionada a código do trabalho de uma pessoa líder de tecnologia consiste, em grande parte, nessas duas perguntas. Este guia existe para obrigá-las a entrar na conversa.

Question one: esta é uma porta pela qual você pode voltar?

A carta aos acionistas da Amazon de 2015 explica isso da forma mais clara possível. Algumas decisões são "consequentes e irreversíveis ou quase irreversíveis - portas de mão única - e essas decisões devem ser tomadas de forma metódica, cuidadosa, lenta, com muita reflexão e consulta." A maioria não é: "elas podem ser alteradas, são reversíveis - são portas de mão dupla", e essas "podem e devem ser tomadas rapidamente por indivíduos com bom discernimento ou por grupos pequenos."

A razão pela qual isso importa mais com um modelo do que sem um é que um modelo nivela essa distinção. Pergunte a ele sobre o formato dos seus logs e sobre o seu modelo de dados na mesma sessão, e você receberá duas respostas igualmente completas e igualmente confiantes. Uma dessas decisões pode ser alterada em uma tarde de terça-feira. A outra ainda estará afetando vocês quando as pessoas que a tomaram já tiverem ido embora.

Portanto, o primeiro passo não é "qual opção". É classificar a decisão: quanto realmente custa desfazer isso, em que unidade, e o que a torna cara. Um modelo é bom nessa pergunta quando você a faz, mas nunca a levantará por conta própria.

Há uma terceira resposta que o modelo também não oferecerá: isso ainda não precisa ser decidido. Adiar uma decisão sem volta até você saber mais costuma ser a atitude mais madura que uma pessoa líder pode tomar, e parece indecisão para quem não está prestando atenção.

Question two: essa equipe consegue operá-lo às 3h da manhã?

Um modelo sabe o que é tecnicamente bom. Ele leu os blogs de arquitetura, e esses blogs são escritos por pessoas que trabalham em empresas com uma equipe de plataforma.

O que ele não sabe é quem está de plantão, o que essas pessoas já operaram, para quais problemas serão acionadas e quantas delas ainda estarão aqui daqui a dezoito meses. Esses são os fatos que realmente decidem a questão, e são justamente os que nunca chegam ao prompt. O resultado é uma recomendação genuinamente correta em abstrato e errada para quatro engenheiros que nunca operaram um broker de mensagens.

A questão da operabilidade não é "isso é bom?", mas "quanto isso nos custa na pior noite do ano?". Quem recebe o alerta. O que essa pessoa precisa saber. O que o runbook diz. O que acontece quando a única pessoa que entende disso está de férias. Coloque esses pontos no prompt como restrições, e a lista final muda, muitas vezes drasticamente.

prompt 1 - classifique a decisão antes de tomá-la

Ainda não recomende uma opção. Esta é uma decisão técnica que preciso tomar: [DESCRIBE] Primeiro, classifique-o: - Isso é reversível, difícil de reverter ou efetivamente permanente? - O que especificamente teríamos de fazer para desfazer isso em 12 meses, e qual é o custo em semanas de engenharia e em risco? - O que torna caro desfazer isso: dados, contratos, API pública, contratação, outra coisa? - Isso precisa ser decidido agora? Se não, o que saberíamos mais tarde que não sabemos agora, e qual é o custo de esperar? - Quem é a pessoa certa para decidir isso: só eu, eu e mais uma ou de toda a equipe com uma proposta por escrito? Então me diga claramente: isso é uma porta de mão única ou de mão dupla, e estou dedicando a ela o nível certo de processo? Se eu estiver se eu estiver deliberando demais sobre uma decisão reversível, diga isso.

prompt 2 - o filtro de operabilidade

Dê a ele o contexto da equipe, não apenas o problema. Os fatos abaixo são os que mudam a resposta.

Avalie essas opções em relação à MINHA equipe, não à melhor prática. DECISÃO: [DESCRIBE] OPÇÕES: [LIST] MINHA EQUIPE: - [N] engenheiros. Distribuição de senioridade: [DESCRIBE HONESTLY] - O que já operamos de fato em produção: [LIST] - O que nunca operamos: [LIST] - Plantão: [QUEM, COM QUE FREQUÊNCIA E SE É PAGO] - Rotatividade esperada: quem pode sair e o que só essa pessoa sabe - Nossa realidade atual de implantação e rollback Para cada opção, responda: 1. Quem recebe o alerta quando isso falhar e o que essa pessoa precisa saber para corrigir isso às 3h da manhã? 2. Qual é o modo de falha que ninguém percebe por uma semana? 3. O que o runbook precisa conter e quem o escreve? 4. Se a pessoa que defendeu isso sair, o que acontece? 5. Qual é o custo operacional em horas por mês, não em dólares? Depois, classifique as opções pelo que ESTA equipe consegue operar e diga explicitamente onde essa classificação difere da opção tecnicamente melhor resposta. Quero ver os dois.
Destaque de Skill
Dante - Skill de AI para líder técnico
Dante - Skill de AI para líder técnico
US$ 19 · pagamento único

Leva os fatos da equipe entre as sessões, e isso é toda a diferença aqui. Redigitar sua stack, sua escala de plantão e o que sua equipe nunca operou em um novo chat toda vez é o motivo pelo qual a maioria desiste e aceita a resposta genérica. Ele também organiza as decisões por reversibilidade antes de recomendar qualquer coisa e mantém suas decisões em andamento, para parar de se contradizer em relação à decisão da semana passada.

Ver Dante - Skill de IA para líderes técnicos →

Revisões: o problema da lista sem hierarquia

Peça a um modelo para revisar um diff e você receberá uma lista. Uma preferência de nomenclatura, um teste ausente e uma condição de corrida, todos apresentados com o mesmo tamanho, no mesmo tom comedido e com a mesma confiança. É isso que torna o feedback de revisão de IA exaustivo de receber e inútil como ensinamento: o autor não consegue dizer o que importa, então ou corrige tudo mecanicamente ou passa os olhos.

Duas correções. Primeiro, force uma divisão por severidade com um limite: no máximo três itens MUST FIX, e todo o resto explicitamente opcional. Um limite faz o modelo escolher, e o que ele escolhe é informativo.

Segundo, e mais importante para um líder: ele não conhece suas convenções, então vai inventá-las. Ele dirá a um júnior que um código perfeitamente razoável viola um padrão que não é o seu, afirmando isso como se fosse universal. Isso é pior do que não fazer revisão nenhuma, porque o júnior acredita que você endossou aquilo. Forneça suas convenções e proíba-o de afirmar qualquer regra que você não tenha fornecido.

Prompt 3 - uma revisão que ensina

Revise este diff como um feedback que passarei ao autor. NOSSAS CONVENÇÕES: [COLE AQUI OU LINK PARA O GUIA DE ESTILO] CONTEXTO: [PARA QUE ESTA ALTERAÇÃO SERVE E QUAL É O NÍVEL DO AUTOR] Regras: - No máximo 3 itens MUST FIX. Se você tiver mais candidatos, escolha e diga-me o que você descartou. - Todo o resto fica em OPTIONAL e é marcado como minha preferência em vez de uma regra. - Para cada MUST FIX: a falha específica que ele evita, com entrada ou a sequência que o aciona. "Isso pode causar "problemas" não é um comentário de revisão. - Não afirme nenhum padrão que não esteja nas convenções que eu lhe forneceu. Se você acha que algo está errado, mas é apenas uma convenção em outros lugares, diga isso com essas palavras. - Diga uma coisa que o autor fez bem, somente se isso for verdade e específico. - Nenhum comentário sobre formatação. Um linter cuida disso. Depois, separadamente da revisão: diga-me o que este diff sugere que o autor ainda não entende, então eu sei o que ensinar em vez de dizer o que corrigir.

Defendendo a proposta junto à liderança

Líderes técnicos passam uma quantidade surpreendente de tempo pedindo tempo. Refatore isso, reduza a dívida técnica, dedique uma sprint ao pipeline de deploy. Peça a um modelo para escrever essa justificativa de negócio e ele produzirá alegremente uma com números - uma porcentagem de incidentes evitados, uma quantidade de horas de engenharia, um ganho de velocidade. Você não forneceu esses números. Ele os inventou, e você está prestes a colocar seu nome neles diante de um diretor.

A mesma regra vale em qualquer lugar: nenhum número que não tenha sido fornecido ao modelo. Mas há um uso melhor para ele aqui do que redigir o caso inteiro.

Peça ao modelo para argumentar contra você. Faça-o escrever o motivo mais forte pelo qual um diretor sensato deveria dizer não. Essa resposta é genuinamente útil, porque mostra o que você realmente precisa responder, e os modelos são bons nisso quando orientados a fazê-lo e ruins em perceber que precisam fazer isso.

Prompt 4 - defenda a recusa da melhor forma

Quero pedir [TEMPO / NÚMERO DE PESSOAS / UM SPRINT] para fazer [O TRABALHO]. Este é o meu caso: [COLE] Não melhore meu caso. Argumente contra ele. Escreva a versão mais forte da recusa que um um [DIRETOR / VP / FUNDADOR] bem-intencionado apresentaria, dado que eles também são responsáveis por [A PRIORIDADE CONCORRENTE]. Use o vocabulário deles, não o meu. Então: - nomeie o elo mais fraco da minha argumentação e por que ele é o mais fraco - nomeie a coisa que estou presumindo que eles já concordam que eles talvez não - diga que evidência realmente os faria mudar de ideia e se Atualmente, tenho isto - sinalize cada número no meu caso e de onde ele veio. Se eu se não lhe dei um número, não forneça um - escreva [NÚMERO NECESSÁRIO: qual] em vez disso. Se o meu caso for realmente fraco, diga isso. Eu prefiro descobrir aqui.

Desbloqueando sem se tornar um roteador

Um engenheiro está travado. O caminho rápido é colar o problema em um chat, obter a resposta e repassá-la. Funciona, leva noventa segundos e discretamente piora as coisas: o engenheiro não aprende nada, procura você mais cedo da próxima vez e você se transforma em uma API lenta na frente de uma rápida.

A versão que escala é pedir ao modelo as perguntas em vez da resposta. Ele é realmente bom em gerar o caminho de diagnóstico se você o proibir de percorrê-lo.

Prompt 5 - perguntas, não respostas

Um engenheiro da minha equipe está travado nisto: [DESCREVA O PROBLEMA E O QUE JÁ TENTARAM] Não resolva. Não dê pistas sobre a solução. Não diga o que você acha que está a causa. Dê-me as três perguntas que eu deveria fazer a eles, na ordem em que deveria fazer a eles, o que provavelmente os levaria a descobrir por conta própria. Para cada pergunta, diga o que um sim e um não elimine cada regra. Então me diga: o que este engenheiro já teria que saber para pergunta um para ser útil? Se eles não souberem, essa lacuna é a coisa que realmente deve ser ensinada, e a sessão de depuração é a intervenção errada.

Prompt 6 - o registro de decisão que ninguém escreve

O artefato que não custa nada a um líder técnico e poupa seis meses do próximo. Faça isso no fim da conversa, enquanto as opções rejeitadas ainda estão nela.

Transforme nossa conversa em um registro de decisão. Curto. Escrito para alguém que entrar na equipe daqui a um ano e perguntar por que funciona deste jeito. Seções: - A decisão, em uma frase - A data e quem decidiu - Se esta foi uma decisão de mão única ou de mão dupla e o custo para desfazer - As opções que rejeitamos e o motivo concreto pelo qual cada uma foi rejeitadas - não "era pior" - As restrições que decidiram isso, incluindo a equipe e operacionais - O que conscientemente sacrificamos - O que nos faria reconsiderar isto: um gatilho específico, não "se as coisas mudarem" Use apenas o que foi dito nesta conversa. Quando eu afirmar algo sem evidências, escreva como uma suposição em vez de um fato. do que um fato. Marque qualquer coisa sobre a qual você não tenha certeza de que eu realmente disse.

Resolva a questão do compartilhamento de código de uma vez, antes do fluxo de trabalho, e não dentro dele

Um líder técnico geralmente é a pessoa que define, ou pelo menos exemplifica, o que a equipe cola em uma janela de chat. Código-fonte, dados de clientes, credenciais e arquitetura interna são regidos pelo seu contrato de trabalho, pela política da sua empresa e, muitas vezes, por um contrato com o cliente, e a resposta depende de qual nível e qual conta você está usando, não do que é conveniente no momento.

Decida isso deliberadamente, por escrito, antes que se torne um hábito. Práticas que funcionam em qualquer situação: raciocine sobre a estrutura de um problema em vez de colar o arquivo, remova identificadores e segredos antes de inserir qualquer coisa, mantenha os dados dos clientes totalmente fora disso e lembre-se de que um trecho pequeno o bastante, junto com seu repositório público, pode identificar a base de código tão seguramente quanto um comentário de cabeçalho. Se sua empresa tiver uma política, ela prevalece sobre esta página. Se não tiver, provavelmente você é a pessoa que deveria escrevê-la.

Onde falha

Falha O que acontece O que fazer a respeito
Riscos nivelados Uma escolha reversível e uma permanente recebem a mesma resposta confiante e detalhada Classifique primeiro pela reversibilidade. Nunca pergunte "qual opção" antes de perguntar "quanto custa desfazer isso"
A arquitetura de post de blog Recomenda o que uma empresa com uma equipe de plataforma faria, porque é ela que escreve o material de origem Inclua no prompt a escala de plantão, o risco de rotatividade e aquilo que você nunca operou como restrições
Números de negócio inventados Percentuais e horas economizadas no seu argumento sobre dívida técnica que surgiram do nada Proíba qualquer número que você não tenha fornecido. Use-o para defender seu argumento, não para redigi-lo
Convenções inventadas Diz a um júnior que o código dele viola uma regra que não é sua, num tom que parece o seu Forneça suas convenções e proíba-a de afirmar qualquer padrão que você não tenha fornecido
Listas de revisão sem hierarquia Uma observação sobre nomenclatura e uma condição de corrida com o mesmo peso e grau de confiança Um orçamento de severidade. No máximo três itens que precisam ser corrigidos, e ela precisa escolher
Ela não dirá para esperar Quando solicitada a decidir, ela decide. Não vai se oferecer para dizer que a decisão é prematura Pergunte explicitamente se isso precisa ser decidido agora e o que se ganha esperando
Concordância Pergunte se seu plano é sólido e você ouvirá que sim Peça o argumento mais forte contra isso, na voz da pessoa que precisa aprovar
Nada da confiança Ela não estava no incidente, não sabe que este engenheiro está esgotado e não tem autoridade sobre a equipe Essa metade do trabalho não é delegável. Ela serve para o raciocínio e a escrita

Como você instala a Skill do Dante?

O download é um ZIP com SKILL.md na raiz do arquivo, não dentro de uma pasta aninhada - essa estrutura de pastas é o motivo mais comum para um upload falhar. No aplicativo de desktop do Claude, abra Personalizar → Skills, faça upload do ZIP e ative-o.

As Skills precisam da execução de código ativada, em Configurações → Recursos. A central de ajuda da Anthropic atualmente lista as Skills nos planos Free, Pro, Max, Team e Enterprise, enquanto o tutorial da Academy lista Pro, Max, Team e Enterprise - portanto, se você estiver no plano gratuito, verifique Configurações → Recursos na sua própria conta em vez de acreditar no que qualquer uma das páginas diz. O passo a passo completo está no guia de instalação da Skill.

No ChatGPT ou no Gemini, não há etapa de upload: abra SKILL.md, copie o conteúdo e cole-o nas instruções personalizadas. Você perde o acionamento automático, mas mantém o método.

Para quem é isso?

Líderes técnicos e engenheiros seniores responsáveis pela direção técnica junto com suas próprias entregas, e líderes de primeira viagem que já têm a responsabilidade, mas ainda não o título. Funciona no Claude, no ChatGPT ou em qualquer chat de AI.

As funções de engenharia são divididas em Skills próprias, cada uma por US$ 19 e com download único:

O conjunto mais amplo é o de skills para desenvolvedores de software e skills de software e TI.

Em resumo:

Classifique a decisão antes de tomá-la, porque um modelo dá a uma escolha reversível e a uma permanente a mesma resposta confiante e nunca dirá qual tipo você tem. Inclua sua equipe no prompt como uma restrição rígida - quem está de plantão, o que nunca operaram, quem pode sair - e peça as duas classificações: a tecnicamente melhor e a que sua equipe consegue realmente executar. Limite suas revisões a três itens que precisam ser corrigidos e proíba o modelo de afirmar convenções que você não forneceu, ou ele ensinará aos seus juniores regras que você nunca definiu. Use-o para argumentar contra seu próprio caso de dívida técnica, em vez de escrevê-lo, e não permita que ele invente nenhum número que você não tenha fornecido. Depois, registre a decisão enquanto as opções rejeitadas ainda estão na conversa. Para os fatos da equipe mantidos entre sessões, Dante - Skill de AI para líder técnico ($19). Funciona no Claude, ChatGPT e em qualquer chat de AI, com garantia de devolução do dinheiro em 30 dias.

Skill · .md · Funciona com Claude e ChatGPT

Dante - Skill de AI para líder técnico

Classifica as decisões pelo custo para desfazê-las antes de recomendar qualquer coisa, filtra as opções pelo que sua equipe realmente já operou, limita o orçamento dos comentários de revisão e argumenta contra o seu caso quando você pede. Sem assinatura. Seu permanentemente.

$19
Adquira o Skill Dante →

KissMySkills é um marketplace com mais de 2.000 skills de AI, mais de 80 pacotes de prompts, mais de 75 agentes e ferramentas gratuitas para Claude, ChatGPT e qualquer chat de AI.

Guias de Skills relacionados

Perguntas frequentes

Can Claude help with technical decisions?+

It can reason through options well, but it will not raise the two questions that actually settle most of them. The first is reversibility: ask it about your log format and your data model in the same session and you get two equally confident answers, though one is changeable on a Tuesday and the other outlives everyone who chose it. The second is operability: it does not know who is on call. Ask it to sort the decision by what undoing it costs before you ask it which option, and put your team in the prompt as a hard constraint.

What is a one-way door decision?+

Amazon's 2015 shareholder letter frames it as decisions that are consequential and irreversible or nearly irreversible, which must be made methodically, carefully and slowly with great deliberation and consultation. Most decisions are not like that: they are changeable, two-way doors, and those can and should be made quickly by high-judgement individuals or small groups. The practical value for a tech lead is spotting when a team is applying one-way-door process to a two-way-door decision, which is where most of the slowness comes from.

Why does AI recommend architecture my team cannot run?+

Because it optimises for what is technically good, and the material it learned from was written largely by people at companies with a platform team. It does not know who is on call, what they have operated before, what they will be paged for, or how many of them will still be there in eighteen months. Give it those facts as constraints and ask for two rankings: the technically best answer and the one this team can actually run. Where they differ is the interesting part.

Is AI good at code review?+

It is good at finding candidates and bad at weighting them. The default output is a flat list where a naming preference, a missing test and a race condition all appear at the same size in the same confident tone, which is exhausting to receive and teaches nothing. Two fixes: impose a budget of at most three must-fix items so it has to choose, and supply your conventions while forbidding it from asserting any standard you did not give it. Otherwise it will tell a junior their code breaks a rule that is not your rule.

Will it invent numbers in a tech-debt business case?+

Yes. Ask it to make the case for paying down debt and you get percentages of incidents avoided and engineering hours saved that you never supplied. Forbid any figure you did not give it, with a placeholder instead. The better use is to point it the other way entirely: ask it to write the strongest refusal a competent director would give, in their vocabulary. That tells you what you actually have to answer, and models are good at it when asked and bad at noticing it needs doing.

How do I unblock an engineer without doing the work for them?+

Do not paste their problem in and hand back the answer. It takes ninety seconds and it makes you a slow API in front of a fast one, while the engineer learns nothing and comes to you sooner next time. Ask the model for the three questions to ask, in order, with what a yes and a no would each rule out, and forbid it from hinting at the cause. Then ask what the engineer would need to already know for the first question to land - if they do not know it, the gap is the thing to teach and the debugging session is the wrong intervention.

Is it safe to paste work code into an AI chat?+

That is a policy question rather than a technical one, and as a tech lead you are usually the person who sets it or models it. Source code, customer data, credentials and internal architecture are governed by your employment agreement, your company's policy and often a customer contract, and the answer depends on your tier and account. Settle it in writing before it becomes a habit. Practices that hold regardless: reason about the shape of a problem rather than pasting the file, redact identifiers and secrets, keep customer data out, and remember a small snippet plus your public repo can identify the codebase.

How do I install the Dante skill?+

The download is a ZIP with SKILL.md at the root of the archive rather than inside a nested folder, which is the usual reason an upload fails. In the Claude desktop app open Customize, then Skills, upload the ZIP and toggle it on. Skills need code execution enabled, under Settings then Capabilities. Anthropic's help centre currently lists Skills on Free, Pro, Max, Team and Enterprise, while its Academy tutorial lists Pro, Max, Team and Enterprise, so if you are on the free plan check Settings then Capabilities for your own account rather than trusting either page. In ChatGPT or Gemini there is no upload step, so open SKILL.md, copy the contents and paste them into custom instructions.

~/get-started

Skills que funcionam. Sem enrolação.

Navegue por todas as skills, prompts e agents na loja.

Navegue por todas as habilidades →Ou experimente as ferramentas gratuitas