Reverter Trilha

Reverta alterações por unidade lógica de trabalho com total conhecimento do git. Suporta a reversão de trilhas inteiras, fases específicas ou tarefas individuais.

Use esta habilidade quando

• Trabalhando em tarefas ou fluxos de trabalho de reverter trilha
• Precisando de orientação, melhores práticas ou checklists para reverter trilha

Não use esta habilidade quando

• A tarefa não está relacionada a reverter trilha
• Você precisa de um domínio ou ferramenta diferente fora deste escopo

Instruções

• Clarifique objetivos, restrições e entradas necessárias.
• Aplique melhores práticas relevantes e valide os resultados.
• Forneça passos acionáveis e verificação.

Verificações Pré-voo

1. Verifique se o Conductor está inicializado:

   • Verifique se conductor/tracks.md existe
   • Se ausente: Exiba um erro e sugira executar /conductor:setup primeiro

2. Verifique o repositório git:

   • Execute git status para confirmar o repositório git

   • Verifique se há alterações não commitadas

   • Se houver alterações não commitadas:

     WARNING: Uncommitted changes detected
     
     Files with changes:
     {list of files}
     
     Options:
     1. Stash changes and continue
     2. Commit changes first
     3. Cancel revert
     

3. Verifique se o git está limpo o suficiente para reverter:

   • Nenhuma mesclagem em andamento
   • Nenhuma rebase em andamento
   • Se problemas forem encontrados: Pare e explique os passos de resolução

Seleção de Alvo

Se um argumento for fornecido:

Analise o formato do argumento:

Trilha completa: {trackId}

• Exemplo: auth_20250115
• Reverte todos os commits para a trilha inteira

Fase específica: {trackId}:phase{N}

• Exemplo: auth_20250115:phase2
• Reverte commits para a fase N e todas as fases subsequentes

Tarefa específica: {trackId}:task{X.Y}

• Exemplo: auth_20250115:task2.3
• Reverte apenas os commits para a tarefa X.Y

Se nenhum argumento for fornecido:

Exiba o menu de seleção guiada:

What would you like to revert?

Currently In Progress:
1. [~] Task 2.3 in dashboard_20250112 (most recent)

Recently Completed:
2. [x] Task 2.2 in dashboard_20250112 (1 hour ago)
3. [x] Phase 1 in dashboard_20250112 (3 hours ago)
4. [x] Full track: auth_20250115 (yesterday)

Options:
5. Enter specific reference (track:phase or track:task)
6. Cancel

Select option:

Descoberta de Commits

Para Reversão de Tarefa

1. Pesquise o log do git por commits específicos da tarefa:

   git log --oneline --grep="{trackId}" --grep="Task {X.Y}" --all-match
   

2. Encontre também o commit de atualização do plan.md:

   git log --oneline --grep="mark task {X.Y} complete" --grep="{trackId}" --all-match
   

3. Colete todos os SHAs de commit correspondentes

Para Reversão de Fase

1. Determine o intervalo de tarefas para a fase lendo o plan.md

2. Pesquise por todos os commits de tarefa nessa fase:

   git log --oneline --grep="{trackId}" | grep -E "Task {N}\.[0-9]"
   

3. Encontre o commit de verificação da fase, se existir

4. Encontre todos os commits de atualização do plan.md para as tarefas da fase

5. Colete todos os SHAs de commit correspondentes em ordem cronológica

Para Reversão de Trilha Completa

1. Encontre TODOS os commits que mencionam a trilha:

   git log --oneline --grep="{trackId}"
   

2. Encontre os commits de criação da trilha:

   git log --oneline -- "conductor/tracks/{trackId}/"
   

3. Colete todos os SHAs de commit correspondentes em ordem cronológica

Exibição do Plano de Execução

Antes de qualquer operação de reversão, exiba o plano completo:

================================================================================
                           PLANO DE EXECUÇÃO DE REVERSÃO
================================================================================

Alvo: {descrição do que está sendo revertido}

Commits a serem revertidos (em ordem cronológica inversa):
  1. abc1234 - feat: adicionar renderização de gráfico (dashboard_20250112)
  2. def5678 - chore: marcar tarefa 2.3 como concluída (dashboard_20250112)
  3. ghi9012 - feat: adicionar hooks de dados (dashboard_20250112)
  4. jkl3456 - chore: marcar tarefa 2.2 como concluída (dashboard_20250112)

Arquivos que serão afetados:
  - src/components/Dashboard.tsx (modificado)
  - src/hooks/useData.ts (será excluído - foi criado nestes commits)
  - conductor/tracks/dashboard_20250112/plan.md (modificado)

Atualizações do plano:
  - Tarefa 2.2: [x] -> [ ]
  - Tarefa 2.3: [~] -> [ ]

================================================================================
                              !! AVISO !!
================================================================================

Esta operação irá:
- Criar {N} commits de reversão
- Modificar {M} arquivos
- Resetar {P} tarefas para o status pendente

Isso NÃO pode ser facilmente desfeito sem intervenção manual.


…