Playbook · Duda por Voz

1 · As palavras que a Duda obedece

Você fala	O que acontece
"duda"	Acorda e começa a transcrever (terminal em foco). Pausa ~1s depois de "duda" antes de ditar — o reconhecedor reinicia.
(ditado)	Vai aparecendo digitado ao vivo onde o cursor está, com correção da Apple.
"câmbio" (ou "cambio")	ENVIA a mensagem. É a ÚNICA palavra que envia.
"dormir"	Para de ouvir. O texto ditado FICA na tela esperando — não apaga nada.
"apagar tudo" / "cancelar"	Apaga o rascunho. É o ÚNICO jeito de apagar por voz.
(sair do terminal)	Trava de foco: muda na hora; não digita nem envia em outra janela.

"enviar" NÃO é mais comando (removida 23/07): disparava envio quando falada como conteúdo normal — "...a palavra de enviar" mandou mensagem no meio da frase.

2 · As 5 leis do rascunho sagrado

1. Texto ditado NUNCA se apaga sozinho. Só "câmbio" envia; só "apagar tudo"/"cancelar" (ou megabrain zerar) apaga.
2. Pausar não perde nada. Pare por 2 segundos, 10 minutos ou 2 horas: o texto espera o "câmbio". Com rascunho pendente a Duda não dorme por inatividade.
3. "dormir" preserva. O ouvido desliga, o texto fica. Acordou com "duda" de novo? O ditado novo continua DEPOIS do que já estava.
4. Restart não perde. Rascunho espelhado em ~/.megabrain/draft; daemon reiniciou (guardião, crash, boot) → volta ACORDADO com o texto pendente e o "câmbio" segue valendo.
5. Pausa de 2s congela o bloco. O que você já ditou vira prefixo intocável — revisão tardia do reconhecedor não reescreve/apaga mais o bloco, só a frase em andamento.

3 · Fluxo normal

"duda"  →  (pausa 1s)  →  dita o bloco inteiro, no seu ritmo, com pausas
        →  quer conferir? para de falar; o texto espera
        →  "câmbio"  →  enviou; Duda responde na voz Dora no fone
        →  continua acordada pra próxima fala; "dormir" quando terminar

Ditou errado? "apagar tudo" e recomeça — ou edita na mão no teclado (aí rode megabrain zerar antes do próximo ditado, pra Duda esquecer o espelho dela).

4 · Por que quebrava (23/07) — pra não regredir nunca

Sintoma	Causa raiz	Conserto
Ditado travava em ~2 frases	audio-guard v1 religava o daemon 25+ vezes/dia, várias no meio do ditado (fone BT troca perfil quando a Duda fala → "assinatura mudou" → restart)	Guard v2: nunca religa com ditado em andamento (draft <120s), ignora TTS falando, confirmação dupla (40s), carência 180s
Daemon caía com Cadu usando	"Zumbi 15min" olhava mtime do awake que nunca atualizava	awake carimbado a cada frase; zumbi = sem ouvir NADA há 15min E sem rascunho
Texto sumia sem "câmbio" rápido	sleep/idle/wake zeravam o espelho; final tardio do reconhecedor reescrevia o input	Rascunho sagrado (leis acima) + guard `request === req` + commit-on-pause 2s
Enviava no meio da frase	"enviar" era comando e aparecia como conteúdo	SEND = só cambio,câmbio
Palavra cortada a cada ~50s	Troca de sessão da Apple em ponto arbitrário	Troca espera micro-silêncio de 0.6s (teto +8s)
Voz da Duda comia palavras do ditado	TTS liga flag speaking → mic ignorado	mb-say/duda-say/narrador DROPAM fala se draft mexido há <90s

5 · Comandos de terminal

megabrain status     # rodando? acordado? tem rascunho pendente?
megabrain restart    # religa o ouvido (rascunho sobrevive)
megabrain zerar      # esquece o rascunho (você enviou/apagou NA MÃO)
megabrain mudo       # para de falar (continua ouvindo) | mudo hoje = só hoje
megabrain falar      # volta a falar
megabrain acordado   # fura o silêncio noturno 22h-08h
megabrain pause      # muta o MIC (reunião) | resume = desmuta
megabrain wake/sleep # acorda/dorme na marra
megabrain logs       # acompanha o ouvido ao vivo

6 · Primeiro socorro

Falou e nada digitou: terminal em foco? (trava de foco). Ainda nada → megabrain status; surdo pós-boot → megabrain restart (não só wake).

"duda...câmbio" imediato = vazio: pausa ~1s depois de "duda".

Enviou/apagou na mão e a Duda se perdeu: megabrain zerar.

Não responde por voz: você ouve pelo HB200? → /tmp/setoutput "HB200". Nunca trocar a saída sem confirmar que você não ouve.

Quer ditar enquanto a Duda fala: espera ela calar (anti-eco) — ou megabrain mudo pra sessão longa de ditado.

Quebrou de vez: restaurar o GOLDEN (~/megabrain/GOLDEN-*/, ver DUDA-VOZ-FOCO.md).

Contrato da voz compromissos do Claude

Assinado 23/07/2026, depois de duas semanas de texto ditado perdido. Vale pra TODA sessão do Claude, qualquer janela, qualquer dia. Cópias: vault duda/contrato-voz.md, ~/megabrain/CONTRATO-VOZ.md, memória persistente.

1 · Rascunho é sagrado

Texto ditado NUNCA se apaga nem se envia sozinho. Não existe timeout, idle, restart, sleep ou automação com direito de destruir rascunho. Esta lei tem prioridade sobre qualquer feature.

2 · Ler antes de mexer

Nenhuma sessão toca no megabrain sem ler DUDA-VOZ-FOCO.md + este contrato.

3 · Backup antes, GOLDEN intocado

Backup datado de cada arquivo ANTES de editar; GOLDEN nunca se edita; validou por voz → novo GOLDEN datado.

4 · Incluir, não substituir

Feature nova = env var com default compatível, uma de cada vez.

5 · Nenhuma automação derruba o ouvido no meio do ditado

Watchdog que reinicia respeita: draft <120s = não religa; confirmação dupla; carência 180s; daemon retoma rascunho após restart.

6 · Fala não atropela ditado

mb-say/duda-say/narrador nunca falam com draft mexido há <90s. Melhor silêncio que atravessar.

7 · Palavras de comando são do Cadu

Wake/send/sleep/scrap só mudam com ordem explícita dele. "enviar" foi removida 23/07 e não volta sem ordem.

8 · Testar antes de dar o pronto

Build limpo + teste de draft-resume + zerar + teste por voz do Cadu (ditar → pausar 30s → câmbio envia TUDO). Só depois o pronto é pronto.

9 · Quebrou? GOLDEN na hora

Voz regrediu → restaurar GOLDEN imediatamente, avisar, investigar depois. Downtime de voz é prioridade zero.

10 · Registro em todos os lugares

Mudança na voz atualiza: doc canônica, playbook, contrato, skill duda-voz, memória, log de sessão (GitHub via autocommit) e esta página.

CW Marketing · Duda por Voz · doc técnica: ~/megabrain/DUDA-VOZ-FOCO.md · v1 23/07/2026

Playbook — Duda por Voz