New features: Route Stickness, Handoff, Clarification, Read-Only/Transactional, Long Term Memory

docs/PERFORMANCE_OPTIMIZATIONS_MCP_JUDGES_RAG.md

@@ -0,0 +1,14 @@
+# Otimizações de execução MCP, RAG e Judges
+
+- `mcp_tools` permanece allowlist; somente a consulta selecionada por `selection_keywords` é executada.
+- Extração `strategy: hybrid` tenta `pattern` regex antes do perfil LLM.
+- RAG é ignorado quando MCP bem-sucedido é suficiente, salvo perguntas de política/regra.
+- `mcp_results` é fornecido como evidência ao groundedness judge.
+- `judges.yaml` aceita `sample_rate` e `always_run_for_transactional`.
+- Consultas estruturadas simples podem retornar resposta determinística sem LLM do agente.
+
+## Mudança de consulta para ação transacional
+
+A route stickiness é preemptada quando uma keyword explícita configurada em `routing.yaml` identifica outra intent/agente. Assim, uma sessão em `retail_order_tracking` muda para `retail_support_exchange_return` ao receber pedidos como “devolver pedido”. Além disso, respostas diretas de tools read-only são bloqueadas quando a mensagem contém `selection_keywords` de qualquer tool transacional registrada.
+
+As palavras de ação ficam em `config/tools.yaml`; o runtime não mantém aliases de domínio hardcoded.