Repository navigation
Skill tab_pendencias
Esta página explica a skill /tab_pendencias de forma didática. Se algum termo for novo, consulte o Glossário.
A /tab_pendencias cria e mantém uma tabela de tarefas (o que falta fazer no projeto), ordenada de cima para baixo na melhor sequência para evitar retrabalho. O nome significa "tabela de pendências".
O diferencial: a ordem das linhas já é a ordem recomendada de execução. E tarefas que podem ser feitas ao mesmo tempo aparecem agrupadas em uma "onda".
A tabela é gravada sempre no arquivo TODO.md, na raiz do projeto.
Use quando pensar em frases como:
- "O que ainda falta fazer aqui?"
- "Em que ordem devo fazer as coisas?"
- "Planejar os passos do projeto."
- "Organizar o backlog (a lista de tarefas)."
- "Reordenar para perder menos tempo com retrabalho."
Dentro do Claude Code, use uma das opções:
/tab_pendencias --create
/tab_pendencias --show
/tab_pendencias --main
/tab_pendencias --reorder
/tab_pendencias --add_tests_audit
O que cada opção faz:
-
--create: cria a tabela do zero, a partir das tarefas que você listar. -
--show: mostra a tabela completa, inclusive o que já foi concluído. -
--main: mostra só o que ainda falta (esconde o que já terminou). -
--reorder: recalcula a ordem quando novas tarefas entram ou as dependências mudam. -
--add_tests_audit: acrescenta itens de testes e auditoria que faltavam no planejamento.
Você também pode falar em português: "o que falta" leva ao --main; "criar tabela" leva ao --create; "reordenar" leva ao --reorder.
A skill usa dois critérios combinados, explicados no Glossário:
- Ordenação topológica: nada aparece antes daquilo de que depende. Se a tarefa B precisa da A pronta, A vem antes.
- WSJF (menor trabalho ponderado primeiro): dentro do que é possível fazer, sobe o que entrega mais valor por menos esforço. O efeito prático: as decisões de base e as difíceis de reverter sobem ao topo, porque errar nelas custa o retrabalho mais caro.
Depois, a skill agrupa em ondas (W1, W2, W3): tarefas da mesma onda não dependem umas das outras e têm valor parecido, então podem ser feitas em paralelo.
Cada tarefa vira uma linha com estas informações:
| Coluna | O que indica |
|---|---|
| ID | um código curto para a tarefa |
| Onda | grupo de tarefas paralelizáveis (W1, W2, ...) |
| Grupo | a área da tarefa |
| Descrição | o que precisa ser feito |
| Prioridade | Alta, Média ou Baixa |
| Pré-requisito | o que precisa estar pronto antes |
| Dificuldade | Alta, Média ou Baixa |
| Status | pendente, em andamento, concluído, e assim por diante |
| Estado Auditado | se já passou por revisão de qualidade |
Uma tabela só ajuda enquanto reflete a realidade. Manter esse "frescor" é barato e quase todo manual: não precisa acionar o time de agentes a cada passo. Quatro hábitos simples bastam.
1. Ao fechar ou avançar um item, registre no commit. Quando você termina um trabalho que conclui ou faz progredir uma linha da tabela, cite o ID do item (por exemplo, V-12) na mensagem do commit e atualize a coluna Status dessa linha no mesmo commit. Assim o código e a tabela andam juntos, e quem ler o histórico entende o que cada commit fechou. Isso é manual e leve: não dispara a equipe de agentes.
2. O Status segue um caminho. Entregar a implementação não é o fim. O Status percorre uma sequência:
-
🔍 Pendente verificação: a implementação foi entregue, mas ainda não passou por teste ou auditoria. -
✅ Concluído: só depois da onda de teste e auditoria confirmar que está correto.
Ou seja, assim que você termina de implementar, marque 🔍 Pendente verificação; o ✅ Concluído fica reservado para quando a verificação acontecer. Isso evita dar por pronto algo que ninguém revisou ainda.
3. Trabalho novo no meio do caminho vai para a INBOX. Quando surge uma tarefa nova enquanto você está focado em outra, não pare para repriorizar tudo. Anote-a em uma linha de INBOX no fim do TODO.md e siga o que estava fazendo. A INBOX é a caixa de entrada da tabela: um lugar para não perder a ideia sem quebrar o seu ritmo. Mais tarde, o /tab_pendencias --reorder integra esses itens na ordem certa.
4. Reordenar é a parte cara, use com critério. Recalcular a ordem das linhas (/tab_pendencias --reorder) exige julgamento e pode acionar o time de agentes em tabelas grandes. Por isso, reordene só quando uma prioridade real mudar: surgiu uma dependência nova, a INBOX acumulou itens, ou apareceu algo urgente. No dia a dia, os passos 1 a 3 mantêm a tabela viva sem esse custo.
Um cuidado importante da skill: ela garante que testes e auditoria (revisão de qualidade) estejam no planejamento, porque eles fazem parte do "trabalho terminado" (a definição de pronto).
Duas regras de ordem que ela respeita sempre:
- O teste unitário anda junto com o código (ele é escrito antes ou ao mesmo tempo, pela disciplina de TDD), então não vira uma tarefa separada na tabela.
- Os demais testes (integração, ponta a ponta, segurança) e as auditorias vêm depois do que eles verificam, nunca antes. Auditar algo que ainda não foi feito não faz sentido.
Se faltarem esses itens, a skill pergunta antes de acrescentar (ela nunca faz isso em silêncio), com forte recomendação a favor.
O catálogo de auditorias usado pela skill ganhou uma coluna Ferramentas: para cada tema de auditoria, ela já indica as ferramentas típicas adequadas ao tipo de projeto. Por exemplo, a auditoria de cobertura de testes (AUD-COV) sugere lcov/gcov para projetos em C e C++, coverage.py/pytest-cov para Python, e os equivalentes de cada tecnologia. Assim, quando uma auditoria entra na tabela, você já sabe com que ferramenta começar, sem precisar pesquisar. As ferramentas são sugestões úteis; a escolha final continua sendo sua.
A skill se ajusta ao tamanho. Para uma tabela pequena (até cerca de 8 itens, projeto pessoal), ela mesma faz a ordenação, sem acionar um time de agentes. Para uma tabela grande e cheia de dependências cruzadas, ela aciona um time coordenado pelo Cosmo (COO) para olhar cada item por uma lente diferente (dependência técnica, valor de negócio, esforço, sequenciamento) e consolidar a ordem final.
Você digita:
/tab_pendencias --create
O que acontece:
- A skill coleta as tarefas (suas, ou de um documento que você indicar).
- Pergunta o essencial: onde gravar (sugere
TODO.mdna raiz) e o título do projeto. - Detecta a tecnologia do projeto e calcula quais testes e auditorias se aplicam.
- Ordena tudo pelo método (dependência, depois valor) e agrupa em ondas.
- Escreve a tabela no
TODO.md, com as linhas já na ordem de execução.
Depois, quando novas tarefas surgirem, você roda /tab_pendencias --reorder para reencaixar tudo na melhor ordem, sem perder o que já estava marcado como concluído.
- A /bigtech e a /proj_software usam a
/tab_pendenciascomo a tabela oficial de planejamento do projeto.
Veja também o agente que coordena a ordenação quando a tabela é grande: Cosmo (COO). Voltar para a Home.