Leia o guia de escrita e as convenções da coleção antes de redigir, revisar ou responder; um checkout da coleção tem ambos em shared/.
Desenvolvimento Iterativo de Vídeo
Use esta skill como o trabalhador de implementação para uma atribuição completa de video-iterative-orchestration. Execute o escopo atribuído de backend, frontend ou camadas cruzadas sem reinterpretá-lo. Quando existir um fluxo visível ao usuário, prove o contrato local real — desde a resposta do backend, passando pelo cliente gerado, até a interação com Android — e então capture evidências visuais para revisão.
Fronteira de autoridade e solicitações de decisão
O agente de implementação executa; ele não toma decisões consequenciais de entrega. Ele não deve escolher ou alterar a interpretação da fonte, o escopo do ticket, o comportamento do produto ou design, os repositórios ou camadas participantes, a ordem de dependência, a topologia de branch ou PR, as evidências necessárias, os desvios, a disposição de bloqueadores ou o estado final do ticket. Ele não deve perguntar ao solicitante ou a outro proprietário externo para decidir.
O agente pode escolher mecânicas de implementação reversíveis e convencionais ao repositório que não alterem a atribuição, incluindo organização local de código, ordenação de comandos, detalhes de seletores determinísticos e diagnóstico ou novas tentativas para falhas no escopo. Se a atribuição estiver faltando informações necessárias, conflitar com uma fonte autoritativa ou fato do repositório, ou exigir uma escolha consequencial, retorne esta solicitação estruturada ao orquestrador e continue o trabalho não afetado:
decision_request:
observed_condition: <fato>
assignment_clause: <cláusula ausente ou conflitante>
evidence: <caminhos, comandos ou saída editada>
decision_needed: <uma pergunta exata para o orquestrador>
affected_work: <trabalho pausado por essa decisão>
unaffected_work_continued: <trabalho ainda em andamento>
Não recomende ou selecione silenciosamente uma alternativa na solicitação. Se a atribuição não tiver seu escopo selecionado, superfície de escrita, branch e alvo de PR, comportamento de aceitação ou gate de evidência, retorne um decision_request antes da implementação.
Use o pacote visual Figma fornecido
Quando a atribuição incluir um pacote extract-figma-visuals, inspecione seu metadata.json, screen.png e as imagens descendentes nomeadas antes de alterar o código da interface. Use os IDs de nó canônicos e URLs do manifesto para recuperar detalhes de implementação estreitos através do Figma MCP; ao implementar a partir desse contexto, primeiro siga a orientação obrigatória figma-design-to-code do Figma e chame get_design_context para o nó raiz ou relevante. Não reexporte o frame, descarte o pacote ou infira um design apenas a partir do texto. Registre quais imagens raiz e descendentes informaram a implementação e a revisão visual. Aplique a resolução Figma registrada pelo orquestrador. Se o contexto recuperado conflitar com essa resolução ou expor uma escolha de produto não resolvida, retorne um decision_request; não reinterprete as fontes.
O pacote é uma referência de implementação, não evidência final. Ele não substitui a gravação real do Android, a prova do fluxo do usuário ou a revisão visual exigida abaixo.
Siga os trilhos da interface do repositório
Leia o AGENTS.md do repositório participante, a orientação de engenharia, o inventário de interface/componentes, as regras de localização e os comandos de validação documentados antes de editar. Reutilize controles e tokens do sistema de design público; não importe componentes internos ou introduza uma substituição local de funcionalidade sem um requisito concreto. Inspecione o inventário de componentes somente leitura do repositório quando disponível, incluindo contratos de substituição e parâmetros públicos. Um componente ausente que altere o escopo da atribuição retorna um decision_request.
Atribua identificadores semânticos estáveis a ações interativas tocadas e elementos de relato de estado, não um único identificador para um contêiner que contém várias ações. Mantenha o acesso ao serviço em sua camada proprietária, use a localização do repositório e siga suas convenções de chave E2E documentadas. Novos componentes públicos recebem anotações de contrato necessárias, histórias de componentes e cobertura dourada revisada apenas quando o repositório os exige. Execute a validação completa documentada de linhas alteradas e componentes; um analisador sozinho não substitui um plugin de lint configurado. Relate seleções de inventário, resultados de comandos, histórias aplicáveis, imagens revisadas e exceções justificadas na transferência.
Use linhas de conformidade de funcionalidade atribuídas
Quando a atribuição incluir um caminho de contrato de funcionalidade e linhas relevantes, trate essas linhas como o alvo de aceitação para este ticket. Anexe prova de cliente gerado ou fronteira de serviço e evidência de jornada ou visual às linhas correspondentes na transferência. Apenas o orquestrador pode criar ou alterar registros de agent_decided, decision_needed ou desvio. Se uma linha não puder ser implementada conforme atribuída, retorne um decision_request e continue as linhas não afetadas. Não reivindique uma linha entregue sem sua evidência necessária ou um approved_deviation registrado pelo orquestrador.
Execute o escopo de mudança atribuído
Antes da implementação, inspecione ambos os repositórios, seu contrato de API atual, dependência de cliente gerado e fluxo de interface relevante para validar o escopo atribuído e identificar sua mecânica. Não o reclassifique:
- Apenas backend: altere e verifique diretamente o contrato do servidor; não invente uma mudança de frontend. Use um fluxo de interface existente apenas quando a atribuição o exigir como evidência.
- Apenas frontend: consuma o cliente gerado e o contrato existentes; não regenere o cliente ou altere o backend. Retorne um
decision_requestse a implementação expor uma lacuna de contrato. - Camadas cruzadas: faça a menor alteração de contrato de backend, regenere o cliente e então implemente o comportamento de frontend dependente.
A prova E2E deve cobrir a camada alterada atribuída e seu limite de dependência real. Para uma mudança apenas de API atribuída sem fluxo visível ao usuário significativo, evidências de requisição/resposta válida e inválida orientadas ao contrato são suficientes; não fabrique uma mudança de interface apenas para vídeo. Se a inspeção do repositório mostrar que o escopo atribuído não pode produzir o comportamento exigido, retorne um decision_request em vez de adicionar outra camada.
Mantenha as descrições de PR focadas no revisor e siga o modelo de PR do repositório. Para trabalho de épico Jira, vincule a Subtarefa de implementação quando presente e sua História pai; a aceitação de QA permanece na História. Indique o ticket, o comportamento final implementado e os links de prova aplicáveis. Para mudanças de interface com Figma mapeado, nomeie cada área alterada e se seu resultado revisado corresponde ao frame mapeado. Não adicione texto padrão de escopo negativo como "nenhuma mudança OpenAPI/cliente" ou "nenhuma prova de UI/vídeo inventada"; histórico de iteração como "Correção aplicada"; contagens de teste local, lint, formato ou resultados de hook que o pipeline já relata; ou contabilidade interna de branch fonte, dependência e impacto de lançamento. Inclua uma exceção apenas quando ela criar uma ação concreta do revisor, preocupação de compatibilidade ou requisito de coordenação de lançamento.
Disciplina de commit e push
Siga o plano de commits da atribuição e os limites de push nomeados. Exija push_policy: final_verified_batch, final_push_authorized: true, checkpoint_pushes: prohibited, additional_boundary_authority: orchestrator e missing_boundary_state: decision_request_not_blocked. Se um estiver ausente ou diferente sem uma política de substituição explícita, retorne um decision_request e continue o trabalho local não afetado. Não chame o ticket de bloqueado.
O limite final de lote verificado é autoridade permanente e uma instrução para fazer push uma vez após as portas de verificação local e evidência da atribuição passarem. Não peça ao solicitante ou orquestrador para aprová-lo novamente. Até que essas portas passem, continue trabalhando localmente em estado active ou de recuperação; ainda não ter feito push é esperado e nunca um bloqueador.
Preserve o histórico adotado e realize apenas a reconciliação de linhagem atribuída; preservar o histórico não exige commitar ou fazer push de cada tentativa de recuperação. Commits remotos existentes permanecem inalterados, mas uma branch já publicada não exige que experimentos posteriores se tornem commits ou pushes.
Mantenha experimentos de seletor, esperas temporárias, logs de depuração, sondas de harness e outras edições de diagnóstico na árvore de trabalho até que seu resultado seja conhecido. Remova tentativas substituídas antes de commitar. Não comite uma tentativa de recuperação apenas porque a branch já tem um remoto; comite apenas mudanças que permanecem no diff final pretendido: uma mudança coerente de produto ou contrato com sua cobertura de regressão durável, um artefato gerado obrigatório ou uma mudança final de harness de teste necessária para provar a funcionalidade. Quando um checkpoint seguro contra interrupções for útil, registre um patch editado ou notas no diretório de evidências ignorado em vez de criar um commit na branch. Nunca inclua segredos ou valores de tempo de execução transitórios.
Vários commits significativos podem permanecer locais e ser enviados juntos. Faça push do lote verificado final uma vez sem outra solicitação de permissão. Faça push antes ou novamente apenas em um limite nomeado pela atribuição: uma transferência de dependência remota ou uma correção de revisão coerente. Leasing de tempo de execução, preservação de evidências ou uma etapa de diagnóstico bem-sucedida não justificam um push. Antes de fazer push, inspecione os commits de saída e o diff final; não publique commits apenas de diagnóstico ou substituídos. Se outro limite de push for necessário, retorne um decision_request antes de fazer push e continue o trabalho não afetado; o limite ausente não é um bloqueador.
Não altere, faça rebase, force-push ou reescreva o histórico remoto existente para limpar uma sequência de commits anterior sem autorização explícita. Continue com commits de correção comuns quando o histórico remoto já existir.
Execute ações externas autorizadas
Os limites de push e submissão nomeados da atribuição são autorização de fluxo de trabalho para a branch, PR e evidência atribuídos. Eles não ignoram um portão de aprovação gerenciado pelo runtime. Quando o executor de comando exigir aprovação para um push, operação de PR ou upload de evidência autorizado, tente imediatamente essa mesma operação de escopo estreito novamente através do mecanismo de aprovação ou escalonamento gerenciado do executor, nomeando o destino exato e o propósito. Deixe o runtime expor seu controle de aprovação quando um for necessário.
Não substitua esse mecanismo por uma solicitação conversacional para o solicitante dizer "vá em frente" e não retorne um decision_request, recovery_exhausted ou bloqueador apenas porque a aprovação gerenciada é necessária. Nunca enfraqueça, evite ou amplie a aprovação do runtime. Apenas uma negação explícita retornada pela tentativa de aprovação gerenciada é uma falha de ação externa; preserve sua resposta de ferramenta exata editada, mantenha o ticket não terminal e retorne-o ao orquestrador para recuperação focada. Um aviso, uma preocupação de informação privada inferida ou um escalonamento não tentado não é uma negação.
Após cada ação externa, verifique o estado remoto resultante em vez de confiar apenas na saída do comando: resolva o commit da branch remota, busque o PR através do GitHub e verifique a prova carregada a partir da descrição do PR e download autenticado. Retorne esses fatos na transferência para o portão de fechamento de submissão do orquestrador.
Corrigindo um PR não mesclado
Para uma tarefa de correção de revisão, compare a branch fonte do PR com seu alvo antes de alterar um artefato. Qualquer coisa introduzida apenas pelo PR não mesclado — incluindo uma migração, rota, cliente gerado, campo de API, componente de interface, teste ou harness — é mutável. Corrija, renomeie ou remova o artefato original para que o diff final do PR esteja correto; não adicione um artefato de compensação apenas para preservar a compatibilidade com a implementação intermediária do PR. Um commit de acompanhamento normal é suficiente; não reescreva o histórico remoto ou force-push a menos que explicitamente autorizado.
Qualquer coisa já na branch alvo, mesclada, implantada ou consumida externamente segue a política normal de compatibilidade e migração direta do repositório. Se a origem de um artefato não estiver clara, inspecione o diff alvo/fonte e o histórico antes de prosseguir; não assuma uma exceção não lançada. Execute novamente verificações de migração ou geração em estado limpo conforme aplicável, depois substitua a prova final afetada por evidência do comportamento corrigido.
Selecione o runtime local documentado
Um contêiner full-stack singleton definido pelo repositório é opcional, não um pré-requisito da coleção. A atribuição nomeia runtime_mode: shared_canonical ou runtime_mode: isolated_local. Aplique as regras de lease abaixo apenas a shared_canonical. Com isolated_local, use a configuração local documentada pelo repositório atribuído, portas e processos próprios; preserve identidade da fonte, prontidão, fixture, autenticação e verificações de evidência sem inventar uma topologia de host da empresa. Configuração específica do projeto ausente é um gatilho de diagnóstico, não permissão para instalar padrões da empresa.
Use apenas o runtime canônico concedido pelo orquestrador
As worktrees de fonte podem progredir em paralelo. O contêiner de desenvolvimento full-stack canônico do repositório não: ele aceita uma branch ou commit atribuído por vez, sob um lease de runtime de propriedade do orquestrador. A atribuição deve dizer explicitamente se este trabalhador detém esse lease.
Sem o lease, não monte ou troque a fonte no contêiner canônico; não inicie, pare ou reinicie seus serviços; não aplique migrações ou fixtures aos seus dados locais; não autentique contra ele; não execute Android E2E; nem grave evidências. Complete todo o trabalho de fonte não afetado, então retorne:
runtime_lease_request:
ticket: <ticket atribuído>
exact_sources: <worktrees de repositório, branches e commits prontos para implantar>
required_runtime_work: <migração, fixture, sondas, E2E e evidências ainda necessárias>
unaffected_work_completed: <implementação e verificação não-runtime já concluídas>
Com o lease, use apenas a topologia de dev-container documentada pela atribuição, portas padrão, fonte de ambiente completa, migrações, fixtures...