Epics

Código Aberto — O GitScrum MCP Server é código aberto sob a licença MIT. Disponível no npm e no GitHub. Servidor Model Context Protocol para GitScrum — Claude, GitHub Copilot, Cursor e qualquer cliente compatível com MCP têm acesso operacional completo à sua stack de gerenciamento de projetos.

A ferramenta epic fornece 3 ações para gerenciar epics — a unidade organizacional de mais alto nível na hierarquia do seu projeto. Epics agrupam user stories e funcionalidades relacionadas em iniciativas estratégicas, dando à sua equipe uma visão clara dos objetivos em grande escala. Através do MCP Server, seu assistente de IA pode criar epics, atualizar seus detalhes e listar todos os epics dentro de um projeto.

Epics no GitScrum representam corpos significativos de trabalho que abrangem múltiplos sprints e contêm múltiplas user stories. Eles respondem à pergunta "em qual grande iniciativa estamos trabalhando?" enquanto user stories e tarefas tratam do "como" e "o que especificamente." O MCP Server torna possível construir e gerenciar toda essa hierarquia — epics → user stories → tarefas — através de conversas em linguagem natural.

Visão Geral das Ações

Listando Epics

A ação list retorna todos os epics dentro de um projeto específico. Cada epic na resposta inclui seu uuid, título, descrição, cor e metadados associados. Isso dá ao seu assistente de IA uma visão completa das iniciativas estratégicas do projeto.

Use esta ação para revisar o roadmap do projeto, identificar quais epics têm mais atividade ou verificar como o trabalho está distribuído entre os objetivos estratégicos.

Parâmetros Obrigatórios

Exemplos de Prompts

Você:  "Listar todos os epics no projeto Backend"
IA:    Chama epic action=list → retorna todos os epics com títulos, descrições e cores

Você:  "Quais são nossas iniciativas estratégicas atuais?"
IA:    Chama epic action=list → resume os epics do projeto como objetivos de alto nível

Você:  "Mostrar o roadmap do projeto"
IA:    Chama epic action=list → apresenta epics como marcos estratégicos

Criando Epics

A ação create constrói um novo epic em uma única chamada. Epics são intencionalmente leves — precisam de um título e podem opcionalmente incluir uma descrição e uma cor para identificação visual no quadro. A simplicidade reflete seu papel como containers estratégicos em vez de itens de trabalho no nível de tarefa.

Parâmetros Obrigatórios

Parâmetros Opcionais

Diretrizes de Cores

Epics aparecem como labels codificados por cor em toda a interface do GitScrum — no quadro Kanban, nas visualizações de sprint e nos relatórios. Escolher cores distintas para cada epic ajuda sua equipe a identificar visualmente a qual iniciativa estratégica uma tarefa pertence de relance.

Convenções comuns de cores:

Exemplos de Prompts

Você:  "Criar um epic 'Release Q1' com cor azul"
IA:    Chama epic action=create com title="Release Q1", color="3B82F6"

Você:  "Criar um epic chamado 'Reformulação da Autenticação' com descrição cobrindo
       metas de migração OAuth2, SSO e RBAC"
IA:    Chama epic action=create com title, description contendo detalhes do escopo

Você:  "Adicionar um novo epic para o redesign do app mobile, usar cor laranja"
IA:    Chama epic action=create com title="Redesign do Mobile App", color="F59E0B"

Você:  "Criar três epics para o Q1: Performance da API, Dashboard do Usuário e
       Integração de Pagamentos. Usar cores diferentes para cada."
IA:    Chama epic action=create três vezes com títulos e cores distintos

Atualizando Epics

A ação update modifica qualquer campo de um epic existente. Apenas os campos que você especifica são alterados — todos os outros campos permanecem inalterados. Isso é útil para refinar descrições de epics conforme o escopo evolui, alterar cores para reorganização visual ou renomear epics para melhor refletir sua direção atual.

Parâmetros Obrigatórios

Parâmetros Opcionais

Todos os parâmetros opcionais de create estão disponíveis em update: title, description, color.

Exemplos de Prompts

Você:  "Atualizar a descrição do epic Release Q1 para incluir o novo escopo de migração de API"
IA:    Encontra o epic via list → chama epic action=update com descrição expandida

Você:  "Mudar a cor do epic Reformulação da Autenticação para vermelho"
IA:    Chama epic action=update com color="EF4444"

Você:  "Renomear o epic 'Mobile App v2' para 'Redesign do Mobile App'"
IA:    Chama epic action=update com title="Redesign do Mobile App"

Você:  "Atualizar todos os epics para incluir datas estimadas de conclusão nas descrições"
IA:    Lista epics → atualiza cada um com descrições revisadas

Workflow de Planejamento Estratégico

Epics são mais eficazes quando usados como o topo de uma hierarquia de planejamento deliberada. Este workflow demonstra como construir uma estrutura completa de projeto desde iniciativas estratégicas até tarefas acionáveis.

1. Definir epics estratégicos

Comece estabelecendo as grandes iniciativas para o trimestre ou ciclo de release.

Você:  "Estamos planejando o Q1. Criar epics para: Performance da API (verde),
       Dashboard do Usuário (azul) e Integração de Pagamentos (roxo)"
IA:    Cria três epics com títulos descritivos e cores distintas

2. Adicionar escopo e critérios de sucesso

Refine cada epic com descrições detalhadas que esclareçam como é o "pronto".

Você:  "Atualizar o epic Performance da API com descrição: 'Reduzir latência p95
       para menos de 200ms. Migrar para connection pooling. Adicionar camada de cache.'"
IA:    Chama epic action=update com a descrição detalhada

3. Dividir epics em user stories

Crie user stories sob cada epic para definir requisitos específicos.

Você:  "Criar user stories para o epic Integração de Pagamentos:
       - Como usuário, quero pagar com cartão de crédito
       - Como usuário, quero ver meu histórico de pagamentos
       - Como admin, quero emitir reembolsos"
IA:    Cria três user stories vinculadas ao projeto

4. Converter stories em tarefas

Divida cada user story em tarefas implementáveis que vão para o quadro Kanban.

Você:  "Dividir a story de pagamento com cartão em tarefas de desenvolvimento"
IA:    Cria tarefas para: integração com Stripe, UI do formulário de pagamento, validação,
      tratamento de erros e geração de recibos

5. Revisar progresso dos epics

Verifique como o trabalho está progredindo nas suas iniciativas estratégicas.

Você:  "Mostrar o status de todos os epics no projeto"
IA:    Lista epics → para cada, filtra tarefas para calcular métricas de conclusão

Epics e Visibilidade do Projeto

Epics fornecem uma camada poderosa de comunicação entre equipes de desenvolvimento e stakeholders. Quando um gerente de projetos ou cliente pergunta "no que estamos trabalhando este trimestre?", a lista de epics fornece a resposta no nível certo de abstração — estratégico o suficiente para revisões executivas, estruturado o suficiente para planejamento de sprints.

Através do MCP Server, você pode gerar resumos em nível de epic sob demanda:

Você:  "Dar um status update de alto nível de todos os epics"
IA:    Lista epics → filtra tarefas por epic → resume progresso para cada iniciativa

Você:  "Qual epic tem mais trabalho incompleto?"
IA:    Lista epics → analisa conclusão de tarefas → identifica o epic com mais tarefas restantes

Resolução Automática de Contexto

A ferramenta de epics suporta resolução automática de contexto. Se o assistente de IA já conhece seu workspace e projeto de uma chamada anterior na conversa, ele mantém esse contexto. Isso significa que você pode dizer "Criar um epic" sem especificar o projeto toda vez, desde que o assistente de IA tenha estabelecido o contexto do projeto antes na conversa.

Próximos Passos

• User Stories: Defina requisitos dentro de epics como user stories estruturadas.
• Tarefas: Crie as tarefas de implementação que entregam seus epics.
• Sprints: Planeje sprints em torno do trabalho priorizado dos epics.
• Labels: Categorize tarefas entre epics com labels para filtragem.
• Início Rápido: Configure o servidor MCP se ainda não o fez.