WorkOS — o Sistema que Sustenta minha Equipe
Como mapear, planejar e construir um sistema interno sob medida para o seu negócio com Next.js, Supabase e Vercel.
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?
Na Formação Gestor de IA você vai do zero ao site no ar comandando equipes de agentes, sem escrever uma linha de código.