Architecture & CoreDecisions
0010 unified ai agent personas
ADR 0010: Consolidação da Nomenclatura de Agentes IA (v5.5)
Status
Aceito
Contexto
Durante o desenvolvimento da v5.5, foram introduzidas novas personas de agentes IA (QualityGate, CopyMaster). No entanto, o código de rotas (public-api.ts) e o sistema de análise (smart-pipeline.ts) ainda mantinham referências a nomes obsoletos da v4 (Sherlock, LabAgent), causando confusão técnica e inconsistência nos logs de telemetria.
Decisão
Unificar toda a nomenclatura de agentes para o padrão atualizado:
- Sherlock Service ➔ Referenciado externamente e nas rotas como QualityGate.
- LabAgent ➔ Renomeado/Substituído por CopyMaster.
Lista oficial de Personas permitidas:
CopyMaster: Descrições criativas e SEO.QualityGate: Auditoria técnica e de conformidade.PriceWizard: Otimização de precificação.TrendSpotter: Identificação de tendências.Concierge: Atendimento e suporte multi-idioma.
Consequências
- Os logs do
Decision EngineeAgent Auditsagora refletirão nomes consistentes com as funcionalidades. - Facilitada a manutenção de prompts no
HubGateway. - Eliminação de código morto/pseudônimos que induziam ao erro de implementação.