# Planos do Byte

- **[Co-Streamer](#plano-de-implementação--byte-co-streamer)** (este doc) — vê/fala/comenta/aparece.
- **[Studio Dashboard State-of-the-Art](studio-state-of-the-art.md)** — evoluir o `/studio` pra referência. ✅ S0–S6 concluído.
- **[Ops Dashboard Redesign](ops-dashboard-redesign.md)** — `/` ops com a identidade do studio + mascote reativo maior + wow vendável. (base: [auditoria validada](../OPS_DASHBOARD_AUDIT_2026-06-29.md))

---

# Plano de Implementação — Byte Co-Streamer

Roteiro faseado que converte a [auditoria](../DEEP_AUDIT_2026-06-29.md) + o [report do co-streamer](../CO_STREAMER_REPORT_2026-06-29.md) 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](00-foundation.md) | ✅ concluída (1057 verde, 85% cob.) |
| 1 — Ativar o dormente | [01-activate-dormant.md](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](02-expression-voice-presence.md) | ✅ LIVE (2.1 voz · 2.2 avatar · 2.3 comentário) |
| 3 — Interação | [03-interaction.md](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](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.