chore: npm workspaces na raiz, e o setup instalando linter e formatação

[ronifabio]

Closes #

O que este PR faz e por quê

Dois defeitos do /utf-setup que só apareceram quando fui escrever o enunciado da atividade que roda esse comando. Os dois têm a mesma forma: o workflow exige uma coisa que ele mesmo nunca cria.

Primeiro, a raiz do monorepo. O Passo 3 mandava criar o package.json da raiz "com os scripts de orquestração descritos no architecture.md" — só que o architecture.md não tinha seção nenhuma onde descrevê-los, e a raiz nem aparecia na árvore do §3. Cada equipe inventava a própria raiz, e o setup adivinhava. Pior: sem workspaces o repositório tem dois pacotes com dependências de verdade (o json-server na raiz, o Angular em apps/web), então quem clona instala duas vezes, em duas pastas — a fricção clássica que derruba integrante novo, sem dar mensagem de erro nenhuma. O documento ganha a §3.1 com o package.json declarado por extenso (private, workspaces: ["apps/*"], os scripts) e a nota explicando o que isso compra. O workflow ganha a ordem correta, que é a parte sutil: gerar com --skip-install, criar a raiz, e só então instalar uma vez — fora dessa ordem o npm instala dentro de apps/web antes de a raiz existir, o hoisting não acontece, e sobra um node_modules duplicado que ninguém percebe porque tudo continua funcionando.

Segundo, o linter. O Passo 5 manda rodar o lint como prova de vida, e o §2 exige declarar "os comandos exatos de suíte e lint" — mas nada instalava linter nenhum, e o ng new não traz ESLint. O setup declarava um comando, exigia que ele passasse, e entregava ao aluno um npm run lint inexistente. Agora o Passo 2 roda ng add angular-eslint quando o documento declara comando de lint, e o Passo 3 acrescenta Prettier, eslint-config-prettier, .prettierrc e .editorconfig na raiz. O eslint-config-prettier não é precaução teórica: a config recomendada do angular-eslint inclui tseslint.configs.stylistic, então o conflito com o Prettier é real.

Nx e Turborepo seguem fora, e agora o documento diz por quê em vez de só omitir: eles resolvem cache de build e grafo de dependências entre muitos subprojetos, que não é o problema desta disciplina. Extensão de IDE também fica de fora de propósito — o que se versiona aqui é a regra que o agente lê; obedecer a ela é configuração da máquina de cada um.

Apontamentos da revisão

Não se aplica — PR de manutenção, sem spec.md.

🤖 Generated with Claude Code