Peça o b-roll,veja a prévia,aprove e receba.

O doctor não confere só as ferramentas. Desde a 2.5.2 ele roda o Python da .venv que a CLI usa e compara cada pacote com requirements.txt e requirements-bootstrap.txt. Se a venv não existe, não roda ou tem versão diferente, aparece venv em summary.missing, com o que difere, e summary.do traz o comando do instalador.

É o relatório de mídia faltando antes de abrir o projeto: você descobre a pendência antes do render quebrar.

1. Vale quando o código foi atualizado por git pull ou /plugin update sem rodar o instalador de novo.
2. A saída ganha o campo venv, com status: ok, stale, absent, broken ou pinned.
3. Com GB_YTDLP_PATH fixado, a venv não é usada e não é cobrada (pinned).
4. resolved["yt-dlp"] mostra o yt-dlp que a CLI usa de fato: o fixado, depois o da .venv, só então o do PATH.

Os instaladores primeiro instalam o pip fixado (26.2.2) de requirements-bootstrap.txt, com os sha256 que o PyPI publica. Depois instalam todo o resto com --require-hashes --only-binary :all:: arquivo com hash diferente é recusado e nenhum pacote é construído na sua máquina. O certifi vai para a 2026.10.19, que tira a raiz emSign ECC Root CA - G3 (advisory GHSA-6q48-6c7w-9gw2).

É conferir o hash do arquivo de mídia depois da cópia: se um bit mudou, o clipe não entra.

1. Quando o pip falha, a mensagem diz a causa: rede ou índice inacessível, arquivo que não confere com o sha256, ou Python sem roda compatível.
2. O registro do pip fica em .venv/pip-install.log.
3. Depois de atualizar o getbrolls, peça /get-brolls-setup de novo.

A skill /get-brolls conduz o pedido inteiro. Para etapas soltas existem quatro comandos curtos: /get-brolls-setup (instala e confere), /get-brolls-brief (entrevista e escreve o BRIEF.md), /get-brolls-review (monta o Storyboard, manda o link e importa as decisões) e /get-brolls-status (diz onde você parou). Um quinto, /get-brolls-eval, roda um teste cego do próprio fluxo. No Codex, a skill se chama $get-brolls.

São os atalhos do painel: um clique por etapa, sem decorar comando.

1. O agente roda os comandos do terminal por você e mostra a saída real.
2. Nada é baixado sem duas coisas: você aprovar o trecho e registrar os direitos de uso.
3. Silêncio não é aprovação: o agente para na revisão e espera a sua resposta.

O RULES.md guarda as regras permanentes do canal: formato do vídeo (native, reels ou horizontal), a ordem das fontes para busca literal e ilustrativa, os domínios bloqueados e o modo de direitos. Elas valem em camadas: ~/.getbrolls/RULES.md para todos os projetos, depois o arquivo apontado por GB_RULES_FILE, depois o RULES.md do projeto. Listas se somam e, para valor único, vale o último.

É o preset de exportação do canal: todo vídeo nasce com as mesmas regras.

1. Trocar o formato nas regras atualiza o relatório e invalida aprovações anteriores.
2. rules mostra em sources de onde veio cada campo.
3. Responsabilidade e declaração nunca vêm da camada global: valem só no projeto do vídeo.

O BRIEF.md lista os beats do vídeo: o id de cada um, a fala exata e o que precisa aparecer na tela. É um arquivo Markdown com um bloco JSON dentro, e você edita só o bloco. Sem BRIEF, o /get-brolls-brief conduz uma entrevista de no máximo sete perguntas, uma por mensagem, e pára quando as perguntas 1, 3 e 7 foram respondidas. Dois "tanto faz" seguidos viram padrões, e o Claude mostra o que assumiu.

É o roteiro de b-roll: uma linha por momento do vídeo que precisa de imagem de apoio.

1. O id do beat (minúsculas, números e hífen) vira o --shot de toda a coleta.
2. O Claude nunca inventa fala, alvo, link ou nome de responsável.
3. Depois de editar na mão, rode brief --validate.

O search pesquisa numa fonte e salva cada resultado como candidato do projeto. Nada é baixado. YouTube, Wikimedia Commons e NASA funcionam sem chave; Pexels e Pixabay usam a chave de cada banco. A regra editorial é fixa: procure o fato, a pessoa, o produto ou a tela que a narração cita. Stock entra somente quando você pede stock com todas as letras, nunca como preenchimento de um beat sem fonte.

É marcar candidatos num banco de imagens: nada foi puxado para a timeline.

1. --shot liga o candidato ao beat do BRIEF, e a entrega sai organizada por beat.
2. --dry-run lista o que a fonte devolveu sem gravar nada no projeto.
3. --media filtra por image, video ou any; só NASA e Commons têm os dois.
4. --intent é literal (a coisa exata citada) ou illustrative (ideia genérica).

O resolve registra um candidato sem precisar buscar. Com --url aceita YouTube, Instagram, TikTok, Wikimedia Commons e NASA. Com --file registra um vídeo ou imagem que já está no seu computador, e você anota --creator e --source-url. Prints de notícia e de página entram como news_screenshot ou web_screenshot. O browser-plan planeja a captura pelo navegador autorizado.

É importar a mídia que o cliente mandou, com a ficha de origem preenchida.

1. Tipos de arquivo local: video, image, news_screenshot e web_screenshot. O padrão é inferido pela extensão.
2. Print de site precisa virar arquivo local verificável, com URL, manchete e data reais.
3. Não existe busca de imagens por API nem áudio isolado como entrega final.

TikTok e YouTube vêm por link, com yt-dlp e FFmpeg, sem chave. Instagram passa pelo navegador autorizado: o agente captura o vídeo e o áudio do mesmo Reel e o coletor incluído junta os dois canais. Não há busca global por palavra no Instagram ou no TikTok. Para lotes, a queue guarda os links e só entrega o próximo quando o intervalo e os tetos por hora e por dia permitem. A CLI nunca dorme: ela diz quanto esperar.

É a fila de render: os jobs saem um por vez, no ritmo que a plataforma aguenta.

1. Ritmo padrão: Instagram a cada 45 a 120 s, TikTok e YouTube a cada 15 a 40 s, no máximo 20 por hora e 60 por dia.
2. Falha com 403, 429, login ou "rate limit" pausa a fila de 30 minutos até 4 horas.
3. Você sempre usa a sua própria sessão do navegador. Nunca distribua perfis ou cookies.

O inspect lê duração, capítulos e legendas da fonte e devolve janelas pontuadas pela fala ou pelo alvo que você passa em --query. Você escolhe --start e --end a partir delas, nunca de palpite. Sem pista nenhuma, o preview --scan varre o vídeo inteiro numa folha de quadros de baixa resolução.

É folhear o material bruto com a legenda ao lado, em vez de assistir tudo.

1. Escreva a --query no idioma do vídeo.
2. --max-windows define quantas janelas voltam (1 a 20, padrão 3).
3. Com --candidate, grava só a duração no candidato; com --url, não registra nada.

O preview gera, para o intervalo que você escolheu, um GIF, um pôster e um contact sheet: uma grade de quadros igualmente espaçados, com número e tempo em cada célula. Dá para avaliar ação, enquadramento e texto sobreposto sem baixar o vídeo em alta. A fala exata (--narration) e o motivo da escolha (--reason) vão junto e aparecem no Storyboard.

É o proxy da timeline: leve para decidir, o arquivo pesado só vem depois.

1. No máximo 10 segundos por prévia e um preview por chamada. Intervalo maior é recusado.
2. GIF padrão: 360 px, 8 fps, 128 cores, até 5 MB. Grande demais vira prévia estática, com aviso.
3. GB_PREVIEW_MODE=static usa só pôster e sequência de quadros.
4. Um pôster isolado, inclusive o de --reference-only, não prova movimento.

O review gera brolls/review.html: uma página para alternar entre imagem estática e GIF, ver fala, intervalo, motivo da escolha, autor e fonte, e decidir por trecho. O serve --background abre a página numa porta local e devolve o link. No fim, o botão Salvar decisões grava um JSON em brolls/reviews/, e o import-review --by traz tudo para o projeto com o nome de quem decidiu.

É mandar o corte de aprovação para o cliente, sem link de Drive: ele clica, você importa.

1. Em cada trecho: Aprovar, Pedir ajuste (com comentário; cabe "procure outro vídeo") ou Reprovar.
2. Abra pelo link que o serve devolveu e salve antes de fechar a aba. Abrir por file:// pode desligar o salvamento local.
3. Se o intervalo mudou depois da decisão, o trecho volta como stale_epoch ou signature_mismatch e a decisão antiga nunca é reaplicada.
4. Dá para imprimir ou salvar em PDF uma versão estática, com quadros, fontes e comentários.

A aprovação vem sempre de uma pessoa: pelo Storyboard (import-review) ou por fala explícita no chat, registrada com approve --by NOME --channel chat --statement "frase". O Claude mostra o que cada folha de quadros contém e pergunta "aprova todos, ou quais?"; aprova exatamente o que você viu. Mudou o intervalo ou o contexto, a aprovação cai. O reject descarta o candidato e guarda o porquê.

É o OK do cliente por escrito, com nome e data, antes do render final.

1. No canal chat, --statement é obrigatório. Silêncio não é aprovação e o agente não se autoaprova.
2. --all só vale quando todos os candidatos com prévia foram mostrados.
3. reject zera o output do candidato: nada fica rejeitado e entregue ao mesmo tempo. Nada é apagado de brolls/.
4. approve remove a rejeição antiga do candidato.

O permit grava as condições de uso do trecho antes do corte. São três rotas: --evidence, com as condições reais que você leu na página da fonte; --preset, com o texto de termos padrão da fonte (youtube, nasa, commons, pexels, pixabay), sempre com o pedido de conferir a página; e --declared-by com --declaration-text, a sua declaração de responsabilidade, com nome real e frase de pelo menos 20 caracteres. Não invente licença.

É guardar a licença do arquivo junto do arquivo, antes de usar na edição.

1. O modo do projeto vem do RULES.md: per_item_evidence (um por um) ou user_declaration (a declaração cobre o projeto).
2. Responsabilidade e declaração valem só no projeto em que o vídeo é feito.
3. O permit registra o que foi dito e de onde veio. Ele não verifica a licença sozinho.

O fetch baixa e corta só o intervalo aprovado e permitido, em 1080p quando a fonte oferece, e salva em brolls/clips/. Se faltar aprovação ou direitos, ele recusa. O verify compara o sha256 de cada arquivo e tenta decodificá-lo. Arquivo alterado, sumido ou que não abre volta a approved e deixa de ir para a entrega.

É o export final conferido: o arquivo que sai bate com o que foi aprovado.

1. A conferência passa por todos os clipes antes de falhar, para que um segundo arquivo alterado não continue marcado como verificado.
2. Uma verify limpa depois de restaurar o arquivo volta a marcar como verificado.
3. Imagens aprovadas são copiadas sem alteração; prints saem como PNG ou JPG com a origem registrada.

O deliver organiza o que já foi coletado em entrega/, uma pasta por beat, na ordem do BRIEF (NN-<beat>-<alvo>). Cada pasta leva o .mp4, o contact-sheet.jpg e o ORIGEM.md: fonte, autor, intervalo, direitos, quem aprovou e o sha256. Um README.md na raiz traz a tabela de tudo. Sem BRIEF, tudo vai para 00-sem-beat/. A pasta é derivada: o que vale é brolls/.

É o bin organizado por cena, com a ficha de cada clipe ao lado.

1. Os arquivos entram por hardlink: não ocupam disco duas vezes, mas editar em entrega/ é editar o original. Por isso nascem somente-leitura.
2. GB_DELIVERY_COPY=1 entrega cópias independentes e editáveis.
3. Rodar de novo é seguro. O que você criou dentro de entrega/ é preservado, e arquivo entregue que você editou nunca é sobrescrito.
4. Clipe rejeitado ou com integridade reprovada não é entregue e aparece em skipped, com o motivo.

O status responde "onde estamos?" sem alterar nada: candidatos encontrados, prévias geradas, decisões pendentes, aprovadas e rejeitadas, itens com direitos registrados, entregues e verificados. Em summary.do vem o próximo passo: o command pronto, o why e blocking_human, que fica true quando depende de você. summary.do.for_human é a frase pronta para dizer à pessoa.

É o painel de status do render: o que terminou, o que está na fila e o que travou.

1. Só lê. Pode rodar enquanto um fetch longo está em andamento, sem esperar.
2. Num projeto que não existe, responde que não encontrou e não cria nada.
3. No chat, /get-brolls-status repassa a frase do for_human sem parafrasear.

O remember registra, no projeto, uma referência aprovada ou rejeitada com o motivo real e o nome de quem decidiu. O references consulta tudo que foi guardado. Os exemplos orientam a próxima busca, mas nunca transferem aprovação ou licença para outro trecho.

É a nota de montagem de cada clipe: por que ficou, por que saiu.

1. --decision é approved ou rejected, e --reason é obrigatório.
2. A memória é por projeto. Para ver a de outro projeto, aponte --project para ele, com a autorização da pessoa.

O learn guarda aprendizados que valem para todos os seus projetos: uma busca que rendeu ou não (--outcome hit ou miss), uma preferência editorial sua e anotações livres. O library consulta isso antes de você sair buscando. É uma pista editorial e nada além disso: nenhuma resposta da biblioteca aprova ou permite coisa alguma.

É a sua coleção de presets: o que funcionou no último vídeo já está à mão no próximo.

1. Fica em ~/.getbrolls/library. Desligue com GB_LIBRARY=off.
2. A biblioteca mistura projetos: não cole o texto dela numa conversa com cliente.
3. --from-candidate guarda um trecho já memorizado com remember, como ponteiro.

Cada projeto ganha brolls/getbrolls.log: uma linha chave=valor por evento, com início e fim de cada comando, cada passo da trilha, cada chamada de ffmpeg, ffprobe, yt-dlp e curl com duração e código de saída, e cada pedido de rede. O arquivo tem permissão restrita e gira a cada cerca de 1 MB, guardando 3 cópias. Nunca entram no log: nome de quem aprovou, frase de aprovação, motivo de rejeição, evidência de direitos, texto de busca, títulos, canais, URLs (só o host) e linha de comando.

É o log do render: mostra o que rodou e quanto demorou, sem expor o seu conteúdo.

1. GB_LOG_LEVEL aceita DEBUG, INFO (padrão), WARNING, ERROR e off.
2. GB_LOG_STDERR=1 espelha o log no terminal, para depurar.
3. Comando de leitura não cria o arquivo, e falha de log nunca derruba um comando.
4. Erros trazem app_log com o caminho do log, e brolls/diagnostics.jsonl guarda o detalhe de cada erro.

O serve sobe o Storyboard em 127.0.0.1, só no seu computador. Toda resposta leva cabeçalhos que impedem outra página de embutir a revisão para induzir um clique de aprovação. O servidor entrega somente review.html, previews/ e clips/: o manifesto, o diagnóstico, as decisões e a listagem de pastas respondem 404. Um .. codificado na URL não sai de previews/ nem de clips/.

É um link de revisão que só abre a janela certa, sem deixar a porta dos fundos aberta.

1. A página não pede login: ela serve a projetos locais confiáveis. Compartilhe só o necessário à revisão.
2. O processo em segundo plano não herda as chaves de provedor.
3. .serve.pid e .serve.log nascem com permissão restrita.

O coletor aceita somente URLs públicas HTTPS sem credenciais, recusa nomes que resolvem para redes locais, fixa o download no endereço que acabou de validar e não segue redirecionamentos. Erros de yt-dlp, curl, ffmpeg e HTTP trazem o código e as últimas linhas do erro, sempre sem URL assinada, chave ou token.

É o firewall do importador: só entra mídia de endereço público, e nada sai do seu computador por engano.

1. Respeita Retry-After e faz pausas do yt-dlp entre downloads.
2. Seus projetos e originais ficam locais. Só a pesquisa e o download falam com as fontes que você escolheu.
3. Guarde chaves de API, sessão do navegador e URLs assinadas em ambiente privado, fora da pasta da skill.