O responsável pelo produto deixa um comentário: “A atribuição automática ainda não está disponível”. Fácil de corrigir? Só se a promessa aparecer uma vez. Em um tutorial real, ela também pode estar no título, na abertura, nas instruções de tela e na recapitulação.
Usaremos o Claude Code para revisar um tutorial existente de caixa de entrada de equipe como uma pequena mudança de projeto. O Kabo, um agente de IA para pesquisa de criadores, pode ser instalado como plugin do Claude Code e ajuda quando a correção deixa uma lacuna na explicação. Os fatos atuais do produto continuam vindo dos nossos próprios materiais aprovados. Para um primeiro rascunho baseado em imagens, comece pelo guia de roteiro do Codex.
1. Transforme a correção em uma solicitação de mudança revisável
Nosso exemplo elaborado começa com um rascunho antigo que promete uma passagem automática. O fato atualizado diz que o espectador deve atribuir um responsável manualmente. Ainda é possível ensinar uma ação útil; a promessa e a demonstração precisam corresponder a ela.
Salve a nota curta abaixo como change-request.md. Isso explicita a correção antes de o Claude Code pesquisar o projeto.
Correção aprovada: A atribuição automática não está disponível nesta versão. Ação suportada: Um usuário atribui manualmente o responsável pela conversa. Manter: A aula sobre tornar a responsabilidade visível para a equipe. Verificar: Título, promessa inicial, ações de demonstração, recapitulação e notas de gravação. Fonte da aprovação: [documento atual do produto / revisor].
Reúna o rascunho aprovado e a correção
Não há rascunho existente? Comece pela lista de ações gravadas com a instrução abaixo, revise o roteiro resultante e aplique o processo de correção quando os fatos mudarem. O guia de roteiro que parte das imagens aprofunda a escolha desses materiais.
[ ] drafts/script-v1.md — Narração existente, IDs de momentos e instruções de tela. [ ] product-facts.md — Comportamento atualmente suportado; itens planejados identificados à parte. [ ] change-request.md — Correção exata, fonte e pessoa que a aprovou. [ ] voice.md — Exemplo de escrita aprovado e nível do público. [ ] recording-plan.md — Ambiente de demonstração, tomadas gravadas e telas ainda disponíveis. [ ] claims.md — Afirmações do roteiro ligadas aos fatos aprovados; criar se faltar. [ ] title-caption.md — Texto de apresentação a verificar junto com o roteiro.
Leia product-facts.md, recording-plan.md e voice.md. Usando as ações gravadas do espectador na ordem fornecida, escreva drafts/script-v1.md com IDs estáveis de momentos, falas, instruções de tela e referências aos fatos aprovados. Marque como lacuna de gravação qualquer ação não sustentada pela demonstração. Crie claims.md a partir das promessas factuais do rascunho. Não sugira que funções planejadas já estão disponíveis.
2. Encontre os trechos dependentes antes de alterar as falas
Abra o Claude Code no projeto. Peça que examine os arquivos fornecidos e retorne uma lista de impacto com IDs de momentos e motivos. Uma correspondência de palavras é o ponto de partida: “a próxima pessoa vê quem é responsável” pode continuar verdadeiro, enquanto “o sistema escolhe a próxima pessoa” depende da função removida.
Revise a lista. Mantenha os pontos de ensino válidos em vez de apagar todas as frases sobre atribuição.
Leia change-request.md e product-facts.md, depois examine drafts/script-v1.md, claims.md, title-caption.md e recording-plan.md. Retorne uma lista de impacto: arquivo, momento ou trecho, dependência do fato corrigido, manter ou mudar ou perguntar e motivo. Inclua promessas implícitas, não só correspondências exatas de palavras. Ainda não edite.
3. Aprove uma alteração focada e uma lista de regravações
Uma mudança ilustrativa troca “A caixa de entrada atribui o responsável por você” por “Escolha o colega que cuidará desta conversa”. A instrução de tela agora deve mostrar o controle manual. Se a abertura prometia um sistema sem intervenção, atualize essa promessa também.
Peça ao Claude Code que salve um novo rascunho e explique os momentos alterados. Tomadas gravadas que ainda demonstram o comportamento errado devem entrar na lista de regravação; corrigir um arquivo Markdown não as conserta.
Aplique apenas as decisões de impacto que aprovei. Escreva drafts/script-v2.md e changes.md com o trecho antigo e o novo, ID do momento e fato de apoio. Atualize ações de tela e title-caption.md apenas onde dependerem da correção. Preserve o original aprovado. Produza rerecord.md com tomadas afetadas e capturas de tela ausentes; não afirme que os arquivos de vídeo foram editados.
Conecte o Kabo quando a reescrita precisar de pesquisa de referências
Abra o projeto de conteúdo, instale o Kabo para Claude Code e conclua o login. Para uma conexão direta ao servidor, siga o guia de configuração.
4. Use referências se a etapa manual precisar de uma explicação mais clara
Se houver dificuldade para explicar a importância da responsabilidade manual, use o Kabo para examinar escolhas didáticas em tutoriais públicos. Guarde URLs reais e notas curtas de evidências. Uma referência pode sugerir mostrar estados não atribuídos e atribuídos lado a lado, mas não comprova os controles disponíveis no nosso produto.
Se a correção já estiver clara, pule esta pesquisa. Para um estudo mais amplo, siga o guia de pesquisa do Claude Code.
Use o Kabo para uma pequena pesquisa de referências sobre como explicar a atribuição manual de responsáveis por conversas. Relate escolhas de explicação relevantes com fontes reais e limites das evidências. Sugira uma forma de esclarecer nosso momento corrigido usando as telas de recording-plan.md. Trate product-facts.md como autoridade para nossas afirmações de funções; não reabra seções de roteiro sem relação.
5. Entregue um pacote de gravação em que o editor possa confiar
Peça ao produtor que abra script-v2.md junto com changes.md e rerecord.md. Confira se o estado com responsável atribuído está visível e se a abertura promete a aula que realmente ensinamos. Mantenha uma versão aprovada clara para que a tomada antiga não volte à edição.
Use o Descript ou seu editor habitual para substituir a gravação afetada. Para um problema de voz restrito às primeiras falas, o guia de Hook do Claude Code foca a abertura falada.
Compare script-v2.md, title-caption.md e recording-plan.md com a correção aprovada. Liste promessas restantes de atribuição automática, instruções de tela incompatíveis ou tomadas ainda a substituir. Confira se os momentos não alterados continuam intactos. Retorne pendências para aprovação do produtor; não publique.
Os exemplos desenvolvidos são ilustrativos. As capturas do produto mostram resultados existentes do Kabo na web, não uma execução do exemplo deste guia. Use seus próprios materiais e as evidências retornadas na sua tarefa.