Specs existentes
Papel no sistema
Specs e planos registram por que a arquitetura atual existe. Eles são a fonte de contexto antes de mexer em auth, D1, workflows ou no próprio app de specs.
Onde fica o código
Os documentos ficam em docs/superpowers/specs e docs/superpowers/plans. Comece por estes arquivos:
docs/superpowers/specs/2026-06-22-workflows-platform-design.mddocs/superpowers/specs/2026-06-19-drizzle-d1-db-package-design.mddocs/superpowers/specs/2026-06-19-betterauth-design.mddocs/superpowers/plans/2026-06-22-workflows-platform-phase-0-foundations.mddocs/superpowers/plans/2026-06-22-workflows-platform-phase-5-monitor.md
Como se conecta com o resto
As specs explicam as fronteiras entre apps/monitor, apps/api, apps/workflows, packages/auth, packages/db e packages/workflow-core. Os planos mostram a sequência de implementação e ajudam a entender quais decisões já foram deliberadas.
Como verificar
Use rg -n "workflows|Better Auth|D1|specs" docs/superpowers/specs docs/superpowers/plans para encontrar decisões relacionadas antes de alterar comportamento. Em mudanças de docs, confirme que os caminhos listados ainda existem com test -f.