Task Master AI

Taskmaster AI - Gerenciador de Projetos para Agentes de IA

Sobre

O Taskmaster AI é uma ferramenta open-source de gerenciamento de tarefas voltada para desenvolvimento orientado por agentes de IA. Seu principal objetivo é decompor projetos complexos em tarefas granulares, bem definidas e com dependências claras, mantendo o agente de IA focado e evitando sobrecarga de contexto durante a execução.

Criado por Eyal Toledano, o projeto ganhou mais de 15.500 estrelas no GitHub em menos de 9 semanas, evidenciando forte adoção pela comunidade de desenvolvimento AI-nativo.

---

Problema que Resolve

Em projetos de grande porte, agentes de IA tendem a perder contexto ao longo da execução, gerando código inconsistente, retrabalho e erros difíceis de rastrear. O Taskmaster age como um “Scrum Master para IA”, fornecendo um plano estruturado que o agente pode seguir tarefa por tarefa, sem desvios.

---

Conceitos Fundamentais

PRD (Product Requirements Document)

O PRD é o ponto de entrada do Taskmaster. Trata-se de um documento de requisitos que descreve o projeto em linguagem natural. A partir dele, o Taskmaster gera automaticamente uma lista estruturada de tarefas.

• Deve ser salvo em .taskmaster/docs/prd.txt
• Um template de exemplo é criado automaticamente após o comando init
• Quanto mais detalhado o PRD, melhor a qualidade das tarefas geradas

Tarefas e Subtarefas

Cada tarefa possui metadados como status, dependências e nível de complexidade. Tarefas podem ser decompostas em subtarefas para maior granularidade.

Modelos de IA (Roles)

O Taskmaster suporta configuração de três papéis de modelo:

• main: modelo principal para geração e atualização de tarefas
• research: modelo para consultas externas e pesquisa contextual
• fallback: usado caso o principal ou o de pesquisa falhe

---

Instalação

# Instalação global
npm install -g task-master-ai
 
# OU instalação local no projeto
npm install task-master-ai

Inicialização de novo projeto

task-master init

O comando solicita detalhes do projeto e cria a estrutura de diretórios necessária.

---

Provedores de IA Suportados

A ferramenta é compatível com múltiplos provedores via chaves de API configuradas no arquivo .env:

Provedor	Variável de Ambiente
Anthropic	ANTHROPIC_API_KEY
OpenAI	OPENAI_API_KEY
Google Gemini	GOOGLE_API_KEY
Perplexity	PERPLEXITY_API_KEY
Mistral	MISTRAL_API_KEY
xAI	XAI_API_KEY
Azure OpenAI	AZURE_OPENAI_API_KEY

Nota: Ao usar Claude Code CLI com OAuth, nenhuma chave de API é necessária.

---

Integração via MCP (Model Control Protocol)

O Taskmaster disponibiliza suas ferramentas via MCP, permitindo uso direto dentro de editores como Cursor, Windsurf, Lovable e Roo, sem sair do ambiente de desenvolvimento.

Modos de ferramentas disponíveis

Modo	Qtd. de Ferramentas	Descrição
core	~9	Funções essenciais, menor uso de tokens
standard	15	Funções principais + análise e geração
all	36	Conjunto completo incluindo tags e pesquisa

Recomendação: novos usuários devem começar com standard.

---

Comandos Principais (CLI)

# Parsear um PRD e gerar tarefas
task-master parse-prd .taskmaster/docs/prd.txt
 
# Listar tarefas
task-master list
 
# Ver próxima tarefa recomendada
task-master next
 
# Marcar tarefa como concluída
task-master set-status --id=3 --status=done
 
# Atualizar tarefas a partir de uma mudança de decisão
task-master update --from=4 --prompt="Agora usamos MongoDB ao invés de PostgreSQL"
 
# Analisar complexidade das tarefas
task-master analyze-complexity
 
# Gerar relatório de complexidade
task-master complexity-report

---

Fluxo de Trabalho Típico

1. Escrever um PRD detalhado em .taskmaster/docs/prd.txt
2. Executar task-master parse-prd para gerar a lista de tarefas
3. Consultar a próxima tarefa com task-master next
4. Implementar a tarefa no editor com auxílio do agente de IA
5. Marcar como concluída e avançar para a próxima
6. Usar task-master update para propagar mudanças de decisão em tarefas futuras

---

Licença

Distribuído sob a licença MIT com Commons Clause. É permitido uso, modificação e distribuição, mas não a venda do software como produto autônomo.

---

Referências

• Site oficial: https://www.task-master.dev/
• Repositório GitHub: https://github.com/eyaltoledano/claude-task-master
• Pacote npm: https://www.npmjs.com/package/task-master-ai
• Tutorial oficial: https://github.com/eyaltoledano/claude-task-master/blob/main/docs/tutorial.md
• CLI alternativa (taskmaster-cli): https://github.com/RajaRakoto/taskmaster-cli