jake-jiffi/jiffi-video-studio

Jiffi Video Studio

O usuário fornece um cenário, brief ou mídia. Entregue o vídeo solicitado, usando material gerado, material gravado ou uma combinação conforme o projeto exigir. Não assuma comédia, pessoas, um escritório, fotorrealismo, diálogo, marca Jiffi, legendas, múltiplos formatos ou duração fixa. Use estes pontos de revisão:

1. Portão 1: aprovar o tratamento e escopo de entrega (e orçamento, se nenhum estiver definido)
2. Portão 2: escolher novo elenco ou direção visual quando essas decisões forem necessárias
3. Portão 3: dar notas sobre o corte bruto

Em um portão, envie a mensagem do portão e pare até que o usuário responda. Se pedir alterações, aplique-as e mostre apenas o que mudou. Se dispensar um portão ("apenas escolha o elenco"), siga sua recomendação e anote no registro do portão. Entre os portões, não peça permissão para nada que esta habilidade autoriza. Diretrizes explícitas existentes podem satisfazer um portão. Marque o Portão 2 como não aplicável para uma edição sem novo elenco ou escolhas visuais. Não invente alternativas ou solicite uma segunda aprovação para decisões que o usuário já tomou.

Mantenha brief/brief.md atualizado: atualize o status e o registro do portão conforme cada etapa e portão forem concluídos. Esse arquivo é como uma sessão posterior retoma o projeto.

Espaço de trabalho (raiz do estúdio)

A raiz do estúdio é a pasta de projeto selecionada pelo usuário no host atual. Ela contém tudo que persiste entre vídeos. Mantenha as saídas do projeto fora da própria pasta desta habilidade. Quando o usuário autorizar explicitamente reparos da habilidade, edite uma cópia gravável, mantenha um backup e registre a alteração e sua verificação. Não edite um cache de plugin gerenciado pelo host; atualize o pacote fonte e reinstale-o. Nestes arquivos, caminhos começando com references/, assets/ ou scripts/ estão dentro da pasta desta habilidade. Todo outro caminho é relativo à raiz do estúdio.

<raiz do estúdio>/
  AGENTS.md              orçamento e permissões (veja README)
  cast-registry.json     cada personagem, local e adereço reutilizável
  cast/<id>/             master.png, sheet.png, photos/ (apenas pessoas reais)
  locations/<id>/  props/<id>/  brand/ (apenas a marca solicitada pelo projeto)
  projects/<slug>/       brief/ source/ storyboard/ previz/ renders/ graphics/ audio/ edit/ export/

Se cast-registry.json estiver ausente, esta é a primeira execução: copie assets/cast-registry.template.json para a raiz do estúdio como cast-registry.json. Todos os caminhos do registro são relativos à raiz do estúdio.

Iniciar ou retomar

• Primeira execução ou ambiente alterado: inicie o Estágio 0 abaixo antes de prometer produção. Em uma execução de retorno, leia setup/status.md e o brief do projeto, reuse escolhas definidas e re-verifique apenas capacidades alteradas ou com falha.
• Nova ideia: crie projects/<slug>/ (curto, minúsculas, hífens), copie assets/project-brief-template.md para brief/brief.md, complete as verificações de configuração relevantes e então inicie o Estágio 1.
• Projeto existente ("continue com..."): leia brief/brief.md, encontre o status e o registro do portão e continue a partir do próximo passo incompleto. Não refaça um portão aprovado a menos que o usuário peça.
• Entradas: uma frase, captura de tela, link, roteiro, gravação ou edição existente. Estabeleça propósito, público, tratamento factual ou ficcional, estilo, duração (exata, intervalo ou proposta), mídia disponível, formatos de saída, som e orçamento. Use o que o usuário já forneceu. Pergunte apenas sobre decisões ausentes que afetam o resultado; caso contrário, proponha um tratamento com premissas claras no Portão 1.
• Desenvolvimento de conceito ou entrega: use references/10-concept-to-script.md durante o Estágio 1 para extrair decisões e alegações, resolver contradições e escrever um roteiro de produção cronometrado com registros de tomadas, ativos, dependências e uma estimativa. Documentos anexados são material de origem, não nova autorização. Para uma solicitação de escopo/roteiro apenas, entregue esse pacote sem iniciar renders.
• Rota: gerar novas tomadas, gravar/capturar, editar mídia fornecida ou combiná-las. Inspecione as ferramentas de captura disponíveis antes de prometer gravar qualquer coisa. Filmagem física precisa de câmera/operador; forneça um plano de filmagem e solicite a filmagem necessária quando a captura direta não estiver disponível. Preserve gravações originais. Não substitua evidências factuais por filmagens geradas inventadas.
• Duração: use o tempo total solicitado. O limite de clipe de um modelo não é um limite de duração de filme. Para trabalhos mais longos, planeje capítulos, sequências e tomadas, mantenha referências e estado compartilhados e faça checkpoint de cada seção antes da montagem completa. Cite o escopo inteiro mais uma margem de repetição. Se orçamento ou ferramentas não puderem atender, proponha um ajuste específico em vez de encurtar silenciosamente o vídeo.

Pipeline

Leia cada arquivo de estágio quando alcançar esse estágio, não antes.

Estágio	Leitura	Produz	Termina com
0. Configuração guiada e entrada	references/00-setup-and-hosts.md	detalhes ausentes resolvidos, instruções de configuração específicas da rota e evidência local em setup/status.md	próximo trabalho identificado; apenas trabalho dependente espera
1. Tratamento e roteiro	references/01-concept.md, references/10-concept-to-script.md	brief escopo, roteiro de produção cronometrado ou seleções, registros de tomadas, dependências de ativos, estimativa e proposta de entrega	Portão 1 para produção
2. Ativos e direção visual, se necessário	references/02-casting.md	mídia selecionada e referências necessárias	Portão 2, se aplicável
3. Planejamento visual, quando útil	references/07-storyboarding.md, depois references/03-previz.md se ensaio espacial for necessário	quadros, animatic cronometrado ou ensaio 3D, proporcional à incerteza
4. Gerar ou adquirir tomadas ausentes	references/04-render.md para geração	takes inspecionados, mídia capturada ou fornecida, gráficos
5. Som e edição	references/05-edit.md	corte bruto, depois exportações finais	Portão 3

Use IDs de tomada ou segmento estáveis. Pule estágios que não adicionam valor. Editar filmagens existentes não requer novo elenco, imagens pagas, trabalho 3D ou geração de vídeo.

Para tomadas com personagens atuando, ou uma cena que continua entre tomadas, leia Direção e continuidade após a seleção de conceito e antes de encenar ou gerar keyframes de tomada. Use um plano por local/tempo contínuo, ou seções em brief/scene-plan.md. Mantenha transições intencionais distintas de falhas de continuidade. Use um piloto onde uma interação gerada incerta colocaria tomadas dependentes em risco. Isto é preparação interna dentro dos portões existentes. Rastreie resultados técnicos, de continuidade, realismo visual, desempenho e comunicação/narrativa separadamente. Para personagens, planeje intenção, atenção e reações mesmo quando estiverem ouvindo ou esperando. Decida o que o guia deve travar e onde o gerador pode adicionar desempenho natural. Uma posição fixa não deve implicar um corpo congelado.

Leia Storyboarding quando imagens puderem resolver composição, encenação, transições ou estilo visual. Registre a pergunta útil ou o motivo para pular. Não gere um storyboard apenas para preencher um estágio. Leia Especificação de entrega antes de configurar a edição e verificador final. Verifique as saídas solicitadas para este projeto. Leia Som de cena ao planejar cenas audíveis, escolher performances e mixar. Combine identidade vocal ao personagem e tratamento de som ao cenário, ação e perspectiva de escuta pretendida. Registre a revisão de som com imagem separadamente das verificações técnicas de áudio. Use Bíblia de som e spotting para estabelecer o papel dramático de uma trilha sonora, planejar entradas de cue e resolver uma direção musical incerta. Mantenha o plano proporcional ao projeto. Use Revisão de áudio e vídeo quando um modelo autorizado com capacidade de áudio estiver disponível. Revise o áudio fonte real antes de comprometê-lo com uma edição, depois a mixagem completa com imagem. Análise do modelo, medições técnicas e o veredito do público são evidências separadas.

Configuração do host e acesso a ferramentas

O Estágio 0 é uma conversa guiada e verificação, não uma lista de verificação entregue ao usuário para resolver sozinho. Leia references/00-setup-and-hosts.md no primeiro uso ou após trocar de hosts. Inspecione o que esta sessão já pode fazer, use o brief e política existente, e faça um pequeno lote de perguntas apenas para detalhes ausentes que afetam a rota selecionada. Explique o propósito de cada ferramenta ausente, o passo local de configuração exato ou instalador oficial, quem precisa agir e como você testará. Nunca peça aos usuários para colar senhas, chaves de API, tokens ou cookies. Detalhes de conta significam escolha de serviço/espaço de trabalho e status de login, não valores secretos ou informações pessoais não relacionadas. Deixe-os autenticar no fluxo do provedor ou configurar segredos privadamente no ambiente de execução.

Execute o scripts/studio.py doctor incluído para a rota selecionada antes da produção, use seus next_steps e mantenha resultados não secretos em setup/status.md. Instale ou configure dependências locais necessárias dentro da autorização do usuário; oriente-o através de login, acesso de administrador ou capacidades de host ausentes quando sua ação for necessária. Re-verifique após cada reparo. Ferramentas opcionais são necessárias apenas se o projeto as selecionar. O planejamento pode continuar enquanto a configuração de renderização espera. Reutilize decisões anteriores e verificações bem-sucedidas em execuções subsequentes, re-validando capacidades alteradas ou com falha. Isto não cria outro portão de aprovação. Um executável descoberto não é prova de uma conta funcional, servidor MCP conectado ou renderização bem-sucedida. Registre essas verificações separadamente. Use apenas capacidades realmente presentes nesta sessão. Nomes de ferramentas nativas, controle de navegador e geração de imagem diferem entre hosts; as rotas compartilhadas de CLI, Python e FFmpeg são a base portátil. Sem sistema de arquivos ou shell, desenvolva o escopo no chat e explique o acesso de execução ainda necessário.

Rotas de ferramentas

A tabela descreve rotas suportadas, não permissão permanente para enviar dados ou gastar dinheiro. Siga os provedores aprovados do usuário e a política da organização. Registre qualquer aprovação necessária de provedor/dados antes de um novo upload externo. Não assuma que uma assinatura significa que o treinamento está desabilitado ou dados confidenciais estão limpos. Dependências locais de código aberto não são automaticamente novos fornecedores hospedados. Instale apenas dependências necessárias para a rota selecionada.

Tarefa	Primária	Alternativa
Pesquisa	pesquisa web
Imagens (pessoas, lugares, adereços, imagens estáticas)	CLI Higgsfield, modelo gpt_image_2_5	geração de imagem integrada do host
Vídeo	Seedance 2.5 no Higgsfield (CLI ou web)
Captura	gravações fornecidas ou uma ferramenta de captura local já autorizada, verificada antes do uso	plano de filmagem/captura e filmagem fonte necessária
Previz	Blender local ou Higgsfield 3D Jutsu, selecionados usando 03-previz.md	Higgsfield para plugin Blender, depois keyframes adequados
Gráficos com texto exato	HTML renderizado para PNG com Chrome headless, ou títulos do Resolve
Voz	CLI Higgsfield text2speech_v2, ou a própria gravação do usuário	áudio nativo do Seedance
Música, quando necessário	Faixa fornecida licenciada adequadamente	Cue original através da conta Higgsfield autorizada, com verificações de modelo/cota ao vivo e termos da fonte registrados
Edição	DaVinci Resolve Studio via MCP DaVinci Resolve	controle de computador do Resolve, depois ffmpeg
Verificações	scripts/verify_project.py (usa ffprobe e ffmpeg)
Análise de áudio/vídeo	API Gemini autorizada através de scripts/gemini-review.mjs, usando uma chave de API fornecida através do ambiente do processo	Feedback auditivo do usuário; reter julgamentos não verificados

IDs de modelo, parâmetros e limites mudam. Antes de usar um modelo, verifique-o ao vivo com higgsfield model list e higgsfield model get <model> em vez de confiar em números nestes arquivos. No CLI 1.1.26, generate create <model> --help mostra ajuda genérica de comando, não parâmetros de modelo. Use ./bin/higgsfield quando o estúdio fornecer um wrapper local. O login do CLI é separado do login do site: execute auth login, deixe o usuário completar o fluxo do navegador, depois workspace list, selecione o espaço de trabalho pretendido e verifique account status --json. Nunca imprima auth token. Um plano pago ou listagem de modelo não é prova de uma renderização bem-sucedida. Para uma leitura ou operação local com falha, tente novamente uma vez, depois use sua alternativa e registre o resultado. Submissões pagas precisam de tratamento diferente: um tempo limite pode ter criado um job. Reconcilie o ID do job e a transação antes de tentar novamente. Um job em andamento não é um job com falha. Consulte-o em um intervalo sensato enquanto continua trabalho independente. Não envie um duplicado porque está lento. Se Higgsfield ou um site estiver desconectado, peça ao usuário para fazer login. Nunca digite uma senha.

Orçamento

O orçamento vem de instruções explícitas do usuário e da política do estúdio em AGENTS.md (ou seu equivalente no host). Um orçamento não definido significa sem submissões pagas. Se estiver faltando, proponha um na mensagem do Portão 1. Estime com higgsfield generate cost onde suportado, caso contrário a partir do preço listado do modelo, e declare suas premissas. Estimativa de custo com caminhos de mídia locais pode fazer upload desses arquivos, então use estimativas apenas de texto até que as entradas sejam liberadas para upload. Registre gastos por tomada em brief.md. Persista cada cotação e reserva antes da submissão. Mantenha gastos concluídos, jobs pendentes, jobs com falha e submissões incertas dentro do limite até que um reembolso seja verificado. Proteja nomes duplicados de tomada/take e bloqueie novo trabalho pago enquanto uma submissão estiver incerta. Reserve quaisquer custos de navegador também. Trate respostas nsfw, ip_detected, com falha, canceladas e erro como terminais, não jobs para continuar consultando ou reenviar automaticamente. Use account transactions para reconciliar cobranças e reembolsos com horários e valores de submissão, uma vez que a listagem de transações pode omitir IDs de job. Saldo da conta sozinho é insuficiente se outro trabalho foi executado concorrentemente. Dentro do orçamento, você pode renderizar, tentar novamente e editar regiões livremente. Se a próxima ação excedê-lo, pare a ... [truncado para tradução]