folder-structure-blueprint-generator
Faz seu agente analisar e documentar a estrutura de pastas de projetos. Ele detecta o tipo de projeto e gera um guia detalhado. Útil para manter a organização do código consistente.
O que ela faz
Este agente analisa a organização das pastas do seu projeto de programação. Ele cria um guia detalhado mostrando como as pastas e arquivos estão organizados, ajudando a manter tudo arrumado e consistente.
Quando usar
- ✓Ao iniciar um novo projeto para definir uma boa estrutura.
- ✓Ao revisar um projeto existente para documentar sua organização.
- ✓Ao integrar novos membros na equipe para explicar a estrutura.
Exemplo do que pedir para a IA
“Crie um guia da estrutura de pastas para o meu projeto Node.js, mostrando até 3 níveis de profundidade e usando listas aninhadas.”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
Ele examina as pastas e arquivos do seu projeto, identifica o tipo de tecnologia usada (como .NET, Java, React, etc.) e gera um documento visualizando essa estrutura.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add github/awesome-copilot --skill folder-structure-blueprint-generatorOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/folder-structure-blueprint-generator/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Gerador de Blueprint de Estrutura de Pastas de Projeto
Variáveis de Configuração
${PROJECT_TYPE="Auto-detect|.NET|Java|React|Angular|Python|Node.js|Flutter|Outro"}
<!-- Seleciona a tecnologia principal -->${INCLUDES_MICROSERVICES="Auto-detect|true|false"}
<!-- Esta é uma arquitetura de microsserviços? -->${INCLUDES_FRONTEND="Auto-detect|true|false"}
<!-- O projeto inclui componentes de frontend? -->${IS_MONOREPO="Auto-detect|true|false"}
<!-- É um monorepo com múltiplos projetos? -->${VISUALIZATION_STYLE="ASCII|Lista Markdown|Tabela"}
<!-- Como visualizar a estrutura -->${DEPTH_LEVEL=1-5}
<!-- Quantos níveis de pastas documentar em detalhe -->${INCLUDE_FILE_COUNTS=true|false}
<!-- Incluir estatísticas de contagem de arquivos -->${INCLUDE_GENERATED_FOLDERS=true|false}
<!-- Incluir pastas geradas automaticamente -->${INCLUDE_FILE_PATTERNS=true|false}
<!-- Documentar padrões de nomeação/localização de arquivos -->${INCLUDE_TEMPLATES=true|false}
<!-- Incluir modelos de arquivos/pastas para novos recursos -->Prompt Gerado
"Analise a estrutura de pastas do projeto e crie um documento abrangente 'Project_Folders_Structure_Blueprint.md' que sirva como um guia definitivo para manter uma organização de código consistente. Use a seguinte abordagem:
Fase Inicial de Autodetecção
${PROJECT_TYPE == "Auto-detect" ? "Comece escaneando a estrutura de pastas em busca de arquivos-chave que identifiquem o tipo de projeto:
- Procure por arquivos de solução/projeto (.sln, .csproj, .fsproj, .vbproj) para identificar projetos .NET
- Verifique arquivos de build (pom.xml, build.gradle, settings.gradle) para projetos Java
- Identifique package.json com dependências para projetos JavaScript/TypeScript
- Procure por arquivos de framework específicos (angular.json, entradas react-scripts, next.config.js)
- Verifique identificadores de projetos Python (requirements.txt, setup.py, pyproject.toml)
- Examine identificadores de aplicativos móveis (pubspec.yaml, pastas android/ios)
- Anote todas as assinaturas de tecnologia encontradas e suas versões" : "Concentre a análise na estrutura do projeto ${PROJECT_TYPE}"}
${IS_MONOREPO == "Auto-detect" ? "Determine se este é um monorepo procurando por:
- Múltiplos projetos distintos com seus próprios arquivos de configuração
- Arquivos de configuração de workspace (lerna.json, nx.json, turborepo.json, etc.)
- Referências entre projetos e padrões de dependência compartilhada
- Scripts de orquestração e configuração em nível raiz" : ""}
${INCLUDES_MICROSERVICES == "Auto-detect" ? "Verifique indicadores de arquitetura de microsserviços:
- Múltiplos diretórios de serviço com estruturas semelhantes/repetidas
- Arquivos Dockerfile ou configurações de implantação específicos do serviço
- Padrões de comunicação entre serviços (APIs, message brokers)
- Configuração de registro ou descoberta de serviço
- Arquivos de configuração de API gateway
- Bibliotecas ou utilitários compartilhados entre serviços" : ""}
${INCLUDES_FRONTEND == "Auto-detect" ? "Identifique componentes de frontend procurando por:
- Diretórios de ativos web (wwwroot, public, dist, static)
- Arquivos de framework de UI (componentes, módulos, páginas)
- Configuração de build de frontend (webpack, vite, rollup, etc.)
- Organização de folhas de estilo (CSS, SCSS, styled-components)
- Organização de ativos estáticos (imagens, fontes, ícones)" : ""}
1. Visão Geral Estrutural
Forneça uma visão geral de alto nível dos princípios de organização e estrutura de pastas do projeto ${PROJECT_TYPE == "Auto-detect" ? "tipos de projeto detectados" : PROJECT_TYPE}:
- Documente a abordagem arquitetural geral refletida na estrutura de pastas
- Identifique os principais princípios organizacionais (por funcionalidade, por camada, por domínio, etc.)
- Anote quaisquer padrões estruturais que se repetem em toda a base de código
- Documente a lógica por trás da estrutura onde puder ser inferida
${IS_MONOREPO == "Auto-detect" ? "Se detectado como um monorepo, explique como o monorepo é organizado e a relação entre os projetos." : IS_MONOREPO ? "Explique como o monorepo é organizado e a relação entre os projetos." : ""}
${INCLUDES_MICROSERVICES == "Auto-detect" ? "Se microsserviços forem detectados, descreva como eles são estruturados e organizados." : INCLUDES_MICROSERVICES ? "Descreva como os microsserviços são estruturados e organizados." : ""}
2. Visualização de Diretório
${VISUALIZATION_STYLE == "ASCII" ? "Crie uma representação de árvore ASCII da hierarquia de pastas até o nível de profundidade ${DEPTH_LEVEL}." : ""}
${VISUALIZATION_STYLE == "Lista Markdown" ? "Use listas markdown aninhadas para representar a hierarquia de pastas até o nível de profundidade ${DEPTH_LEVEL}." : ""}
${VISUALIZATION_STYLE == "Tabela" ?
…
Perguntas frequentes
O que é um 'blueprint' de estrutura de pastas?
É um documento que descreve e visualiza como as pastas e arquivos de um projeto estão organizados, servindo como um mapa.
Ele funciona para qualquer tipo de projeto?
Sim, ele tenta detectar automaticamente o tipo de projeto (.NET, Java, React, Python, etc.) ou você pode especificar.
Posso escolher como a estrutura é mostrada?
Sim, você pode escolher entre visualizações como árvore ASCII, lista em Markdown ou tabela.
Detalhes
Descrição original do autor
Comprehensive technology-agnostic prompt for analyzing and documenting project folder structures. Auto-detects project types (.NET, Java, React, Angular, Python, Node.js, Flutter), generates detailed blueprints with visualization options, naming conventions, file placement patterns, and extension templates for maintaining consistent code organization across diverse technology stacks.
repo: github/awesome-copilot
Popularidade
- Estrelas no GitHub
- 40 mil
- Posição no ranking
- #5149
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
acquire-codebase-knowledge
Ajuda seu agente a entender e documentar um projeto de código existente. É útil para novas pessoas entrarem no projeto ou para ter uma visão geral da arquitetura.
github/awesome-copilot
acreadiness-assess
Faz seu agente avaliar a prontidão de um projeto para IA e gerar um relatório. É útil para entender o quão bem um projeto está preparado para usar ferramentas de IA.
github/awesome-copilot
acreadiness-generate-instructions
Ajuda seu agente a criar instruções para ferramentas de IA baseadas em uma avaliação. É útil para melhorar a forma como a IA interage com o código e fecha lacunas identificadas.
github/awesome-copilot
acreadiness-policy
Faz seu agente ajudar a definir ou aplicar políticas para avaliação de projetos de IA. É útil para padronizar a forma como os projetos são avaliados e garantir conformidade.
github/awesome-copilot
Skills parecidas
benchmark-optimization-loop
Faz seu agente melhorar a velocidade de algo de forma medida. Ele testa várias versões e escolhe a mais rápida que ainda funciona corretamente.
affaan-m/ECC
change-impact
Ajuda seu agente a analisar o impacto de mudanças no código antes de fazê-las. Ele compara o planejado com o real depois, cobrindo caminhos, dados, testes e documentação. É útil para mudanças arriscadas ou que afetam várias partes do sistema.
affaan-m/ECC
click-path-audit
Faz seu agente rastrear todos os botões e interações do usuário para achar bugs. Ele encontra problemas onde funções parecem funcionar sozinhas, mas falham juntas. Útil quando bugs persistem mesmo após depuração.
affaan-m/ECC