Voice Guide 2.0 · Arquitetura por dentro

Voice Guide 2.0 —
como funciona por dentro

A arquitetura que faz uma IA escrever como você — no seu léxico, no seu ritmo, com o seu jeito de falar com cada pessoa. Não é mágica, é engenharia. E foi validada por blind test.


01 — A separação fundamental

Dois repositórios: conteúdo vs método

A voz de uma pessoa é íntima. O método pra capturá-la é público. Misturar os dois num lugar só te obrigaria a escolher: ou expor sua intimidade, ou esconder o método. Por isso, dois repositórios separados.

🔒 Privado · só você

O conteúdo da sua voz

seu-repo-pessoal · acesso restrito

Aqui vive o que faz a sua voz ser SUA: seu vocabulário, seu ritmo, como você fala com um cliente frio versus com a sua equipe — tudo extraído das suas conversas reais. Sensibilidade máxima. Só você e os seus agentes acessam.

🧁
É a receita secreta. O que ninguém mais tem, e que ninguém deveria ver.
🌐 Público · este aqui

O método pra criar o seu

expertintegrado/voice-guide · aberto

Este repositório é o passo a passo: como qualquer pessoa coleta, limpa, extrai e valida o próprio Voice Guide. Zero dado pessoal. É o processo, não o resultado — pura instrução replicável.

📖
É o curso de confeitaria. Ensina a técnica sem entregar a receita de ninguém.
 Repo privado (conteúdo)Repo público (método)
O que guarda A sua voz extraída O passo a passo pra criar
Dado pessoal Sim — máximo Nenhum
Quem acessa Só você e seus agentes Qualquer pessoa
Analogia A receita secreta O curso de confeitaria

Por que separar? Um repositório só te forçaria a um dos dois males: expor a sua intimidade pra ensinar o método, ou esconder o método pra proteger a intimidade. Separando, você ensina o mundo inteiro sem entregar uma vírgula do que é seu.


02 — Onde o guide mora e de onde é lido

O GitHub é cofre, não é fonte de leitura

Muita gente imagina que a IA "vai buscar" o guide no GitHub toda vez que escreve. Não é assim — e não poderia ser. A leitura acontece de outro lugar.

Regra de ouro

Na hora de mandar a mensagem, a IA nunca consulta o GitHub. A leitura é sempre de um arquivo local — pela velocidade e porque tem que funcionar até offline.

a.

Cópias locais ativas leitura em tempo real

O guide fica salvo como arquivo no seu computador e nos servidores dos seus agentes. É daqui que a IA lê, sempre. Instantâneo, sem rede, sem depender de nada externo.

b.

GitHub cofre + correio

O papel do GitHub é ser backup, guardar o histórico de todas as versões e sincronizar o guide entre as suas máquinas. Ele arquiva e distribui — não é consultado na hora de escrever.

c.

Memória do agente contexto da IA

Quando uma sessão começa, o guide é carregado pra dentro do contexto do modelo. A partir daí ele "já sabe" como você fala, sem reler o arquivo a cada frase.

d.

Nota na nuvem opcional

Opcionalmente, um sistema de memória em nuvem guarda uma nota que funciona como "instalador": numa máquina nova, ela ensina o agente a baixar e ativar o guide sozinho.


03 — O fluxo de uma mensagem

Do pedido ao envio, sem passar pelo GitHub

Quando você pede pra IA responder no seu tom, é isto que acontece por baixo — em milissegundos.

1

Chega o pedido

Você pede: "responde essa mensagem no meu tom". O agente identifica o contexto — é um lead frio? Um cliente? A sua equipe? Alguém próximo?

2

A IA lê o guide do disco local

O agente abre a cópia local do Voice Guide — direto do arquivo na máquina. Nada de rede, nada de GitHub. Leitura imediata.

3

Redige aplicando estrato + motor retórico

Ajusta o registro ao contexto (o estrato) e reproduz o seu movimento: onde você fricciona em vez de concordar, onde devolve uma pergunta em vez de validar. É o motor que engana o teste às cegas.

4

Checagem automática de fingerprints

Antes de enviar, um filtro varre a mensagem atrás das digitais que denunciam uma IA. Se achar, corrige. Só então libera.

em-dash concordância lisa vocativo errado hype / "revolucionário" gramática perfeita demais
5

Envia

A mensagem sai soando como você. A pessoa do outro lado não tem como saber que passou por uma IA.

Em nenhum desses 5 passos o GitHub participou. Ele só entra quando o guide muda.

04 — O fluxo de uma atualização

Editar uma vez, chegar em toda parte

Sua voz evolui. Quando você refina o guide, o GitHub finalmente entra em cena — como histórico e como correio.

01

Edita uma vez

Você ajusta o guide num único lugar — uma regra nova, um anti-padrão, um estrato.

02

Commit + push

O GitHub grava a mudança e guarda o histórico completo de versões.

03

Copia pras máquinas

As cópias locais de cada máquina e agente são atualizadas a partir do cofre.

04

Pronto

Todos os seus agentes já falam com a versão nova, em qualquer canal.

Versionamento = rede de segurança. Como cada mudança fica registrada, você pode voltar atrás a qualquer momento. Errou um ajuste? Um comando e a voz volta pra versão anterior.


05 — Como o método foi validado

Não é "achismo" — passou no teste cego

Um Voice Guide novo é só uma hipótese até provar que engana de verdade. No caso real que originou este método, a validação teve três frentes — e um teste final brutal.

3 rodadas
de blind test com juízes cegos: pontuaram cada resposta numa rubrica sem saber qual era a real e qual era a clonada.
23 mil
mensagens no corpus limpo, todas anteriores ao uso de IA — pra capturar a voz humana crua, sem contaminação.
6 / 15
o teste final: o próprio dono tentou distinguir o clone das respostas reais — e foi enganado em 6 dos 15 pares.

Clone aprovado

Quando nem o dono da voz consegue separar com segurança o que ele escreveu do que a IA escreveu, o guide passou. Esse é o critério — não uma nota bonita numa rubrica, mas a incapacidade de distinguir o clone do original.


06 — Sua vez

Crie o seu Voice Guide

Você não precisa clonar nada. Cole o texto abaixo no Claude Code — o instalador conduz tudo, do zero à ativação, em português.

prompt de instalação
Leia e execute as instruções em:
https://raw.githubusercontent.com/expertintegrado/voice-guide/main/ONBOARDING.md

Conduza em português brasileiro. Não pule etapas. Aguarde minha resposta
a cada pergunta antes de avançar.
Ver o repositório no GitHub Método aberto · zero dado pessoal · replicável por qualquer pessoa