Communitygithub.com

MarkTripoli/skills

Centraliza as decisões de entrega no escopo de tickets e delega a execução em branches de ticket isoladas e retomáveis usando desenvolvimento iterativo por vídeo.

O que é skills?

Esta skill atua como um orquestrador rígido que transforma um épico do Jira, fila de issues do GitHub ou lista de requisitos explícita em uma fila de entrega durável. Cada ticket selecionado recebe um agente de implementação exclusivo e uma worktree isolada, com um contrato de execução completo definido antes da dispatch. A skill utiliza um workflow de desenvolvimento iterativo por vídeo (video-iterative-development) para executar o contrato e produzir entregas verificadas. O orquestrador mantém autoridade total sobre decisões de escopo, comportamento do produto, repositórios, branches, PRs, desvios, bloqueios, estados de ciclo de vida, aceitação final e relatórios de tickets, enquanto os agentes de implementação podem apenas tomar decisões mecânicas e reversíveis. A skill também se integra com ferramentas como resume-and-reconcile, extract-figma-visuals e feature-conformance para gerenciar trabalho interrompido, exportar ativos do Figma e validar conformidade, tudo coordenado via Slack opcionalmente.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MarkTripoli/skills/tree/HEAD/skills/delivery/video-iterative-orchestration

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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/.

Orquestração Iterativa por Vídeo

Tipo de Skill: Rígido — preservar escopo de ticket, trabalho interrompido, ancestralidade de dependência e portões de evidência. Falhas comuns entram em recuperação; não encerram uma tentativa de implementação.

Propósito e responsabilidade

Transforme um épico do Jira, fila de issues do GitHub ou lista explícita de requisitos, opcionalmente restrita a tickets nomeados, em uma fila de entrega durável. Cada ticket ou correção selecionada recebe um agente de implementação exclusivo e uma worktree. Antes da dispatch, o orquestrador seleciona o escopo (apenas backend, apenas frontend ou camada cruzada) e fornece um contrato de execução completo. Todo agente de implementação usa video-iterative-development para executar esse contrato e produzir sua submissão verificada.

O orquestrador delega execução, não autoridade de decisão. Ele possui exclusivamente a interpretação da fonte, escopo do ticket, comportamento do produto, seleção de repositório e camada, ordem de dependência, topologia de branch e PR, desvios, disposição de bloqueios, estado do ciclo de vida, aceitação final e relatórios de ticket. Ele invoca, em vez de reafirmar, seus companheiros:

  • resume-and-reconcile.md é responsável pela descoberta de trabalho interrompido e detecção de alterações na fonte mapeada.
  • extract-figma-visuals é responsável pela seleção da hierarquia do Figma, exportação e validação do pacote.
  • feature-conformance é responsável pela autoridade da fonte, registros de decisão, rastreabilidade e validação de reivindicação de entrega.
  • video-iterative-development é responsável pela implementação atribuída, mecânica de recuperação, evidência e submissão. Ele retorna observações e solicitações de decisão estruturadas; não altera o contrato de execução nem atribui estados de entrega.
  • agent-implementation-reviewer é responsável por um relatório independente de plano-para-diff somente leitura. O orquestrador aplica o adaptador de contrato de recurso sem alterar esse revisor compartilhado.
  • A revisão de orientação de engenharia examina o diff final em relação às convenções aplicáveis do repositório. Ela registra consequências concretas e exceções justificadas sem transformar preferências em novos requisitos de ticket.

Autoridade de decisão

Uma decisão consequente é qualquer escolha que altera interpretação da fonte, escopo, comportamento do produto ou design, repositórios ou camadas participantes, ordem de dependência, topologia de branch ou PR, evidência exigida, um desvio aprovado, disposição de bloqueio ou estado final do ticket. O orquestrador toma e registra toda decisão consequente antes da dispatch ou em resposta a uma solicitação de trabalhador. Resoluções automáticas de fonte autorizadas por esta skill também são decisões do orquestrador.

Agentes de implementação podem escolher apenas mecânicas reversíveis e convencionais ao repositório que deixem o contrato de execução inalterado, como organização local de código, ordenação de comandos, detalhes de seletores determinísticos ou como diagnosticar e tentar novamente uma falha dentro do escopo. Quando as instruções estão incompletas, conflitantes ou exigem uma escolha consequente, o trabalhador não deve adivinhar, expandir escopo, contatar o solicitante ou atribuir a si mesmo um estado terminal. Ele retorna uma decision_request estruturada ao orquestrador e continua todo o trabalho atribuído não afetado.

Entradas

  • Uma chave/link de épico do Jira, fila de issues do GitHub ou lista explícita de requisitos priorizada. Resolva a fila selecionada a partir da solicitação; não exija Jira para uma execução com tracker neutro ou do GitHub.
  • Para modo de correção, um documento de descobertas (findings) somente leitura.
  • Raízes de repositório quando não podem ser descobertas do workspace.
  • Opcionalmente, um documento de design ou link somente leitura. Arquitetura é um subtipo de documento, não uma categoria de entrada separada.
  • Opcionalmente, links de frame raiz do Figma (somente leitura) contendo node-id para tickets de UI aplicáveis.
  • Uma solicitação opcional para coordenar a execução através do Slack, incluindo um canal explicitamente nomeado ou uma solicitação explícita para uma execução por mensagem direta. Sem nenhum destino, slack-coordinator usa o padrão do repositório.
  • Qualquer autoridade externa explícita ou prazo.

Não solicite um ID de recurso, arquivo de contrato, flag de aprovação, revisão do Figma ou classificação de camada. Contexto ausente do Figma ou documento de design opcional não é um bloqueador.

Quando a coordenação via Slack for solicitada, invoque slack-coordinator diretamente como parte da orquestração; não crie um agente ou painel separado do Slack. Use uma execução e thread única do Slack para a orquestração. O orquestrador é o único contato com o Slack e o único consumidor de seu run_id; agentes de implementação se reportam ao orquestrador e nunca chamam o coordenador nem consomem entrada do proprietário.

Após a ingestão somente leitura resolver o épico e os tickets selecionados, inspecione um ledger existente em busca de um run_id de coordenador ativo. Retome essa execução quando presente. Caso contrário, confirme que o executável está disponível e chame run start antes da primeira ação de mudança de estado, usando o épico como trabalho, o resultado solicitado como meta e os tickets selecionados como escopo. Passe --channel apenas para o canal único explicitamente nomeado na instrução atual, passe --dm apenas quando o solicitante solicitar explicitamente uma execução por mensagem direta; caso contrário, deixe o coordenador usar o padrão do repositório. Registre o run_id retornado, canal, timestamp do thread e permalink no ledger na primeira gravação permitida. Nunca inicie uma segunda execução do coordenador meramente porque um ticket começa, retoma, tenta novamente ou muda de proprietário.

Execute run check imediatamente antes de cada ação de mudança de estado do orquestrador e imediatamente antes de cada dispatch ou acompanhamento que autorize trabalho de implementação. Saída 0 permite a ação. Na saída 10, aplique, responda ou rejeite a entrada do proprietário com run resolve, então verifique novamente. Na saída 11, pause, tente novamente após uma breve espera e relate o motivo; nunca mude estado, dispache trabalho ou recorra a outro caminho do Slack enquanto a coordenação estiver indisponível. Saída 12 é a decisão explícita de interrupção do operador e permite que a execução continue sem mais chamadas ao Slack.

Use run event para mudanças de fase de orquestração, mudanças de ciclo de vida de ticket e início ou fim de bloqueadores; o daemon é responsável por reenvios de status em intervalos silenciosos. Chame run finish uma vez quando a orquestração atingir seu resultado terminal completado, falhou ou cancelado. Siga os contratos de comando, seleção de canal, mensagem e falha da skill independente em vez de reafirmá-los ou enfraquecê-los aqui. Quando a coordenação via Slack não foi solicitada, não inicie uma execução e não adicione portões do Slack.

Selecione o modo de execução

Use modo de entrega sem descobertas: leia o workflow de entrega do Jira para Jira, ou modo de entrega para filas do GitHub e tracker neutro. Use modo de correção quando a fila selecionada incluir um documento de descobertas. Leia o workflow de correção.

Em ambos os modos, execute retomada e reconciliação de fonte antes de criar uma worktree. Para Jira, o status é decisivo: In Progress e Code Review são resume_required e devem adotar trabalho existente em vez de começar da base.

Escopo de ticket e autoridade de design

Os requisitos e critérios de aceitação do ticket selecionado definem o limite do trabalho. O épico fornece contexto de associação, ordem e dependência; nunca se assume que contém todos os comportamentos representados no Figma ou em um documento de design. Mapeie apenas nós do Figma e seções de documento que esclareçam um ticket selecionado. Conteúdo de design não mapeado é contexto, não trabalho ausente, adiado ou fora do escopo.

Dentro do limite do ticket:

  1. Figma mapeado é a autoridade padrão para comportamento visual e de interação, incluindo detalhes ambíguos ou conflitantes do ticket;
  2. Figma mapeado substitui automaticamente um documento de design conflitante;
  3. sem Figma aplicável, um documento de design mapeado resolve detalhes ambíguos do ticket;
  4. convenções do repositório e API resolvem detalhes de implementação restantes.

Registre cada resolução automática em .agent-evidence/orchestration/<run-id>/decision-log.md. Pause apenas o ticket afetado para a rara escolha não resolvida cujas alternativas mudem materialmente o escopo do produto ou comportamento do usuário. Uma partida explicitamente aprovada das fontes autoritativas é um approved_deviation; decisões comuns de implementação e resoluções do Figma não são desvios.

Crie um manifesto de documento de design no nível da execução em .agent-evidence/orchestration/<run-id>/design-documents/manifest.json. Ele registra identidade da fonte, SHA-256 do documento inteiro e IDs estáveis, títulos e valores SHA-256 apenas para seções mapeadas para tickets selecionados. feature-conformance referencia este manifesto; não cria outro.

Para cada raiz de UI fornecida, invoque extract-figma-visuals antes da dispatch e passe seu pacote validado para os trabalhadores aplicáveis. Uma fonte fornecida do Jira, Figma ou documento de design que permaneça ilegível após verificações de acesso e tentativas materialmente diferentes bloqueia apenas o ticket afetado. Nunca substitua conteúdo desatualizado, um mock recriado ou requisitos adivinhados.

Estabeleça estado de execução

Antes da dispatch:

  1. Crie ou continue uma meta para o trabalho do épico selecionado. Mantenha-a ativa enquanto qualquer ticket tiver trabalho recuperável ou independente.
  2. Inspecione orientações do repositório, status atual, worktrees, branches de ticket, PRs abertos, regras de código gerado e comandos de verificação documentados. Para um PR existente, identifique sua worktree de origem e o motivo se essa worktree estiver inutilizável. Para trabalho em camada cruzada, resolva a configuração de lançamento composta documentada dos repositórios participantes em sua topologia de processo completa: cada comando, argumento, diretório de trabalho, fonte de ambiente, ordem de dependência, porta, sonda de saúde/recurso, etapa de migração/fixture, etapa de geração de cliente, definição de runtime e comando Android Patrol. Passe a worktree selecionada, comandos de verificação e topologia resolvida para o agente de implementação. Um composto de IDE documentado no repositório é uma definição de topologia, não uma instrução para invocar a IDE.
  3. Resolva tickets e dependências através da interface autenticada do tracker selecionado, então execute retomada/reconciliação de fonte. Jira usa Jira MCP; uma execução do GitHub ou lista explícita preserva seu próprio escopo e autoridade de status.
  4. Extraia e valide pacotes do Figma aplicáveis. Crie o manifesto único de documento de design quando fornecido.
  5. Invoque feature-conformance em modo de pré-voo. Repare erros de esquema ou mapeamento gerados pelo agente e execute novamente; não os apresente como bloqueadores de ticket.
  6. Resolva o diretório de tarefa explícito ou raiz de tarefa configurada. Use recibos indexados imutáveis conforme descrito abaixo. Crie um ledger ignorado, decision-log.md e os caches reconstruíveis resume-state.json e source-index.json. Jira, Git, PRs, manifestos atuais e leituras de fonte atual permanecem autoritativos quando os caches estão ausentes ou desatualizados.
  7. Construa a tabela de dependência e registre proprietário, escopo selecionado e camadas inalteradas, superfície de escrita adotada ou nova, alvo do PR, mapeamentos de fonte, linhas de contrato, decisões do orquestrador, portão de evidência, estado de lease de runtime canônico, estado de recuperação e estado final. Quando a coordenação via Slack estiver habilitada, registre também seu run_id, canal, timestamp do thread, permalink e estado de coordenação atual no nível da execução.

Use estados de máquina canônicos em snake_case: ready, waiting, resume_required, resume_needs_lineage, resume_source_missing, active, source_update_detected, reconciliation_active, correction_active, needs_product_decision, locally_verified, submitted, submitted_verified e blocked.

Preserve registros indexados e prova

index.json é autoritativo para artefatos de tarefa. Registre recibos de contrato como feature-contract (design.contract), conformidade como feature-conformance (review.conformance), bloqueadores propostos como delivery-disposition (delivery.disposition) e recibos de submissão verificada como submission-closure (delivery.closure). Aloque uma nova iteração imutável para cada revisão durável, vinculando seu caminho/hash exato do JSON snapshot, ticket, cabeça da fonte e registro de contrato/revisão relevante. Selecione e valide com digestão os registros atuais antes de usá-los; índices inválidos nunca recorrem a escaneamentos. Use o auxiliar de artefato de tarefa opcional adjacente ou as convenções manuais exatas. Apenas tarefas legadas genuinamente não indexadas usam registros numerados.

O ledger de execução, inventário de retomada e índice de fonte são caches operacionais reconstruíveis, não substitutos para recibos de aceitação ou revisão imutáveis. Pacotes visuais brutos e capturas permanecem evidência local excluída. O corpo do PR do GitHub, comentário de evidência distinto, captura hospedada direta e leitura de volta da cabeça atual permanecem autoridade de publicação; nunca enfraqueça hooks de publicação instalados ou requisitos de prova de linha de base/atual.

Isole e empilhe trabalho de ticket

Dê a cada agente de implementação ativo uma worktree e branch exclusiva em cada repositório que ele modificar. Nunca compartilhe um checkout mutável ou descarte alterações interrompidas.

  • Adote a fonte selecionada para tickets In Progress e Code Review, incluindo uma worktree suja cujas alterações pertencem a esse ticket.
  • Crie novo trabalho apenas para tickets elegíveis sem trabalho adotado.
  • Crie uma branch dependente a partir da cabeça remota verificada submetida de seu pré-requisito.
  • Direcione um PR dependente para essa branch de pré-requisito para que o PR contenha apenas o delta do seu ticket. Registre a ancestralidade empilhada.
  • Reutilize uma branch fonte de PR de correção existente e o PR. Recrie apenas um checkout exato dessa branch quando sua worktree antiga for inutilizável.
  • Nunca reset, limpe, stash, force-push ou reescreva trabalho interrompido meramente para simplificar a configuração.
  • Sequencie superfícies de escrita sobrepostas ou crie uma branch de ticket de integração dedicada.

Uma branch de pré-requisito submetida é suficiente para implementação downstream, verificação local e submissão.

Nota: O conteúdo foi truncado na versão original; a tradução segue a estrutura fornecida.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas