User Stories

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 user_story fornece 5 ações para gerenciar user stories — os blocos fundamentais dos requisitos ágeis. User stories capturam o que seus usuários precisam em um formato estruturado ("Como [papel], eu quero [capacidade], para que [benefício]"), e o MCP Server permite que seu assistente de IA crie, atualize, pesquise e organize-as sem sair da sua IDE ou cliente de IA.

User stories no GitScrum servem como a ponte entre epics de alto nível e tarefas acionáveis. Cada user story define um requisito que pode ser dividido em uma ou mais tarefas no quadro Kanban. Através do MCP Server, seu assistente de IA pode construir hierarquias inteiras de requisitos — de epics a user stories a tarefas — em uma única conversa.

Visão Geral das Ações

Listando User Stories

A ação list retorna todas as user stories dentro de um projeto específico. Cada user story na resposta inclui seu uuid, título, descrição, prioridade e contagem de tarefas vinculadas. Isso dá ao seu assistente de IA a visão completa do panorama de requisitos do projeto.

Use esta ação para revisar o backlog, verificar cobertura de requisitos ou identificar stories que precisam de mais divisão em tarefas.

Parâmetros Obrigatórios

Exemplos de Prompts

Você:  "Listar todas as user stories no projeto Backend"
IA:    Chama user_story action=list → retorna todas as stories com títulos, prioridades e contagem de tarefas

Você:  "Mostrar o backlog de requisitos"
IA:    Chama user_story action=list → retorna a lista completa de user stories do projeto atual

Você:  "Quantas user stories temos no projeto Mobile?"
IA:    Chama user_story action=list → conta e resume os resultados

Obtendo Detalhes da User Story

A ação get retorna o objeto completo da user story, incluindo descrição, critérios de aceitação, prioridade, tarefas vinculadas e todos os metadados. Esta é a ação para chamar quando você precisa do contexto completo de um requisito específico.

Parâmetros Obrigatórios

Você:  "Mostrar detalhes da user story de redefinição de senha"
IA:    Encontra a story via list/search → chama user_story action=get → retorna detalhes completos

Você:  "Quais são os critérios de aceitação da story de autenticação?"
IA:    Chama user_story action=get → extrai e apresenta critérios de aceitação

Criando User Stories

A ação create constrói uma nova user story em uma única chamada. Você pode definir título, descrição, prioridade e critérios de aceitação no momento da criação. O assistente de IA pode inferir o formato da user story a partir da sua linguagem natural — você não precisa seguir o template "Como... eu quero... para que..." literalmente, embora seja recomendado para clareza.

Parâmetros Obrigatórios

Parâmetros Opcionais

Exemplos de Prompts

Você:  "Criar uma user story 'Como usuário, quero redefinir minha senha para
       que eu possa recuperar o acesso à minha conta'"
IA:    Chama user_story action=create com title, company_slug, project_slug

Você:  "Criar uma story de alta prioridade para autenticação de dois fatores com critérios
       de aceitação: deve suportar TOTP e SMS"
IA:    Chama user_story action=create com title, priority="high",
      acceptance_criteria="- [ ] Suportar TOTP\n- [ ] Suportar SMS"

Você:  "Adicionar uma user story ao projeto Dashboard: 'Como gerente, quero
       exportar relatórios em PDF para que eu possa compartilhá-los com stakeholders'.
       Incluir descrição sobre formatos suportados."
IA:    Chama user_story action=create com title, description, company_slug, project_slug

Você:  "Criar uma story sobre notificações em tempo real com critérios de aceitação detalhados"
IA:    Chama user_story action=create com title, acceptance_criteria contendo
      condições específicas como checklist Markdown

Atualizando User Stories

A ação update modifica qualquer campo de uma user story existente. Apenas os campos que você especifica são alterados — todos os outros campos permanecem inalterados. Isso é útil para refinar requisitos conforme a equipe aprende mais, ajustar prioridades durante o refinamento de backlog ou adicionar critérios de aceitação após a criação inicial da story.

Parâmetros Obrigatórios

Parâmetros Opcionais

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

Exemplos de Prompts

Você:  "Atualizar a story de redefinição de senha para alta prioridade"
IA:    Encontra a story → chama user_story action=update com priority="high"

Você:  "Adicionar critérios de aceitação à story de autenticação:
       deve validar formato de e-mail e aplicar complexidade de senha"
IA:    Chama user_story action=update com acceptance_criteria

Você:  "Renomear a story de notificações para 'Notificações Push em Tempo Real'"
IA:    Chama user_story action=update com title="Notificações Push em Tempo Real"

Você:  "Adicionar mais contexto à descrição da story de exportação"
IA:    Obtém descrição atual → chama user_story action=update com descrição expandida

Pesquisando User Stories

A ação search encontra user stories por palavra-chave em título, descrição e critérios de aceitação. Isso é mais rápido que listar todas as stories e filtrar no lado do cliente — a pesquisa acontece no servidor e retorna apenas resultados correspondentes.

Parâmetros Obrigatórios

Exemplos de Prompts

Você:  "Pesquisar user stories sobre autenticação"
IA:    Chama user_story action=search com q="autenticação" → retorna stories correspondentes

Você:  "Encontrar stories relacionadas a processamento de pagamentos"
IA:    Chama user_story action=search com q="pagamento" → retorna stories relevantes

Você:  "Existem user stories mencionando rate limiting de API?"
IA:    Chama user_story action=search com q="rate limiting" → retorna resultados ou conjunto vazio

Vinculando User Stories a Tarefas

User stories ganham seu real poder quando vinculadas a tarefas no quadro Kanban. Ao criar uma tarefa pela ferramenta task, você pode passar o parâmetro userstoryslug para associar a tarefa a uma user story específica. Isso cria uma cadeia rastreável do requisito à implementação.

Workflow: Do Requisito à Implementação

Você:  "Criar uma user story para redefinição de senha do usuário"
IA:    Chama user_story action=create → retorna a nova story com seu slug

Você:  "Agora dividir em tarefas: validar e-mail, enviar link de redefinição,
       tratar expiração do token, atualizar senha"
IA:    Chama task action=create quatro vezes, cada uma com user_story_slug
      apontando para a story de redefinição de senha

Você:  "Mostrar todas as tarefas vinculadas à story de redefinição de senha"
IA:    Chama task action=filter com user_story=[slug da story]
      → retorna todas as tarefas de implementação

Este workflow garante que toda tarefa rastreia de volta a um requisito de negócio, tornando revisões de sprint e relatórios para stakeholders diretos. O assistente de IA cuida da resolução de slugs — você referencia stories por nome, e o servidor MCP as mapeia para os identificadores corretos.

Workflow de Planejamento de Requisitos

Para equipes usando gerenciamento de requisitos via MCP, este workflow cobre o ciclo completo de planejamento:

1. Definir user stories a partir de input de stakeholders

Traduza requisitos de negócio em user stories estruturadas.

Você:  "Precisamos de redefinição de senha, autenticação de dois fatores e gerenciamento de sessão.
       Criar user stories para cada."
IA:    Cria três user stories com títulos e descrições apropriados

2. Adicionar critérios de aceitação

Refine cada story com critérios específicos e testáveis.

Você:  "Adicionar critérios de aceitação a todas as três stories"
IA:    Atualiza cada story com checklists detalhados de critérios de aceitação

3. Dividir em tarefas

Converta stories em tarefas implementáveis no quadro Kanban.

Você:  "Dividir a story de redefinição de senha em tarefas de desenvolvimento"
IA:    Cria tarefas vinculadas à story via user_story_slug

4. Acompanhar cobertura

Verifique que todas as stories têm tarefas de implementação.

Você:  "Quais user stories ainda não têm tarefas?"
IA:    Lista stories → cruza referências com filtro de tarefas → identifica lacunas

Próximos Passos

• Epics: Agrupe user stories em epics estratégicos para planejamento de alto nível.
• Tarefas: Crie e gerencie as tarefas que implementam user stories.
• Sprints: Planeje sprints em torno de user stories priorizadas.
• Início Rápido: Configure o servidor MCP se ainda não o fez.