Gerador de Portfolio Showcase
Uma skill abrangente para transformar projetos técnicos em peças de portfólio profissionais otimizadas para diferentes públicos (recrutadores, gerentes de contratação, arquitetos, líderes técnicos).
Capacidades Principais
- Análise de Código - Analisar estrutura de repositórios GitHub, pilha tecnológica, padrões arquiteturais
- Adaptação de Público - Gerar conteúdo para executivos, arquitetos e equipes técnicas
- Visualização de Arquitetura - Criar diagramas de sistema, fluxo de dados e implantação
- Quantificação de Impacto - Extrair e apresentar métricas de negócio e realizações técnicas
- Saída Multi-Formato - Resumos executivos, análises técnicas aprofundadas, histórias para entrevistas, páginas GitHub Pages
Quando Usar Esta Skill
Use esta skill quando o usuário quiser:
- Transformar um projeto técnico em materiais de portfólio
- Criar estudos de caso atraentes a partir de seu trabalho
- Gerar materiais de preparação para entrevistas (histórias no formato STAR)
- Construir uma página profissional no GitHub Pages
- Extrair impacto de negócio a partir de realizações técnicas
- Criar resumos de projeto específicos para cada público
Formatos de Entrada
A skill aceita vários formatos de entrada:
1. Repositório GitHub
- URL do repositório ou caminho local
- Analisa: estrutura de arquivos, padrões de código, pilha tecnológica, dependências, documentação
- Extrai: padrões arquiteturais (DDD, microsserviços, etc.), frameworks, serviços em nuvem
2. Contexto do Projeto (qualquer combinação)
- Notas/índices brutos - Capturas rápidas de realizações e detalhes
- Especificações técnicas - Documentos de arquitetura, documentos de design
- Conversacional - Usuário descreve o projeto naturalmente
- Documentação existente - Arquivos README, wikis, ADRs
3. Contexto de Negócio
- Metas e objetivos do projeto
- Problemas resolvidos
- Partes interessadas e usuários
- Cronograma e tamanho da equipe
- Restrições e desafios
Geração de Saída
1. Resumo Executivo (Para Gerentes de Contratação/Recrutadores)
Propósito: Visão geral rápida e de alto impacto focada no valor de negócio e resultados.
Estrutura:
- Visão Geral do Projeto (2-3 frases): O que é, por que é importante
- Principais Realizações (3-5 itens): Impacto de negócio quantificado
- Destaques Técnicos (breve): Tecnologias/abordagens notáveis
- Cronograma e Escopo: Duração, tamanho da equipe, função
- Métricas de Impacto: Ganhos de desempenho, economia de custos, métricas de usuário
Tom: Profissional, confiante, focado em resultados. Minimize jargões. Lide com resultados.
Comprimento: 150-250 palavras (leitura de 30-60 segundos)
2. Análise Técnica Aprofundada (Para Arquitetos/Líderes Técnicos)
Propósito: Demonstrar pensamento arquitetural, profundidade técnica e julgamento de engenharia.
Estrutura:
- Contexto e Restrições: Requisitos, restrições, sistemas existentes
- Decisões Arquiteturais: Principais escolhas de design com justificativa
- Implementação Técnica:
- Arquitetura do sistema
- Pilha tecnológica e por quê
- Padrões aplicados (DDD, CQRS, event sourcing, etc.)
- Pontos de integração
- Desafios e Soluções: Problemas técnicos e como você os resolveu
- Escala e Desempenho: Métricas, estratégias de otimização
- Segurança e Qualidade: Testes, observabilidade, medidas de segurança
- Trade-offs: O que você otimizou, o que sacrificou, por quê
Tom: Técnico, mas acessível. Explique o raciocínio, não apenas as escolhas. Mostre julgamento.
Comprimento: 800-1500 palavras (leitura de 4-6 minutos)
3. Diagramas de Arquitetura (Mermaid)
Gere diagramas relevantes com base no tipo de projeto:
Diagrama de Arquitetura do Sistema:
graph TB
Client[Aplicação Cliente]
API[Gateway de API]
Service1[Nome do Serviço]
Service2[Nome do Serviço]
DB[(Banco de Dados)]
Cache[(Cache)]
Client --> API
API --> Service1
API --> Service2
Service1 --> DB
Service1 --> Cache
Diagrama de Fluxo de Dados:
flowchart LR
Source[Fonte de Dados] --> Ingestion[Camada de Ingestão]
Ingestion --> Processing[Processamento]
Processing --> Storage[(Armazenamento)]
Storage --> API[Camada de API]
API --> Consumer[Consumidor]
Diagrama de Implantação:
graph TB
subgraph Azure
subgraph VNet
AppService[App Service]
Function[Azure Functions]
end
DB[(Banco SQL)]
Storage[(Armazenamento Blob)]
end
AppService --> DB
Function --> Storage
Diretrizes:
- Use o tipo de diagrama apropriado para o conteúdo
- Mantenha os diagramas focados (5-12 nós no máximo)
- Use rótulos claros e descritivos
- Inclua legenda se necessário para cores/formas
- Gere vários diagramas se o projeto for complexo
4. Métricas e Análise de Impacto
Extraia e apresente realizações quantificáveis:
Métricas Técnicas:
- Melhorias de desempenho (tempo de resposta, throughput, etc.)
- Realizações de escalabilidade (usuários suportados, transações/segundo)
- Qualidade de código (cobertura de testes, redução de defeitos)
- Confiabilidade (tempo de atividade, MTTR, taxas de erro)
- Melhorias de segurança (vulnerabilidades abordadas, conformidade alcançada)
Métricas de Negócio:
- Economia de custos (infraestrutura, tempo de desenvolvimento)
- Impacto na receita (novas capacidades, expansão de mercado)
- Ganhos de eficiência (automação, redução de trabalho manual)
- Satisfação do usuário (NPS, taxas de adoção)
- Tempo de mercado (velocidade de entrega, frequência de lançamento)
Formato: Apresente como números concretos com contexto:
- "Reduziu o tempo de resposta da API em 60% (450ms → 180ms)"
- "Reduziu custos de nuvem em $24K/ano através de otimização de recursos"
- "Permitiu escala de 10x de 1K → 10K usuários simultâneos"
5. Preparação para Entrevistas (Formato STAR)
Gere 2-4 histórias convincentes no formato STAR:
Estrutura:
- Situação: Contexto, problema, restrições (2-3 frases)
- Tarefa: Sua responsabilidade específica (1-2 frases)
- Ação: O que você fez, decisões técnicas, implementação (3-5 frases)
- Resultado: Resultados, métricas, impacto (2-3 frases)
Comprimento: Cada história deve ter 90-120 segundos quando falada
Foco: Histórias diferentes devem destacar:
- Resolução de problemas técnicos
- Tomada de decisão arquitetural
- Liderança/influência
- Lidar com restrições/trade-offs
6. Site GitHub Pages
Gere uma estrutura de site estático completa:
Página Inicial (index.html):
- Seção hero com nome do projeto e slogan
- Estatísticas rápidas (pilha tecnológica, cronograma, métricas de impacto)
- Navegação para seções
- Captura de tela/demo se disponível
Página de Arquitetura (architecture.html):
- Visão geral do sistema
- Diagramas de arquitetura (Mermaid embutido)
- Detalhes da pilha tecnológica
- Decisões de design
Página de Impacto (impact.html):
- Resultados de negócio
- Realizações técnicas
- Visualização de métricas
- Comparações antes/depois
Página de Demonstração (demo.html - se aplicável):
- Demonstração interativa ou passo a passo
- Capturas de tela com anotações
- Cenários de uso
- Incorporação de vídeo se disponível
Estilização:
- Design limpo e profissional
- Responsivo para celular
- Carregamento rápido (dependências mínimas)
- Acessível (conforme WCAG)
- Opcional: Use Primer CSS do GitHub ou CDN Tailwind
Fluxo de Trabalho
Passo 1: Coletar Entrada
-
Perguntar pela fonte do projeto:
- URL/caminho do repositório GitHub
- Documentação existente
- Notas do projeto
-
Entender o contexto:
- Que problema isso resolveu?
- Para quem foi?
- Qual foi sua função?
- O que tornou isso desafiador?
- Quais foram os resultados?
-
Esclarecer saídas:
- Quais entregáveis eles precisam?
- Algum requisito específico (comprimento, áreas de foco)?
- Detalhes do público-alvo?
Passo 2: Analisar (se repositório GitHub fornecido)
Use ferramentas bash/visualização para analisar o repositório:
# Analisar estrutura do repositório
find /caminho/para/repo -type f -name "*.cs" -o -name "*.csproj" | head -20
find /caminho/para/repo -type f -name "*.yml" -o -name "*.yaml"
# Verificar documentos de arquitetura
find /caminho/para/repo -type f -name "*.md" | grep -i "architecture\|design\|adr"
# Analisar dependências
cat /caminho/para/repo/*.csproj
cat /caminho/para/repo/package.json
cat /caminho/para/repo/requirements.txt
# Verificar configuração
find /caminho/para/repo -name "appsettings*.json" -o -name "*.config"
Extrair:
- Pilha tecnológica: Linguagens, frameworks, bancos de dados, serviços em nuvem
- Padrões: DDD, microsserviços, orientado a eventos, CQRS, etc.
- Arquitetura: Monolito, microsserviços, serverless, etc.
- Infraestrutura: Provedor de nuvem, estratégia de implantação
- Práticas de qualidade: Testes, CI/CD, monitoramento
Passo 3: Gerar Conteúdo
Gere cada tipo de saída solicitada seguindo as estruturas acima.
Princípios-chave:
- Público em primeiro lugar: Combine profundidade e jargão com o público
- Baseado em evidências: Fundamente afirmações em código/documentos quando possível
- Quantificar: Sempre tente incluir números e métricas
- Orientado por histórias: Enfatize desafios → soluções → impacto
- Honesto: Reconheça restrições e trade-offs
Passo 4: Criar Artefatos
Para documentos (resumos, análises aprofundadas):
- Use formato markdown
- Inclua seções claras com cabeçalhos
- Adicione trechos de código quando relevante
- Incorpore diagramas
Para GitHub Pages:
- Gere arquivos HTML completos
- Inclua CSS inline ou referencie CDN
- Garanta capacidade de resposta para celular
- Adicione meta tags para SEO
Para diagramas:
- Use ferramenta Mermaid Chart para renderizar
- Forneça tanto o código-fonte Mermaid quanto a imagem renderizada
- Garanta que os diagramas sejam autoexplicativos
Passo 5: Empacotar Entregáveis
Organize as saídas com base nas necessidades do usuário:
Para candidaturas a empregos:
- Resumo executivo (pronto para copiar/colar)
- 2-3 histórias STAR
- Lista de métricas-chave
Para site de portfólio:
- Estrutura completa do GitHub Pages
- Todos os ativos organizados
- Instruções de implantação
Para entrevistas:
- Histórias STAR (impressas/PDF)
- Diagrama de arquitetura (para referência de whiteboard)
- Folha de dicas de métricas
Considerações Especiais
Projetos .NET/Azure
- Destaque: Padrões DDD, princípios SOLID, padrões async/await
- Enfatize: Zero Trust, conformidade InfoSec, padrões empresariais
- Pilha tecnológica: Versão .NET, serviços Azure usados, padrões de design
Projetos de Machine Learning/Visão Computacional
- Foco: Formulação do problema, justificativa da seleção do modelo, métricas de desempenho
- Destaque: Abordagem de treinamento, pipeline de dados, otimização de inferência
- Métricas: Acurácia, precisão, recall, F1, latência de inferência
Projetos de Integração
- Enfatize: Design de API, tratamento de erros, consistência de dados
- Destaque: Integrações de terceiros, limitação de taxa, padrões de resiliência
- Métricas: Confiabilidade (tempo de atividade), precisão de dados, throughput
Projetos Empresariais/Em Grande Escala
- Contexto: Escala, requisitos de conformidade, restrições legadas
- Destaque: Estratégias de migração, compatibilidade reversa, mitigação de riscos
- Métricas: Números de escala, desempenho sob carga, otimização de custos
Formato de Saída
Ao gerar múltiplas saídas, organize da seguinte forma:
# Portfolio Showcase: [Nome do Projeto]
## Referência Rápida
- **Pilha Tecnológica**: [Lista]
- **Duração**: [Cronograma]
- **Função**: [Sua função]
- **Impacto**: [Top 1-2 métricas]
## Saídas Geradas
### 1. Resumo Executivo
[Conteúdo]
### 2. Análise Técnica Aprofundada
[Conteúdo]
### 3. Histórias STAR
#### História 1: [Título]
[Conteúdo]
#### História 2: [Título]
[Conteúdo]
### 4. Diagramas de Arquitetura
[Diagramas com explicações]
### 5. Painel de Métricas
[Métricas formatadas]
### 6. Arquivos GitHub Pages
[Estrutura de arquivos e conteúdos]
Lista de Verificação de Qualidade
Antes de entregar, garanta:
- Todas as métricas são específicas e quantificadas
- Termos técnicos são explicados ou justificados para o público
- Diagramas são claros e devidamente rotulados
- Histórias STAR estão completas (todos os 4 elementos)
- Resumo executivo passa no teste do "elevator pitch"
- Análise técnica aprofundada demonstra pensamento arquitetural
- Páginas GitHub Pages são responsivas para celular e acessíveis
- Nenhum erro gramatical ou digitação
- Terminologia consistente em todo o texto
- Realizações são enquadradas como impacto, não apenas tarefas
Exemplos de Prompts
Simples: "Crie um portfolio showcase para meu projeto DocFlow no GitHub"
Detalhado: "Construí um painel de status de voo usando .NET 8, DDD e Azure. Foi o primeiro aplicativo implantado em nosso ambiente Zero Trust. Preciso de um resumo executivo para recrutadores e uma análise técnica aprofundada para a entrevista, além de diagramas de arquitetura."
Conversacional: "Quero mostrar meu projeto de scanner de documentos com IA. Ele usa visão computacional para extrair dados de quadros brancos e se integra com vários sistemas. Você pode me ajudar a criar materiais para meu site de portfólio?"
Dicas para Usuários
Para obter os melhores resultados:
- Forneça acesso ao GitHub, se possível (fonte de informação mais rica)
- Compartilhe o "porquê" por trás do projeto (contexto de negócio é importante)
- Inclua quaisquer métricas que você acompanhou (mesmo informais)
- Mencione desafios que você superou (eles geram ótimas histórias)
- Especifique seu público-alvo (a profundidade técnica varia muito)
- Note o que te deixou orgulhoso ou o que você aprendeu (detalhes autênticos ressoam)
Erros comuns a evitar:
- Ser muito humilde (portfólio não é lugar para modéstia)
- Listar tarefas em vez de realizações ("Construí API" vs "Projetei API que reduziu latência em 40%")
- Usar jargões sem contexto para públicos não técnicos
- Esquecer de quantificar o impacto
- Fazer parecer um relatório de equipe em vez de sua contribuição