Discussões

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 discussion fornece 6 ações para criar e gerenciar canais de discussão com threads dentro dos seus projetos. Discussões são a alternativa estruturada a mensagens de chat dispersas — elas mantêm decisões de arquitetura, revisões de design, propostas de funcionalidades e conversas da equipe organizadas e pesquisáveis dentro do contexto do projeto.

Cada discussão existe dentro de um projeto, suporta comentários em threads e pode ser aberta ou fechada conforme os tópicos são resolvidos. Seu assistente de IA pode criar discussões, postar comentários, acompanhar threads abertos e fechar tópicos resolvidos — tudo através de linguagem natural na sua IDE ou cliente de IA.

Visão Geral das Ações

Listando Discussões

A ação list retorna todas as discussões dentro de um projeto. Você pode opcionalmente filtrar por status para ver apenas threads abertos ou fechados. Cada discussão na resposta inclui seu uuid, título, status, data de criação e autor — fornecendo o contexto necessário para operações subsequentes.

Parâmetros Obrigatórios

Parâmetros Opcionais

You:  "Liste todas as discussões do projeto Backend"
AI:   Chama discussion action=list → retorna todas as threads de discussão

You:  "Mostre as discussões abertas do projeto Mobile App"
AI:   Chama discussion action=list com status="open" → retorna threads ativos

You:  "Existem discussões fechadas sobre o redesign da API?"
AI:   Chama discussion action=list com status="closed" → AI filtra por tópico

Obtendo Detalhes da Discussão

A ação get retorna o objeto completo da discussão — título, descrição, status, autor, data de criação e metadados. Este é o ponto de partida quando você precisa do contexto completo sobre uma thread específica.

Parâmetros Obrigatórios

You:  "Mostre os detalhes da discussão sobre design da API"
AI:   Encontra a discussão pelo título → chama discussion action=get → retorna dados completos da thread

You:  "O que foi decidido na discussão de revisão de arquitetura?"
AI:   Chama discussion action=get → retorna descrição e contexto

Criando Discussões

A ação create inicia uma nova thread de discussão dentro de um projeto. Toda discussão precisa de um título; a descrição é opcional, mas recomendada para fornecer contexto aos participantes.

Parâmetros Obrigatórios

Parâmetros Opcionais

Exemplos de Prompts

You:  "Inicie uma discussão sobre estratégia de autenticação da API no projeto Backend"
AI:   Chama discussion action=create com title="API Authentication Strategy",
      description com contexto sobre o tópico

You:  "Crie uma discussão 'Plano de Migração de Banco de Dados' com detalhes sobre
       o cronograma de migração de PostgreSQL para CockroachDB"
AI:   Chama discussion action=create com título e descrição em Markdown

You:  "Abra uma thread sobre o checklist de lançamento do app mobile"
AI:   Chama discussion action=create com title="Mobile App Launch Checklist"

Atualizando Discussões

A ação update modifica o título, descrição ou status de uma discussão existente. Apenas os campos que você especificar são alterados — todo o resto permanece inalterado. Fechar uma discussão sinaliza que o tópico foi resolvido.

Parâmetros Obrigatórios

Parâmetros Opcionais

You:  "Feche a discussão sobre autenticação da API — decidimos pelo OAuth2"
AI:   Encontra a discussão → chama discussion action=update com status="closed"

You:  "Atualize o título da discussão de migração para 'Plano de Migração de Banco de Dados v2'"
AI:   Chama discussion action=update com title="Database Migration Plan v2"

You:  "Reabra a discussão sobre estratégia de deploy"
AI:   Chama discussion action=update com status="open"

Comentários em Discussões

Comentários formam a conversa em threads dentro de uma discussão. Cada comentário suporta formatação Markdown, permitindo conteúdo rico incluindo blocos de código, links e texto formatado.

Listando Comentários

A ação comment_list retorna todos os comentários de uma discussão em ordem cronológica.

You:  "Mostre todos os comentários da discussão de arquitetura"
AI:   Chama discussion action=comment_list → retorna comentários em threads

You:  "O que a equipe disse sobre o redesign da API?"
AI:   Encontra a discussão → chama comment_list → resume a conversa

Criando Comentários

A ação comment_create adiciona um novo comentário a uma discussão existente. Comentários suportam Markdown completo — blocos de código, listas, links e texto formatado.

You:  "Adicione um comentário na discussão da API: 'Após revisar os benchmarks,
       recomendo usarmos GraphQL para a API pública'"
AI:   Chama discussion action=comment_create com comentário em Markdown

You:  "Poste os prós e contras de cada opção de banco de dados na thread de migração"
AI:   Chama discussion action=comment_create com lista formatada em Markdown

You:  "Comente na discussão de arquitetura com anotações da reunião de hoje"
AI:   Chama discussion action=comment_create com anotações da reunião em Markdown

Fluxo de Comunicação com Threads

Discussões funcionam melhor quando combinadas com outras ferramentas MCP para criar um processo estruturado de tomada de decisão:

1. Inicie a conversa

Crie uma discussão com enquadramento claro e contexto de fundo.

You:  "Crie uma discussão 'Estratégia de Auth para API v3' no projeto Backend.
       Inclua contexto sobre nossa configuração atual de JWT e a necessidade de suportar OAuth2."
AI:   Cria discussão com título e descrição detalhada em Markdown

2. Colete opiniões

Membros da equipe adicionam comentários com suas análises e recomendações.

You:  "Adicione um comentário com minha análise: OAuth2 + PKCE para mobile, API keys
       para server-to-server, session cookies para o dashboard web"
AI:   Posta comentário formatado com a recomendação técnica

3. Revise a thread

Resuma os comentários para sintetizar as contribuições da equipe.

You:  "Resuma os comentários da discussão sobre estratégia de auth"
AI:   Chama comment_list → gera um resumo conciso de todas as posições

4. Resolva e aja

Feche a discussão e crie tarefas baseadas na decisão.

You:  "Feche a discussão de estratégia de auth e crie tarefas para implementar
       a abordagem OAuth2 que concordamos"
AI:   Atualiza status da discussão para closed → cria tarefas a partir da decisão

Resolução Automática de Contexto

A ferramenta de discussão suporta resolução automática de contexto. Se seu assistente de IA já conhece o workspace e o projeto de uma chamada anterior na conversa, ele carrega esse contexto adiante. Você pode dizer "liste as discussões" sem especificar o projeto toda vez, desde que o contexto tenha sido estabelecido anteriormente.

Próximos Passos

• Comentários: Gerencie comentários em tarefas para colaboração operacional.
• Wiki: Construa bases de conhecimento de projetos para documentação de longo prazo.
• Tarefas: Crie tarefas a partir dos resultados das discussões.
• Início Rápido: Configure o MCP server se ainda não o fez.