.

docs/FLUXO_PERSONAS.md

@@ -0,0 +1,169 @@
+# Fluxo de Trabalho das Personas
+
+Este documento descreve o fluxo atual de trabalho das personas no sistema Antigravity Brain e o problema identificado na transição de "voz" entre agentes.
+
+---
+
+## 📊 Arquitetura Atual
+
+```mermaid
+flowchart TD
+    subgraph Interface["💬 Interface Chainlit"]
+        User([Usuário])
+        Gnarl["🧙 Gnarl<br/>(Mensagem de Boas-Vindas)"]
+    end
+    
+    subgraph Core["⚙️ Core System"]
+        Router["SmartRouter<br/>(classifica a requisição)"]
+        Crews["CrewDefinitions<br/>(monta a crew apropriada)"]
+    end
+    
+    subgraph CrewsAvailable["🎭 Crews Disponíveis"]
+        C1["Infra Engineering (Zabbix)<br/>Arthur Mendes + Gus Fring"]
+        C2["Security Audit<br/>Elliot Alderson + Devil"]
+        C3["HR & Evolution<br/>The Architect + Sherlock Holmes"]
+        C4["Sales Growth<br/>(não implementado)"]
+        C5["Business Strategy<br/>Harvey Specter (fallback)"]
+    end
+    
+    User -->|"mensagem"| Gnarl
+    Gnarl -->|"passa para"| Router
+    Router -->|"seleciona"| Crews
+    Crews -->|"monta"| C1
+    Crews -->|"monta"| C2
+    Crews -->|"monta"| C3
+    Crews -->|"monta"| C4
+    Crews -->|"monta"| C5
+```
+
+---
+
+## ❌ Problema Atual: Transição de Voz
+
+### Sintoma
+O **Gnarl** cumprimenta o usuário na mensagem inicial, mas quando uma task é executada, os agentes especializados (Arthur, Harvey, Elliot, etc.) respondem diretamente **sem indicação de quem está falando**.
+
+### Fluxo Atual (Problemático)
+
+| Etapa | Quem Fala | O que Aparece |
+|-------|-----------|---------------|
+| 1. Início | Gnarl | "Gnarl Online. Mestre, estou pronto..." |
+| 2. Usuário pergunta | - | "Como monitoro um servidor?" |
+| 3. Processamento | (invisível) | "Pensando..." |
+| 4. Resposta | **???** | "Para monitorar um servidor você precisa..." |
+
+**Problema:** Na etapa 4, o usuário não sabe que a resposta veio do **Arthur Mendes** (especialista em infraestrutura) e não do Gnarl.
+
+### Impacto na UX
+- Confusão sobre quem está respondendo
+- Perda de "personalidade" dos agentes especializados
+- Usuário não entende a expertise por trás de cada resposta
+
+---
+
+## 🎯 Personas Disponíveis (27 total)
+
+### Por Crew
+
+| Crew | Agentes | Função |
+|------|---------|--------|
+| **Infra Engineering** | Arthur Mendes, Gus Fring | Zabbix, monitoramento, infraestrutura |
+| **Security Audit** | Elliot Alderson, Devil | Pentesting, vulnerabilidades |
+| **HR & Evolution** | The Architect, Sherlock Holmes | Criar agentes, aprender políticas |
+| **Business Strategy** | Harvey Specter | Fallback genérico, ROI, compliance |
+| **Sales Growth** | (não implementado ainda) | - |
+
+### Lista Completa de Personas
+
+```
+ari-gold, arthur-mendes, chris-gardner, devil, don-draper, elliot-alderson,
+gordon-ramsay, gremlin, gus-fring, hannibal-lecter, harvey-specter, 
+jerry-maguire, jim-halpert, kevin-oleary, leslie-knope, linus-torvalds,
+marie-kondo, olivia-pope, react-expert, saul-goodman, sherlock-holmes,
+steve-jobs, ted-lasso, the-architect, tony-stark, tyrion-lannister, walter-white
+```
+
+---
+
+## 💡 Soluções Propostas para Discussão
+
+### Opção A: Gnarl como "Narrador/Tradutor"
+O Gnarl permanece como a única voz visível ao usuário. Ele recebe o resultado das crews e *parafrasea* no seu estilo.
+
+```
+Gnarl: "Mestre, consultei Arthur Mendes sobre seu problema. 
+       Ele diz que para monitorar um servidor você precisa..."
+```
+
+**Prós:** Interface consistente, uma única personalidade
+**Contras:** Perde a riqueza dos personagens especializados
+
+---
+
+### Opção B: Assinatura de Agente na Resposta
+Adicionar visualmente quem está respondendo:
+
+```
+━━━ Arthur Mendes ━━━
+Para monitorar um servidor você precisa...
+```
+
+**Prós:** Clareza sobre quem fala
+**Contras:** Pode parecer "robótico", quebra imersão
+
+---
+
+### Opção C: Transição Narrativa (Recomendada)
+Gnarl faz a ponte entre as vozes:
+
+```
+Gnarl: "Mestre, deixe-me chamar Arthur Mendes para essa questão..."
+
+Arthur: "Olá! Para monitorar um servidor você precisa..."
+
+Gnarl: "Arthur finalizou. Posso ajudar com mais algo, Mestre?"
+```
+
+**Prós:** Mantém narrativa fluida, mostra expertise, Gnarl como orquestrador
+**Contras:** Mais verboso, requer mudanças no app.py
+
+---
+
+### Opção D: Gnarl "Veste" a Persona
+Gnarl muda seu estilo de fala baseado na crew ativa, sem trocar nome:
+
+```
+# Se crew é "Security Audit" (Elliot personality)
+Gnarl: "Mestre... analisei a superfície de ataque. Root access em 3 minutos."
+
+# Se crew é "Business Strategy" (Harvey personality)  
+Gnarl: "Mestre, vamos fechar isso. Aqui está o que você precisa fazer..."
+```
+
+**Prós:** Uma voz, várias personalidades
+**Contras:** Pode ser confuso, Gnarl perderia sua identidade
+
+---
+
+## 🔧 Arquivos Relevantes para Implementação
+
+| Arquivo | Função |
+|---------|--------|
+| [app.py](file:///c:/Users/joao.goncalves/Desktop/minions-da-itguys/src/app.py) | Interface Chainlit, onde Gnarl é definido |
+| [definitions.py](file:///c:/Users/joao.goncalves/Desktop/minions-da-itguys/src/crews/definitions.py) | Montagem das crews |
+| [router.py](file:///c:/Users/joao.goncalves/Desktop/minions-da-itguys/src/router.py) | Lógica de roteamento |
+| [factory.py](file:///c:/Users/joao.goncalves/Desktop/minions-da-itguys/src/agents/factory.py) | Criação de agentes |
+| [src/agents/personas/](file:///c:/Users/joao.goncalves/Desktop/minions-da-itguys/src/agents/personas/) | Arquivos de personalidade |
+
+---
+
+## ⏳ Próximos Passos
+
+1. **Decidir** qual opção de transição de voz implementar (A, B, C ou D)
+2. **Implementar** as mudanças no `app.py` e possivelmente `definitions.py`
+3. **Testar** o novo fluxo de conversação
+4. **Documentar** o comportamento final
+
+---
+
+*Documento criado em: 2026-01-09*

src/app.py

@@ -8,8 +8,8 @@ from src.router import SmartRouter
 
 @cl.on_chat_start
 async def on_chat_start():
-    # Welcome message without emojis, more natural
-    await cl.Message(content="**Antigravity Brain Online**\n\nEstou pronto para ajudar. Pode me dizer o que precisa? Por exemplo: *'Verificar a saúde do servidor'* ou *'Criar um novo agente'*.").send()
+    # Welcome message - Gnarl from Overlord franchise
+    await cl.Message(content="**Gnarl Online**\n\nMestre, estou pronto para servi-lo. O que deseja? Por exemplo: *'Verificar a saúde do servidor'* ou *'Criar um novo agente'*.", author="Gnarl").send()
     cl.user_session.set("selected_crew", None)
 
 @cl.on_message
@@ -33,19 +33,12 @@ async def on_message(message: cl.Message):
     # No, that's risky. Let's stick to: Route First -> Sticky -> User can /reset.
     
     if not current_crew:
-        # Show loading indicator while routing
-        msg_routing = cl.Message(content="Analisando sua solicitação...")
-        await msg_routing.send()
-        
+        # Route silently without showing routing details to user
         current_crew = SmartRouter.route(user_input)
         cl.user_session.set("selected_crew", current_crew)
 
-        await msg_routing.update()
-        await cl.Message(content=f"**Direcionando para:** {current_crew}").send()
-
-    # 3. Execution with proper loading indicator
-    # Create a message that will show loading state and be updated with the result
-    msg = cl.Message(content=f"**{current_crew}** está processando sua solicitação...")
+    # 3. Execution - show only thinking indicator
+    msg = cl.Message(content="Pensando...", author="Gnarl")
     await msg.send()
     
     try:
@@ -57,12 +50,12 @@ async def on_message(message: cl.Message):
         result = crew.kickoff(inputs={"topic": user_input})
         final_answer = str(result)
         
-        # Update message with final result
-        msg.content = f"### Relatório de {current_crew}\n\n{final_answer}"
+        # Update message with clean result (no crew info)
+        msg.content = final_answer
         await msg.update()
         
     except Exception as e:
-        msg.content = f"**Erro ao processar solicitação:** {str(e)}"
+        msg.content = f"Mestre, encontrei um problema: {str(e)}"
         await msg.update()
         # Reset crew on failure so user can try again or get re-routed
         cl.user_session.set("selected_crew", None)