# Boards, cards e sprints O board é onde o time acompanha o trabalho do dia a dia. Cada projeto do KrakenDock pode ter várias boards, cada uma com metodologia (Scrum ou Kanban), colunas e sprints próprias. Os cards guardam tudo sobre uma tarefa: responsável, prazo, estimativa, subtarefas, comentários, anexos e histórico. Este guia é para quem organiza o trabalho de um projeto e para quem trabalha nos cards todo dia. > Versão em Markdown puro deste guia: [https://app.krakendock.com/docs/boards.md?lang=pt-BR](https://app.krakendock.com/docs/boards.md?lang=pt-BR). Use-a para colar num assistente de IA ou na documentação interna do seu time. ## Visão geral | Peça | O que é | Onde | | -------------- | ---------------------------------------------------------------- | ------------------------------------- | | Board | colunas com os cards de uma parte do projeto (ex.: Backend) | barra lateral → projeto → **Board** | | Backlog | cards ainda sem sprint, ao lado das sprints abertas (só Scrum) | barra lateral → projeto → **Backlog** | | Sprints | ciclos de trabalho com início, fim e meta (só Scrum) | barra lateral → projeto → **Sprints** | | Cards | lista de todos os cards do projeto, com filtros e ações em massa | projeto → **Cards** | | Minhas tarefas | os cards atribuídos a você em todos os seus projetos | barra lateral → **Minhas tarefas** | | Busca | busca de texto em cards, comentários e wiki | `Ctrl+K` / `⌘K` ou `/` | | Wiki | páginas Markdown do projeto | projeto → **Wiki** | A chave dos cards (`KEY-N`, como `APP-12`) e as labels são do projeto, não da board. Um card movido para outra board mantém a chave. ## Como começar 1. Abra o projeto. Ele já vem com uma board e três colunas: `To Do`, `In Progress` e `Done` (a última é a coluna de concluídos). Renomeie à vontade. 2. Escolha a metodologia da board no menu **Opções da board** → **Configurações da board**: **Scrum** (sprints, backlog e planejamento em ciclos) ou **Kanban** (fluxo contínuo, sem sprints). 3. Crie cards com **Adicionar card** no rodapé de uma coluna, ou pela tecla `c`. 4. No Scrum, abra o **Backlog**, crie uma sprint com **Nova sprint** e arraste cards para ela. Depois, em **Sprints**, clique em **Iniciar**. Veja [Backlog e sprints](#backlog-e-sprints). 5. Arraste os cards entre as colunas conforme o trabalho anda. Na coluna de concluídos, clique em **Finalizar** para tirar o card da board. ## Boards Use várias boards quando partes do projeto têm fluxos diferentes, como Backend e Frontend. Cada board tem colunas, cards e sprints próprios. - **Criar:** no menu **Opções da board**, clique em **Nova board**, ou vá em Configurações do projeto → **Boards**. Dê um **Nome** (até 60 caracteres, único no projeto) e escolha a **Metodologia**. - **Ordem:** a primeira board é a **Padrão**: é para ela que vão os links antigos e os cards criados sem board. Reordene em Configurações do projeto → **Boards**. - **Metodologia padrão:** em Configurações do projeto → **Geral**, a **Metodologia** vale para as boards novas. Cada board tem a sua. - **Excluir:** só é possível com a board sem cards e sem sprint ativa. O projeto sempre mantém ao menos uma board. ### Scrum ou Kanban | | Scrum | Kanban | | -------------------- | ----------------------------------- | --------------------------------- | | O que a board mostra | só os cards da sprint ativa | todos os cards ativos | | Backlog e sprints | sim | não | | Indicado para | trabalho em ciclos de 1 a 4 semanas | fluxo contínuo, suporte, operação | - Uma board Scrum sem sprint ativa mostra **Nenhuma sprint ativa**, com um botão para iniciar a próxima sprint planejada. - Para mudar de Scrum para Kanban, encerre a sprint ativa antes. As sprints planejadas ficam guardadas, mas não podem ser iniciadas enquanto a board for Kanban. ### Colunas - **Adicionar coluna** fica no fim da board. O nome tem até 60 caracteres. - O menu de cada coluna tem **Renomear**, **Marcar como concluída**, **Mover para a esquerda**, **Mover para a direita**, **Limite de WIP…**, **Finalizar todos os cards** e **Excluir coluna**. - Uma **coluna de concluídos** marca o fim do fluxo. Os cards nela contam como concluídos nas subtarefas e no encerramento da sprint, e só eles podem ser finalizados. - Uma coluna só é excluída vazia, e a board sempre mantém ao menos uma coluna. Também contam os cards que a board não mostra: os finalizados, os arquivados e, no Scrum, os do backlog e de outras sprints. Mova ou reabra esses cards antes. ### Limite de WIP O limite de trabalho em andamento (WIP) avisa quando uma coluna tem cards demais. 1. No menu da coluna, clique em **Limite de WIP…**. 2. Informe o **Máximo de cards na coluna**, de 1 a 999. Deixe vazio para não ter limite. O limite só avisa: o contador da coluna mostra **no limite** ou **acima do limite**, e o card arrastado mostra **Acima do WIP**. Ele nunca impede mover cards. ### Exibição e filtros da board - **Filtros:** busque por título ou chave e filtre por **Responsável** (inclusive **Eu** e **Sem responsável**), **Labels**, **Prioridade** e **Tipo**. Os filtros ficam no endereço da página, então dá para mandar o link. - **Exibição:** escolha a **Densidade** (Compacta, Confortável ou Ampla), a **Largura das colunas** e as **Propriedades no card** (labels, prioridade, responsável, estimativa, subtarefas, prazo e campos). A escolha fica salva no seu navegador. - **Agrupar por card pai:** divide a board em raias, uma por card pai, com arrastar e soltar e criação rápida dentro da raia. - **Filtros salvos:** veja [Filtros salvos](#filtros-salvos). ## Cards ### Campos do card | Campo | Valores | | ----------- | -------------------------------------------------------------------------------------------------- | | Título | até 255 caracteres | | Descrição | Markdown, até 20.000 caracteres | | Tipo | Tarefa, Bug ou História | | Prioridade | Muito baixa, Baixa, Média (padrão), Alta ou Muito alta | | Responsável | um membro do projeto | | Estimativa | número inteiro de pontos | | Prazo | uma data; o responsável recebe lembretes no dia e quando atrasa | | Labels | as labels do projeto | | Card pai | outro card do projeto (veja [Hierarquia](#hierarquia-epico-historia-e-subtarefa)) | | Campos | os campos customizados do projeto (veja [Campos customizados e templates](https://app.krakendock.com/docs/fields-templates)) | As **Labels** são criadas em Configurações do projeto → **Labels**, ou pelo atalho **Gerenciar labels** no seletor do card. Cada label tem nome (até 40 caracteres, único no projeto) e cor. ### Criar cards - **Adicionar card** no rodapé da coluna cria só com o título. A tecla `c` abre a criação na primeira coluna. - **Criar** → **Novo card (com template)**, no topo da tela, abre o formulário completo, com tipo e template. - No celular, o botão flutuante cria um card na coluna aberta. - Numa board Scrum, o card novo entra na sprint ativa. Quem não pode planejar sprints cria o card no backlog. Cada card tem uma página própria, `///cards/KEY-N`. Ela abre como janela sobre a board, e **Copiar link** copia esse endereço. ### Mover cards - Arraste o card entre colunas com o mouse ou o toque. - **Pelo teclado:** foque o card, aperte espaço ou Enter, use as setas e aperte espaço ou Enter de novo para soltar (`Esc` cancela). - **Mover para…**, no menu do card, escolhe a coluna e se ele vai para o **Topo** ou o **Fim**. - No card aberto, o campo **Status** muda a coluna (atalho `m`) e o campo **Board** leva o card para outra board. Mudar de board tira o card da sprint, e um card numa sprint só muda de board por quem pode planejar sprints. ### Finalizar, arquivar e excluir | Ação | O que acontece | Como desfazer | | ------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | | **Finalizar** | o card sai da board e conta como concluído. Só cards numa coluna de concluídos podem ser finalizados | **Reabrir**: o card volta ao fim da coluna | | **Arquivar** | o card sai da board e não conta como concluído. Um card finalizado precisa ser reaberto antes | **Desarquivar** | | **Excluir** | o card some de todas as telas | **Desfazer** no aviso, ou restaurar pela lista em até 30 dias | - **Finalizar todos os cards**, no menu de uma coluna de concluídos, finaliza todos de uma vez. Numa board Scrum, só os da sprint ativa. - Os cards finalizados e arquivados aparecem na [lista de cards](#lista-de-cards), no filtro **Status**. - Depois de 30 dias na lixeira, o card é apagado de vez, com comentários e anexos. ## Hierarquia: épico, história e subtarefa Qualquer card pode ter um **Card pai** do mesmo projeto, até de outra board. O uso comum é épico → história → subtarefa, mas o nível não depende do tipo do card. - São no máximo 3 níveis, sem ciclos. Um card no 3º nível não pode ter subtarefas. - No card aberto, a seção **Subtarefas** mostra a barra de progresso e tem **Adicionar subtarefa** e **Vincular card existente**. O menu de cada subtarefa tem **Remover do card pai**. - Uma subtarefa criada ali vai para a board escolhida. Na mesma board, ela herda a sprint do pai. - **Progresso:** conta as subtarefas numa coluna de concluídos ou finalizadas. Subtarefas arquivadas não entram na conta. - Na board, o card mostra o card pai e o selo de progresso (por exemplo, "2 de 5 subtarefas concluídas"). - Arquivar o pai não muda os filhos. Excluir o pai de vez deixa os filhos sem pai. ## Backlog e sprints Só nas boards Scrum. Cada board tem suas sprints, e só uma pode estar ativa por vez. ### Planejar O **Backlog** mostra lado a lado os **Cards sem sprint** e as **Sprints abertas**. - **Adicionar ao backlog** cria um card direto no backlog. - Arraste os cards entre o backlog e as sprints, ou selecione vários e use **Mover para…** (até 100 por vez). - Filtre o backlog por texto, responsável, labels, tipo e prioridade. - Cada sprint mostra os cards e os pontos planejados. A velocidade média do time é a média de pontos concluídos nas 3 últimas sprints encerradas. Uma sprint com mais pontos que essa média mostra um aviso. ### Iniciar uma sprint 1. No **Backlog** ou em **Sprints**, clique em **Nova sprint**. Preencha o **Nome** (até 120 caracteres), a **Meta** e, se quiser, o **Início** e o **Fim**. 2. Planeje os cards no **Backlog**. 3. Em **Sprints**, clique em **Iniciar** (ou use o botão da board sem sprint ativa). A board passa a mostrar os cards dessa sprint, e os responsáveis recebem uma notificação. Enquanto não for encerrada, a sprint pode ser editada. Só uma sprint planejada pode ser excluída, e os cards dela voltam para o backlog. ### Encerrar uma sprint Em **Sprints**, clique em **Encerrar** na sprint ativa. Na janela **Encerrar sprint**, escolha o destino dos cards que ainda não terminaram: - **Mover para o backlog**; ou - **Mover para outra sprint**, uma sprint planejada da mesma board. O que conta como terminado: | Card | Ao encerrar | | ------------------------- | ---------------------------- | | numa coluna de concluídos | fica na sprint encerrada | | finalizado | fica na sprint encerrada | | arquivado | fica na sprint encerrada | | em qualquer outra coluna | vai para o destino escolhido | Uma sprint encerrada não pode mais ser editada. Ela aparece em **Encerradas**, na página **Sprints**, e entra no cálculo da velocidade. ## Lista de cards Em **Cards**, o projeto inteiro aparece numa tabela, com todas as boards. Clique num card para abri-lo sobre a lista, sem perder filtros, seleção e rolagem. Com o card aberto, `j` e `k` trocam para o próximo e o anterior. ### Filtros da lista - **Busca:** encontra palavras do título ou da descrição (sem diferenciar acentos e maiúsculas), parte do título ou a chave exata do card. - **Filtros:** **Board**, **Coluna**, **Sprint** (ou **Backlog (sem sprint)**), **Responsável**, **Prioridade**, **Tipo**, **Labels**, **Card pai**, **Somente cards de topo** e **Campos**. - **Status:** **Ativos** (padrão), **Finalizados**, **Arquivados** ou **Todos**. - **Mostrar só excluídos:** a lixeira dos últimos 30 dias, com o botão de restaurar. Aparece para quem pode excluir cards. - **Ordenar por:** Prazo, Prioridade, Atualização, Criação ou Chave. Sem ordenação, vale a ordem do board. - A lista mostra 25, 50 ou 100 cards por página. Todos os filtros ficam no endereço da página. ### Ações em massa Marque os cards e use a barra de ações: **Arquivar**, **Finalizar**, **Responsável**, **Prioridade**, **Labels**, **Mover para coluna**, **Mover para board**, **Sprint**, **Card pai** e **Excluir**. Na lixeira, **Restaurar**. - Cada ação mostra um aviso com **Desfazer**. - **Finalizar** ignora os cards fora de uma coluna de concluídos. - **Mover para coluna** exige cards de uma única board. ## Filtros salvos Guarde uma combinação de filtros da board ou da lista para usar de novo. O menu **Filtros salvos** fica ao lado dos filtros. 1. Aplique os filtros. 2. Clique em **Filtros salvos** → **Salvar filtro atual…**. 3. Dê um **Nome** (até 60 caracteres). Marque **Compartilhar com o projeto** para todos os membros verem e aplicarem o filtro. - **Gerenciar filtros…** renomeia, compartilha, atualiza com os filtros atuais ou exclui. - Cada pessoa pode ter até 50 filtros por projeto. - Compartilhar ou editar um filtro compartilhado exige permissão para editar cards. ## Minhas tarefas Em **Minhas tarefas** (`/me/tasks`), você vê os cards atribuídos a você em todos os projetos de que é membro. - **Agrupar por:** **Prazo** (Atrasadas, Hoje, Esta semana, Mais tarde e Sem prazo) ou **Projeto**. - **Situação:** **Em aberto** ou **Finalizadas**. - **Projeto** e **Contexto** (sua conta pessoal ou uma organização) restringem a lista. - Cada card tem **Finalizar** e **Mover para…**, sem precisar abrir o board. - O início do app mostra um resumo com o que está atrasado ou vence hoje. ## Busca Abra a paleta com `Ctrl+K` (`⌘K` no Mac) ou `/` e digite. Dentro de um projeto, a paleta busca primeiro nele, e uma opção amplia a busca para todos os projetos. Para ver tudo, escolha "Ver todos os resultados", que abre a página **Busca** (`/search`). - A busca cobre **Cards**, **Comentários** e **Wiki** dos projetos de que você é membro. Com o filtro **Projeto**, ela cobre só aquele projeto, inclusive um projeto público. - Cada palavra encontra o começo de uma palavra do texto, e todas precisam aparecer. Acentos e maiúsculas não importam. - Digitar a chave de um card (`APP-12`) traz esse card primeiro. - Digite de 2 a 100 caracteres. Filtre por **Tipo do card** e por **Situação**. - Acima de 1.000 resultados, a contagem mostra "Mais de 1000 resultados": refine a busca. ## Comentários e menções Os comentários ficam no **Histórico** do card. Eles aceitam Markdown (até 10.000 caracteres) e anexos. - Só o autor edita o comentário. Excluir cabe ao autor ou a quem pode excluir cards. - No editor, `@` sugere os membros do projeto e `#` sugere cards. Uma menção `KEY-N` vira link para o card. - **Menções:** `@usuario` notifica a pessoa, se ela for membro do projeto. Menções a quem não é membro são ignoradas. Ao editar o texto, só as menções novas notificam. - Quem comenta, o relator, o responsável e as pessoas mencionadas acompanham o card e recebem as notificações de comentários. - Ajuste o que chega por e-mail em Configurações → **Notificações**. ## Anexos Anexe arquivos à descrição, aos comentários ou à seção **Anexos** do card. - Use **Anexar arquivo**, arraste para a seção ou cole e solte no editor. No celular, também há **Tirar foto**. - Imagens, PDFs e textos (PNG, JPEG, GIF, WebP, PDF e TXT) abrem no navegador. Os outros tipos são baixados. - Executáveis e scripts (`.exe`, `.bat`, `.sh`, `.js`, `.apk`, `.dmg`, `.iso`…) são recusados. - Um comentário leva até 20 anexos. A seção **Anexos** lista também os de comentários, com o selo **Em comentário**. - Quem enviou remove o próprio anexo. Quem pode excluir cards remove qualquer um. - Em projetos públicos, qualquer visitante que vê o card vê e baixa os anexos. Os limites dependem do plano. Veja [Limites por plano](#limites-por-plano). ## Histórico do card O **Histórico** do card junta comentários e atividade. Use **Mostrar no histórico** para ver **Tudo**, só **Comentários** ou só **Atividade**. A atividade registra quem mudou o quê e quando: título, descrição (com **Ver alterações**, linha a linha), tipo, prioridade, estimativa, prazo, responsável, sprint, labels, card pai, coluna e board, campos customizados, anexos, e quando o card foi finalizado, arquivado, excluído ou restaurado. Mudanças feitas por um assistente de IA aparecem com **via MCP**. ## Tempo real A board, a lista, o card aberto e a wiki se atualizam sozinhos quando outra pessoa muda algo. Não é preciso recarregar a página. - Um card movido, criado ou restaurado por outra pessoa pisca por um instante. - No card aberto, um aviso mostra "Atualizado por … agora há pouco", com **Recarregar**. Se o card foi excluído, o aviso diz isso. - Em projetos públicos, os visitantes também veem as mudanças em tempo real. ## Wiki do projeto A **Wiki** guarda a documentação do projeto em páginas Markdown, organizadas em árvore (página pai e subpáginas). - Cada salvamento gera uma versão. **Histórico** mostra as versões anteriores, só para leitura. - Se outra pessoa salvou antes de você, o editor avisa, mantém o seu rascunho e oferece **Copiar meu texto** e **Recarregar a versão atual**. - Uma página pode virar o README do projeto, mostrado na visão geral. Escolha em Configurações do projeto → **README**. - Em projetos públicos, a wiki inteira, com o histórico, é visível para qualquer pessoa. - A wiki ainda não aceita anexos. ## Atalhos de teclado Aperte `?` para ver os atalhos da página atual. No mesmo painel, **Ativar atalhos de teclado** liga ou desliga todos eles. | Onde | Tecla | O que faz | | ---------- | -------------------- | ----------------------------------- | | Em tudo | `Ctrl+K` / `⌘K`, `/` | abre a paleta de comandos e a busca | | Em tudo | `?` | mostra os atalhos | | Em tudo | `[` | recolhe ou expande a barra lateral | | No projeto | `g` `b` | vai para a board | | No projeto | `g` `l` | vai para a lista de cards | | No projeto | `g` `w` | vai para a wiki | | No projeto | `g` `a` | vai para a IA | | Board | `c` | adiciona um card na primeira coluna | | Lista | `/` | foca a busca da lista | | Lista | `j` / `k` | próximo e anterior card | | Card | `e` | edita o título | | Card | `a` | atribui o card a você | | Card | `m` | muda a coluna do card | | Card | `f` | finaliza ou reabre o card | ## Permissões | Permissão | O que libera neste guia | | --------------------- | ------------------------------------------------------------------------------------------------- | | **Ver projeto** | ver boards, cards, sprints, wiki e anexos | | **Editar cards** | criar, editar, mover, finalizar e arquivar cards; comentar; anexar arquivos; compartilhar filtros | | **Excluir cards** | excluir e restaurar cards; remover comentários e anexos de outras pessoas | | **Gerenciar sprints** | criar, iniciar, encerrar e excluir sprints; tirar e pôr cards em sprints | | **Editar wiki** | criar, editar, mover e excluir páginas | | **Gerenciar projeto** | criar e configurar boards, colunas e labels; escolher o README | O papel `Write` tem todas essas permissões menos **Excluir cards** e **Gerenciar projeto**. O papel `Read` só vê. O papel `Admin` tem todas. Numa organização, crie papéis próprios em **Roles**. ## Limites por plano Boards, colunas, cards e sprints não têm limite em nenhum plano. Os anexos têm: | | Free | Pro | Business | | -------------------------------- | ------- | ------- | -------- | | Tamanho máximo por arquivo | 10 MiB | 100 MiB | 100 MiB | | Armazenamento de anexos da conta | 500 MiB | 10 GiB | 10 GiB | - O armazenamento soma os anexos de todos os projetos da conta (pessoal ou organização), inclusive os de cards na lixeira até serem apagados de vez. - O uso aparece em **Plano e uso**, nas configurações da sua conta ou da organização. - Veja os planos em [https://app.krakendock.com/pricing](https://app.krakendock.com/pricing). ## Perguntas frequentes ### Por que meu card não aparece na board? Numa board Scrum, a board mostra só os cards da sprint ativa: os outros estão no **Backlog**. Cards finalizados e arquivados também saem da board. Confira ainda os filtros: a contagem da coluna avisa quantos cards estão ocultos. ### Qual a diferença entre finalizar e arquivar? Finalizar é entregar: o card conta como concluído no progresso do pai e na sprint. Arquivar é guardar algo que não vai ser feito. Os dois saem da board e continuam na lista de cards. ### Excluí um card sem querer. Dá para recuperar? Sim. Clique em **Desfazer** no aviso, ou abra a lista de cards com **Mostrar só excluídos** e restaure. O prazo é de 30 dias. ### Posso mover um card para outra board? Sim, pelo campo **Board** do card ou por **Mover para board** na lista. A chave continua a mesma, e o card sai da sprint. ### O limite de WIP impede mover cards? Não. Ele só avisa quando a coluna chega ao limite ou passa dele. ### Por que não consigo mudar a board para Kanban? A board tem uma sprint ativa. Encerre a sprint e tente de novo. ## Veja também - [Primeiros passos](https://app.krakendock.com/docs/getting-started): conta, organização, projeto e convites. - [Campos customizados e templates](https://app.krakendock.com/docs/fields-templates): campos próprios nos cards e modelos de card. - [IA: reuniões e textos em cards](https://app.krakendock.com/docs/ai): transforme reuniões e anotações em cards. - [Servidor MCP e tokens de acesso](https://app.krakendock.com/docs/mcp): deixe um assistente de IA mover cards e cuidar das sprints. - [GitHub](https://app.krakendock.com/docs/github): importe e sincronize issues.