🗺️ Diagnóstico do Projeto "Quer Que Eu Desenhe"

Raio-X completo feito em 28/07/2026 · ~262 mil arquivos · ~57 GB · 6 exploradores + verificação manual

✋ NADA foi alterado — diagnóstico 100% somente leitura

📌 Resumo em 1 minuto

O projeto funciona, mas cresceu como uma casa que ganhou puxadinho atrás de puxadinho: tem cômodos ótimos, corredores que não levam a lugar nenhum, e três chaves diferentes para a mesma porta. O motor principal está de pé e tem várias proteções boas — porém o desenho original em preto e branco (o "traço sagrado") não tem nenhuma tranca física, os manuais antigos ainda ensinam o caminho velho, e existe muito peso morto (backups, relatórios e arquivos temporários) misturado com o que é vivo.

8problemas GRAVES
(alta prioridade)
13problemas MÉDIOS
7problemas leves
7pontos FORTES
confirmados
15etapas propostas
no plano
Progresso geral do conserto

0 de 15 etapas concluídas — todas aguardando sua aprovação. Diagnóstico: ✅ concluído em 28/07.

vermelho = área com problema grave amarelo = precisa de atenção verde = saudável / futuro
✅ O que já está BOM (para você não achar que é só notícia ruim):
  • Os motores acham a pasta do projeto sozinhos (sem endereço fixo digitado no código que apontasse para o lugar errado).
  • Nenhuma senha ou chave escrita dentro do código (ficam num arquivo separado — que precisa de proteção, mas o código em si está limpo).
  • O render final (a montagem do vídeo) tem portões de segurança LIGADOS — conferi a versão ativa hoje.
  • Existe um "cadeado de render" que trava escritas perigosas enquanto um vídeo está sendo montado.
  • A colorização nunca mexe no desenho preto e branco original — sempre grava numa pasta separada de cor.
  • Os atalhos .bat da raiz apontam todos para DENTRO desta cópia (sem risco de mexer no projeto errado).
  • Existem 32 testes automáticos na biblioteca central, e redes de segurança (backups) — bagunçadas, mas existem.

🧠 Mapa mental do projeto

🗺️ Novo: o Mapa Mental COMPLETO e interativo
O projeto inteiro até o nível de arquivo (.py e .md), em árvore: abra e feche os ramos, filtre por cor, busque por nome. As cores mostram o que já foi revisado e o que falta — e cada caixa fechada mostra a saúde do que tem dentro.
🧠 Abrir o mapa completo →
(ou veja a versão radial, em teia)

Abaixo, o resumo por área. Cada caixa é uma área do projeto. A cor mostra a saúde. Clique numa caixa para pular para os problemas dela. A etiqueta 0/N etapas mostra o progresso do conserto naquela área (vou atualizando aqui a cada etapa concluída).

QED
Quer Que Eu Desenhe
C:\Projetos\Quer Que Eu Desenhe - Copy
~262 mil arquivos · ~57 GB
Esta cópia É o projeto vivo
(o original sem "- Copy" não existe mais)
📖 Canal Bíblia GRAVE 0/4 etapas
O canal principal (45 mil arquivos, 46 GB). Episódios 1–6 prontos, 9–20 selados, 21–30 em produção. Traço original SEM tranca física · 3 pastas de cor duplicadas · a pasta de cor padrão no código é a ANTIGA · 27 GB de vídeos de teste acumulados.
⚙️ _ESTUDIO_MASTER (motores) GRAVE 0/3 etapas
O cérebro: CAPATAZ (gerente de produção), ESCRIBA (motor de roteiro), Mini Canva, Estúdio de Narração. Motores bons, mas afogados: 328 scripts na mesma pasta (~250 são consertos velhos descartáveis) · lista de episódios autorizados duplicada · 1 script gasta crédito sem pedir confirmação.
✅ Curadoria GRAVE 0/1 etapa
O sistema de aprovar/rejeitar. 99% dos seus 191 mil arquivos são o "diário de eventos": 190 mil arquivinhos, sendo ~90% o MESMO evento repetido por um robô em loop (bug). Parada desde 22/07 com 238 tarefas represadas.
📄 Documentos da raiz GRAVE 0/3 etapas
Manuais e relatórios soltos. O AGENTS.md (manual que outras IAs leem sozinhas) ainda ensina a usar o motor VELHO, já aposentado. Docs se contradizem sobre onde a BP é aprovada. 6+ relatórios históricos gigantes misturados com o que é atual.
🏛💻 História + Tecnologia ATENÇÃO 0/1 etapa
Canais informativos (motor "PLANO"). Tecnologia é o modelo oficial de onde os outros são clonados. Problema: 86 scripts copiados-e-colados entre os dois canais, e 20+ já ficaram diferentes entre si (conserto num não chega no outro).
📚 Biblioteca (Acervo Universal) ATENÇÃO 0/1 etapa
O acervo compartilhado de desenhos entre canais. Só 10 desenhos promovidos; 3.075 esperando na fila de entrada; cada canal segue usando a biblioteca local própria. A ideia é boa, mas ainda não aconteceu de verdade.
🔎 Central de Inteligência ATENÇÃO 0/1 etapa
A "fábrica de temas": espiona canais concorrentes no YouTube e sugere próximos vídeos. Funciona, mas está dormente desde 12/07 e 98% dos arquivos dela são bibliotecas Python copiadas para dentro (peso inútil na cópia).
🔐 Segurança & memória do projeto GRAVE 0/2 etapas
Não existe controle de versão de verdade (a pasta .git é uma casca vazia) = sem histórico e sem "desfazer". As 9 chaves de API (senhas de serviços pagos) estão em texto puro no .env, possivelmente até dentro do backup zip.
🗄️ Backups & peso morto ATENÇÃO 0/2 etapas
Zip de 3,17 GB na raiz + 3 sistemas de backup diferentes + 1.450 arquivos .bak misturados com a produção (um episódio tem 373 backups automáticos do Mini Canva!) + projetos estranhos dentro do canal (um podcast de 1,6 GB).
🌱 9 canais futuros + apoio OK decisão sua
Ciência, Crimes, Dinheiro, Filosofia… são só esqueletos-modelo (9 arquivos cada, inofensivos). highlights/, thumbnails/ e output/ na raiz são saídas soltas sem dono claro — leve, mas vale decidir o destino.

😨 Seus 5 medos, checados um a um

1. "Alterarem meu rascunho PB original"
⚠️ Medo justificado. Conferi arquivo por arquivo: nenhum desenho original está marcado como somente-leitura (uma tranca do Windows que impede gravar por cima), e não existe uma lista de checksums (impressões digitais) para conferir se algo mudou. Hoje a proteção é só combinado + backups. A colorização se comporta bem (grava em pasta separada), mas qualquer script com defeito PODE gravar por cima do original sem nenhuma barreira. → Etapa 1 do plano.
2. "Misturarem episódios ou cenas"
⚠️ Risco moderado e real. O mesmo episódio tem 3 nomes diferentes dependendo do lugar (ep014, bib_ep_014, "014 - Genesis..."), e História/Tecnologia usam qed-001 sem dizer o canal — se uma pasta for copiada para o canal errado, nada no nome denuncia. Além disso, a Curadoria tem 238 tarefas VELHAS represadas: religar a automação sem limpar pode reprocessar coisa antiga. → Etapas 9 e 7.
3. "Gerarem/desenharem imagens duplicadas"
⚠️ Já aconteceu e o terreno favorece. Cada desenho colorido existe em até 4 cópias (storybook, storybook_ko, storybook_ko_marrom + testes de estilo), 605 delas com o MESMO nome em pastas diferentes. Existem 2.754 candidatos acumulados numa pasta de trabalho. Há um portão anti-duplicata, o que ajuda — mas a bagunça de pastas paralelas é o que gera retrabalho. → Etapa 14.
4. "Gastarem meus créditos sem necessidade"
⚠️ Dois buracos encontrados. O script executar_refacoes_visuais_replicate.py chama o Replicate (serviço pago de gerar imagem) sem pedir confirmação nenhuma — e ele se alimenta justamente da fila velha de 238 tarefas. E o atalho REFAZER-16-SECAO90.bat também dispara geração paga com 2 cliques. O bom: o caminho normal de produção usa o Codex (grátis) e o ElevenLabs tem trava de autorização. → Etapa 3.
5. "Enviarem a imagem errada"
⚠️ Confirmado — este é o achado mais traiçoeiro do diagnóstico. No código que exporta a cena (export-cena-geo.py, linha 29), a pasta de cor padrão é storybook_ko — a ANTIGA. O marrom (o visual oficial atual) só é usado se alguém lembrar de ligar a chave QED_COLORDIR (uma variável de ambiente) antes de rodar. Ou seja: o caminho do esquecimento leva à cor errada. → Etapa 2 (uma linha de código resolve).

🚨 Todos os problemas encontrados

Organizados por gravidade. Em cada um: onde está, por que importa, e o que fazer.

🔴 ALTA prioridade (8)

A1 · O traço sagrado (PB original) está sem tranca nenhuma

Onde: Bíblia\...\whiteboard-pipeline\assets\library\ (characters, concepts, elementos, nature, objects, places — ~600 desenhos)
Por que importa: é o coração do canal. Um script com defeito ou um clique errado grava por cima e o original se perde para sempre (só restaria caçar em backups).
O que fazer: marcar tudo como somente-leitura + criar a lista de impressões digitais (checksums) para detectar qualquer mudança. → Etapa 1

A2 · A pasta de cor PADRÃO no código é a antiga

Onde: export-cena-geo.py linha 29 (padrão = storybook_ko; o marrom depende da chave QED_COLORDIR)
Por que importa: risco direto de montar vídeo com as cores antigas — o medo nº 5.
O que fazer: trocar o padrão para storybook_ko_marrom (1 linha) e revisar os outros pontos que leem essa chave. → Etapa 2

A3 · Não existe controle de versão (git) de verdade

Onde: raiz do projeto — a pasta .git é uma casca vazia; não há .gitignore; nenhum histórico
Por que importa: sem histórico não existe "desfazer". Qualquer mudança ruim é definitiva. Os selos e backups manuais que você criou são justamente uma muleta para essa ausência.
O que fazer: ligar o git de verdade guardando SÓ código, configurações e documentos (nunca vídeos, imagens pesadas ou senhas). → Etapa 4

A4 · Chaves de API (senhas de serviços pagos) em texto puro

Onde: .env na raiz (9 chaves: ElevenLabs ×4, Gemini, Google TTS, vozes, YouTube scraper) + Central de Inteligencia\.env + possivelmente DENTRO do zip de backup de 3,17 GB
Por que importa: quem tiver essas chaves gasta os SEUS créditos. Se o zip circular (Drive, HD emprestado), as chaves vão junto.
O que fazer: proteger no .gitignore (Etapa 4), verificar se o zip contém o .env, e você trocar as chaves nos sites (rotacionar). → Etapa 5 + pergunta 9

A5 · O manual que as IAs leem ensina o caminho VELHO

Onde: AGENTS.md (lido automaticamente pelo Codex) + ORQUESTRADOR_PIPELINE.md — ambos mandam operar o orquestrador antigo (aposentado) e a curadoria de desenho individual (morta)
Por que importa: uma IA obediente seguindo o manual errado conduz a produção pelo motor aposentado — foi assim que surgiram vários "fantasmas" no passado.
O que fazer: reescrever o AGENTS.md refletindo o CAPATAZ + Mini Canva + curadoria atual, e carimbar "MORTO/HISTÓRICO" nos docs antigos (sem apagar). → Etapa 6

A6 · Curadoria: 190 mil arquivinhos de evento (90% repetidos) + fila velha represada

Onde: Curadoria\producao\orquestracao\events\ (190.415 arquivos JSON de ~530 bytes) + jobs\pending (238 tarefas de 22/07)
Por que importa: ~171 mil eventos são o MESMO pedido repetido por um robô reconciliador em loop (bug: a tarefa nunca "fechava"). Isso deixa backup, antivírus e buscas lentos — e religar a automação com fila velha pode reprocessar episódios antigos (mistura + gasto).
O que fazer: compactar os eventos em pacotes (1 por dia), consertar o loop, e você decidir se a fila velha morre. → Etapa 9 + pergunta 3

A7 · 86 scripts duplicados entre História e Tecnologia (20+ já divergiram)

Onde: História\scripts\Tecnologia\scripts\ (+ 3 versões vivas do montador de Big Picture)
Por que importa: é o clássico drift: você conserta um bug na Tecnologia e ele continua vivo na História (ou vice-versa).
O que fazer: unificar aos poucos num motor comum (a Tecnologia é o modelo oficial), começando pelos 20 que já divergiram. → Etapa 13

A8 · Dois gatilhos de gasto sem trava de confirmação

Onde: _ESTUDIO_MASTER\scripts\executar_refacoes_visuais_replicate.py (sem confirmação; consome a fila velha de 238 tarefas) e REFAZER-16-SECAO90.bat (dispara geração paga)
Por que importa: medo nº 4 — crédito gasto por acidente, ainda mais com fila velha esperando.
O que fazer: exigir uma confirmação explícita (ex.: --confirmo-gasto) antes de qualquer chamada paga. → Etapa 3

🟡 MÉDIA prioridade (13)

M1 · Três pastas de cor paralelas do mesmo desenho

Onde: assets\library\_color\: storybook (267), storybook_ko (605 + 90 backups), storybook_ko_marrom (864) — 605 nomes idênticos entre si
Impacto: confusão sobre qual é a oficial; risco de imagem errada e retrabalho. Fazer: declarar o marrom como oficial e arquivar as outras (depois da Etapa 2). → Etapa 14

M2 · ~27 GB de vídeos de teste e variantes acumulados

Onde: remotion-video\out\: qa (14,2 GB), _variantes (7,6 GB), .qed-render-backups (5,5 GB) — com 5 cópias de ~400 MB do MESMO preview
Impacto: disco sufocado (só 68 GB livres no C:). São regeneráveis. Fazer: mover para arquivo morto/HD externo com sua aprovação. → Etapa 10 + pergunta 4

M3 · Zip de 3,17 GB na raiz + 3 sistemas de backup diferentes

Onde: QED_REBUILD_SEED_20260718.zip (raiz), _restore_points\, RESTORE_PRE_MINI_CANVA...\
Impacto: backup dentro da área de trabalho infla tudo e confunde qual rede de segurança vale. O zip ainda contém amostras de voz privadas. Fazer: um lugar único de arquivo morto + zip para fora do projeto. → Etapa 10

M4 · 1.450 arquivos .bak misturados com a produção

Onde: pior caso: roteiros-graficos\layouts\ — 92% dos arquivos são backup automático do Mini Canva (ep014 tem 373!). Também há .bak DENTRO do código-fonte (guarded_render, production_loop ×6...)
Impacto: polui busca, engorda backup, e dá medo de restaurar o errado. Fazer: mover .baks para pasta de arquivo + ensinar o Mini Canva a guardar só os N últimos. → Etapa 8

M5 · 328 scripts numa pasta só (~250 são consertos velhos)

Onde: _ESTUDIO_MASTER\scripts\ — 133 qed_repair_*, 38 diagnósticos, 9 enfileiramentos datados, afogando os ~15 motores reais
Impacto: difícil achar o certo; fácil rodar o errado. Fazer: separar motores de one-offs (mover para arquivo, checando antes que ninguém os importa). → Etapa 11

M6 · Lista de episódios autorizados existe em DOIS lugares

Onde: qed_gerente.py (EPISODIOS_AUTORIZADOS 011–031, a oficial) e cópia em qed_production_loop.py, sincronizada por script manual
Impacto: esquecer de sincronizar = episódio liberado num motor e barrado no outro (já causou bloqueios). Fazer: um lugar só; o outro importa de lá. → Etapa 12

M7 · Documentos se contradizem sobre o fluxo atual

Onde: COMO_O_BP_FUNCIONA...md ("BP aprova na curadoria") × AGENTS.md ("BP vai ao Mini Canva") × _ESTUDIO_MASTER\CLAUDE.md regra 4 (curadoria de imagem viva)
Impacto: cada IA/pessoa que lê um doc diferente opera um fluxo diferente. Fazer: na Etapa 6, alinhar todos com a verdade atual (Mini Canva aprova BP; desenho vai direto pro BP). → Etapa 6

M8 · Restos de endereço do projeto antigo (sem "- Copy")

Onde: Biblioteca\README.md (linhas 8/41/66), Compartilhamento de Aprendizado\COMECE_AQUI.md, e metadados de proveniência em episodios\*\estado.json
Impacto: o projeto antigo NEM EXISTE mais — comando copiado desses docs falha ou recria uma pasta fantasma e divide a produção em duas. Fazer: corrigir os docs (os metadados são só histórico, podem ficar). → Etapa 6

M9 · Cinco repositórios git aninhados e desgovernados

Onde: Bíblia (.git), BiblIA (485 MB!), whiteboard-pipeline (349 MB), Curadoria (parou em 11/07), Central de Inteligência
Impacto: históricos gordos e espalhados, nenhum coordenado; o da Curadoria nem ignora os 190 mil eventos (fica lento). Fazer: decidir na Etapa 4 o desenho: um repositório na raiz + ignorar os internos, ou mantê-los isolados. → Etapa 4

M10 · Selos de aprovação cobrem só parte dos episódios

Onde: out\bigpicture\*.sig — só ep009 a ep020 têm selo; ep001–008, 021, 023, 031 têm BP final sem selo
Impacto: não dá para auditar integridade de forma uniforme (o bug do "resize que volta" se aproveitou disso). Fazer: gerar selo retroativo para os antigos na Etapa 1 (junto com o manifesto). → Etapa 1

M11 · Acervo Universal parado no meio da mudança

Onde: Biblioteca\: 10 promovidos vs 3.075 na fila de entrada (todos da Bíblia); His (1.108) e Tec (1.950) usando bibliotecas locais
Impacto: a promessa de "um desenho, todos os canais usam" não se realizou; cada canal reinventa. Fazer: decidir: tocar a migração ou pausar oficialmente o Acervo. → pergunta 7

M12 · Migração do Mural v2 (serpentina) no meio do caminho

Onde: bp_serpentina.py + SPEC_MURAL_V2.md (28/07 — hoje); ep012-layout.json encolheu de 9,4 KB para 1,7 KB
Impacto: estado transitório: episódios migrados e não-migrados convivendo. Não é bug, é obra em andamento — mas o plano de organização precisa respeitar essa obra para não conflitar. Fazer: nada por ora; só coordenar as etapas com ela.

M13 · Bibliotecas Python copiadas para dentro, 4 a 6 vezes

Onde: Central\.deps (6.177 arquivos!), _ESTUDIO_MASTER\pydeps + vendor + .deps + .audit-test-deps, whiteboard-pipeline\.deps (com numpy instalado 2×)
Impacto: milhares de arquivos que não são seus, inflando cada cópia/backup. Fazer: manter UMA cópia por motor que realmente precise, arquivar o resto. → Etapa 11 (parte 2)

🟢 BAIXA prioridade (7)

B1 · Relatórios históricos gigantes na raiz

ADDENDUM de 889 KB + 2 cópias .bak + 6 relatórios da era de recuperação (12–18/07) misturados com docs vivos. Fazer: mover para _ARQUIVO\. → Etapa 8

B2 · Projetos "hóspedes" dentro do canal Bíblia

BiblIA\ (podcast bíblico, 1,6 GB, outro projeto!) e no-detalhe\ (experimento órfão de Caim e Abel). Fazer: sua decisão — arquivar ou mudar de endereço. → pergunta 5

B3 · Saídas soltas na raiz sem dono

highlights\ (64 MB, ninguém referencia), thumbnails\ (3 thumbs de 1 episódio de Tec), output\ (screenshots de teste). Fazer: confirmar dono e guardar no lugar certo. → perguntas 6

B4 · Nomes inconsistentes

"Quer que Eu" vs "Quer que eu" nas pastas de canal; ep014 vs bib_ep_014 vs qed-001 vs hist_qed_001. Fazer: padronizar só nos pontos que causam bug (renomear pastas é cirurgia arriscada — fica para o fim, se valer a pena).

B5 · Ferramentas natimortas

QED-Obsidian (painel que nunca sincronizou) e Compartilhamento de Aprendizado (montado em 11/07, nunca alimentado). Fazer: ativar ou arquivar — sua decisão. → pergunta 7

B6 · Lixinhos diversos

Captura de página "Miso Labs" perdida em .playwright-cli; 3 logs vazios; pastas vazias da curadoria aposentada; __pycache__; ko_test; binários .exe de 30 MB em pasta de produção. Fazer: varrer na Etapa 8.

B7 · Testes não cobrem os motores principais

Os 32 testes cobrem a biblioteca interna, mas CAPATAZ e ESCRIBA não têm teste direto. Fazer: criar testes básicos quando formos mexer neles (Fase 4).

🛠️ O plano — pequenas etapas, uma por vez

Como funciona: nenhuma etapa roda sem seu "sim". Você aprova UMA etapa → eu faço SÓ ela → te mostro o resultado → você valida → só então vamos para a próxima. Toda etapa tem teste e botão de arrepender (como desfazer). A regra de ouro em todas: mexeu em X, só X muda — e nunca apagamos nada, só movemos para _ARQUIVO\ (arquivo morto).

FASE 1 — Blindar (proteger antes de arrumar) 🔐
1Cofre do traço sagrado🟡 aguardando aprovação
O que será revisado
As 6 pastas de desenhos PB originais da Bíblia (~600 arquivos).
Arquivos envolvidos
assets\library\{characters, concepts, elementos, nature, objects, places} — só o ATRIBUTO deles muda; o conteúdo (pixels) não é tocado. + 1 arquivo novo de manifesto fora dessas pastas.
Problema que resolve
A1 (traço sem tranca) e M10 (selos parciais).
O que pretendo alterar
1) Marcar cada PNG como somente-leitura (tranca do Windows). 2) Gerar um manifesto com a impressão digital (checksum SHA-256) de cada desenho, guardado fora da pasta e no _ARQUIVO. 3) Criar um mini-script "conferir-traço" que compara tudo em segundos.
Riscos
Baixo. Se algum script legítimo precisar escrever ali (não deveria!), vai falhar com erro claro — o que é bom: revela o culpado. Nada é sobrescrito ou apagado.
Como testar
Rodar o "conferir-traço" (deve dar 100% OK) e tentar salvar por cima de um PB de teste (deve ser bloqueado).
Como desfazer
1 comando remove o atributo somente-leitura de tudo; o manifesto é só um arquivo novo (apagar = voltou ao estado atual).
2Cor certa por padrão (marrom)🟡 aguardando aprovação
O que será revisado
Todos os pontos do código que escolhem a pasta de cor.
Arquivos envolvidos
export-cena-geo.py (linha 29) + qualquer outro que leia QED_COLORDIR (vou mapear todos antes).
Problema que resolve
A2 (cor padrão errada) — o medo nº 5.
O que pretendo alterar
Trocar o padrão de storybook_ko para storybook_ko_marrom. A chave QED_COLORDIR continua funcionando para casos especiais — só o "esquecimento" passa a cair no certo.
Riscos
Baixo. Muda o comportamento de quem rodava SEM a chave (que hoje pega a pasta errada — é justamente o que queremos corrigir).
Como testar
Exportar a geometria de 1 episódio já pronto e conferir que os arquivos apontados são os marrons (comparando com uma execução anterior correta).
Como desfazer
Reverter a(s) linha(s) — guardo cópia .bak-antes e o diff exato.
3Trava de custo nos gatilhos pagos🟡 aguardando aprovação
O que será revisado
Os 2 pontos que disparam gasto sem confirmação.
Arquivos envolvidos
executar_refacoes_visuais_replicate.py e REFAZER-16-SECAO90.bat.
Problema que resolve
A8 (gasto acidental) — o medo nº 4.
O que pretendo alterar
Exigir a opção explícita --confirmo-gasto (sem ela: só mostra O QUE faria e quanto custaria, sem chamar a API). No .bat: aviso + pausa pedindo confirmação digitada.
Riscos
Quase zero — só ADICIONA uma pergunta antes do gasto.
Como testar
Rodar sem a opção (deve listar e NÃO gastar — confiro que nenhuma chamada de rede sai); rodar com a opção num caso de 1 imagem barata SÓ se você quiser provar ponta a ponta.
Como desfazer
Restaurar as cópias .bak-antes.
4Ligar o controle de versão (git) de verdade🟡 aguardando aprovação
O que será revisado
A raiz do projeto (e o desenho dos 5 gits aninhados).
Arquivos envolvidos
Novos: .gitignore caprichado (fora: vídeos, imagens pesadas, .env, eventos da curadoria, bibliotecas copiadas, backups) e o banco do git. NENHUM arquivo seu é modificado.
Problema que resolve
A3 (sem histórico/desfazer) e M9 (gits aninhados).
O que pretendo alterar
git init na raiz + primeiro commit só de código/configuração/documentos (estimo poucos milhares de arquivos leves). Os gits internos ficam como estão nesta etapa (só documentados).
Riscos
Baixo. Git só ADICIONA uma pasta .git com histórico. Cuidado real: garantir que .env e mídia NÃO entrem — o .gitignore nasce antes do primeiro commit e eu te mostro a lista do que vai entrar ANTES de commitar.
Como testar
git status limpo; conferir que .env está ignorado; simular a edição de um arquivo e ver o git acusar na hora.
Como desfazer
Apagar a pasta .git (o projeto volta a ser exatamente o que é hoje).
5Chaves protegidas🟡 aguardando aprovação
O que será revisado
Os arquivos .env e o zip de 3,17 GB.
Arquivos envolvidos
.env (raiz), Central de Inteligencia\.env, whiteboard-pipeline\.env, História\.env — e a LISTA de conteúdo do zip (só leitura).
Problema que resolve
A4 (chaves em texto puro).
O que pretendo alterar
Eu: confirmo que todos os .env estão no .gitignore; verifico (sem extrair) se o zip carrega algum .env e te digo quais chaves foram expostas. Você: troca essas chaves nos sites (eu te passo o passo-a-passo de cada serviço — eu não entro nas suas contas).
Riscos
Zero no meu lado (só leitura + .gitignore). Ao trocar as chaves, os scripts que as usam precisam do valor novo no .env — te aviso quais.
Como testar
Rodar 1 geração de áudio de teste barata depois da troca, se você quiser (ou só na próxima produção normal).
Como desfazer
Nada a desfazer (chave trocada é segurança ganha).
FASE 2 — Uma verdade só (documentos) 📖
6Manuais atualizados (AGENTS.md e companhia)🟡 aguardando aprovação
O que será revisado
Os manuais que humanos e IAs seguem.
Arquivos envolvidos
AGENTS.md (reescrito), _ESTUDIO_MASTER\CLAUDE.md (regra 4 corrigida), COMO_O_BP_FUNCIONA...md (1 frase), Biblioteca\README.md e Compartilhamento\COMECE_AQUI.md (caminhos sem "- Copy"), carimbo "HISTÓRICO — NÃO SEGUIR" no topo de ORQUESTRADOR_PIPELINE.md e dos docs mortos.
Problema que resolve
A5, M7, M8 (manuais ensinando o caminho velho / contradições / endereços fantasmas).
O que pretendo alterar
Texto de documentação apenas — nenhum código. Verdades novas: CAPATAZ conduz; BP aprova no Mini Canva; desenho vai direto ao BP; sync-beats (não normalize-beats); esta cópia é O projeto.
Riscos
Baixo. Docs errados são hoje o maior gerador de "fantasmas". Rascunho passa por você antes de valer.
Como testar
Você lê o AGENTS.md novo e aprova; teste real: a próxima sessão de IA seguir o manual sem cair no motor velho.
Como desfazer
Versões anteriores guardadas (e, com a Etapa 4 feita, o git registra tudo).
7LEIA-ME raiz: o mapa oficial🟡 aguardando aprovação
O que será revisado
Nada existente — nasce 1 documento novo.
Arquivos envolvidos
Novo LEIA-ME.md na raiz (1 página): o que cada pasta é, onde cada coisa vive, as 5 regras de ouro, e o link deste painel.
Problema que resolve
O critério de sucesso do seu pedido: "entender a estrutura e saber por que cada parte existe".
O que pretendo alterar
Só criar o arquivo novo (baseado neste diagnóstico).
Riscos
Zero.
Como testar
Você lê e diz se um "você do futuro" se acharia só com aquilo.
Como desfazer
Apagar o arquivo.
8Arquivo morto: históricos e .baks saem do caminho🟡 aguardando aprovação
O que será revisado
Relatórios históricos da raiz + os 1.450 .bak espalhados + lixinhos (B6).
Arquivos envolvidos
Criação de _ARQUIVO\ organizada por origem; MOVER (nunca apagar): ADDENDUM + .baks, relatórios 12–18/07, .bak-canva dos layouts (mantendo os 3 mais recentes de cada episódio no lugar), .baks do código-fonte, logs vazios, captura Miso Labs.
Problema que resolve
B1, M4, B6 (poluição e risco de restaurar errado).
O que pretendo alterar
Só a LOCALIZAÇÃO desses arquivos. Produção, layouts vivos e selos não são tocados. Ajuste no Mini Canva (guardar só os N últimos autosaves) fica para depois, como mini-etapa própria.
Riscos
Médio-baixo: se algo referenciar um .bak pelo caminho antigo (improvável — backup não é referenciado), quebraria; por isso movo com lista assinada (manifesto do que foi para onde) e busco referências ANTES de mover cada grupo.
Como testar
Depois de mover: abrir o Mini Canva do ep014, rodar 1 rebuild de BP e 1 conferir-traço — tudo deve funcionar igual.
Como desfazer
O manifesto "de-onde-veio-para-onde-foi" permite devolver tudo com 1 comando.
FASE 3 — Desafogar (peso e fila velha) 🧹
9Curadoria: compactar o diário e decidir a fila velha🟡 aguardando aprovação
O que será revisado
O diário de eventos (190 mil arquivos) e a fila parada.
Arquivos envolvidos
Curadoria\producao\orquestracao\events\ (compactar em 1 pacote zip por dia, guardando os originais em _ARQUIVO até você validar), production_control.py (conserto do loop que repete o mesmo evento), .gitignore da Curadoria, e — se você aprovar na pergunta 3 — mover os 238 jobs velhos para _ARQUIVO.
Problema que resolve
A6 (lentidão + risco de reprocessar coisa velha ao religar).
O que pretendo alterar
Compactação + 1 correção pontual no gravador de eventos (fechar o pedido reconciliado para não repetir) + ignorar eventos no git local.
Riscos
Médio: o diário é histórico de auditoria — por isso compacto (nada se perde) em vez de apagar. O conserto do loop passa por teste antes.
Como testar
Teste do gravador em pasta de ensaio (gera evento, reconcilia, confere que NÃO duplica); contagem antes/depois; a Curadoria abre e navega normal.
Como desfazer
Descompactar os pacotes de volta; reverter o production_control pelo .bak-antes.
10Os 30 GB: renders de teste + zip gigante🟡 aguardando aprovação
O que será revisado
~27 GB de vídeos regeneráveis + o zip de 3,17 GB.
Arquivos envolvidos
out\qa\, out\_variantes\, out\.qed-render-backups\ e QED_REBUILD_SEED_20260718.zip — destino conforme sua resposta à pergunta 4 (pasta _ARQUIVO, HD externo ou Drive).
Problema que resolve
M2 e M3 (disco sufocado, backup dentro da área de trabalho).
O que pretendo alterar
Só MOVER (com conferência de integridade pelo hash do zip, que já existe). Os vídeos FINAIS entregáveis não são tocados.
Riscos
Baixo: são regeneráveis/backup. Único cuidado: confirmar antes que nenhum preview pendente de aprovação esteja só ali (pergunta 4).
Como testar
Espaço livre antes/depois; hash do zip confere no destino; 1 render de preview roda normalmente depois.
Como desfazer
Mover de volta (nada é apagado nesta etapa).
11Separar motores de consertos velhos (+ dependências)🟡 aguardando aprovação
O que será revisado
_ESTUDIO_MASTER\scripts\ (328 arquivos) e as 4–6 cópias de bibliotecas Python.
Arquivos envolvidos
~250 one-offs movidos para scripts\_arquivo_oneoff\ (após varredura automática garantindo que NADA os importa); duplicatas de bibliotecas (pydeps/vendor/.deps extras) para _ARQUIVO.
Problema que resolve
M5 e M13 (agulha no palheiro; peso morto).
O que pretendo alterar
Só localização. Os ~15 motores + biblioteca estudio + orquestração ficam onde estão (caminhos que o resto do sistema usa não mudam).
Riscos
Médio: algum one-off pode ser referenciado por um cartão de remediação antigo. Mitigação: varredura de referências antes + manifesto de movimentação + testes.
Como testar
Rodar a suíte de 32 testes + 1 ciclo do CAPATAZ em episódio de ensaio + abrir Mini Canva e Curadoria.
Como desfazer
Manifesto devolve tudo com 1 comando.
FASE 4 — Unificar (o conserto de raiz, por partes) 🧩
12Uma lista só de episódios autorizados🟡 aguardando aprovação
Arquivos envolvidos
qed_production_loop.py passa a IMPORTAR a lista do qed_gerente.py (ou de um arquivo-config único); o script de sincronização vira desnecessário.
Problema que resolve
M6. Riscos: baixo (mesmo valor, fonte única). Teste: suíte + production_loop em episódio autorizado e um NÃO autorizado (deve barrar). Desfazer: .bak-antes.
13História+Tecnologia: um motor comum (aos poucos)🟡 aguardando aprovação
O que será revisado
Os 86 scripts duplicados — começando pelos ~20 que já divergiram.
O que pretendo alterar
Sub-etapas de 1 a 3 scripts por vez: comparar as 2 versões, escolher/fundir a correta num lugar comum, e os canais passarem a usar essa única. Cada sub-etapa com render de prova nos DOIS canais antes de seguir.
Problema que resolve
A7. Riscos: médio-alto se feito no atacado — por isso é a gota-a-gota, com prova visual a cada passo. Teste: BP + render de 1 episódio de cada canal idênticos ao antes (comparação de imagem). Desfazer: cada sub-etapa tem .bak-antes individual.
14Uma pasta de cor oficial🟡 aguardando aprovação
O que será revisado
As 3+ pastas de cor paralelas (depois da Etapa 2 estabilizada).
O que pretendo alterar
Confirmar por varredura que NADA mais lê storybook/storybook_ko → mover as legadas para _ARQUIVO. O marrom vira a única viva.
Problema que resolve
M1 (e fecha os medos 3 e 5). Riscos: médio — mitigado pela varredura de referências + ensaio de render completo antes e depois. Teste: render de prova de 2 episódios comparado pixel a pixel. Desfazer: mover de volta.
15Destinos finais (suas decisões da lista de perguntas)🟡 aguardando aprovação
O que será revisado
BiblIA (podcast), no-detalhe, QED-Obsidian, Compartilhamento de Aprendizado, highlights/thumbnails/output da raiz, 9 canais placeholder, Acervo Universal (3.075 pendentes).
O que pretendo alterar
Exatamente o que você decidir nas perguntas abaixo — cada item vira uma mini-etapa própria com o mesmo ritual (mostrar → aprovar → mover → validar).
Riscos
Definidos por item, sempre com manifesto de movimentação e nada apagado.

❓ Perguntas que só você pode responder

Pode responder por número, do jeito que preferir ("1 sim, 2 sim, 3 pode matar…").

1. A pasta de cor marrom (storybook_ko_marrom) é a oficial para TODOS os renders daqui pra frente? (Etapas 2 e 14 dependem disso.)
2. Posso ligar o git na raiz (Etapa 4)? Só código/config/docs — nunca vídeos, imagens pesadas ou o .env.
3. As 238 tarefas velhas da Curadoria (paradas desde 22/07) podem ir para o arquivo morto, ou alguma ainda vale?
4. Os ~27 GB de vídeos de teste e o zip de 3,17 GB: movo para onde? (a) pasta _ARQUIVO no próprio C:, (b) HD externo, (c) Google Drive. Existe algum preview pendente de aprovação que só exista nessas pastas?
5. BiblIA (o podcast bíblico de 1,6 GB dentro do canal) e no-detalhe (experimento Caim e Abel): ainda usa, ou arquivamos?
6. highlights\ (64 MB), thumbnails\ e output\ na raiz: quem usa? Podem ir para dentro dos canais/arquivo?
7. QED-Obsidian (painel nunca sincronizado), Compartilhamento de Aprendizado (vazio desde 11/07) e Acervo Universal (3.075 na fila): ativar de verdade ou pausar/arquivar oficialmente?
8. Os 9 canais futuros (Ciência, Crimes…) ficam como estão (esqueletos inofensivos)?
9. Você vai trocar as chaves do .env nos sites (recomendo — estão em texto puro e podem ter ido no zip de backup)? Te passo o passo-a-passo de cada serviço.
10. Confirma que o CAPATAZ é o único condutor da produção (posso carimbar o orquestrador velho como HISTÓRICO nos manuais)?

📚 Dicionário rápido (os termos que apareceram)

PB / traço — o desenho original em Preto e Branco, feito a lápis. A matéria-prima sagrada.
BP / Big Picture / mural — o quadro gigante com todos os painéis do episódio montados, que vira o vídeo.
render — o processo de "revelar" o vídeo final a partir dos desenhos + áudio + tempos.
checksum / SHA-256 — impressão digital matemática de um arquivo; se 1 pixel mudar, ela muda. Serve para detectar alteração.
git — programa que guarda o histórico de cada mudança em arquivos de texto/código, permitindo comparar e desfazer.
.gitignore — lista do que o git deve IGNORAR (vídeos pesados, senhas, temporários).
.env — arquivo com as chaves/senhas de serviços (ElevenLabs, Gemini…). Nunca deve circular.
chave de API — a "senha" que os serviços pagos usam para cobrar da SUA conta.
hardcoded — valor digitado fixo dentro do código (ex.: um endereço de pasta), em vez de configurável.
drift — quando cópias do mesmo arquivo são editadas separadas e ficam diferentes sem ninguém perceber.
one-off — script feito para UM conserto pontual, usado uma vez e nunca mais.
.bak — cópia de segurança automática feita antes de mexer num arquivo.
gate (portão) — checagem automática que barra o avanço se algo estiver errado (ex.: texto sobrepondo desenho).
waiver — dispensa temporária e registrada de um portão (ex.: no render de PROVA, antes da aprovação).
allowlist — lista do que está autorizado (ex.: quais episódios podem ser produzidos).
variável de ambiente — valor definido fora do programa (no computador) que o programa lê ao rodar; fácil de esquecer de ligar.
event-store / diário de eventos — registro de tudo que o sistema fez, um arquivinho por acontecimento.
vendorizada — biblioteca de terceiros COPIADA para dentro do projeto em vez de instalada no sistema.
orquestrador / CAPATAZ — o gerente automático que decide a próxima etapa de cada episódio e chama os operários.
manifesto — lista assinada do que existe/foi feito (ex.: "de onde veio → para onde foi" numa mudança).
placeholder / esqueleto — estrutura vazia criada de antemão para uso futuro.
rollback / desfazer — voltar ao estado anterior quando algo dá errado.