Communitygithub.com

yezhwi/estilização-de-frameworks

Transforme frameworks de código aberto em guias de arquitetura para humanos e IA.

O que é estilização-de-frameworks?

Esta skill capacita agentes de IA a realizar engenharia reversa profunda de frameworks de código aberto, extraindo sua arquitetura, modelo de execução, pontos de extensão e compensações de engenharia. Diferente de simples resumos de README ou tutoriais de API, ela foca no raciocínio arquitetônico, separando fatos observados de inferências. Suporta plataformas como Claude Code, Cursor e Codex, e oferece três modos de saída (mini, standard e deep) para atender desde análises rápidas até reproduções exaustivas. É ideal para equipes que precisam reproduzir a arquitetura de um framework em outra linguagem ou domínio, criando pacotes de conhecimento legíveis por IA.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add yezhwi/framework-distillation

Perguntar na sua IA favorita

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

Documentação

Estilização de Frameworks

Visão Geral

Extraia arquitetura, não código.

Use esta skill para fazer engenharia reversa da forma do framework, modelo de execução, pontos de extensão e compensações de engenharia, para que outro agente de IA ou equipe possa reproduzir uma arquitetura semelhante em outra linguagem ou domínio.

Quando Usar

  • Engenharia reversa da arquitetura do framework além do README e da API pública
  • Estudo do runtime, ciclo de vida, máquina de estado ou mecanismo de extensão
  • Reprodução de um framework semelhante em outra linguagem ou domínio
  • Criação de pacotes de conhecimento de arquitetura legíveis por IA
  • Comparação de frameworks por arquitetura e compensações

Alvos típicos: runtimes de agentes, engines de workflow, frameworks de máquina de estado, sistemas de plugins, plataformas de orquestração.

Quando Não Usar

  • Apenas resumo do README
  • Tutorial de API ou guia de uso
  • Explicação linha a linha do código
  • Reimplementação copiando e colando
  • Inventário de funcionalidades sem análise de compensações

Se a solicitação for próxima, mas fora do alvo, redirecione o escopo primeiro.

Entradas Necessárias

Mínimo:

  • URL do repositório ou caminho local da fonte

Recomendado:

  • Nome do framework
  • Objetivo da análise
  • Linguagem ou domínio de implementação alvo
  • Profundidade: mini, standard ou deep
  • Áreas de foco

Princípio Central

Arquitetura > Código
Raciocínio > Sintaxe
Design > API
Compensação > Funcionalidade
Princípios > Implementação

Fluxo de Trabalho

  1. Verifique a adequação; recuse ou redirecione solicitações de tutorial, API ou análise arquivo por arquivo.
  2. Escolha a profundidade com base no objetivo. Padrão standard; use mini para uma primeira passagem rápida, deep para reprodução exaustiva.
  3. Examine documentos, testes, exemplos e a forma do repositório antes da leitura profunda do código-fonte.
  4. Extraia arquitetura, runtime, estado, modelo de dados, pontos de extensão, decisões e compensações.
  5. Destile regras reutilizáveis e produza saída alinhada ao modo escolhido e ao objetivo de reprodução.

Regras de Execução

  • Comece pela arquitetura, não por listas de funcionalidades.
  • Não desvie para tutorial, inventário de API ou análise arquivo por arquivo.
  • Fundamente as afirmações em evidências do código, documentação, testes, exemplos ou histórico de commits quando disponível.
  • Diferencie fatos observados de inferências; use Observado, Inferência forte, Inferência tentativa quando as evidências forem escassas.
  • Informe explicitamente acesso incompleto ao repositório ou evidências fracas.
  • Adapte a análise à linguagem alvo, domínio, áreas de foco e critérios de comparação.

Modos de Saída

  • mini — resumo rápido da arquitetura em primeira passagem
  • standard — extração completa da arquitetura para a maioria dos estudos
  • deep — engenharia reversa exaustiva para reprodução do framework

Detalhes em:

  • references/output-modes.md
  • references/analysis-checklist.md
  • references/deliverables.md

Antipadrões

Evite:

  • Resumir apenas o README
  • Listar APIs sem arquitetura
  • Explicar exemplos sem extrair o design
  • Descrever código sem perguntar por que ele existe
  • Ignorar compensações, caminhos de falha ou pontos de extensão
  • Copiar a implementação em vez de destilar os princípios
  • Declarar filosofia ou justificativa como fato quando as evidências são fracas
  • Comparar frameworks apenas por lista de funcionalidades

Referências de Apoio

  • references/output-modes.md — formatos de saída, templates, diagramas
  • references/analysis-checklist.md — checklist de análise e gate de qualidade
  • references/deliverables.md — estrutura de entrega e prompt de simulação de IA
  • references/self-test.md — revisão de brechas e correções aplicadas
  • references/simulated-dialogue-tests.md — prompts de pressão e scorecard

Habilidades Relacionadas