WorkOS — o Sistema que Sustenta minha Equipe
Você vai construir o mapa completo de um sistema interno sob medida para a sua equipe — o "sistema operacional" do dia a dia do negócio. Antes de qualquer
O que é
WorkOS — o Sistema que Sustenta minha Equipe
Você vai construir o mapa completo de um sistema interno sob medida para a sua equipe — o "sistema operacional" do dia a dia do negócio. Antes de qualquer linha de código, você identifica onde o trabalho trava hoje, define o núcleo do que o sistema precisa ter e transforma tudo isso num PRD pronto para o squad de dev executar. A stack de referência é Next.js + Supabase + Vercel, a mesma base usada nos outros projetos.
A maioria das equipes vive pulando entre cinco ou seis ferramentas que não conversam entre si: o mesmo dado digitado em três lugares, planilhas exportadas para colar em outro sistema, tempo perdido e erro garantido. Um sistema sob medida elimina esse retrabalho porque foi desenhado em cima do fluxo real da sua empresa — não do fluxo genérico que a ferramenta de prateleira assume. O resultado é eficiência operacional real: a equipe abre um lugar só, os dados moram num lugar só, e o processo passa a ser o processo da sua empresa.
O tutorial passa por quatro conceitos centrais. WorkOS é o sistema operacional interno da equipe — o lugar onde o trabalho de fato acontece. Núcleo (core) são as poucas entidades e telas sem as quais o sistema não faz sentido; é o coração, não a lista de desejos. Entidade é uma "coisa" que o sistema guarda e organiza, como cliente, pedido ou tarefa. PRD é o plano que traduz o mapa em algo executável pelo time.
Antes de começar, você precisa de acesso à rotina da equipe (quais ferramentas eles abrem e o que digitam em cada uma), ter lido o tutorial de PRD (REV-OS), ter o squad de dev disponível no Claude Code via /team-os, e contas na Vercel e no Supabase para publicar o sistema.
Como funciona
Principais recursos
Mapeie as repetições de dados
Liste todas as ferramentas que a equipe usa num dia e marque onde a mesma informação aparece em mais de um lugar. Cada repetição é um candidato direto a ser resolvido pelo sistema.
Defina o núcleo enxuto
Identifique as 3 a 5 entidades essenciais e as telas que a equipe precisa ver todo dia. Resistir a colocar tudo é o que mantém o sistema sustentável e rápido de construir.
Gere o PRD completo
Transforme o mapa em um plano executável com objetivo, estrutura de tabelas, arquitetura, fluxo de autenticação e sequência de implementação em ondas.
Construa com o squad de dev
Use o /team-os no Claude Code para orquestrar a construção em paralelo: banco primeiro, depois componentes e telas, por fim QA. Aprove o plano antes de executar.
Publique na Vercel
Com o sistema testado localmente, conecte o repositório à Vercel e coloque o WorkOS no ar num endereço acessível para toda a equipe.
Nível: intermediário · Tempo estimado: 30 min
Pré-requisitos
- •Acesso a como sua equipe trabalha hoje (quais ferramentas eles abrem, o que digitam onde)
- •O tutorial de PRD (REV-OS) já lido — o sistema sob medida também nasce de um PRD
- •O squad de dev disponível no Claude Code (/team-os — github.com/joaoguirunas/team-os)
- •Uma conta na Vercel (vercel.com) para publicar, e no Supabase (supabase.com) para banco e login
Conceitos-chave
WorkOS
O sistema operacional interno da sua equipe — o lugar onde o trabalho acontece de verdade, centralizando dados e processos num único ambiente.
Núcleo (core)
As poucas entidades e telas sem as quais o sistema não faz sentido. É o coração do projeto, não a lista de desejos — enxuto, essencial e executável.
Entidade
Uma "coisa" que o sistema guarda e organiza: cliente, pedido, tarefa, contrato. As entidades são o esqueleto do banco de dados.
PRD
O plano que traduz o mapa visual em algo executável pelo time — com objetivo, estrutura de tabelas, arquitetura e sequência de implementação.
Passo a passo
Construindo o WorkOS
Passo 1 — Liste as ferramentas que a equipe abre num dia
Sente com a equipe (ou observe o dia deles) e anote toda ferramenta aberta num dia normal: planilha, CRM, WhatsApp, e-mail, gestor de tarefas, drive, sistema de nota, etc. Não filtre ainda — só liste. Esse inventário é o ponto de partida para enxergar onde o trabalho trava.
Passo 2 — Marque onde os dados se repetem
Em cima da lista de ferramentas, marque onde a mesma informação aparece em mais de um lugar. Por exemplo: o nome do cliente digitado no CRM, de novo na planilha e de novo na proposta. Cada repetição é um candidato a ser resolvido pelo sistema. É aqui que o desperdício fica visível — e que o argumento para construir o sistema fica claro.
Passo 3 — Defina o núcleo (entidades e telas essenciais)
Olhando as repetições, pergunte: quais são as poucas "coisas" que o sistema precisa guardar? Essas são as entidades. E quais telas a equipe precisa ver todo dia? Essas são as telas essenciais. Um bom núcleo é enxuto: 3 a 5 entidades e as telas para vê-las e editá-las. Resista a colocar tudo — o que não é núcleo fica para depois.
Passo 4 — Gere o PRD
Com o núcleo definido, escreva o plano usando o método do tutorial de PRD (REV-OS): descreva o objetivo, o que precisa ser construído, a estrutura das entidades, o fluxo de login e a sequência de implementação. Salve o arquivo dentro do projeto no caminho indicado.
docs/PRD-workos.md
Passo 5 — Construa com o squad de dev
No Claude Code, rode o /team-os, passe o PRD e peça o plano antes de executar. Aprove um plano em ondas: base do banco primeiro; depois componentes, telas e autenticação em paralelo; por fim ajustes e QA. Rejeite plano fraco e peça orquestração mais agressiva. Lembre das ações manuais que só o humano faz: ativar o RLS no Supabase (SQL Editor) e criar o usuário de acesso (Authentication → Users).
Passo 6 — Teste localmente
Rode o ambiente local e navegue pelas telas do núcleo. Confira: as entidades estão listadas, dá para criar e editar, e o login protege o que precisa ser protegido. Só avance para a publicação depois que tudo funcionar no ambiente local.
npm run dev
Passo 7 — Publique na Vercel
Com o sistema testado, publique. A Vercel conecta ao repositório e coloca o sistema no ar num endereço acessível para a equipe. A partir daí, o WorkOS deixa de ser um protótipo e vira a ferramenta do dia a dia — o lugar onde o trabalho acontece.
Mapear repetições de dados
Vou te descrever as ferramentas que minha equipe abre num dia e o que fazem em cada uma. Sua tarefa: identificar onde a mesma informação é digitada em mais de um lugar e propor quais entidades (coisas que o sistema guarda) e telas essenciais formariam o núcleo de um sistema interno único. Ferramentas e uso: <DESCREVA AQUI>
Gerar o PRD do WorkOS
Com base no núcleo definido (entidades e telas essenciais), gere um PRD completo para um sistema interno em Next.js + Supabase + Vercel. No PRD inclua: objetivo e escopo, estrutura completa das tabelas (campos, tipos e regras), arquitetura, fluxo de autenticação com Supabase Auth, e sequência de implementação passo a passo. Salve como docs/PRD-workos.md.
PRD para painel de acompanhamento de pedidos
Gere um PRD completo para um sistema interno que centralize o acompanhamento de pedidos da minha equipe, em Next.js + Supabase + Vercel. Entidades do núcleo: Cliente, Pedido e Tarefa. O sistema precisa de uma tela de lista de pedidos com status (aberto, em andamento, concluído), uma tela de detalhe do pedido com as tarefas ligadas a ele, e uma tela de clientes. Login por e-mail e senha via Supabase Auth; só usuário autenticado edita. No PRD inclua: objetivo e escopo, estrutura completa das tabelas (campos, tipos e regras de relacionamento entre elas), arquitetura, fluxo de autenticação e sequência de implementação em ondas. Salve como docs/PRD-workos.md.
Pedir plano de orquestração no /team-os
Leia o docs/PRD-workos.md. Antes de executar, me apresente um plano de orquestração em ondas para eu aprovar, usando somente a squad de dev e com o máximo de paralelismo possível.
Erros comuns
- •Querer resolver tudo de uma vez: O núcleo tem que ser enxuto. Se a lista de telas passou de meia dúzia, você provavelmente misturou o essencial com o "seria bom ter". Corte para depois.
- •Pular o Passo 2: Sem mapear as repetições, o sistema vira mais uma ferramenta a mais — exatamente o que você queria evitar.
- •Construir sem plano: Igual ao tutorial de PRD — sempre aprove o plano em ondas antes de liberar a execução.
- •Esquecer as ações manuais: Sem ativar o RLS e criar o usuário no Supabase, o login não funciona.
- Lista completa das ferramentas que a equipe abre num dia
- Repetições de dados identificadas
- Núcleo definido (3-5 entidades + telas essenciais)
- PRD gerado e salvo em docs/PRD-workos.md
- Plano em ondas aprovado no /team-os
- RLS ativado e usuário criado no Supabase
- Testado com npm run dev
- Publicado na Vercel e acessível pela equipe
- •team-os — squad de dev e orquestração em ondas (https://github.com/joaoguirunas/team-os)
- •Supabase — banco de dados e Auth (https://supabase.com)
- •Vercel — publicação do sistema (https://vercel.com)
Vá além do tutorial
Quer dominar isso na prática?
Aprofunde com acompanhamento direto na mentoria ou siga o passo a passo completo, do zero ao avançado, no curso online.