Marcadores de Código Gerado por IA (AI Code Smells)

1. Visão geral do conceito e propósito

Qualquer engenheiro sênior experiente, durante uma entrevista ou auditoria de repositório, consegue identificar em 5 segundos: «Este código foi escrito por alguém que entende o que está fazendo, enquanto este outro foi copiado cegamente de um chatbot sem qualquer revisão».

A inteligência artificial escreve rapidamente, mas possui maneirismos específicos e "vícios" que a indústria denomina AI Code Smells.

Conhecer esses marcadores é essencial para todo iniciante: isso ajudará você a limpar o projeto de lixo sintético a tempo e a parecer um desenvolvedor profissional aos olhos dos colegas e clientes.

2. Principais marcadores de código gerado por redes neurais

┌─────────────────────────────────────────────────────────────┐
│                 TOP-4 MARCADORES DE "AI CODE SMELLS"        │
├─────────────────────────────────────────────────────────────┤
│ 1. 📢 Comentários óbvios (Captain Obvious):                 │
│    // Atribuindo valor à variável a                         │
│    const a = 10; // Isto é o número dez                     │
├─────────────────────────────────────────────────────────────┤
│ 2. 🖨️ Duplicação de utilitários em cada arquivo:           │
│    Em vez de importar a função compartilhada `formatDate()`,│
│    a IA copia a mesma função de 15 linhas em 7 componentes  │
│    diferentes                                               │
├─────────────────────────────────────────────────────────────┤
│ 3. 🙈 Blocos vazios de tratamento de erros:                 │
│    try { doSomething(); } catch (e) { /* não fazemos nada */│
│    (O erro ocorre, mas você nunca fica sabendo dele)        │
├─────────────────────────────────────────────────────────────┤
│ 4. 🤹 Hipercomplexidade para tarefas simples:               │
│    Criar 3 classes, uma fábrica e uma interface apenas      │
│    para somar dois números                                  │
└─────────────────────────────────────────────────────────────┘

3. Como transformar código sintético em código profissional

Compare os dois trechos de código:

❌ Antes (Saída bruta típica da IA):

// Функція, яка перевіряє користувача
function checkUser(user: any) {
  try {
    // Якщо користувач існує
    if (user != null) {
      // Повертаємо істину
      return true;
    }
  } catch (err) {
    console.log("Помилка");
  }
  return false;
}

✅ Depois (Código de engenharia limpo):

export function isUserActive(user: User | null): boolean {
  return Boolean(user?.isActive);
}

4. Checklist de limpeza do projeto antes do release

• Remova todos os comentários óbvios que apenas repetem o que já está expresso no nome da variável.
• Verifique os tipos: substitua todos os any negligentes por tipos TypeScript específicos.
• Extraia trechos de código repetidos para uma pasta dedicada como src/lib ou src/utils.
• Certifique-se de que todas as mensagens de erro sejam realmente logadas, em vez de serem ocultadas em blocos catch vazios.