aitormf/agent-skills

Divide um plano técnico aprovado em pequenas tarefas, ordenadas por dependências, com arquivos afetados, verificação por tarefa e grupos paralelos. Use quando houver um plano e alguém pedir para dividi-lo em tarefas ou prepará-lo para implementação.

O que é agent-skills?

Esta skill transforma um plano técnico ou especificação aprovada em uma lista executável de tarefas, pronta para ser seguida pelo agente `implement`. Ela organiza cada item de trabalho em `docs/specs/<YYYYMMDD>-<type>-<name>/` e atualiza `tasks.md` com checkboxes `[x]` para marcar progresso. O processo inclui uma verificação de gate: se o plano não tiver `status: approved`, a skill solicita autorização antes de prosseguir. Durante a divisão, as tarefas são pequenas, ordenadas por dependências, sinalizadas com `[P]` para paralelismo, e cada uma lista os arquivos afetados e como será verificada (testes ou comandos). A skill também exige uma fase de *Wrap-up* obrigatória com critérios de aceitação e comandos de verificação, garantindo que nenhum trabalho extra seja adicionado. É ideal para desenvolvedores que usam agentes como Claude Code, Cursor ou Codex, pois prepara o terreno para implementação estruturada e revisável.

Funciona com~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/aitormf/agent-skills/tree/HEAD/skills/plan-to-tasks

Documentação

Do plano para as tarefas

Transforme um plano em uma lista de tarefas executável que o agente implement possa seguir e marcar.

Cada item de trabalho reside em docs/specs/<YYYYMMDD>-<tipo>-<nome>/.
tasks.md não tem status: seu progresso é indicado pelos checkboxes [x].

Antes de começar

Identifique o item de trabalho e leia plan.md e spec.md.
Gate: se o plano não tiver status: approved, pare e pergunte:

O plano está <status>. Devo continuar mesmo assim, revisá-lo primeiro com review-spec, ou você vai aprová-lo agora?

Continue apenas com uma resposta explícita. Para uma alteração pequena sem plano, o gate se aplica à especificação.
Leia o comando de verificação na seção Commands de AGENTS.md (Comandos em projetos em espanhol). Se não houver, pergunte qual é ou deixe a tarefa de encerramento com um aviso.

Como dividir

Tarefas pequenas: cada uma é uma alteração revisável que mantém o projeto funcional.
Ordenadas por dependências. Marque com [P] aquelas que podem ser feitas em paralelo com a anterior.
Cada tarefa lista os arquivos que toca, se conhecidos, e como é verificada: qual teste ou qual comando.
Se o projeto trabalha com TDD (CONTRIBUTING.md ou AGENTS.md dirão), o teste vem antes do código ou na mesma tarefa, nunca no final.
Todo critério de aceitação da especificação e todo teste negativo de Segurança deve ser coberto por pelo menos uma tarefa. Se um não estiver, informe.
A fase Wrap-up é obrigatória: critérios de aceitação com testes e o comando de verificação bem-sucedido.
Não adicione trabalho que não esteja no plano. Se algo estiver faltando no plano, levante como uma pergunta.

Resultado

Elabore tasks.md a partir de assets/tasks-template.md.
Mostre o rascunho com:
- as tarefas;
- os grupos paralelos;
- os pontos de verificação;
- quaisquer perguntas restantes.
Escreva-o somente quando a pessoa aprovar.
Próximo passo sugerido: implementar com o agente implement.