getedgehq/workplan

Habilidade de Plano de Trabalho

Os planos de trabalho são arquivos markdown com timestamp que sobrevivem à compactação automática. Eles são seu cérebro externo para trabalhos com várias etapas.

Convenção de Arquivos

• Localização: Raiz do projeto, no .gitignore
• Nome: WORKPLAN-AAAAMMDD-slug.md (exemplo: WORKPLAN-20260228-auth-refactor.md)
• Um arquivo por tarefa/fase. Não reutilize planos de trabalho antigos. Comece do zero para cada esforço distinto.

Ações

Criar (/workplan ou /workplan create)

1. Leia primeiro. Antes de escrever o plano, leia todos os arquivos, issues e contexto relevantes.

2. Certifique-se de que .gitignore inclui WORKPLAN-*.md (adicione se estiver faltando).

3. Escolha um modo de escopo antes de escrever o plano:

   • EXPANSION: "Qual é a versão 10 estrelas?" Sonhe grande, expanda o escopo.
   • HOLD: "Torne isso à prova de balas." Escopo está correto, maximize o rigor.
   • REDUCTION: "Qual é o mínimo que entrega valor?" Corte impiedosamente.

   Padrões: funcionalidade greenfield = EXPANSION, correção de bug / preparação para lançamento = HOLD, com restrição de tempo = REDUCTION.

4. Crie o arquivo com este modelo:

# Plano de Trabalho: [Título]

Criado: AAAA-MM-DD HH:MM
Última atualização: AAAA-MM-DD HH:MM
Status: EM ANDAMENTO
Modo: HOLD / EXPANSION / REDUCTION

## Contexto

[Por que este trabalho existe. O problema. Causa raiz. Restrições principais. Links para issues/PRs.]

## Roteiro

- [ ] 1. Descrição da etapa
- [ ] 2. Descrição da etapa
- [ ] 3. Descrição da etapa

## Decisões

[Registre decisões arquiteturais ou de abordagem com timestamps]
- [HH:MM] Escolhemos X em vez de Y porque Z

## Problemas Descobertos

[Coisas encontradas ao longo do caminho que não estavam no escopo original]
- [HH:MM] Encontrado ... enquanto trabalhava na etapa 2

## Registro de Verificação

[Cada item concluído recebe uma entrada de verificação]
- [HH:MM] Etapa 1: VERIFICADO - executei `npm test`, todos os 42 testes passam
- [HH:MM] Etapa 3: VERIFICADO - testei manualmente o fluxo de login, funciona com OAuth e email

Atualizar (/workplan update)

1. Leia o(s) arquivo(s) WORKPLAN-*.md ativo(s) na raiz do projeto.
2. Atualize o timestamp "Última atualização".
3. Marque itens concluídos com timestamps de verificação.
4. Adicione quaisquer novas descobertas ou decisões.
5. Relate o status atual ao usuário.

Encerrar (/workplan close)

1. Leia o plano de trabalho ativo.
2. Verifique se TODOS os itens estão marcados com timestamps de verificação.
3. Execute verificação final (build, testes, verificações manuais).
4. Mude o status para CONCLUÍDO.
5. Adicione um resumo final:

## Concluído

Encerrado: AAAA-MM-DD HH:MM
Todos os N itens implementados e verificados. Build passa. Testes passam.

Retomar (após compactação)

Quando o contexto foi compactado ou você não tem certeza de onde parou:

1. Encontre planos de trabalho ativos: procure por WORKPLAN-*.md na raiz do projeto.
2. Leia o arquivo de plano de trabalho.
3. Identifique o primeiro item não marcado.
4. Continue a partir daí.

Regras

1. VERIFICADO significa testado. Não "acho que funciona." Execute, veja passar, depois marque como verificado. Inclua o que foi executado e o resultado.
2. Atualize timestamps a cada mudança. Seu eu futuro (pós-compactação) depende disso.
3. Novas descobertas vão imediatamente. Não as mantenha apenas no contexto.
4. Nunca delete o plano até que o usuário confirme que o trabalho está concluído.
5. Um item por item da lista de verificação. Divida etapas grandes em peças menores verificáveis.
6. Se uma etapa falhar na verificação, registre a falha, mantenha-a desmarcada, adicione o que deu errado.