Poda do user-flows, progressão json-server→BaaS e adaptações de equipe

.agents/workflows/architecture.md

@@ -1,5 +1,5 @@
 ---
-description: Conduz a entrevista que produz o docs/architecture.md a partir do prd.md — stack, estrutura do monorepo, testes, glossário técnico, diagrama ER e os padrões estruturais cobrados pelos IDs. Garante as quatro declarações que o /utf-setup exige. Roda depois do /utf-prd e do /utf-flows.
+description: Conduz a entrevista que produz o docs/architecture.md a partir do prd.md — stack, estrutura do projeto, testes, glossário técnico, diagrama ER e os padrões estruturais cobrados pelos IDs. Garante as quatro declarações que o /utf-setup exige. Roda depois do /utf-prd e do /utf-design.
 ---
 
 # Gerar o architecture.md
@@ -15,7 +15,7 @@ Você é o entrevistador técnico. O aluno é o Arquiteto: **ele decide; você a
 
 ## Passo 0 — Pré-condições
 
-0. `docs/user-flows.md` tem pelo menos uma jornada desenhada, com o parágrafo de decisão sobre o nó vermelho. Se não tiver, **PARE** e mande rodar `/utf-flows`: é lá que aparecem os estados que faltam ("o pedido fica AGUARDANDO para sempre?"), e estado esquecido aqui vira retrabalho na primeira spec.
+0. `docs/design-tokens.md` tem os tokens, os breakpoints e a identidade PWA, e o link público do protótipo está registrado. Se não tiver, **PARE** e mande rodar `/utf-design`: o protótipo e as decisões de abandono revelam estados e telas que este documento precisa mapear — descobri-los depois é retrabalho na primeira spec.
 1. `docs/prd.md` existe, com glossário, atores e stories. Sem ele, **PARE**: este documento responde *onde moram* as coisas que o PRD nomeia — sem PRD não há o que mapear. Mande rodar `/utf-prd` antes.
 2. Leia `docs/checklist.md` **inteiro** — a seção *Regras da disciplina* diz o que é stack fixa e o que é escolha do aluno, e vários IDs são padrões estruturais que este documento precisa declarar.
 

.agents/workflows/backlog.md

@@ -53,7 +53,7 @@ fazer isso; se não conseguir, não é erro — siga com a orientação manual.
 ## Passo 4 — Entrega
 
 Relate: Issues criadas (número e título), stories puladas (e por quê), e o
-estado do Kanban. Lembre o fluxo: se `/utf-flows`, `/utf-architecture` e `/utf-setup` ainda
+estado do Kanban. Lembre o fluxo: se `/utf-design`, `/utf-architecture` e `/utf-setup` ainda
 não rodaram, eles vêm antes; então a implementação de cada Issue começa por
 `/utf-issue <n>`, **uma por vez**, começando pelos `Must Have`.
 

.agents/workflows/design.md

@@ -0,0 +1,69 @@
+---
+description: Conduz as decisões de design da Fase 0 — framework CSS, Design System (docs/design-tokens.md), protótipo navegável (Stitch/Figma), Mobile-First e identidade PWA. A jornada vive no protótipo; aqui ela vira decisão registrada. Roda depois do /utf-prd e antes do /utf-architecture.
+---
+
+# Design: tokens, protótipo e identidade
+
+Você conduz as decisões visuais do projeto. O aluno decide; você pergunta, organiza
+e escreve. **Nesta disciplina a jornada do usuário vive no protótipo navegável**
+(Stitch/Figma — ID1), não num documento: o que se documenta aqui é o que o protótipo
+não consegue guardar — os tokens, os breakpoints e as decisões de abandono.
+
+## Regras da conversa
+
+- **Uma pergunta por vez.** Espere a resposta antes da próxima.
+- **Proibido implementação.** Nada de componente, service ou rota — isso é do
+  `/utf-architecture` em diante. Aqui é aparência, identidade e comportamento visual.
+- Decisão sem dono não existe: cada escolha registrada é da equipe, e alguém da
+  equipe vai explicá-la na apresentação.
+
+## Passo 0 — Pré-condições
+
+1. `docs/prd.md` preenchido, com stories e critérios. Sem ele, **PARE** e mande
+   rodar `/utf-prd` — design sem requisito é decoração.
+2. Se `docs/design-tokens.md` já tem conteúdo real, **PARE** e pergunte: revisar ou
+   recomeçar?
+
+## Passo 1 — Framework CSS e Design System (IDs 1 e 5)
+
+1. **Framework CSS** — apresente as opções que a ficha permite (ex.: Tailwind,
+   PrimeNG), com o custo de cada uma. A escolha é única para o semestre.
+2. **Tokens** — grave em `docs/design-tokens.md`: paleta (com os papéis: primária,
+   superfície, erro…), escala de espaçamento, tipografia, estados de botão. Não é
+   design system completo — é o mínimo para a IA não inventar um botão por tela.
+3. **Protótipo** — registre o **link público** do Stitch/Figma no
+   `docs/design-tokens.md` e no README. O protótipo é a jornada navegável: telas
+   das stories principais, no fluxo real.
+
+## Passo 2 — Mobile-First (ID2)
+
+Pergunte e registre nos tokens: os **breakpoints** e a regra de layout — o design
+nasce para a menor tela e cresce. Toda tela do protótipo tem versão mobile antes da
+versão desktop.
+
+## Passo 3 — Identidade PWA (ID3)
+
+Decida e registre (os valores alimentam o `manifest.webmanifest` no setup): nome
+curto do app, cores de tema e de fundo, ícone, modo de exibição (standalone) e o
+**comportamento visual offline** — o que a pessoa vê sem rede.
+
+## Passo 4 — O ponto de desistência
+
+Para cada story crítica do PRD (na dúvida, a mais central do tema), **uma** pergunta:
+*"onde a pessoa desiste nesse fluxo, e o que fazemos a respeito?"*. A resposta não
+vira documento novo — vira **regra de negócio ou critério de aceite no `prd.md`**
+(registre lá, com o OK do aluno). O caminho ruim precisa aparecer antes de virar spec.
+
+## Passo 5 — Portão
+
+1. Grave `docs/design-tokens.md` completo (tokens + breakpoints + identidade PWA +
+   link do protótipo).
+2. **PARE.** A equipe revisa fora do chat; o commit é dela. Próximo passo:
+   `/utf-architecture`.
+
+## Proibições
+
+- Gerar CSS, componente ou código de qualquer tipo — aqui nascem decisões, não telas.
+- Inventar valores de marca (cores, nomes) sem o aluno escolher.
+- Criar documento de jornadas separado — a jornada vive no protótipo, e a decisão de
+  abandono vive no `prd.md`.

.agents/workflows/prd.md

@@ -1,5 +1,5 @@
 ---
-description: Conduz a entrevista que produz o docs/prd.md — tema, glossário, atores, user stories com critérios verificáveis, regras de negócio, fora de escopo e NFRs. Uma pergunta por vez; o aluno decide, o agente escreve. Roda antes do /utf-flows e do /utf-architecture.
+description: Conduz a entrevista que produz o docs/prd.md — tema, glossário, atores, user stories com critérios verificáveis, regras de negócio, fora de escopo e NFRs. Uma pergunta por vez; o aluno decide, o agente escreve. Roda antes do /utf-design e do /utf-architecture.
 ---
 
 # Gerar o PRD
@@ -48,7 +48,7 @@ Percorra o `docs/checklist.md` e confira o rascunho contra **todo ID cuja sement
 
 1. Grave `docs/prd.md` completo.
 2. **PARE.** O aluno lê o documento inteiro, fora do chat. Ajuste agora custa uma conversa; depois, custa uma spec.
-3. O commit do `prd.md` é **dele**. Próximos passos, nesta ordem: com o **aceite do professor** e stories `Ready`, `/utf-backlog` leva as stories para o GitHub (Issues + Kanban); depois `/utf-flows`, que desenha as jornadas e acha os pontos de desistência; e só então `/utf-architecture`.
+3. O commit do `prd.md` é **dele**. Próximos passos, nesta ordem: com o **aceite do professor** e stories `Ready`, `/utf-backlog` leva as stories para o GitHub (Issues + Kanban); depois `/utf-design`, que fecha tokens, protótipo e os pontos de desistência; e só então `/utf-architecture`.
 
 ## Proibições
 

.agents/workflows/setup.md

@@ -71,9 +71,15 @@ dentro da estrutura de pastas que o documento descreve.
    Sem isso, um repositório tocado em Windows e Linux reescreve todos os arquivos a
    cada troca de máquina, e o diff de qualquer PR vira ruído.
 
-3. `package.json` da raiz com os scripts de orquestração descritos no
-   `architecture.md` (ex.: `start`, `api`, `test`). Se o documento traz os scripts
-   prontos, copie-os literalmente.
+3. `package.json` com os scripts descritos no `architecture.md` (ex.: `start`,
+   `api`, `test`). Se o documento traz os scripts prontos, copie-os literalmente.
+   Dois casos desta disciplina:
+   - **json-server declarado para o MVP:** adicione a dependência, o script
+     (`"api": "json-server db.json"` ou equivalente) e um `db.json` **vazio de
+     negócio** (`{}`) — as entidades chegam pelas histórias, nunca pelo setup.
+   - **PWA declarado:** rode `ng add @angular/pwa` e preencha o
+     `manifest.webmanifest` com a identidade decidida no `/utf-design`
+     (nome curto, cores, ícones) — sem inventar valores.
 
 ## Passo 4 — As ferramentas do método
 
@@ -103,17 +109,18 @@ do guia é exatamente como o Portão nasce parafraseado e sem efeito.
    {
      "required_status_checks": null,
      "enforce_admins": true,
-     "required_pull_request_reviews": { "required_approving_review_count": 0 },
+     "required_pull_request_reviews": { "required_approving_review_count": 1 },
      "restrictions": null,
      "allow_force_pushes": false,
      "allow_deletions": false
    }
    JSON
    ```
 
-   `required_approving_review_count: 0` exige **Pull Request** para entrar na
-   `main`, sem exigir aprovação de terceiro — funciona igual para quem faz
-   sozinho e para dupla. `enforce_admins: true` faz a regra valer também para o
+   `required_approving_review_count: 1` exige **Pull Request aprovado por um
+   colega** — nesta disciplina o projeto é em equipe (2–3), e a revisão entre
+   colegas com resolução de conflitos é cobrada pelo ID27: quem abre a story
+   não mergeia o próprio PR. `enforce_admins: true` faz a regra valer também para o
    dono do repositório: sem isso, o aluno é justamente quem fura a regra sem
    perceber. Para destravar uma emergência ele desliga a proteção
    conscientemente, e isso fica registrado no log do repositório.

.claude/commands/utf-architecture.md

@@ -1,5 +1,5 @@
 ---
-description: Gera o docs/architecture.md por entrevista guiada a partir do prd.md — stack, monorepo, testes, glossário técnico, diagrama ER e os padrões cobrados pelos IDs. Garante o que o /utf-setup exige. Roda depois do /utf-prd.
+description: Gera o docs/architecture.md por entrevista guiada a partir do prd.md — stack, projeto, testes, glossário técnico, diagrama ER e os padrões cobrados pelos IDs. Garante o que o /utf-setup exige. Roda depois do /utf-prd.
 ---
 
 Leia `.agents/workflows/architecture.md` e execute-o integralmente.

.claude/commands/utf-design.md

@@ -0,0 +1,5 @@
+---
+description: Conduz as decisões de design da Fase 0 — framework CSS, tokens (docs/design-tokens.md), protótipo navegável, Mobile-First e identidade PWA. Roda depois do /utf-prd e antes do /utf-architecture.
+---
+
+Leia `.agents/workflows/design.md` e execute-o integralmente.

.cursor/commands/utf-architecture.md

@@ -1,5 +1,5 @@
 ---
-description: Gera o docs/architecture.md por entrevista guiada — stack, monorepo, testes, glossário técnico e diagrama ER. Roda depois do /utf-flows.
+description: Gera o docs/architecture.md por entrevista guiada — stack, projeto, testes, glossário técnico e diagrama ER. Roda depois do /utf-design.
 ---
 
 Leia `.agents/workflows/architecture.md` e execute-o integralmente.

.cursor/commands/utf-design.md

@@ -0,0 +1,5 @@
+---
+description: Conduz as decisões de design da Fase 0 — framework CSS, tokens (docs/design-tokens.md), protótipo navegável, Mobile-First e identidade PWA. Roda depois do /utf-prd e antes do /utf-architecture.
+---
+
+Leia `.agents/workflows/design.md` e execute-o integralmente.

.cursor/commands/utf-prd.md

@@ -1,5 +1,5 @@
 ---
-description: Gera o docs/prd.md por entrevista guiada — tema, glossário, atores, user stories, regras de negócio e NFRs. Roda antes do /utf-flows.
+description: Gera o docs/prd.md por entrevista guiada — tema, glossário, atores, user stories, regras de negócio e NFRs. Roda antes do /utf-design.
 ---
 
 Leia `.agents/workflows/prd.md` e execute-o integralmente.

.opencode/command/utf-architecture.md

@@ -1,5 +1,5 @@
 ---
-description: Gera o docs/architecture.md por entrevista guiada — stack, monorepo, testes, glossário técnico e diagrama ER. Roda depois do /utf-flows.
+description: Gera o docs/architecture.md por entrevista guiada — stack, projeto, testes, glossário técnico e diagrama ER. Roda depois do /utf-design.
 ---
 
 Leia `.agents/workflows/architecture.md` e execute-o integralmente.

.opencode/command/utf-design.md

@@ -0,0 +1,5 @@
+---
+description: Conduz as decisões de design da Fase 0 — framework CSS, tokens (docs/design-tokens.md), protótipo navegável, Mobile-First e identidade PWA. Roda depois do /utf-prd e antes do /utf-architecture.
+---
+
+Leia `.agents/workflows/design.md` e execute-o integralmente.

.opencode/command/utf-prd.md

@@ -1,5 +1,5 @@
 ---
-description: Gera o docs/prd.md por entrevista guiada — tema, glossário, atores, user stories, regras de negócio e NFRs. Roda antes do /utf-flows.
+description: Gera o docs/prd.md por entrevista guiada — tema, glossário, atores, user stories, regras de negócio e NFRs. Roda antes do /utf-design.
 ---
 
 Leia `.agents/workflows/prd.md` e execute-o integralmente.