docs/plan/README.md

Planos do Byte

• Co-Streamer (este doc) — vê/fala/comenta/aparece.
• Studio Dashboard State-of-the-Art — evoluir o /studio pra referência. ✅ S0–S6 concluído.
• Ops Dashboard Redesign — / ops com a identidade do studio + mascote reativo maior + wow vendável. (base: auditoria validada)

---

Plano de Implementação — Byte Co-Streamer

Roteiro faseado que converte a auditoria + o report do co-streamer em execução. Cada fase entrega código + testes científicos + Meta-Reflexão.

Fases

Fase	Doc	Estado
0 — Fundação (suíte hermética)	00-foundation.md	✅ concluída (1057 verde, 85% cob.)
1 — Ativar o dormente	01-activate-dormant.md	✅ código: 1.2 visão LIVE · 1.1 verificado · 1.3/1.4 = credenciais
2 — Expressão (voz + presença)	02-expression-voice-presence.md	✅ LIVE (2.1 voz · 2.2 avatar · 2.3 comentário)
3 — Interação	03-interaction.md	✅ código: 3.3 segmentos LIVE · 3.1/3.2 testados (ativação documentada)
4 — Produção & crescimento	04-production-growth.md	✅ código: 4.2 recap + 4.3 churn LIVE · 4.1 highlights testado

✅ PLANO CONCLUÍDO (código)

Todo o código das 5 fases está implementado, testado (1057 testes verdes, 85% cobertura, suíte hermética) e deployado. As superfícies que não dependem de infra externa estão LIVE e validadas (/studio, /capture, /voice, /avatar, /recap, segmentos, churn). O que resta é configuração de operador, não código.

Checklist de operador (ativa o que falta)

Ação	Destrava
Secret TTS_API_KEY (ElevenLabs)	voz/comentário/segmentos viram áudio (hoje legenda)
OBS browser sources …/voice?token=X e …/avatar?token=X + abrir …/capture	presença na live
SUPABASE_URL/KEY (1.3)	persistência + memória de regulars (3.2)
Re-auth Twitch scope editor:manage:clips (1.4)	clipes + auto-highlights (4.1)
control_plane.update_config({"autonomy_enabled": True}) (1.1)	autonomia proativa (+ highlights no loop)
TWITCH_CHAT_MODE=eventsub + scope channel:read:redemptions + subscription (3.1)	Channel Points → Byte fala

⚠️ Segurança pendente (do audit): rotacionar tokens Twitch versionados em docs/ (a re-auth de clipes já gera novos).

Princípios (todas as fases)

1. Testes científicos comportamentais — convenção bot/tests/scientific/test_phaseN_*_scientific.py + suite_*.py; valida contratos, não implementação. Novas fases = Phase 26+.
2. Provider-neutral — serviços externos seguem o padrão LLM_PROVIDER (bot/config.py).
3. Reaproveitar módulos existentes — sem reescrever o que já está pronto.
4. Overlays pelo dashboard_server — padrão /studio (_dashboard_asset_route + assets sob dashboard/).
5. Validação ao vivo — playwright/curl após deploy.

Protocolo de Meta-Reflexão (fim de CADA fase)

Registrar o resultado na seção "Meta-Reflexão" do doc da fase:

1. Re-derivar os comportamentos esperados da fase — listar.
2. Rastreabilidade comportamento↔teste — cada comportamento aponta o teste que o prova. Sem teste = lacuna.
3. Rodar suíte da fase + suíte completa: termina (hermética) e verde.
4. Caça a regressão — nada antes ativo quebrou; nada dormente ligado sem guardrail.
5. Validação ao vivo — evidência real, não suposição.
6. Go/No-Go — registrar lacunas e decisão.