Mapa do repositório
Papel no sistema
Esta página orienta novos desenvolvedores pelo monorepo. A regra prática é separar apps executáveis, pacotes compartilhados e documentação de decisões para evitar procurar lógica de runtime dentro de specs ou componentes.
Onde fica o código
apps/monitor: painel interno em TanStack Start para desenvolvedores.apps/api: Worker Hono para endpoints externos e API keys.apps/workflows: Worker dono dos Cloudflare Workflows e da superfície RPC.apps/specs: site de documentação técnica.packages/ui: componentes e CSS compartilhados.packages/auth: configuração Better Auth para monitor e API.packages/db: schema, migrations, seed e helpers Drizzle/D1.packages/workflow-core: contratos, instrumentação e helpers comuns de workflows.packages/demo-workflow: exemplo mínimo de workflow registrado emapps/workflows.docs/superpowers/specs: specs aprovadas e contexto de design.docs/superpowers/plans: planos de implementação por fase.
Como se conecta com o resto
Os apps consomem os pacotes por imports de workspace. apps/monitor e apps/api dependem de packages/auth, packages/db e packages/workflow-core; apps/workflows também depende de packages/demo-workflow para registrar o workflow de exemplo.
Como verificar
Use rg --files apps packages docs/superpowers para confirmar a localização dos arquivos. Depois de mover ou criar páginas, rode a checagem de navegação do Task 4 para garantir que cada slug em apps/specs/src/lib/navigation.ts tenha um .mdoc correspondente.