Skill de Tema de Design
1. Identidade do Skill
- Nome: design-theme
- Propósito: Define o padrão completo de UI/UX e design visual do portfólio de um desenvolvedor individual.
- Público-alvo: Portfólio de Desenvolvedor AI / Software / Produto
- Objetivo Principal: Transmitir a impressão de um desenvolvedor que descobre problemas reais e cria produtos usando IA e software, e não apenas um portfólio que lista tecnologias.
2. Filosofia Central de Design
Este portfólio prioriza as seguintes impressões:
- Profissional
- Moderno
- Minimalista
- Técnico
- Orientado a Produto
- Legível
- Confiável
Princípios Centrais
"O conteúdo e os projetos devem ser os protagonistas, não a decoração."
Ao ver a tela inicial, o usuário deve ser capaz de entender rapidamente:
- Quem é a pessoa?
- O que ela cria?
- Que problemas ela resolve?
- Quais projetos ela já fez?
- Quais tecnologias ela usa?
- Ela é realmente capaz de desenvolver?
3. Direção Visual
Direção Básica
- Prioridade para o Modo Claro
- Base em branco limpo / cinza claro
- Destaque Azul limitado
- Bordas finas
- Espaçamento generoso
- Tipografia forte
- Grade organizada
- Decoração excessiva minimizada
Direções a Evitar
Os seguintes designs não devem ser usados por padrão:
- Gradientes excessivos
- Brilho intenso
- Glassmorfismo
- Efeitos 3D exagerados
- Animações sem sentido
- Sombras excessivas
- Cores de arco-íris
- Badges em excesso
- Ilustrações decorativas em demasia
- Modelos genéricos comuns em portfólios de IA
- Badges de tecnologia com cores diferentes para cada uma
- Layouts onde o design chama mais atenção que o conteúdo
4. Sistema de Cores
Base
Background #FAFAFA
Surface #FFFFFF
Foreground #18181B
Text Secondary #52525B
Text Weak #71717A
Placeholder #A1A1AA
Border #E4E4E7
Background Weak #F4F4F5
Destaque
Accent #2563EB
Accent Hover #1D4ED8
Accent Soft #EFF6FF
A cor de destaque deve ser usada de forma limitada em toda a tela.
Locais de Uso do Destaque
- CTA Principal
- Links principais
- Navegação ativa
- Estados de foco
- Informações importantes
- Status de projeto que precisam de ênfase
Não use a cor de destaque excessivamente como fundo ou decoração em toda a tela.
Status
Success #16A34A
Warning #D97706
Error #DC2626
As cores de status devem ser usadas apenas para representar estados reais.
5. Tipografia
Prioridade de Fontes
Priorize a legibilidade do coreano.
Ordem recomendada:
Pretendard
system-ui
sans-serif
Para código, nomes de tecnologia, números e metadados, você pode usar:
Geist Mono
monospace
Escala Tipográfica
Hero
Desktop:
56px ~ 72px
font-weight: 700 ~ 800
line-height: 1.05 ~ 1.15
Mobile:
40px ~ 48px
font-weight: 700 ~ 800
line-height: 1.1 ~ 1.2
H2
Desktop:
36px ~ 44px
Mobile:
30px ~ 34px
H3
20px ~ 24px
Corpo
16px ~ 18px
line-height: 1.6 ~ 1.75
Pequeno / Meta
13px ~ 14px
6. Sistema de Layout
Container
Largura máxima padrão:
1200px
Padding Horizontal
Desktop:
32px ~ 48px
Tablet:
24px
Mobile:
20px
Espaçamento entre Seções
Desktop:
120px ~ 160px
Mobile:
80px ~ 100px
Não force o mesmo espaçamento em toda a página. Ajuste o espaçamento de acordo com a importância do conteúdo.
7. Sistema de Grade
A área de projetos deve usar a seguinte estrutura por padrão:
Desktop
2 Colunas
Tablet
2 Colunas
Mobile
1 Coluna
Não use grades com 3 ou mais colunas sem um motivo específico. É mais importante que o conteúdo do cartão do projeto seja legível do que o número de colunas na grade.
8. Cabeçalho
O cabeçalho deve ser uma interface mínima para auxiliar a navegação no portfólio.
Estrutura recomendada:
Logo / Nome
Projetos
Sobre / Abordagem
Contato
Se desejar, você pode adicionar links para Currículo ou GitHub.
Princípios do Cabeçalho
- Evite cabeçalhos excessivamente grandes.
- Não aumente a navegação desnecessariamente.
- Em mobile, reduza para um menu, se necessário.
- Use a cor de destaque de forma limitada para o estado ativo.
9. Hero
O Hero é a área mais importante da tela inicial.
O objetivo não é parecer chamativo, mas transmitir imediatamente a identidade do desenvolvedor.
Estrutura recomendada:
Sublinha
↓
Título Principal
↓
Descrição Curta
↓
CTA Primário / CTA Secundário
Exemplo de direção:
Quando encontro um problema,
eu mesmo o resolvo.
Desenvolvedor que resolve problemas reais
com IA e software e os transforma em produtos, Jung Hyun Yoon
No entanto, o texto final real deve ser gerenciado em um arquivo de conteúdo separado. Não codifique o conteúdo diretamente no componente Hero.
10. Design do Projeto
Os projetos são o conteúdo principal do portfólio.
O Cartão do Projeto não deve ser apenas um cartão que mostra nomes de tecnologias. Sempre que possível, transmita as seguintes informações:
Nome do Projeto
Status
Resumo Curto
Problema
Solução
Tecnologia
Período
Não force todas as informações em um único cartão. Se houver muita informação, direcione para uma página de detalhes.
11. Cartão do Projeto
Estilo padrão:
Background: #FFFFFF
Border: 1px solid #E4E4E7
Border Radius: 12px ~ 16px
Padding: 24px ~ 32px
Shadow: nenhum ou muito sutil
Minimize os efeitos de hover.
Recomendado:
Alteração de border-color
Alteração de background
transform: muito pequeno
Não use efeitos de ampliação excessiva ou brilho.
12. Status do Projeto
Expresse o status do projeto claramente.
Exemplo:
Ativo
Em Andamento
Arquivado
Não transmita o significado apenas com cor ao expressar o status. Use texto ou ícones juntos.
13. Tags de Tecnologia
As tags de tecnologia são elementos auxiliares para identificar informações rapidamente. Não aplique cores de arco-íris para cada tecnologia. Use um estilo Neutro por padrão.
Exemplo:
Next.js
TypeScript
Python
FastAPI
Supabase
SQLite
AI Agent
As tags de tecnologia não devem chamar mais atenção do que a descrição do projeto.
14. Página de Detalhes do Projeto
Ao clicar no Cartão do Projeto, você pode usar a seguinte estrutura:
Cabeçalho do Projeto
↓
Visão Geral
↓
Problema
↓
Abordagem
↓
Implementação
↓
Desafios
↓
Resultado
↓
O que Aprendi
↓
Tecnologia
↓
Links
Nem todos os projetos precisam ter todas as seções. Exiba apenas as informações que realmente existem no projeto.
15. Projetos em Destaque
Na página inicial, não mostre todos os projetos com o mesmo peso. Selecione os projetos principais com base no status featured.
Exemplo:
featured: true
A UI deve exibir os projetos com base no valor featured. Portanto, não deve ser necessário modificar o código do componente para remover um projeto dos Destaques.
16. Mais Projetos
Abaixo dos Projetos em Destaque, você pode fornecer uma área para visualizar outros projetos.
Objetivo:
Não é para evitar que o portfólio pareça ter poucos projetos, mas para mostrar a diversidade de problemas que o desenvolvedor resolveu.
Mantenha a hierarquia visual entre os projetos em destaque e os projetos comuns.
17. Seção de Abordagem
Em vez de um "Sobre Mim" genérico, considere priorizar uma área que mostre o método de desenvolvimento.
Exemplo:
01 Problema
02 Descoberta
03 Aprendizado
04 Construção
05 Resultado
A mensagem principal é:
Descobrir um problema → Pesquisar → Aprender a tecnologia necessária → Criar a solução → Verificar o resultado.
Priorize mostrar o processo real de desenvolvimento e a forma de pensar em vez de uma simples auto-apresentação.
18. Habilidades
A seção de habilidades não deve apenas listar tecnologias, mas sim mostrar o contexto real de uso.
Classificação recomendada:
Frontend
Backend
IA / Automação
Banco de Dados
Ferramentas
Exemplo:
Frontend
Next.js
React
TypeScript
Tailwind CSS
Backend
Python
FastAPI
Flask
IA / Automação
AI Agent
RAG
LLM API
Automação
Banco de Dados
SQLite
PostgreSQL
Supabase
Ferramentas
Git
GitHub
VS Code
No entanto, não adicione tecnologias sem experiência real de uso.
19. Representação de Habilidades
Não represente a proficiência em tecnologias com números arbitrários ou estrelas.
Proibido:
Python ★★★★★
React 90%
IA 95%
Em vez disso, conecte a tecnologia aos projetos reais e ao propósito de uso.
Exemplo:
Python
→ Usado em projetos de AI Agent / Automação / Backend
20. Contato
A área de Contato deve ser simples e clara.
Recomendado:
Mensagem Curta
E-mail
GitHub
LinkedIn ou outros links reais
Não crie contatos ou links que não existem de fato.
21. Rodapé
O rodapé deve ser mínimo.
Exemplo:
© 2026 Jung Hyun Yoon
Construído com Next.js
Não coloque mais informações do que o necessário.
22. Design Responsivo
Considere obrigatoriamente os seguintes ambientes:
Desktop
Tablet
Mobile
Não implemente o design responsivo apenas reduzindo a tela. Especialmente em mobile:
- Altere a estrutura de navegação
- Ajuste a tipografia do Hero
- Grade → 1 Coluna
- Ajuste o tamanho dos botões
- Reduza o padding
- Verifique a quebra de linhas em textos longos
- Priorize as informações no Cartão do Projeto
23. Acessibilidade
Considere a acessibilidade básica obrigatoriamente.
- Hierarquia de títulos adequada
- Contraste de cores suficiente
- Foco do teclado
- Botões / Links claros
- Texto alternativo em imagens
- Área de toque recomendada de 44px ou mais
- Não diferenciar estados apenas com cores
- Projete para que a informação seja transmitida mesmo sem animações
24. Animação
Use animações apenas quando elas ajudarem na funcionalidade.
Recomendado:
150ms ~ 300ms
ease-out
Áreas permitidas:
- Hover em botões
- Hover em links
- Hover em cartões
- Navegação
- Revelação curta de seções
O que não usar:
- Parallax
- Animações de scroll excessivas
- Movimento contínuo
- Animações decorativas sem sentido
- Efeitos exagerados na entrada da página
25. Modo Escuro
Na versão inicial, priorize o Modo Claro. O Modo Escuro será adicionado quando houver um requisito separado. Não complique o sistema de design atual ou a estrutura de componentes por causa do Modo Escuro.
26. Regras Técnicas de Design
Use Tailwind CSS como sistema de estilo padrão. Use CSS Variables para gerenciar tokens de design globais.
Recomendado:
Tailwind
+
CSS Variables
Não use estilos inline desnecessários.
27. Regras de Componentes
Use React Server Component como padrão. Use Client Component apenas nos seguintes casos:
- Entrada do usuário
- Gerenciamento de estado
- APIs do navegador
- Interações baseadas em eventos
- Quando for necessária execução no cliente, como bibliotecas de animação
Não transforme a página inteira em um Client Component desnecessariamente.
28. Separação de Conteúdo / UI
Separe o conteúdo da UI.
Estrutura recomendada:
content/
├─ profile.ts
├─ projects.ts
├─ skills.ts
└─ types.ts
Não escreva informações do projeto diretamente dentro dos componentes da UI. Ao adicionar ou modificar um projeto, projete de forma que, sempre que possível, apenas a edição de:
content/projects.ts
seja refletida na tela.
---
# 29. Princípio dos Dados do Projeto
Gerencie os dados do projeto de forma estruturada.
Exemplo:
```ts
{
slug,
title,
summary,
problem,
solution,
tech,
status,
featured,
period,
image,
links,
highlights
}
Use apenas os valores necessários. Não preencha informações que não existem de fato.
30. Regras para Imagens
Se a imagem do projeto não existir de fato, não crie ou importe imagens arbitrárias. Se um placeholder for necessário, indique claramente que é um placeholder. Crie uma estrutura para que, quando a captura de tela real do projeto estiver disponível, ela possa substituir a imagem do projeto.
31. Integridade dos Dados
Este é um dos princípios mais importantes do portfólio.
Nunca crie arbitrariamente:
- Projetos que não existem
- Experiências com tecnologias que não existem
- Resultados que não existem
- Números que não existem
- Clientes que não existem
- Experiências profissionais que não existem
- Links que não existem
- Certificações/qualificações que não existem
- Resultados de projetos que não existem
Se a informação for insuficiente, priorize:
Deixar em branco
ou
Confirmar com o usuário
32. Preservação de Projetos Existentes
Não altere arbitrariamente o significado dos projetos existentes. Trabalhe com base nas descrições ou requisitos fornecidos pelo usuário. Se for necessário excluir ou reduzir uma funcionalidade existente, explique o motivo primeiro e peça confirmação.
33. Arquitetura da Informação do Portfólio
A estrutura inicial da página inicial deve considerar o seguinte como prioridade:
Cabeçalho
↓
Hero
↓
Projetos em Destaque
↓
Mais Projetos
↓
Abordagem
↓
Habilidades
↓
Contato
↓
Rodapé
No entanto, pode ser ajustado de acordo com o conteúdo real e a usabilidade.
34. Prioridade de Decisão de Design
Em caso de conflito de design, siga esta prioridade:
1. Legibilidade do conteúdo
2. Hierarquia da informação
3. Acessibilidade
4. Usabilidade responsiva
5. Consistência
6. Estética visual
7. Efeitos decorativos
Priorize um design fácil de ler e entender em vez de um design bonito.
35. Fluxo de Trabalho de Implementação
Ao criar uma nova página ou UI, siga esta ordem:
PASSO 1. Analisar
Verifique primeiro a estrutura atual do projeto e a UI existente.
PASSO 2. Planejar
Proponha a estrutura de informação e a composição da tela necessárias.
PASSO 3. Projetar
Proponha uma direção visual com base nos princípios de design deste SKILL.md.
PASSO 4. Componente
Proponha a estrutura de componentes necessária.
PASSO 5. Confirmar
Para grandes mudanças estruturais ou novas funcionalidades, obtenha a confirmação do usuário antes da implementação.
PASSO 6. Implementar
Implemente apenas o escopo confirmado.
PASSO 7. Verificar
Verifique o seguinte:
TypeScript
Build
Responsivo
Acessibilidade
Consistência visual
Funcionalidade existente
36. Gerenciamento de Mudanças
Para pequenas alterações, mantenha a estrutura existente o máximo possível. Antes de grandes alterações, siga esta ordem:
- Verificar a estrutura atual
- Explicar o motivo da mudança
- Verificar o escopo do impacto
- Apresentar alternativas
- Obter aprovação do usuário
- Implementar
37. Dependências
Adicione novas bibliotecas apenas quando a necessidade for clara. Se você pode resolver o problema com as funcionalidades existentes do Next.js / React / TypeScript / Tailwind, não adicione uma nova biblioteca. Se for necessário adicionar uma biblioteca, primeiro analise:
Por que é necessário
O que resolve
Se existe uma alternativa
38. Princípio do Supabase / Backend
A versão inicial do portfólio atual começa com base em conteúdo estático. Use content/*.ts como prioridade. Adicione um backend como Supabase apenas quando os seguintes requisitos surgirem de fato:
- Página de administração
- CRUD de projetos
- Blog
- Registro de desenvolvimento
- Armazenamento de contatos
- Autenticação
- Gerenciamento de dados dinâmicos
Não introduza um banco de dados em uma fase onde o backend não é necessário.
39. Fluxo de Trabalho Git
Faça commit quando uma unidade de trabalho significativa for concluída.
Fluxo básico:
git add .
git commit -m "Descrição do trabalho"
git push
Recomenda-se o formato Conventional Commit para mensagens de commit.
Exemplo:
feat: adicionar página inicial do portfólio
feat: adicionar seção de projetos
style: melhorar cartões de projeto
fix: corrigir layout mobile
refactor: simplificar componentes de projeto
docs: atualizar documentação do portfólio
chore: atualizar dependências
Não agrupe unidades de trabalho excessivamente grandes.
40. Padrão de Qualidade Final
A tela finalizada deve responder "Sim" para as seguintes perguntas:
- A identidade do desenvolvedor é visível na primeira tela?
- Os projetos são vistos como o conteúdo principal?
- É compreensível o que cada projeto resolveu?
- Os resultados e processos reais são enfatizados em vez de uma lista de tecnologias?
- É fácil de ler em mobile?
- O conteúdo e a UI estão separados?
- É fácil adicionar novos projetos?
- Não há informações falsas incluídas?
- Transmite uma impressão profissional sem efeitos de design excessivos?
- Funcionalidades existentes não foram excluídas desnecessariamente?
41. Regras Inegociáveis
Os seguintes princípios são sempre mantidos:
- A decoração não deve superar o conteúdo.
- Os projetos são o núcleo do portfólio.
- Não invente conteúdo que não seja baseado em experiência real.
- Não adicione resultados ou números que o usuário não forneceu.
- Separe o conteúdo da UI.
- O Design Responsivo é padrão.
- Considere a acessibilidade.
- Não adicione bibliotecas desnecessárias.
- Não exclua funcionalidades existentes arbitrariamente.
- Grandes mudanças estruturais devem ser confirmadas com o usuário antes da implementação.
- Mantenha a direção de design Profissional / Moderno / Minimalista / Técnico.
- Mantenha o Modo Claro como padrão da primeira versão.
- Projete de forma que não seja necessário modificar o código da UI ao adicionar projetos.
- Todas as decisões de design priorizam a legibilidade e a transmissão de informações.