---
id: "fluxos.quadro-de-trabalho"
titulo: "O quadro de trabalho"
resumo: "Organize as tarefas de um projeto em colunas e cartões, com busca e filtro para achar o que importa."
idioma: "pt-br"
tipo: "conceito"
categoria: "quadro"
aplicavelDesde: "0.0.16"
capabilities: ["work.board.read", "work.item.read", "work.column.read"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/pt-br/fluxos/quadro-de-trabalho/"
fonte: "pt-br/fluxos/quadro-de-trabalho.md"
caminhoPublico: "docs/publica/pt-br/fluxos/quadro-de-trabalho.md"
hashFonte: "sha256:80be4f6a11541bc4bc4372b143f94c040a3d27b39720be9985f59fb2a0f59787"
hashDestaPagina: "sha256:80be4f6a11541bc4bc4372b143f94c040a3d27b39720be9985f59fb2a0f59787"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
O **quadro de trabalho** é onde as tarefas de um projeto vivem: colunas com nomes que você escolhe, e
cartões que andam entre elas conforme o trabalho avança.

## Um quadro por projeto

O quadro pertence ao **projeto**, não à instalação nem ao workspace:

- Um projeto pode ter vários repositórios e várias configurações de host; todos compartilham o mesmo
  quadro.
- Trocar de workspace **não** troca de quadro.
- Para ver o quadro de outro projeto, troque o projeto.

**Itens não criam workspaces.** Criar, mover ou apagar um cartão não abre, move nem apaga nenhum
workspace — o quadro organiza intenção, não ambiente. Também não existe o caminho contrário: nenhum
workspace vira tarefa sozinho.

## Onde encontrar

- Na barra de projetos, a entrada **Quadro**.
- Na home, quando o projeto está aberto e a visão é a de quadro.

Se nenhum projeto estiver selecionado, a tela orienta a escolher um — ela não inventa um quadro vazio
para um projeto que não existe.

## Ler o quadro

Cada coluna é uma faixa vertical com os cartões dela. Cada cartão resume, sem abrir nada:

- o **título**;
- o progresso do **checklist**, quando existe (quantos passos concluídos de quantos);
- a contagem de **anexos** e de **comentários**;
- quem criou — inclusive quando foi um agente;
- quando mudou pela última vez.

Dois controles de leitura ficam no topo:

- **Buscar item** — reduz os cartões ao que casa com o termo. Uma coluna sem resultado diz "Nada com
  esse termo aqui", em vez de parecer vazia.
- **Filtrar por projeto** — restringe o que é mostrado ao projeto escolhido.

## Quando o quadro não é confiável

Se o arquivo do quadro não puder ser lido com segurança — versão futura, estrutura inválida,
identidade divergente —, a leitura responde com um estado de **não confiável** e o motivo. Nesse
estado:

- o **arquivo original é preservado**;
- as **escritas são recusadas**, em vez de gravar por cima de algo que não se entendeu;
- a interface mostra o problema.

É o comportamento certo: um quadro que não se entende não deve virar um quadro vazio e gravável, nem
ser sobrescrito por uma versão nova que perdeu dados.

## O que se guarda, e onde

- O quadro vive nos **dados do aplicativo**, não dentro do repositório do projeto.
- **Nenhuma escrita acontece no projeto do usuário** por causa do quadro: nem em arquivos, nem em
  configurações do sistema.
- Apagar a pasta de dados do aplicativo remove os quadros e as cópias de anexo junto. Voltar para uma
  versão anterior do app não modifica esses arquivos — eles continuam lá se você atualizar de novo.

## Limites declarados na implementação

Estes números são decisão de implementação e podem mudar entre releases:

| Limite | Valor |
|---|---|
| Colunas por quadro | 12 |
| Itens por quadro | 1000 |
| Título de item | 300 caracteres |
| Descrição | 100 mil caracteres |
| Entradas de checklist | 100 por item, de até mil caracteres cada |
| Comentários | 500 por item, de até 10 mil caracteres cada |
| Anexos | 20 por item, até 20 MiB por arquivo e 200 MiB por quadro |

As recusas são explícitas: o painel diz que o limite foi atingido, em vez de truncar o seu texto em
silêncio.

## Escopo e limites desta página

- **O quadro é por projeto.** Agregar vários projetos exige consultar cada um — não existe um quadro
  global, e a tela não soma projetos diferentes como se fossem um só.

## Próximos passos

- [Criar, editar e mover tarefas](/docs/pt-br/fluxos/quadro-tarefas/)
- [Colunas do quadro](/docs/pt-br/fluxos/quadro-colunas/)