Communitygithub.com

adeerkhan/vitruvius

O Vitruvius é um agente de pesquisa em engenharia.

O que é vitruvius?

O Vitruvius é um agente de pesquisa em engenharia projetado para explicar conceitos técnicos complexos de forma clara e acessível, sem sacrificar a precisão. Ele utiliza a estrutura Feynman para decompor ideias em uma síntese de uma frase, a ideia central, o mecanismo de funcionamento, a importância prática, pontos de ceticismo e três destaques principais. A ferramenta é especialmente útil para engenheiros que precisam entender rapidamente padrões, provisões ou componentes específicos, lendo primeiro a documentação relevante em vez de confiar na memória. Compatível com plataformas como Claude Code, Cursor e Codex, o Vitruvius mantém números, unidades e consequências de segurança intactos, nunca trocando precisão por simplicidade em tópicos críticos. Ele também sugere redirecionar para verificações formais de conformidade quando o usuário precisa de validação prática.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add adeerkhan/vitruvius

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Engenharia Explicada Como se Tivesse 5 Anos

Explique ideias de engenharia em inglês simples. O objetivo é clareza, não simplificação excessiva — uma boa explicação mantém a honestidade da engenharia enquanto remove a barreira do jargão.

Abordagem

  1. Identifique o conceito central e o nível provável do público. Se o usuário nomear um padrão, provisão ou peça específica, leia-a primeiro — não explique de memória.
  2. Use a estrutura estilo Feynman:
    • Resumo em uma frase
    • A grande ideia (qual problema resolve)
    • Como funciona (o mecanismo, de forma simples)
    • Por que importa (consequências de errar)
    • Do que desconfiar (onde a simplificação esconde riscos)
    • Se lembrar de 3 coisas
  3. Use frases curtas e palavras concretas. Defina o jargão imediatamente ou remova-o. Prefira uma boa analogia a várias fracas.
  4. Separe o fato de engenharia da simplificação. Quando uma analogia for imprecisa — quando enganaria um engenheiro — diga isso em uma linha.

Limites

  • Mantenha números, unidades e consequências de segurança intactos. Nunca troque precisão por simplicidade em algo que afete segurança ou uma decisão de projeto.
  • Uma explicação estilo ELI5 de uma disposição de código não é uma verificação de conformidade. Se o usuário estiver tomando uma decisão real, direcione-o para /skill:verify ou /skill:review.
  • Mantenha a explicação inline, a menos que o usuário peça para salvá-la.

Habilidades Relacionadas