🚧 O desafio de escalar para usuários não-técnicos
O TRIAD nasceu no terminal — mas 80% dos usuários potenciais nunca vão abrir um terminal. Gestores, criadores, analistas e pesquisadores precisam dos mesmos resultados sem precisar memorizar comandos. Esse é o gap de empatia que separa "ferramenta de poder" de "ferramenta universal".
O que é
O gap de empatia é a distância entre o modelo mental do criador técnico (terminal, markdown, flags, jobs) e o modelo mental do usuário final não-técnico (formulários, botões, resultados, "isso vai me ajudar agora?"). Onboarding eficaz é o que costura esse gap.
🧠 Três barreiras que matam adoção
✗ Onboarding técnico (afasta)
- ✗"Clone o repositório, copie o .env.example..."
- ✗"Edite seu soul.md seguindo o schema"
- ✗"Configure as flags do Hermes no config.yaml"
- ✗Tutorial de 40 minutos antes do primeiro resultado
✓ Onboarding humano (engaja)
- ✓Instalador único — um clique, sem PATH
- ✓Formulário web gera o soul.md por você
- ✓Persona pré-pronta — escolha uma, comece
- ✓Primeiro resultado em menos de 5 minutos
💡 Por que aprender
Cada amigo, colega ou cliente que você quer ajudar com o TRIAD é um teste real de onboarding. Se você não tem templates prontos e um guia simples, vai gastar horas explicando — e a maioria desiste antes de ver valor. Onboarding é o multiplicador silencioso da adoção.
🔑 Conceitos-chave
Distância entre o modelo mental técnico e o do usuário final não-técnico
Tempo entre instalação e o primeiro resultado útil — meta: menos de 5 minutos
Mostre o que o sistema entrega antes de ensinar como ele se chama
Cada template pronto remove uma decisão de configuração do usuário
📄 Simplificando o soul.md — versão para não-técnicos
O soul.md em markdown puro é poderoso — e intimidador. A versão form-based traduz cada campo do soul em uma pergunta de formulário web. O usuário responde, o sistema gera o markdown.
O que é
Um wizard web em 6 telas que captura as informações essenciais do soul (identidade, missão, restrições, estilo, valores, sucesso) através de campos de formulário com placeholders e exemplos — e exporta um soul.md formatado e validado.
🪄 Antes e depois — o mesmo soul, duas interfaces
ANTES — markdown puro
# soul.md
## identity
name: ___
archetype: ___
## mission
primary: ___
scope: ___
## constraints
- ___
- ___
DEPOIS — formulário web
Nome do seu assistente
ex: "Athena", "Apolo", "Maria"
Em uma frase, o que ele faz?
ex: "Escreve posts pra LinkedIn"
O que ele NUNCA deve fazer?
ex: "Usar emojis, prometer ROI"
💡 Dica de design
Cada campo do formulário deve ter placeholder concreto (não "ex: seu objetivo"), exemplo real abaixo e botão "usar este exemplo". O usuário não-técnico não sabe o que escrever até ver alguém escrevendo.
🔑 Conceitos-chave
Formulário web captura entrada estruturada e gera markdown válido por baixo
Exemplos reais reduzem em 60% o tempo de preenchimento
Erros aparecem no campo, não em uma tela de "schema inválido"
O usuário avançado ainda pode editar o markdown gerado
📖 Guia de primeiro uso — a primeira semana com Hermes
Sem um caminho narrado, o usuário fica olhando para uma tela em branco. A jornada de 7 dias dá um ritmo, uma vitória pequena por dia, e leva à autonomia sem sobrecarga cognitiva.
O que é
Um roteiro de 7 dias que distribui a complexidade do TRIAD em incrementos pequenos — instalação no dia 1, primeira tarefa no dia 3, exploração no dia 5, primeiro job assíncrono no dia 7. Nenhum passo exige mais de 15 minutos.
Instale e configure seu primeiro soul
15 min. Baixe o instalador, escolha uma persona pré-pronta (Athena para escrita, Orpheus para estratégia), responda 6 perguntas no wizard. Resultado: Hermes pronto pra conversar.
Sua primeira tarefa real
10 min. Use o template "Resuma este texto em 5 pontos" ou "Reescreva este e-mail mais conciso". Pequena, concreta, com resultado tangível. Sensação de "isso funciona".
Tour pelo Pantheon
15 min. Apresente os outros personagens (Athena, Orpheus, Apolo) com analogias simples — "Hermes é o mensageiro, Orpheus é o estrategista". Cada um com 1 exemplo de quando usar.
Primeiro job overnight
10 min de setup, processa enquanto dorme. "Analise estes 20 documentos e me devolva um resumo de manhã". O usuário sente o poder da execução assíncrona — momento "wow" que cimenta o hábito.
🎯 Princípio de design
Cada dia tem uma única vitória. Não tente ensinar persona + tarefa + Pantheon + jobs no dia 1. Esparramar a complexidade ao longo da semana mantém o usuário sentindo progresso, não sobrecarga.
🔑 Conceitos-chave
Quatro marcos espaçados, cada um com vitória concreta e sem sobreposição
O job overnight é o que converte curiosidade em hábito de uso recorrente
Não acumule features no mesmo dia — distribua a complexidade no tempo
Acima disso, o usuário não-técnico abandona — abaixo, não sente progresso
🎭 Templates de personas prontas para copiar e usar
Pedir para o usuário não-técnico "criar uma persona do zero" é a forma mais rápida de matar a adoção. Templates prontos dão um ponto de partida que ele pode ajustar — não inventar.
O que é
Uma biblioteca curada de souls pré-prontos, cada um com nome mitológico, descrição em uma frase, caso de uso ideal e três tarefas de exemplo. O usuário escolhe a que mais se aproxima do que precisa e ajusta no máximo 2-3 campos.
Orpheus — Estratégia
Pesa decisões, monta argumentos, faz pre-mortem. Ideal pra fundadores, PMs, consultores.
soul: orpheus.md
archetype: strategist
tone: direto, sem floreio
output: argumento + contra
Athena — Escrita
Redação de posts, e-mails, ensaios. Ideal pra criadores, marketers, escritores.
soul: athena.md
archetype: writer
tone: claro, calor humano
output: rascunho + 2 variantes
Hermes-research — Pesquisa
Deep dives, sínteses, comparativos. Ideal pra analistas, pesquisadores, estudantes.
soul: hermes-research.md
archetype: researcher
tone: cético, cita fontes
output: síntese + bibliografia
Apollo — Criativo
Brainstorm, naming, conceitos visuais. Ideal pra designers, criativos, founders.
soul: apollo.md
archetype: creator
tone: ousado, lateral
output: 10 ideias divergentes
📦 Estrutura de um template
Todo template entrega 4 elementos prontos:
- •soul.md completo — pronto pra uso, com placeholders apenas em nome e contexto pessoal
- •3 tarefas de exemplo — para o usuário copiar/colar e ver a persona em ação
- •Vídeo de 90 segundos — mostrando a persona resolvendo uma tarefa real
- •Variações — 2-3 customizações comuns (tom mais formal, escopo restrito, etc.)
🔑 Conceitos-chave
4-6 personas cobrem 80% dos casos de uso de não-técnicos
O usuário modifica 2-3 campos, não inventa o soul do zero
Ver a persona em ação é mais persuasivo do que ler sua descrição
Prompts prontos para copiar removem a paralisia do "o que peço agora?"
❓ FAQ — as 10 dúvidas mais comuns de usuários novos
Cada dúvida não respondida é um usuário perdido. Um FAQ curado — baseado em perguntas reais de não-técnicos — economiza horas de suporte e converte ansiedade em autonomia.
O que é
Um documento de FAQ organizado por urgência (bloqueadores primeiro, curiosidade depois), com resposta direta em até 3 linhas e link para aprofundamento opcional. Cada entrada deve resolver — não apenas explicar.
❓ Hermes não responde — o que faço?
1. Cheque conexão de internet
2. Rode triad doctor — diagnóstico automático
3. Se persistir, reinicie: triad restart hermes
❓ Como cancelo um job em andamento?
No painel: clique no job → "Cancelar"
No terminal: triad job cancel <id>
Custos parciais já gastos não são reembolsados
❓ Onde fica meu soul.md?
Mac/Linux: ~/.triad/souls/
Windows: %APPDATA%\triad\souls\
Use triad soul open para abrir no editor
❓ Posso usar offline?
Parcial: Workers locais (Ollama) funcionam offline
Workers via API (Claude, GPT) exigem internet
Configure em Settings → Workers → Modo offline
❓ Como mudo o modelo do Worker?
No painel: Settings → Workers → escolha o modelo
Mudança aplica nos próximos jobs (não retroage)
Comparativo de modelos: triad models
✗ FAQ ruim
- ✗"Como funciona o TRIAD?" — vago, não é dúvida real
- ✗Resposta de 40 linhas — usuário não lê até o fim
- ✗Link para docs sem resumo — joga o problema pro usuário
- ✗Linguagem técnica nas respostas (stdout, daemon, IPC)
✓ FAQ bom
- ✓Pergunta literal do usuário ("Hermes não responde")
- ✓Resposta resolve em 3 passos numerados
- ✓Link "saiba mais" opcional, no final
- ✓Linguagem do usuário, não do desenvolvedor
🔑 Conceitos-chave
Use a frase exata que os usuários digitam, não a versão "limpa"
Numerados, acionáveis, no máximo 3 linhas de prosa
O FAQ acaba quando o problema é resolvido — explicação vem depois
Bloqueadores primeiro (não responde, erro), curiosidade depois
🆘 Suporte e escalada — quando chamar o técnico
Nem todo problema precisa de suporte humano — e nem todo problema deve ficar com o usuário. Uma matriz de escalada clara economiza tempo de todo mundo: self-fix para o trivial, suporte humano para o estrutural.
O que é
Uma cadeia de 4 níveis (self-fix → docs → comunidade → suporte técnico) com critérios objetivos pra subir de nível. Cada nível tem tempo máximo recomendado antes de escalar — evita usuário travado e suporte sobrecarregado.
Self-fix — comandos de diagnóstico (5 min)
Códigos de erro mapeados para comandos de correção. triad doctor, triad restart, triad clean. Resolve 60% dos problemas de instalação e conectividade.
Docs e FAQ — busca direcionada (10 min)
Se o self-fix não resolveu, FAQ e troubleshooting cobrem outros 25%. Inclui buscador com sinônimos ("não conecta" = "offline" = "sem internet").
Comunidade — fórum / Discord (1-24h)
Para dúvidas de uso avançado, customização e casos específicos. Outros usuários respondem mais rápido do que suporte oficial — e respostas ficam indexadas pra próxima pessoa.
Suporte técnico — tier pago (24-48h)
Bugs reais, problemas estruturais, integrações customizadas. Inclui upload de logs (triad logs export) e contexto da execução. Reservado pra problemas que comunidade não resolveu.
⚖️ Sinais de "subir um nível"
- →Comando de self-fix retornou erro persistente: vá pro L2
- →FAQ não tem sua dúvida ou resposta não bate: vá pro L3
- →Comunidade indicou que é bug do sistema: vá pro L4 com referência ao thread
- →Dados sensíveis ou conta comprometida: pule direto pro L4
🔑 Conceitos-chave
Cada erro mapeia para 1-2 comandos de correção testados
Evita usuário travado em loop infinito de self-help
Reduz carga do suporte e cria base de conhecimento orgânica
Suporte só consegue ajudar de verdade com contexto da execução
📊 Medindo adoção — como saber se o onboarding funcionou
Sem métricas, "o onboarding está bom" é opinião. Quatro indicadores mostram se o usuário virou hábito — e onde o funil ainda vaza.
O que é
Um painel de 4 métricas que cobre as fases críticas: ativação (primeira tarefa), profundidade (preenchimento do soul), engajamento recorrente (WAU/MAU) e satisfação (NPS aos 30 dias). Juntas, elas mostram onde o onboarding entrega e onde fura.
⏱️ Time-to-first-Triad-task
Tempo entre instalação e primeira tarefa concluída com sucesso.
Meta: menos de 5 minutos · Alerta: acima de 30 min
📝 Soul.md completeness
% de campos opcionais preenchidos além dos obrigatórios.
Meta: acima de 70% · Alerta: abaixo de 40%
📈 WAU/MAU ratio
Usuários ativos semanais sobre mensais — proxy de hábito.
Meta: acima de 0.5 · Alerta: abaixo de 0.3
💬 NPS aos 30 dias
"Você recomendaria o TRIAD pra um colega?" (0-10).
Meta: NPS acima de 40 · Alerta: abaixo de 20
💡 Lendo o painel
Métricas isoladas mentem. Use combinações: time-to-first alto + NPS alto = usuários pacientes, mas você está deixando dinheiro na mesa. WAU/MAU baixo + completeness alto = usuário gostou mas não voltou — falta gatilho de retorno (job overnight, lembrete semanal).
🔑 Conceitos-chave
Métrica mais sensível pra detectar fricção no onboarding
Quem preenche mais do soul investiu mais — e tende a ficar
Acima de 0.5 indica que o TRIAD virou parte da rotina
Único indicador que prevê crescimento orgânico via indicação
🏆 Você completou o TRIAD
Trilha 4 encerrada — e com ela, o curso inteiro. Você agora tem o repertório completo para fundamentos, técnica, orquestração avançada e escala humana.
Próximo passo:
Coloque em prática — escolha uma pessoa não-técnica do seu círculo, aplique a jornada de 7 dias e meça o time-to-first. O TRIAD só escala quando sai do seu terminal.