GitScrum / Docs

Como o GitScrum Funciona

O GitScrum organiza o trabalho em uma hierarquia de três níveis: Workspaces contêm Projetos, Projetos contêm Tarefas. Essa estrutura mapeia diretamente como agências operam — o workspace é sua agência, projetos são engagements com clientes, e tarefas são o trabalho real.

Entender essa hierarquia é chave para usar o GitScrum efetivamente. Tudo flui das configurações do workspace para tarefas individuais. Membros do time podem pertencer a um workspace e ser atribuídos a projetos específicos com diferentes níveis de permissão.

A Hierarquia do Workspace

Workspace

O workspace é o container de nível superior. Pense nele como sua agência ou empresa dentro do GitScrum. Ele guarda todos os seus projetos, membros do time, informações de cobrança e configurações globais.

Quando você cria uma conta, o GitScrum automaticamente cria seu primeiro workspace. A maioria das agências precisa só de um. Crie workspaces adicionais apenas se precisar de isolamento completo de dados entre unidades de negócio ou se gerencia múltiplas agências separadas.

As configurações do workspace afetam todos os projetos dentro: horário de trabalho, fuso horário, plano de cobrança, integrações com GitHub ou GitLab. Mudanças aqui se propagam para baixo.

Projeto

Um projeto é onde o trabalho real acontece. Cada projeto tem seu próprio quadro Kanban, sprints, user stories, wiki, discussões, armazenamento de arquivos e controle de tempo. Membros do time são atribuídos a projetos com papéis específicos.

Para agências, um projeto por engagement de cliente faz sentido. Um cliente pode ter múltiplos projetos ao longo do tempo — um lançamento de site, depois um app mobile, depois manutenção contínua. Cada um é um projeto separado com seu próprio quadro e linha do tempo.

Projetos podem ser públicos (visíveis para qualquer um com o link) ou privados (somente membros do time). Projetos públicos são úteis para trabalho open-source ou dashboards de cliente onde stakeholders só precisam ver o progresso.

Tarefa

Tarefas são as unidades atômicas de trabalho. Elas vivem no quadro Kanban e se movem entre colunas conforme o trabalho avança. Cada tarefa tem um código único (como PRJ-123), título, descrição, responsável, data limite, labels, estimativas de tempo e tempo registrado.

Tarefas podem ter checklists, anexos, comentários e histórico de atividade. Podem ser vinculadas a user stories para fluxos Scrum ou existir independentemente para setups mais simples só-Kanban. Controle de tempo integra diretamente — inicia um timer, trabalha, para quando terminar.

O Quadro Kanban

Todo projeto tem um quadro Kanban como sua view central. Tarefas são exibidas como cards em colunas. Arraste cards entre colunas para atualizar seu status. É aqui que desenvolvedores passam a maior parte do tempo.

Colunas padrão são Backlog, A Fazer, Em Progresso e Feito. Você pode customizá-las — adiciona Review, QA, Bloqueado, o que se encaixar no seu fluxo. Cada coluna pode ter limites de trabalho em progresso para prevenir sobrecarga.

O quadro suporta filtro por responsável, label, sprint e data limite. Busca avançada encontra tarefas por número ou conteúdo. Atalhos de teclado tornam navegação rápida. Sync em tempo real significa que todos veem mudanças instantaneamente.

Sprints e User Stories

Para times seguindo Scrum, o GitScrum suporta sprints e user stories. User stories descrevem funcionalidades da perspectiva do usuário — "Como usuário, quero..." — e agrupam tarefas relacionadas.

Sprints são iterações com tempo limitado, tipicamente duas semanas. Você planeja o que realizar, trabalha durante o sprint, depois revisa resultados. O GitScrum rastreia velocidade (quantos story points você completa por sprint) e gera gráficos burndown mostrando progresso.

Story points são estimados durante refinamento de backlog. O GitScrum inclui planning poker para estimativa colaborativa. Arraste user stories para priorizá-las. Quando um sprint começa, stories comprometidas travam — você pode ver o que foi planejado versus o que foi realmente entregue.

Não faz Scrum? Sem problema. Sprints e user stories são opcionais. Muitos times usam o GitScrum como ferramenta Kanban pura com apenas tarefas e colunas.

Controle de Tempo

Controle de tempo está integrado em cada tarefa. Clique no botão play para iniciar um timer. Trabalhe. Clique em stop quando terminar. O tempo é registrado automaticamente com a data atual e notas opcionais.

Você também pode adicionar entradas de tempo manualmente — útil para registrar trabalho feito offline ou ajustar entradas. Tempo registrado alimenta relatórios do projeto, mostrando horas gastas por tarefa, por membro do time, por período.

Horários de trabalho definidos no nível do workspace (dias úteis e horas por dia) afetam cálculos de capacidade. Se alguém tem 40 horas de trabalho atribuídas em uma semana e trabalha dias de 8 horas, o GitScrum mostra eles em capacidade total. Sobre-alocação dispara avisos.

Dados de tempo exportam para relatórios. Agências usam isso para cobrança de clientes, planejamento de capacidade e entender onde o tempo realmente vai.

Papéis e Permissões

O GitScrum tem quatro papéis com diferentes níveis de permissão:

  • Agency Owner — Acesso total a tudo. Gerencia cobrança, configurações do workspace, todos os membros do time, todos os projetos. Pode deletar o workspace. Geralmente o fundador ou titular da conta.
  • Manager — Pode gerenciar projetos, criar e atribuir tarefas, ver todos os relatórios. Não pode acessar cobrança nem remover Agency Owners. Tipicamente project managers ou líderes de time.
  • Developer — Pode trabalhar em projetos atribuídos, completar tarefas, registrar tempo, comentar em items de trabalho. Não pode mudar configurações do projeto nem acessar outros projetos. O papel padrão para desenvolvedores e contratados.
  • Client — Acesso limitado somente leitura. Vê progresso do projeto e pode comentar em tarefas para as quais foi convidado. Não pode ver discussões internas, detalhes de controle de tempo ou outros projetos. Perfeito para stakeholders que precisam visibilidade sem acesso completo.

Permissões são aplicadas tanto no nível workspace quanto projeto. Um Developer no workspace pode ser atribuído a projetos específicos — eles só veem e interagem com esses projetos.

Papéis podem ser sobrescritos por projeto. Um membro do time pode ser Developer em um projeto mas Manager em outro, dependendo das responsabilidades.

Integrações

GitHub e GitLab

Conecte seus repositórios para vincular automaticamente commits, branches e pull requests a tarefas. Referencie um código de tarefa na sua mensagem de commit (como "Fix login issue #PRJ-123") e o GitScrum mostra esse commit na tarefa.

Quando um pull request é mergeado, o GitScrum pode mover automaticamente a tarefa para Feito. Informação de branch aparece nos cards de tarefa para que o time saiba quem está trabalhando em quê.

Extensão VS Code

A extensão VS Code traz o GitScrum para seu editor. Veja suas tarefas atribuídas, inicie e pare controle de tempo, atualize status de tarefas, adicione comentários — tudo sem trocar para o navegador.

Crie tarefas de comentários TODO no seu código. A extensão lê seus arquivos e permite converter notas inline em tarefas rastreadas com um clique.

Extensão Chrome

Capture telas e crie tarefas de qualquer página web. Encontrou um bug no staging? Capture a tela, adicione uma descrição, atribua a você mesmo — pronto. A captura anexa à tarefa automaticamente.

Criação rápida de tarefas sem sair do seu contexto atual. Útil para times de suporte, QA, ou qualquer um que encontre problemas enquanto navega.

Servidor MCP para Assistentes IA

O GitScrum fornece um servidor MCP (Model Context Protocol) que conecta a assistentes IA como Claude, GitHub Copilot e outros. A IA pode ler suas tarefas, atualizar status, registrar tempo e gerenciar projetos usando linguagem natural.

Pergunte "Quais são minhas tarefas abertas?" ou "Registre 2 horas em PRJ-123" e o assistente executa diretamente. Funciona do VS Code, terminal, ou qualquer cliente compatível com MCP.

Um Fluxo de Trabalho Típico

É assim que uma semana típica parece para uma agência de desenvolvimento usando GitScrum:

  1. Segunda de manhã — Time abre o quadro Kanban. Cada dev pega tarefas de A Fazer e move para Em Progresso. Controle de tempo começa.
  2. Durante o dia — Devs trabalham em tarefas, registrando tempo conforme avançam. Comentários em tarefas capturam decisões e bloqueios. PRs referenciam códigos de tarefa.
  3. Standup diário — O quadro serve como agenda do standup. O que está em progresso? O que está bloqueado? O que foi para Feito ontem?
  4. Pull request mergeado — A integração com GitHub move a tarefa para Feito automaticamente. Tempo gasto fica registrado.
  5. Fim do sprint — Relatórios de velocidade mostram quantos story points foram completados. Gráfico burndown mostra se o time atingiu o objetivo. Retrospectiva usa os dados para melhorar.
  6. Check-in com cliente — Compartilhe um link somente leitura para o projeto. O cliente vê progresso sem precisar fazer login. Ou adicione como papel Client para comentários.

Esse fluxo escala de devs individuais a times de 50 pessoas. A hierarquia e permissões mantêm tudo organizado conforme você cresce.

Próximos Passos

Agora que você entende a arquitetura: