scale-check

Auditoria de prontidão para produção em 7 pontos da base de código: índices e consultas em loops, cache de leitura compartilhada, execução como duas cópias, trabalho lento em requisições web, backups e restauração, cache público vs. privado e limites de taxa em endpoints públicos ou pagos. Execute em modo plano com /scale-check, opcionalmente seguido por uma pasta ou rota para focar.

O que é scale-check?

O skill scale-check é uma ferramenta de auditoria em modo somente leitura que realiza uma análise de prontidão para produção em 7 pontos na base de código. Ele inspeciona a aplicação em busca de problemas comuns de escalabilidade, como consultas N+1 (consultas em loops), falta de índices em colunas de banco de dados, ausência de cache para leituras repetidas que retornam os mesmos dados para todos os usuários, dependência de estado em memória ou disco local que impediria a execução de múltiplas instâncias, trabalho síncrono lento dentro de requisições web (como chamadas de IA ou envio de e-mails), falta de configuração de backup e restauração, configuração incorreta de cache que pode vazar dados privados e ausência de limites de taxa em endpoints públicos ou que consomem serviços pagos. O skill é compatível com qualquer repositório que use Claude Code e deve ser executado no modo plano (plan mode). Ele não modifica arquivos, apenas gera um relatório detalhado com localizações exatas e um plano de correção priorizado, começando pelos itens mais críticos para a sobrevivência da aplicação (backups e limites de taxa). A análise é feita estaticamente, identificando pistas que devem ser verificadas, pois configurações de infraestrutura (como backups gerenciados, regras de CDN ou WAF) podem não estar no repositório.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/eboywonder/missing-readme-skills/tree/main/scale-check

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Scale Check — Auditoria de Prontidão para Produção em 7 Pontos

Você está executando /scale-check no modo plano somente leitura. Sua tarefa é inspecionar a base de código com base nas 7 perguntas de escalabilidade abaixo e apresentar um plano de verificação e correção claro e priorizado na tela do usuário.

Escopo Alvo: $ARGUMENTS (Se vazio, audite todo o repositório).


Regras de Ferro (Leia Antes de Escanear)

  1. Olhe, não altere: Você está estritamente em modo de diagnóstico e planejamento. NÃO crie, edite ou exclua nenhum arquivo. NÃO execute migrações de banco de dados, comandos que alteram estado ou requisições de rede.
  2. Descobertas são pistas para verificar, não fatos: A análise estática do repositório não pode ver painéis de nuvem externos, regras de CDN, políticas de WAF ou configurações de banco de dados gerenciados. Enquadre cada problema que você encontrar como uma pista para verificar, nunca como um bug garantido.
  3. Sempre cite localizações exatas: Cada pista de código deve incluir caminho/para/arquivo:linha e o símbolo ou consulta específica envolvida. Se algo estiver faltando na base de código, reporte explicitamente: "Não encontrado no repositório — verifique em seu provedor de hospedagem/nuvem."
  4. Corrija um de cada vez, começando pela sobrevivência: Ordene o plano de remediação final sempre começando por Backups (Questão 5) e Limites de Taxa (Questão 7), depois qualquer vazamento de dados privados através de um cache compartilhado (Questão 6), e então as questões restantes na ordem em que geralmente afetam um aplicativo em crescimento: índices e loops (Q1), leituras compartilhadas (Q2), execução como duas cópias (Q3), trabalho lento em requisições (Q4) e cache de ativos públicos (o restante da Q6).

Fluxo de Trabalho de Execução

Fase 1: Identifique a Stack (Passagem Rápida)

Antes de verificar as 7 perguntas, identifique rapidamente a stack do projeto para que você procure nos lugares certos:

  • Manifestos e Frameworks: Verifique package.json, pyproject.toml, requirements.txt, go.mod, Cargo.toml ou Gemfile.
  • Banco de Dados e ORM: Localize schema.prisma, arquivos de esquema Drizzle, modelos TypeORM/Sequelize, arquivos SQLAlchemy/Alembic, Django models.py ou migrações .sql brutas.
  • Entrypoints e Rotas: Localize rotas de API (app/api/, pages/api/, src/routes/, controllers/, routers/, main.py, cmd/).
  • Infraestrutura e Configuração: Verifique Dockerfile, docker-compose.yml, vercel.json, next.config.*, fly.toml, render.yaml, nginx.conf, .github/workflows/ e README.md.

Fase 2: Investigue Todas as 7 Perguntas

Execute passagens direcionadas de Glob, Grep e Read para cada uma das 7 perguntas abaixo. Não pule nenhuma pergunta.


As 7 Perguntas

Questão 1: Índices e Consultas Dentro de Loops

  • Forma Curta do Cartão: "Páginas que pesquisam ou listam dados: as colunas são indexadas e há alguma consulta dentro de um loop?"
  • Pergunta de Diagnóstico Completa: Onde o aplicativo lista, filtra, ordena ou pesquisa registros, as colunas de banco de dados subjacentes (WHERE, JOIN, ORDER BY, chaves estrangeiras) são suportadas por índices no esquema, e algum endpoint executa uma consulta de banco de dados ou API dentro de um loop (o problema N+1) ou busca linhas ilimitadas sem paginação?
  • Onde e Como Procurar:
    • Esquema vs. Consultas: Compare consultas de lista/pesquisa (findMany, select, filter, WHERE, ILIKE, ORDER BY) com definições de índice (@@index, index(), CREATE INDEX, db_index=True). Observe que Prisma/SQLAlchemy frequentemente não indexam automaticamente chaves estrangeiras ou colunas de ordenação, a menos que explicitamente declarado.
    • Loops com E/S: Pesquise em manipuladores de rota e funções de serviço por for (, for await, .map(async, forEach(async ou compreensões de lista que chamam db., prisma., supabase., session.execute ou fetch( dentro do corpo da iteração.
    • Leituras Ilimitadas: Verifique se os endpoints de lista impõem um limite take/limit ou se uma única requisição pode carregar uma tabela inteira na memória.
  • O Que Pode Estar Fora do Repositório (Verificação de Falso Positivo):
    • Índices podem ter sido criados manualmente em consoles de produção SQL sem serem commitados em arquivos de migração.
    • Pequenas tabelas de consulta (por exemplo, <50 funções ou categorias estáticas) não causarão gargalos com um índice ausente, embora loops N+1 sobre dados gerados pelo usuário causarão.

Questão 2: Leituras Compartilhadas Repetidas

  • Forma Curta do Cartão: "Consultas de leitura que são executadas com frequência e retornam o mesmo resultado para todos."
  • Pergunta de Diagnóstico Completa: Quais consultas de leitura de alto tráfego computam ou buscam exatamente os mesmos dados públicos para cada visitante em cada requisição — como feeds de página inicial, catálogos de produtos, configuração global, leaderboards ou contagens públicas — sem armazenar o resultado em cache na memória, Redis/KV ou no cache de dados do framework?
  • Onde e Como Procurar:
    • Inspecione rotas públicas, homepages, carregadores de layout e middlewares globais que acessam o banco de dados primário em cada carregamento de página sem parâmetros específicos do usuário (userId, sessionId, orgId).
    • Verifique agregações caras (COUNT(*), SUM(), joins de múltiplas tabelas) sendo executadas ao vivo em endpoints públicos.
    • Procure por primitivas de cache existentes (unstable_cache, 'use cache', revalidate, Redis get/set, @lru_cache, Cache-Control: s-maxage) para ver se as leituras compartilhadas já estão encapsuladas.
  • O Que Pode Estar Fora do Repositório (Verificação de Falso Positivo):
    • Um CDN upstream (Cloudflare, CloudFront, Fastly) pode já estar armazenando em cache rotas públicas completas na borda por meio de regras de página do painel.

Questão 3: Executando como Duas Cópias (Ausência de Estado e Armazenamento Local)

  • Forma Curta do Cartão: "O aplicativo poderia ser executado como duas cópias, e o que vive na memória de um servidor ou em seu disco?"
  • Pergunta de Diagnóstico Completa: Se o tráfego aumentar e você iniciar uma segunda instância do servidor atrás de um balanceador de carga (ou implantar em instâncias serverless de escalonamento automático), o que quebra porque o estado é armazenado na RAM de um único processo ou escrito no sistema de arquivos local de um único contêiner?
  • Onde e Como Procurar:
    • Estado de Memória Intraprocesso: Pesquise por new Map(), new Set() em nível de módulo, arrays/objetos mutáveis globais, stores de sessão em memória (MemoryStore), contadores de limite de taxa locais, ou pub/sub intraprocesso (EventEmitter, Sets de WebSocket não conectados) que assumem que todos os usuários atingem o mesmo processo Node/Python/Go.
    • Dependência de Disco Local: Pesquise por escritas em arquivos locais (fs.writeFile, fs.createWriteStream, open(..., 'w'), multer.diskStorage, armazenamento /tmp ou ./uploads) e bancos de dados locais embutidos (sqlite, better-sqlite3, arquivos .db) usados para dados de tempo de execução mutáveis.
    • Tarefas Agendadas Intraprocesso: Verifique se há node-cron, setInterval ou APScheduler iniciados dentro do entrypoint principal do servidor web, o que dispararia tarefas duplicadas se duas instâncias forem executadas simultaneamente.
  • O Que Pode Estar Fora do Repositório (Verificação de Falso Positivo):
    • Maps em nível de módulo usados estritamente como caches somente leitura com um TTL (ou clientes SDK singleton lazy como Prisma/Stripe) são seguros em várias instâncias.
    • Aplicativos single-VPS usando um volume persistente montado e sessões sticky podem intencionalmente ser executados como um único nó — sinalize claramente a troca em vez de chamá-lo de quebrado.

Questão 4: Trabalho Síncrono Lento Dentro de Requisições Web

  • Forma Curta do Cartão: "Em qualquer lugar onde uma requisição web faz algo lento, como uma chamada de IA, um e-mail ou um arquivo."
  • Pergunta de Diagnóstico Completa: Onde uma requisição HTTP mantém a conexão do usuário aberta enquanto espera por trabalho lento, imprevisível ou pesado — como uma chamada de geração LLM/IA, envio de e-mails transacionais, geração de PDFs, redimensionamento de imagens/vídeos, análise de grandes CSVs ou encadeamento de múltiplos webhooks de terceiros — antes de retornar uma resposta?
  • Onde e Como Procurar:
    • Rastreie controladores POST/PUT, Server Actions e manipuladores de webhook do início da requisição até o retorno da resposta.
    • Pesquise por chamadas await bloqueantes para SDKs de IA (openai, @anthropic-ai, @google/genai, ai), provedores de e-mail (resend, nodemailer, sendgrid, postmark), processadores de mídia/arquivo (sharp, ffmpeg, puppeteer, pdfkit) ou APIs externas dentro do caminho crítico da requisição.
    • Verifique se o projeto tem uma fila de segundo plano ou configuração de worker assíncrono (bullmq, inngest, trigger.dev, celery, sidekiq, waitUntil) e se as chamadas lentas realmente o usam ou o ignoram.
  • O Que Pode Estar Fora do Repositório (Verificação de Falso Positivo):
    • Endpoints de IA com streaming (streamText, SSE, respostas fragmentadas) são projetados para permanecer abertos enquanto transmitem tokens para o cliente; sinalize-os apenas se eles fizerem pré/pós-processamento síncrono pesado ou carecerem de limites de tempo limite.

Questão 5: Backups, Réplicas e Caminho de Restauração

  • Forma Curta do Cartão: "Quais backups ou réplicas existem, onde, com que frequência e como restaurar. Se não estiver no repositório, diga isso."
  • Pergunta de Diagnóstico Completa: Quais backups ou réplicas automatizados de banco de dados e armazenamento existem, onde estão armazenados, com que frequência são executados e existe um procedimento documentado e testado para restaurá-los? Se a configuração de backup não estiver visível no repositório, declare isso explicitamente.
  • Onde e Como Procurar:
    • Pesquise em arquivos de infraestrutura (docker-compose.yml, Terraform .tf, Pulumi, CloudFormation, fly.toml, .github/workflows/, scripts/, Makefile, crontab) por pg_dump, mysqldump, sqlite3 .backup, wal-g, litestream, sincronizações de backup S3 ou configurações de réplica.
    • Pesquise em README.md, CONTRIBUTING.md, docs/ ou runbooks/ por qualquer menção a agendamentos de backup, Point-in-Time Recovery (PITR) ou comandos de restauração.
  • Regra Obrigatória para a Questão 5:
    • Na maioria dos aplicativos modernos que usam bancos de dados gerenciados (Supabase, Neon, RDS, PlanetScale, Railway, MongoDB Atlas), as configurações de backup residem no painel da nuvem, não no git.
    • Se você não encontrar configurações de backup e instruções de restauração no repositório, diga isso claramente: "Nenhuma configuração de backup ou runbook de restauração encontrada no repositório. Verifique no painel do seu provedor de banco de dados se backups automatizados/PITR estão habilitados, verifique a frequência de retenção e execute uma restauração de teste em um banco de dados de staging."

Questão 6: Ativos Públicos vs. Cache de Dados Privados

  • Forma Curta do Cartão: "Quais arquivos são os mesmos para todos os usuários e quais nunca devem ser armazenados em cache."
  • Pergunta de Diagnóstico Completa: Os arquivos estáticos que são idênticos para todos os usuários (bundles, fontes, imagens públicas, páginas de marketing) estão configurados para serem armazenados em cache agressivamente na borda do CDN/navegador, e as respostas autenticadas ou específicas do usuário (dados de conta, dashboards, faturamento, tokens de autenticação) estão estritamente protegidas de serem armazenadas em um cache compartilhado?
  • Onde e Como Procurar:
    • Vazamentos de Cache Perigosos (Risco P0): Verifique se alguma rota que retorna dados personalizados, estado de sessão ou JSON privado define Cache-Control: public ou s-maxage sem private ou no-store, ou se o cache de rota do framework (export const revalidate = ..., force-static) está acidentalmente habilitado em uma rota que lê cookies/cabeçalhos para um usuário específico.
    • Ativos Estáticos Não Armazenados em Cache: Verifique next.config.*, vercel.json, nginx.conf, Express static() ou auxiliares de upload S3/CDN para ver se ativos estáticos e mídia pública enviada pelo usuário definem cabeçalhos Cache-Control imutáveis ou de longa duração.
  • O Que Pode Estar Fora do Repositório (Verificação de Falso Positivo):
    • Frameworks como Next.js, Remix e Vite automaticamente fingerprint e armazenam em cache os ativos de build em /_next/static ou /assets no momento da implantação, mesmo sem cabeçalhos personalizados no repositório.

Questão 7: Endpoints Públicos e Pagos (Limites de Taxa e Proteções de Custo)

  • Forma Curta do Cartão: "Quais endpoints são públicos ou chamam um serviço pago, e algo limita quantas vezes um usuário pode chamá-los?"
  • Pergunta de Diagnóstico Completa: Quais rotas podem ser chamadas sem autenticação (login, cadastro, magic links, redefinição de senha, pesquisa pública, formulários de contato, webhooks) ou acionam um serviço medido/pago (APIs LLM, SMS/OTP, envio de e-mail, armazenamento de arquivos, APIs de dados pagas), e o que impõe limites de taxa por IP ou por usuário, limites de tamanho do corpo da requisição e limites de gasto/token no código?
  • Onde e Como Procurar:
    • Inventário de Endpoints de Alto Risco: Liste todas as rotas públicas de autenticação/formulário e todo endpoint que chama uma API externa faturada ou aciona gravações pesadas no banco de dados.
    • Verifique Limitadores de Taxa: Pesquise dependências e middlewares por bibliotecas de limitação de taxa (@upstash/ratelimit, express-rate-limit, rate-limiter-flexible, slowapi, django-ratelimit, rack-attack, golang.org/x/time/rate) e verifique se elas estão realmente anexadas às rotas de risco.
    • Verifique Limites de Entrada e Gasto: Em endpoints de IA ou upload de arquivo, verifique se max_tokens / maxOutputTokens, validação de comprimento do prompt (por exemplo, Zod .max()) e limites de tamanho de arquivo são aplicados antes de chamar o provedor.
  • O Que Pode Estar Fora do Repositório (Verificação de Falso Positivo):
    • A limitação de taxa pode ser aplicada upstream via Cloudflare WAF, AWS API Gateway, Vercel Firewall ou proxy reverso Nginx fora do repositório do aplicativo. Se nenhum limitador no repositório existir, sinalize isso como uma pista de alta prioridade para verificar upstream ou adicionar no middleware.

Formato de Saída (Coloque Este Plano na Tela)

Apresente seu relatório usando as seções exatas abaixo. Mantenha o tom direto, calmo e prático.

1. Instantâneo da Stack e Escopo

  • Stack Detectada: [Framework, Linguagem, DB/ORM, Dicas de Hospedagem/Infra]
  • Escopo Escaneado: [Repositório completo ou caminho específico]
  • Lembrete: Essas descobertas são pistas para verificar, não bugs garantidos. A infraestrutura configurada em painéis de nuvem (backups de BD gerenciados, regras de CDN, limites de taxa WAF) não aparecerá no git.

2. Quadro de Pontuação das 7 Perguntas

#PerguntaStatusPrincipal Pista / Observação
Q1Índices de pesquisa/lista e consultas em loops[PISTA PARA VERIFICAR] / [PARECE COBERTO]Resumo de 1 linha
Q2Leituras compartilhadas frequentes retornando os mesmos dados[PISTA PARA VERIFICAR] / [PARECE COBERTO]Resumo de 1 linha
Q3Executando duas cópias (estado de memória e disco)[PISTA PARA VERIFICAR] / [PARECE COBERTO]Resumo de 1 linha
Q4Trabalho lento dentro de requisições[PISTA PARA VERIFICAR] / [PARECE COBERTO]Resumo de 1 linha
Q5Backups, réplicas e caminho de restauração[PISTA PARA VERIFICAR] / [PARECE COBERTO]Resumo de 1 linha
Q6Cache de ativos públicos vs. dados privados[PISTA PARA VERIFICAR] / [PARECE COBERTO]Resumo de 1 linha
Q7Endpoints públicos/pagos e limites de taxa[PISTA PARA VERIFICAR] / [PARECE COBERTO]Resumo de 1 linha

3. Principais Pistas por Pergunta (Detalhes)

Repita para cada pergunta onde você encontrou uma pista para verificar.

Questão N: Pergunta Curta Aqui

  • Arquivo e Linha: caminho/para/arquivo:linha
  • O Que Foi Encontrado: Descrição concisa do padrão de código, consulta ou configuração ausente.
  • Por Que Isso Importa: Explicação de 1 a 2 frases sobre o risco de produção.
  • Ação de Verificação: Instrução clara do que o desenvolvedor deve fazer para confirmar ou corrigir.

4. Plano de Remediação Priorizado (Ordem de Correção)

Liste as correções na ordem de prioridade especificada na Regra de Ferro #4 (Backups primeiro, depois Limites de Taxa, depois Vazamento de Cache Privado, depois os outros na ordem 1 a 4, depois o restante do cache público).

  1. [Q5] Assunto do Backup — Ação concreta que o desenvolvedor deve realizar.
  2. [Q7] Assunto do Limite de Taxa — Ação concreta que o desenvolvedor deve realizar.
  3. ...

Relatório gerado por /scale-check em modo somente leitura. Sempre verifique as descobertas no console do seu provedor de nuvem antes de fazer alterações.

Habilidades Relacionadas