Implementar Rastreamento

Execute tarefas do plano de implementação de um rastreamento, seguindo as regras de fluxo de trabalho definidas em conductor/workflow.md.

Use esta habilidade quando

• Trabalhando em tarefas ou fluxos de trabalho de rastreamento de implementação
• Precisando de orientação, melhores práticas ou listas de verificação para rastreamento de implementação

Não use esta habilidade quando

• A tarefa não estiver relacionada ao rastreamento de implementação
• Você precisar 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 etapas acionáveis e verificação.

Verificações Pré-voo

1. Verifique se o Conductor está inicializado:

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

2. Carregue a configuração do fluxo de trabalho:

   • Leia conductor/workflow.md
   • Analise o nível de rigor do TDD
   • Analise a estratégia de commit
   • Analise as regras de ponto de verificação de validação

Seleção de Rastreamento

Se um argumento for fornecido:

• Valide se o rastreamento existe: conductor/tracks/{argument}/plan.md
• Se não encontrado: Procure por correspondências parciais, sugira correções

Se nenhum argumento for fornecido:

1. Leia conductor/tracks.md

2. Analise para rastreamentos incompletos (status [ ] ou [~])

3. Exiba o menu de seleção:

   Select a track to implement:
   
   In Progress:
   1. [~] auth_20250115 - User Authentication (Phase 2, Task 3)
   
   Pending:
   2. [ ] nav-fix_20250114 - Navigation Bug Fix
   3. [ ] dashboard_20250113 - Dashboard Feature
   
   Enter number or track ID:
   

Carregamento de Contexto

Carregue todo o contexto relevante para a implementação:

1. Documentos do rastreamento:

   • conductor/tracks/{trackId}/spec.md - Requisitos
   • conductor/tracks/{trackId}/plan.md - Lista de tarefas
   • conductor/tracks/{trackId}/metadata.json - Estado do progresso

2. Contexto do projeto:

   • conductor/product.md - Entendimento do produto
   • conductor/tech-stack.md - Restrições técnicas
   • conductor/workflow.md - Regras do processo

3. Estilo de código (se existir):

   • conductor/code_styleguides/{language}.md

Atualização de Status do Rastreamento

Atualize o rastreamento para em andamento:

1. Em conductor/tracks.md:

   • Altere [ ] para [~] para este rastreamento

2. Em conductor/tracks/{trackId}/metadata.json:

   • Defina status: "in_progress"
   • Atualize o carimbo de data/hora de updated

Loop de Execução de Tarefas

Para cada tarefa incompleta em plan.md (marcada com [ ]):

1. Identificação da Tarefa

Analise plan.md para encontrar a próxima tarefa incompleta:

• Procure por linhas que correspondam a - [ ] Task X.Y: {description}
• Rastreie a fase atual a partir da estrutura

2. Início da Tarefa

Marque a tarefa como em andamento:

• Atualize plan.md: Altere [ ] para [~] para a tarefa atual
• Anuncie: "Iniciando Tarefa X.Y: {descrição}"

3. Fluxo de Trabalho TDD (se TDD habilitado em workflow.md)

Fase Vermelha - Escreva Teste Falho:

Following TDD workflow for Task X.Y...

Step 1: Writing failing test

• Crie o arquivo de teste, se necessário
• Escreva o(s) teste(s) para a funcionalidade da tarefa
• Execute os testes para confirmar que eles falham
• Se os testes passarem inesperadamente: PARE, investigue

Fase Verde - Implemente:

Step 2: Implementing minimal code to pass test

• Escreva o código mínimo para fazer o teste passar
• Execute os testes para confirmar que eles passam
• Se os testes falharem: Depure e corrija

Fase de Refatoração:

Step 3: Refactoring while keeping tests green

• Limpe o código
• Execute os testes para garantir que ainda estão passando

4. Fluxo de Trabalho Não-TDD (se TDD não for rigoroso)

• Implemente a tarefa diretamente
• Execute quaisquer testes existentes
• Verificação manual conforme necessário

5. Conclusão da Tarefa

Faça commit das alterações (seguindo a estratégia de commit de workflow.md):

git add -A
git commit -m "{commit_prefix}: {task description} ({trackId})"

Atualize plan.md:

• Altere [~] para [x] para a tarefa concluída
• Faça commit da atualização do plano:

git add conductor/tracks/{trackId}/plan.md
git commit -m "chore: mark task X.Y complete ({trackId})"

Atualize metadata.json:

• Incremente tasks.completed
• Atualize o carimbo de data/hora de updated

6. Verificação de Conclusão de Fase

Após cada tarefa, verifique se a fase está completa:

• Analise plan.md para a estrutura da fase
• Se todas as tarefas na fase atual estiverem [x]:

Execute a verificação da fase:

Phase {N} complete. Running verification...

• Execute as tarefas de verificação listadas para a fase
• Execute o conjunto completo de testes: npm test / pytest / etc.

Relate e aguarde aprovação:

Resultados da Verificação da Fase {N}:
- Todas as tarefas da fase: Concluídas
- Testes: {passando/falhando}
- Verificação: {aprovada/reprovada}


…