Repo Cleaner
Torne o propósito, as evidências e a primeira ação útil de um bom projeto fáceis de encontrar. Melhore a superfície do repositório preservando o comportamento da aplicação.
1. Estabeleça o briefing
- Identifique repositório, público, resultado desejado, idioma e auditoria versus implementação. Reutilize a autorização já concedida.
- Leia instruções aplicáveis, README, guias vinculados, licença, manifestos de pacotes/skills, exemplos, ativos e metadados atuais do GitHub. Inspecione o código-fonte apenas conforme necessário para verificar alegações e comandos.
- Inspecione a árvore de trabalho e preserve alterações não relacionadas, a licença existente e a atribuição. Mantenha a visibilidade inalterada, a menos que uma alteração de visibilidade seja explicitamente autorizada.
- Faça perguntas focadas sobre fatos ausentes ou escolhas consequentes: público, identidade visual conflitante, acesso indisponível, instalação incerta ou um rebranding significativo. Resolva escolhas rotineiras de layout a partir do projeto. Continue o trabalho independente enquanto aguarda; não invente fatos para evitar perguntar.
- Use assets/repo-brief.md se um briefing de trabalho ajudar; não o adicione a todo repositório alvo.
2. Audite o percurso do leitor
Leia references/audit-and-validation.md. Trace: descoberta → primeira tela → evidências → instalação → primeiro sucesso → ajuda mais aprofundada.
Liste as poucas lacunas de maior impacto com evidências e prioridade. Separe problemas factuais de escolhas de gosto. Inclua o que deve ser removido. Distinga informações ausentes de informações indisponíveis para suas ferramentas. Para trabalho apenas de auditoria, retorne descobertas e recomendações concretas sem editar arquivos ou configurações.
3. Construa uma apresentação coerente
Leia references/readme-and-visuals.md. Padrão: estilo de documento nativo do GitHub, badges planos padrão, links de navegação comuns e evidências específicas do projeto. Não reutilize a estética do perfil pessoal de um autor, a menos que solicitado. Leia references/readme-patterns.md ao escolher uma estrutura ou aprender com repositórios de referência. Escolha uma direção adequada ao projeto, depois implemente o menor conjunto completo de ativos e documentos que o torne compreensível e utilizável.
- Lidere com uma promessa específica, evidência visual útil e uma primeira ação clara. Mantenha informações essenciais como texto real.
- Adicione um banner apenas quando útil; prefira uma tarefa concreta, resultado real ou demonstração útil em vez de branding decorativo; capture capturas de tela de resultados reais. Rotule conceitos, fixtures, reconstruções e pré-visualizações locais com precisão.
- Adicione uma fileira de badges moderada com destinos funcionais e alegações fundamentadas.
- Mantenha o exemplo de instalação e uso mais curto e verificado no README. Vincule guias de plataforma mais extensos, solução de problemas e exemplos sem duplicá-los.
- Organize documentos públicos e ativos sem mover o código-fonte da aplicação ou alterar o comportamento de tempo de execução/construção. Atualize links ao mover documentação.
- Corresponda a profundidade da documentação ao projeto. Remova texto de marketing genérico, slogans repetidos, tabelas de recursos forçadas, seções de preenchimento, paredes de badges, diagramas decorativos e hierarquias de pastas vazias. Mantenha a voz específica do projeto.
Para repositórios de skills, verifique se a pasta instalável inclui SKILL.md e todos os recursos referenciados. Separe esse pacote dos documentos de marketing público. Documente caminhos exatos de descoberta por host, exemplos de invocação, pré-requisitos e requisitos de ferramentas. Indique se cada rota foi testada em tempo de execução, verificada contra a documentação do host ou apenas utilizável manualmente. Não presuma suporte a plugin, listagem em marketplace ou agente universal a partir de uma simples pasta de skill.
4. Melhore a descoberta com metadados verdadeiros
Leia references/github-discovery.md. Proponha texto 'Sobre' conciso, uma homepage real útil quando disponível, tópicos baseados em evidências e um ativo de pré-visualização social. Verifique os limites atuais do GitHub antes de aplicá-los.
Aplique configurações autorizadas com ferramentas adequadas, preservando valores existentes relevantes. Se as ferramentas não tiverem uma operação, prepare os valores exatos e o link de configurações. Separe aplicado, preparado e bloqueado. Um arquivo de metadados commitado ou imagem social não configura o GitHub. Nunca altere a visibilidade, entre em contato com terceiros ou envie listagens promocionais sem autorização.
5. Verifique e entregue
Valide o percurso do leitor com a referência de auditoria: links e âncoras, imagens, início rápido seguro, badges e compatibilidade verdadeiros, desktop/mobile, claro/escuro, diff final e leitura de configurações. Relate limites de ferramentas ou rede explicitamente. Salve ativos de origem para que atualizações posteriores permaneçam práticas.
Faça commit ou push apenas quando autorizado e siga o fluxo de trabalho do repositório alvo. Confirme o destino e a revisão final. Resuma alterações, verificação, configurações não aplicadas e as poucas ações restantes. Não prometa tráfego, estrelas, classificação ou suporte não testado.