O que genesis-architect faz?
Estruturação de projetos orientada por pesquisa para o Claude Code. Analisa issues do GitHub em busca de falhas de produção antes de escrever um único arquivo.
Visão Geral
Esta skill permite que o Claude Code atue como um arquiteto de software que primeiro pesquisa e entende os problemas existentes em um repositório (especialmente falhas de produção reportadas em issues) antes de propor e gerar a estrutura de um novo projeto ou módulo. O objetivo é criar uma base de código mais robusta, prevenindo a recorrência de bugs conhecidos.
Como Funciona
- Análise de Issues: Quando solicitado, a skill busca e analisa issues abertas e fechadas no repositório alvo (especificado pelo usuário) para identificar padrões de falhas, bugs comuns e áreas problemáticas.
- Geração de Scaffolding: Com base na análise, a skill gera a estrutura de diretórios, arquivos de configuração, código inicial e testes unitários que são conscientes dos problemas identificados.
- Documentação: Cria um
README.mdpreliminar e outros documentos de arquitetura que refletem as decisões de design tomadas para mitigar as falhas passadas.
Uso
Ative a skill no Claude Code e forneça a URL ou o caminho do repositório GitHub que deseja analisar. Por exemplo:
Use a skill genesis-architect para analisar o repositório https://github.com/usuario/projeto-exemplo e criar um scaffolding para um novo módulo de autenticação, evitando falhas de produção conhecidas.
Benefícios
- Prevenção de Falhas: Reduz a probabilidade de introduzir bugs já conhecidos no novo código.
- Eficiência: Acelera o início de novos projetos ao fornecer uma estrutura inicial otimizada.
- Qualidade: Promove a escrita de código mais resiliente desde o início.
Limitações
- A qualidade do scaffolding depende da qualidade e completude das issues analisadas.
- A skill pode não capturar todos os contextos ou decisões arquiteturais complexas apenas a partir de issues.
Notas Técnicas
- A skill utiliza a API do GitHub para acessar as issues.
- O scaffolding gerado segue boas práticas comuns de desenvolvimento (ex: separação de concerns, padrões de projeto).
Nota: Esta skill foi projetada especificamente para uso com o Claude Code. Consulte a documentação oficial do Claude Code para instruções de instalação e configuração detalhadas.