expand-brazilian-identity

name	expand-brazilian-identity
description	Gera variações ortográficas e estruturais do nome do alvo para uso em buscas em bases americanas. Funciona para alvos de qualquer nacionalidade com nome latino. Use sempre antes de qualquer busca em base dos EUA — nomes são transliterados de forma inconsistente (ordem invertida, sobrenomes compostos, acentos removidos). Pode ser invocada pelo orquestrador ou diretamente via CLI.

Expansão de Identidade do Alvo

Quando usar

• Sempre antes de qualquer busca em base americana
• Quando o usuário disser /expandir-nome "Nome Completo"
• Como sub-skill chamada pelo orquestrador due-diligence-transnacional
• O algoritmo é agnóstico à nacionalidade: funciona com qualquer nome latino (espanhol, português, italiano). Para nomes não-latinos (asiáticos, árabes), as variações de acento e ordem inversa ainda se aplicam, mas a cobertura de transliteração é menor.

Inputs

target.yaml com nome_completo, origin_country (opcional, default "BR"), parentes (opcional), apelidos (opcional) — ou via CLI:

python skills/expand-brazilian-identity/scripts/expand_identity.py \
  --name "Carlos Eduardo Ferreira" \
  --alias "Rick Ferreira" \
  --origin-country BR \
  --relatives '[{"nome": "Carla Ferreira", "relacao": "conjuge"}]'

# Non-Brazilian target (Peruvian):
python skills/expand-brazilian-identity/scripts/expand_identity.py \
  --name "Pablo Vargas Mendoza" \
  --origin-country PE

Variações geradas (mínimo obrigatório)

1. Nome completo conforme fornecido
2. Nome completo sem acentos (João → Joao, Ângelo → Angelo)
3. Primeiro nome + último sobrenome (Carlos Ferreira)
4. Ordem invertida: último sobrenome + primeiro nome (Ferreira Carlos) — convenção de alguns formulários americanos
5. Iniciais + último sobrenome (C. E. Ferreira, C. Ferreira)
6. Sobrenome isolado (Ferreira) — busca ampla, alto ruído; marcar como tal
7. Para cada apelido fornecido: registrar como variação do tipo alias
8. Para cada parente direto: gerar nome completo sem acentos + sobrenome isolado, ambos do tipo relative

Output

identity-variations.json validado contra schemas/identity-variations.schema.json.

Exemplo mínimo:

{
  "target_name": "Carlos Eduardo Ferreira",
  "generated_at": "2026-04-30T14:00:00+00:00",
  "approved_by_human": false,
  "variations": [
    {"variation": "Carlos Eduardo Ferreira", "type": "full_name", "note": "..."},
    {"variation": "Carlos Ferreira",         "type": "first_last", "note": "..."},
    {"variation": "Ferreira Carlos",         "type": "last_first", "note": "..."},
    {"variation": "C. E. Ferreira",           "type": "initials_last", "note": "..."},
    {"variation": "Ferreira",                 "type": "surname_only", "note": "..."}
  ]
}

Revisão humana obrigatória

Após gerar as variações, mostrar ao usuário e perguntar:

1. "Há variações incorretas a remover?"
2. "Há variações faltando (apelidos, nome de solteiro/a, nome americanizado)?"

Só avançar para buscas após confirmação explícita. Atualizar approved_by_human: true no JSON antes de passar para as sub-skills.

Princípios anti-alucinação

• Nunca inventar variações que não derivem do nome fornecido.
• Nunca buscar sem aprovação humana das variações.
• Registrar sempre a versão do script usada (generated_at no output).

Referências

• references/transliteration-patterns.md — tabela de substituições de caracteres e padrões de transliteração comuns
• Script CLI: scripts/expand_identity.py