execute-task

Skill de Execução de Task

Pré-requisito

• T0x-PLAN.md deve existir para a task (ou a task deve estar listada no PLAN.md do slice)
• O slice deve estar na fase de execução

Processo

1. Orientar: Leia .spec/STATE.md para confirmar milestone, slice e task ativos
2. Contextualizar: Leia o plano da task e o PLAN.md do slice
3. Revisar dependências: Se há tasks anteriores no slice, leia seus T0x-SUMMARY.md
4. Implementar: Siga os must-haves do plano como checklist
5. Verificar: Rode os comandos de verificação do projeto
   • Se falhar, corrija e rode novamente (máximo 2 tentativas)
   • Se falhar após 2 tentativas, documente o problema no summary
6. Documentar: Escreva T0x-SUMMARY.md:

---
task: T0x
slice: S0x
milestone: M0xx
status: complete  # ou blocked
files_changed:
  - path/to/file1.ts
  - path/to/file2.ts
---

# Summary — T0x: [Título]

## O que foi feito
[Narrativa breve do que foi implementado]

## Must-haves verificados
- [x] Artifact: [arquivo criado/modificado]
- [x] Truth: [comportamento que funciona]
- [x] Link: [integração conectada]

## Verificação
- Lint: ✅ passou
- Testes: ✅ passou (ou ❌ com detalhes)

## Notas para tasks futuras
[Qualquer insight, risco ou decisão que afeta próximas tasks]

7. Commitar: git add . && git commit -m "tipo(M0xx/S0x): descrição — T0x"
8. Atualizar: Marcar [x] na task do PLAN.md
9. Estado: Atualizar .spec/STATE.md com a próxima task ou próximo slice

Gestão de Contexto entre Tasks

Após completar cada task e atualizar STATE.md:

• Se a próxima task é simples (1-3 arquivos, mesmo domínio): Use /compact para comprimir o contexto e continue na mesma sessão.

• Se a próxima task é complexa (domínio diferente, muitos arquivos): Instrua o usuário: "Recomendo /clear antes da próxima task para contexto limpo. O STATE.md vai me reorientar automaticamente."

• Se o slice acabou: Instrua o usuário: "Slice completo. Use /clear e depois /execute para iniciar o próximo slice com contexto fresco."

O STATE.md + T0x-SUMMARY.md são suficientes para reconstruir qualquer contexto perdido. Nunca dependa de informações que só existem na conversa — tudo deve estar no disco.

Interrupção e Retomada (continue.md)

Se a task for interrompida (sessão morreu, /clear prematuro, crash):

1. Antes de parar, crie .spec/milestones/M0xx/S0x/continue.md:

# Continue — T0x: [Título]

## Onde parei
[Passo X de Y do plano da task]

## O que já foi feito
- [mudança 1 — arquivo X]
- [mudança 2 — arquivo Y]

## O que falta
- [passo restante 1]
- [passo restante 2]

## Estado do código
- Lint: [passa/falha]
- Testes: [passam/falham — quais]
- Arquivos parcialmente implementados: [lista]

2. Ao retomar (/execute), verifique se continue.md existe no slice ativo. Se existir, leia e retome de onde parou. Delete continue.md ao concluir a task.

Bloqueio Descoberto (blocker_discovered)

Se durante a execução descobrir que o plano do slice é FUNDAMENTALMENTE inválido (API errada, capacidade ausente, incompatibilidade arquitetural):

1. Marque blocker_discovered: true no frontmatter do T0x-SUMMARY.md
2. Descreva o bloqueio claramente na narrativa do summary
3. NÃO marque a task como [x] — deixe como [ ]
4. Atualize STATE.md com o bloqueio
5. Informe: "Bloqueio descoberto. O plano do slice precisa ser revisado. Use /steer."

NÃO use blocker_discovered para bugs comuns, desvios menores ou issues corrigíveis. Apenas para quando o plano inteiro do slice não faz mais sentido.

Regras

• Uma task por vez. Não antecipe tasks futuras.
• Se descobrir que a task é maior do que o planejado, PARE e divida.
• Se encontrar problema que invalida o plano, use blocker_discovered.
• Se for interrompido, crie continue.md antes de sair.
• SEMPRE atualize STATE.md antes de sugerir /clear — é o mecanismo de recovery.