From 5d798ba0d5f191c2f8ee7df099d5c15699086c46 Mon Sep 17 00:00:00 2001 From: Roni Fabio Banaszewski Date: Tue, 8 Sep 2026 16:04:16 -0300 Subject: [PATCH] refactor: troca a coluna Ready por In Review no Kanban MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Duas correcoes no mesmo lugar. A coluna `Ready` colidia com o status `Ready` do prd.md e nao tinha o que significar: como o /utf-backlog so cria Issue de story que ja esta `Ready`, todo cartao do quadro ja e `Ready` por definicao. A palavra valia duas coisas dentro do mesmo metodo. Se a intencao fosse marcar o escopo de uma entrega, coluna e a ferramenta errada: escopo e atributo do cartao e precisa viajar com ele por todas as colunas — uma historia em `In Progress` continua pertencendo ao escopo. Isso e milestone ou etiqueta na Issue, e o passo agora diz isso. No lugar dela entra `In Review`, que e um estado que existe de verdade neste metodo e nao tinha casa: o Pull Request aberto, esperando o Portao de Entendimento e a revisao dos colegas antes do merge. Sem a coluna, esse cartao ficava em `In Progress` indistinguivel de trabalho sendo digitado — a mesma patologia que a coluna `Blocked` existe para evitar. Numa equipe pequena e a unica coluna que pede acao de outra pessoa. O passo tambem passa a definir entrada e saida de cada coluna: coluna sem regra de entrada e de saida vira deposito. Co-Authored-By: Claude Opus 5 (1M context) --- .agents/workflows/utf-backlog.md | 22 +++++++++++++++++++--- 1 file changed, 19 insertions(+), 3 deletions(-) diff --git a/.agents/workflows/utf-backlog.md b/.agents/workflows/utf-backlog.md index 51a6124..02002ff 100644 --- a/.agents/workflows/utf-backlog.md +++ b/.agents/workflows/utf-backlog.md @@ -43,9 +43,25 @@ usuário — Issue criada aparece para a turma e para o professor. ## Passo 3 — O Kanban (GitHub Projects) A criação do board é **manual** (a interface do Projects muda rápido e o -aluno precisa conhecê-la): oriente-o a criar um Project no repositório com as -colunas `Backlog`, `Ready`, `In Progress`, `Blocked` e `Done` (a `Blocked` recebe a história pausada à espera de outra — guia, seção *Quando o ciclo não é linear*), e a adicionar as Issues -recém-criadas — `Must Have` primeiro no topo do `Backlog`. +aluno precisa conhecê-la): oriente-o a criar um Project no repositório com +cinco colunas, e diga o que cada uma quer dizer — coluna sem regra de entrada +e de saída vira depósito: + +| Coluna | O que fica nela | Sai quando | +| --- | --- | --- | +| `Backlog` | Toda Issue que ainda não começou, ordenada por prioridade | A equipe escolhe a próxima história | +| `In Progress` | A história em que se está trabalhando **agora** | O trabalho termina ou trava | +| `In Review` | O Pull Request está aberto e **espera a revisão dos colegas** antes do merge | O PR é mesclado | +| `Blocked` | A história parada à espera de outra coisa (guia, seção *Quando o ciclo não é linear*) | O impedimento é resolvido | +| `Done` | PR mesclado e story `Live` no `prd.md` | Nunca | + +Adicione as Issues recém-criadas ao `Backlog` — `Must Have` primeiro, no topo. + +> **Não crie uma coluna `Ready`.** Ela colidiria com o status `Ready` do +> `prd.md`, e todo cartão do quadro já é `Ready` por definição — só story +> `Ready` vira Issue. Se a equipe quiser marcar quais histórias pertencem a +> qual entrega, isso é **milestone ou etiqueta na Issue**, não coluna: escopo é +> atributo do cartão e precisa viajar com ele por todas as colunas. Se o MCP/`gh` da sessão conseguir adicionar as Issues ao Project, ofereça fazer isso; se não conseguir, não é erro — siga com a orientação manual.