Community코딩 & 개발github.com

scale-check

읽기 전용 7가지 포인트 코드베이스 생산성 감사: 루프 내 인덱스 및 쿼리, 공유 읽기 캐싱, 두 개의 복사본으로 실행, 웹 요청 내 느린 작업, 백업 및 복원, 공개 vs 비공개 캐싱, 공개 또는 유료 엔드포인트에 대한 속도 제한. `/scale-check`(선택적으로 폴더나 라우트를 추가하여 특정 영역 집중)를 plan 모드에서 실행하세요.

scale-check란 무엇인가요?

Scale Check는 코드베이스가 프로덕션 환경에서 확장 가능한지 평가하기 위해 설계된 읽기 전용 감사 도구입니다. 이는 Claude Code의 Plan 모드에서 실행되며, 7가지 주요 질문을 통해 코드베이스의 병목 지점, 안정성 문제, 캐싱 전략, 상태 관리, 백업 절차, 그리고 보안 및 비용 관리 상태를 분석합니다. 각 질문에 대해 실행 가능한 인사이트와 우선순위가 지정된 수정 계획을 제공하여 개발자가 잠재적인 문제를 신속하게 파악하고 해결할 수 있도록 돕습니다. 이 스킬은 주로 Node.js, Python, Go 등 다양한 언어와 프레임워크로 작성된 프로젝트에서 사용되며, 데이터베이스 스키마, API 라우트, 서비스 로직, 인프라 구성 파일 등을 분석합니다. 사용자는 `/scale-check` 명령어 뒤에 특정 폴더나 경로를 지정하여 감사 범위를 좁힐 수 있으며, 결과는 표 형식의 점수 카드와 상세한 설명, 그리고 우선순위에 따른 실행 계획으로 제공됩니다.

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

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Scale Check — 7가지 포인트 프로덕션 준비 감사

당신은 읽기 전용 plan 모드로 /scale-check를 실행 중입니다. 당신의 작업은 아래 7가지 확장 질문에 대해 코드베이스를 검사하고, 명확하고 우선순위가 지정된 검증 및 수정 계획을 사용자 화면에 표시하는 것입니다.

대상 범위: $ARGUMENTS (비어 있으면 전체 저장소를 감사합니다).


철칙 (스캔 전 읽기)

  1. 보고, 변경하지 마십시오: 당신은 엄격하게 진단 및 계획 모드에 있습니다. 파일을 생성, 편집 또는 삭제하지 마십시오. 데이터베이스 마이그레이션, 상태 변경 명령 또는 네트워크 요청을 실행하지 마십시오.
  2. 발견 사항은 확인해야 할 단서이지, 사실이 아닙니다: 정적 저장소 분석은 외부 클라우드 대시보드, CDN 규칙, WAF 정책 또는 관리형 데이터베이스 설정을 볼 수 없습니다. 발견한 모든 문제를 확인해야 할 단서로 간주하고, 절대 보장된 버그로 간주하지 마십시오.
  3. 항상 정확한 위치를 인용하십시오: 모든 코드 단서에는 path/to/file:line 및 관련된 특정 심볼 또는 쿼리가 포함되어야 합니다. 코드베이스에서 무언가가 누락된 경우, 명시적으로 보고하십시오: "저장소에서 찾을 수 없음 — 호스팅/클라우드 제공업체에서 확인하십시오."
  4. 한 번에 하나씩 수정하고, 생존부터 시작하십시오: 최종 수정 계획은 항상 백업 (질문 5) 및 속도 제한 (질문 7) 부터 시작하고, 그 다음 공유 캐시를 통한 개인 데이터 유출 (질문 6), 그런 다음 일반적으로 성장하는 앱에 영향을 미치는 순서대로 남은 질문(루프 내 인덱스 및 쿼리 (Q1), 공유 읽기 (Q2), 두 개의 복사본으로 실행 (Q3), 요청 내 느린 작업 (Q4), 공개 자산 캐싱 (Q6의 나머지))을 정리하십시오.

실행 워크플로우

1단계: 스택 식별 (빠른 패스)

7가지 질문을 확인하기 전에, 프로젝트의 스택을 신속하게 식별하여 올바른 위치를 살펴보십시오:

  • 매니페스트 및 프레임워크: package.json, pyproject.toml, requirements.txt, go.mod, Cargo.toml 또는 Gemfile을 확인하십시오.
  • 데이터베이스 및 ORM: schema.prisma, Drizzle 스키마 파일, TypeORM/Sequelize 모델, SQLAlchemy/Alembic 파일, Django models.py 또는 원시 .sql 마이그레이션 파일을 찾으십시오.
  • 진입점 및 라우트: API 라우트(app/api/, pages/api/, src/routes/, controllers/, routers/, main.py, cmd/)를 찾으십시오.
  • 인프라 및 구성: Dockerfile, docker-compose.yml, vercel.json, next.config.*, fly.toml, render.yaml, nginx.conf, .github/workflows/ 및 README.md를 확인하십시오.

2단계: 7가지 질문 모두 조사

아래 7가지 질문 각각에 대해 대상 Glob, Grep 및 Read 패스를 실행하십시오. 어떤 질문도 건너뛰지 마십시오.


7가지 질문

질문 1: 루프 내 인덱스 및 쿼리

  • 카드 약식: "데이터를 검색하거나 나열하는 페이지: 열에 인덱스가 있고, 루프 내에 쿼리가 있습니까?"
  • 전체 진단 질문: 애플리케이션이 레코드를 나열, 필터링, 정렬 또는 검색하는 위치, 기본 데이터베이스 열(WHERE, JOIN, ORDER BY, 외래 키)이 스키마에서 인덱스로 지원되는지 여부, 그리고 엔드포인트가 루프 내에서 데이터베이스 또는 API 쿼리를 실행(N+1 문제)하거나 페이지네이션 없이 바인딩되지 않은 행을 가져오는지 여부는 무엇입니까?
  • 찾는 위치 및 방법:
    • 스키마 대 쿼리: 목록/검색 쿼리(findMany, select, filter, WHERE, ILIKE, ORDER BY)를 인덱스 정의(@@index, index(), CREATE INDEX, db_index=True)와 비교하십시오. Prisma/SQLAlchemy는 명시적으로 선언되지 않는 한 외래 키나 정렬 열을 자동으로 인덱싱하지 않는 경우가 많습니다.
    • I/O가 포함된 루프: 라우트 핸들러와 서비스 함수에서 for (, for await, .map(async, forEach(async 또는 반복 본문 내에서 db., prisma., supabase., session.execute 또는 fetch(를 호출하는 리스트 컴프리헨션을 Grep하십시오.
    • 바인딩되지 않은 읽기: 목록 엔드포인트가 take / limit 상한을 적용하는지 또는 단일 요청이 전체 테이블을 메모리에 로드할 수 있는지 확인하십시오.
  • 저장소 외부에 있을 수 있는 것 (오탐지 확인):
    • 마이그레이션 파일에 커밋되지 않고 프로덕션 SQL 콘솔에서 수동으로 인덱스가 생성되었을 수 있습니다.
    • 작은 조회 테이블(예: <50개의 정적 역할 또는 카테고리)은 누락된 인덱스에서 병목 현상이 발생하지 않지만, 사용자 생성 데이터에 대한 N+1 루프는 병목 현상이 발생합니다.

질문 2: 반복되는 공유 읽기

  • 카드 약식: "자주 실행되고 모든 사람에게 동일한 결과를 반환하는 읽기 쿼리."
  • 전체 진단 질문: 트래픽이 많은 읽기 쿼리 중 방문자마다 모든 요청에 대해 정확히 동일한 공개 데이터를 계산하거나 가져오는 쿼리(예: 랜딩 페이지 피드, 제품 카탈로그, 전역 구성, 리더보드 또는 공개 카운트)가 메모리, Redis/KV 또는 프레임워크의 데이터 캐시에 결과를 캐싱하지 않고 있습니까?
  • 찾는 위치 및 방법:
    • 사용자별 매개변수(userId, sessionId, orgId) 없이 모든 페이지 로드 시 기본 데이터베이스에 접근하는 공개 라우트, 홈페이지, 레이아웃 로더 및 전역 미들웨어를 검사하십시오.
    • 공개 엔드포인트에서 실시간으로 실행되는 값비싼 집계(COUNT(*), SUM(), 다중 테이블 조인)를 확인하십시오.
    • 기존 캐시 프리미티브(unstable_cache, 'use cache', revalidate, Redis get/set, @lru_cache, Cache-Control: s-maxage)를 찾아 공유 읽기가 이미 래핑되었는지 확인하십시오.
  • 저장소 외부에 있을 수 있는 것 (오탐지 확인):
    • 업스트림 CDN(Cloudflare, CloudFront, Fastly)이 대시보드 페이지 규칙을 통해 에지에서 전체 공개 라우트를 이미 캐싱하고 있을 수 있습니다.

질문 3: 두 개의 복사본으로 실행 (무상태성 및 로컬 스토리지)

  • 카드 약식: "앱이 두 개의 복사본으로 실행될 수 있으며, 하나의 서버 메모리 또는 디스크에 무엇이 저장되어 있습니까?"
  • 전체 진단 질문: 트래픽이 급증하여 로드 밸런서 뒤에 두 번째 서버 인스턴스를 시작하거나(또는 자동 확장 서버리스 인스턴스에 배포) 단일 프로세스의 RAM에 상태가 저장되거나 단일 컨테이너의 로컬 파일 시스템에 기록되어 중단되는 것은 무엇입니까?
  • 찾는 위치 및 방법:
    • 프로세스 내 메모리 상태: 모듈 수준의 new Map(), new Set(), 전역 가변 배열/객체, 인메모리 세션 저장소(MemoryStore), 로컬 속도 제한 카운터 또는 모든 사용자가 동일한 Node/Python/Go 프로세스를 사용한다고 가정하는 프로세스 내 pub/sub(EventEmitter, 브리징되지 않은 WebSocket Set)을 Grep하십시오.
    • 로컬 디스크 종속성: 로컬 파일 쓰기(fs.writeFile, fs.createWriteStream, open(..., 'w'), multer.diskStorage, /tmp 또는 ./uploads 저장소) 및 가변 런타임 데이터에 사용되는 로컬 임베디드 데이터베이스(sqlite, better-sqlite3, .db 파일)를 Grep하십시오.
    • 프로세스 내 Cron 작업: 메인 웹 서버 진입점 내에서 부팅된 node-cron, setInterval 또는 APScheduler를 확인하십시오. 이는 두 인스턴스가 동시에 실행되면 중복 작업을 실행할 수 있습니다.
  • 저장소 외부에 있을 수 있는 것 (오탐지 확인):
    • 엄격히 읽기 전용 캐시로 TTL과 함께 사용되는 모듈 수준 Map(또는 Prisma/Stripe와 같은 지연 싱글톤 SDK 클라이언트)은 여러 인스턴스에서 안전합니다.
    • 마운트된 영구 볼륨과 고정 세션을 사용하는 단일 VPS 앱은 의도적으로 단일 노드로 실행될 수 있습니다. 트레이드오프를 명확히 표시하고, 고장났다고 말하지 마십시오.

질문 4: 웹 요청 내 느린 동기식 작업

  • 카드 약식: "웹 요청이 AI 호출, 이메일 또는 파일과 같은 느린 작업을 수행하는 부분."
  • 전체 진단 질문: HTTP 요청이 응답을 반환하기 전에 느리거나 예측 불가능하거나 무거운 작업(예: LLM/AI 생성 호출, 트랜잭션 이메일 전송, PDF 생성, 이미지/비디오 크기 조정, 대규모 CSV 구문 분석 또는 여러 타사 웹훅 체이닝)을 기다리는 동안 사용자 연결을 열어 두는 위치는 어디입니까?
  • 찾는 위치 및 방법:
    • POST/PUT 컨트롤러, 서버 액션 및 웹훅 핸들러를 요청 시작부터 응답 반환까지 추적하십시오.
    • AI SDK(openai, @anthropic-ai, @google/genai, ai), 이메일 제공업체(resend, nodemailer, sendgrid, postmark), 미디어/파일 프로세서(sharp, ffmpeg, puppeteer, pdfkit) 또는 외부 API에 대한 중요한 요청 경로 내의 await 호출을 차단하는지 Grep하십시오.
    • 프로젝트에 백그라운드 큐 또는 비동기 워커 설정(bullmq, inngest, trigger.dev, celery, sidekiq, waitUntil)이 있는지, 그리고 느린 호출이 실제로 이를 사용하는지 또는 우회하는지 확인하십시오.
  • 저장소 외부에 있을 수 있는 것 (오탐지 확인):
    • 스트리밍 AI 엔드포인트(streamText, SSE, 청크 분할 응답)는 클라이언트에 토큰을 스트리밍하는 동안 열려 있도록 설계되었습니다. 무거운 동기식 전/후처리를 수행하거나 시간 제한 경계가 없는 경우에만 플래그를 지정하십시오.

질문 5: 백업, 복제본 및 복원 경로

  • 카드 약식: "어떤 백업 또는 복제본이 존재하는지, 어디에, 얼마나 자주, 그리고 복원 방법. 저장소에 없으면 그렇게 말하십시오."
  • 전체 진단 질문: 어떤 자동화된 데이터베이스 및 스토리지 백업 또는 복제본이 존재하며, 어디에 저장되어 있고, 얼마나 자주 실행되며, 이를 복원하는 문서화되고 테스트된 절차가 있습니까? 백업 구성이 저장소에 표시되지 않으면 명시적으로 명시하십시오.
  • 찾는 위치 및 방법:
    • pg_dump, mysqldump, sqlite3 .backup, wal-g, litestream, S3 백업 동기화 또는 복제본 구성을 위해 인프라 파일(docker-compose.yml, Terraform .tf, Pulumi, CloudFormation, fly.toml, .github/workflows/, scripts/, Makefile, crontab)을 검색하십시오.
    • 백업 일정, 특정 시점 복구(PITR) 또는 복원 명령에 대한 언급이 있는지 README.md, CONTRIBUTING.md, docs/ 또는 runbooks/를 검색하십시오.
  • 질문 5에 대한 필수 규칙:
    • 관리형 데이터베이스(Supabase, Neon, RDS, PlanetScale, Railway, MongoDB Atlas)를 사용하는 대부분의 최신 앱에서 백업 설정은 클라우드 대시보드에 있으며, git에 없습니다.
    • 저장소에서 백업 구성 및 복원 지침을 찾지 못하면 다음과 같이 명확하게 말하십시오: "저장소에서 백업 구성 또는 복원 런북을 찾을 수 없습니다. 데이터베이스 제공업체의 대시보드에서 자동 백업/PITR이 활성화되어 있는지 확인하고, 보존 빈도를 확인한 후 스테이징 데이터베이스에 대한 테스트 복원을 실행하십시오."

질문 6: 공개 자산 대 개인 데이터 캐싱

  • 카드 약식: "모든 사용자에게 동일한 파일과 절대 캐시되어서는 안 되는 파일."
  • 전체 진단 질문: 모든 사용자에게 동일한 정적 파일(번들, 글꼴, 공개 이미지, 마케팅 페이지)이 CDN/브라우저 에지에서 적극적으로 캐싱되도록 구성되어 있습니까? 그리고 인증되었거나 사용자별 응답(계정 데이터, 대시보드, 청구, 인증 토큰)이 공유 캐시에 저장되지 않도록 엄격하게 보호되고 있습니까?
  • 찾는 위치 및 방법:
    • 위험한 캐시 누수 (P0 위험): 개인화된 데이터, 세션 상태 또는 개인 JSON을 반환하는 라우트가 private 또는 no-store 없이 Cache-Control: public 또는 s-maxage를 설정하는지, 또는 프레임워크 라우트 캐싱(export const revalidate = ..., force-static)이 특정 사용자에 대한 쿠키/헤더를 읽는 라우트에서 실수로 활성화되었는지 확인하십시오.
    • 캐싱되지 않은 정적 자산: next.config.*, vercel.json, nginx.conf, Express static() 또는 S3/CDN 업로드 헬퍼를 확인하여 정적 자산 및 사용자 업로드 공개 미디어가 변경 불가능하거나 장기간 Cache-Control 헤더를 설정하는지 확인하십시오.
  • 저장소 외부에 있을 수 있는 것 (오탐지 확인):
    • Next.js, Remix 및 Vite와 같은 프레임워크는 저장소에 사용자 정의 헤더가 없더라도 /_next/static 또는 /assets 아래에 빌드 자산을 자동으로 지문 인식하고 배포 시 캐싱합니다.

질문 7: 공개 및 유료 엔드포인트 (속도 제한 및 비용 보호 장치)

  • 카드 약식: "공개되거나 유료 서비스를 호출하는 엔드포인트와 한 사용자가 호출할 수 있는 빈도를 제한하는 장치."
  • 전체 진단 질문: 인증 없이 호출할 수 있는 라우트(로그인, 회원가입, 매직 링크, 비밀번호 재설정, 공개 검색, 문의 양식, 웹훅) 또는 계량/유료 서비스(LLM API, SMS/OTP, 이메일 전송, 파일 저장소, 유료 데이터 API)를 트리거하는 라우트는 무엇이며, IP별 또는 사용자별 속도 제한, 요청 본문 크기 상한 및 비용/토큰 제한을 코드에서 시행하는 것은 무엇입니까?
  • 찾는 위치 및 방법:
    • 고위험 엔드포인트 인벤토리 작성: 모든 공개 인증/양식 라우트와 과금되는 외부 API를 호출하거나 무거운 DB 쓰기를 트리거하는 모든 엔드포인트를 나열하십시오.
    • 속도 제한 장치 확인: 종속성 및 미들웨어에서 속도 제한 라이브러리(@upstash/ratelimit, express-rate-limit, rate-limiter-flexible, slowapi, django-ratelimit, rack-attack, golang.org/x/time/rate)를 Grep하고 실제로 위험한 라우트에 연결되어 있는지 확인하십시오.
    • 입력 및 비용 상한 확인: AI 또는 파일 업로드 엔드포인트에서 제공자를 호출하기 전에 max_tokens / maxOutputTokens, 프롬프트 길이 검증(예: Zod .max()) 및 파일 크기 제한이 시행되는지 확인하십시오.
  • 저장소 외부에 있을 수 있는 것 (오탐지 확인):
    • 속도 제한은 애플리케이션 저장소 외부에서 Cloudflare WAF, AWS API Gateway, Vercel Firewall 또는 Nginx 리버스 프록시를 통해 업스트림에서 시행될 수 있습니다. 저장소 내 제한기가 없으면 업스트림에서 확인하거나 미들웨어에 추가해야 할 높은 우선순위의 단서로 플래그를 지정하십시오.

출력 형식 (화면에 이 계획 표시)

아래 정확한 섹션을 사용하여 보고서를 제공하십시오. 어조는 직설적이고 차분하며 실용적으로 유지하십시오.

1. 스택 및 범위 스냅샷

  • 감지된 스택: [프레임워크, 언어, DB/ORM, 호스팅/인프라 힌트]
  • 스캔된 범위: [전체 저장소 또는 특정 경로]
  • 알림: 이 발견 사항은 확인해야 할 단서이지, 보장된 버그가 아닙니다. 클라우드 대시보드(관리형 DB 백업, CDN 규칙, WAF 속도 제한)에서 구성된 인프라는 git에 나타나지 않습니다.

2. 7가지 질문 점수 카드

#질문상태주요 단서 / 관찰
Q1검색/목록 인덱스 및 루프 내 쿼리[확인 필요] / [적절히 처리됨]1줄 요약
Q2동일한 데이터를 반환하는 빈번한 공유 읽기[확인 필요] / [적절히 처리됨]1줄 요약
Q3두 개의 복사본 실행(메모리 및 디스크 상태)[확인 필요] / [적절히 처리됨]1줄 요약
Q4웹 요청 내 느린 작업[확인 필요] / [적절히 처리됨]1줄 요약
Q5백업, 복제본 및 복원[확인 필요] / [적절히 처리됨]1줄 요약
Q6공개 자산 대 개인 데이터 캐싱[확인 필요] / [적절히 처리됨]1줄 요약
Q7공개 및 유료 엔드포인트 속도 제한[확인 필요] / [적절히 처리됨]1줄 요약

3. 각 질문에 대한 상세 분석

각 [확인 필요] 상태에 대해 아래 템플릿을 사용하여 자세히 설명하십시오.

Q[번호]: [질문 제목]

발견 사항:

  • 단서 1: path/to/file:line — 설명. (심각도: 높음/중간/낮음)
  • 단서 2: path/to/file:line — 설명. (심각도: 높음)
  • ...

권장 사항:

  1. 특정 작업을 수행하기 위해 할당 가능한 작업 항목 또는 변경 사항입니다.
  2. ...

참고 사항 (오탐지 가능성): (이 섹션은 확인 사항이 저장소 외부에 있을 수 있는 경우에만 포함하십시오. 예: 관리형 DB 백업, CDN 규칙, WAF 제한)

4. 우선순위 수정 계획

이 섹션은 모든 확인 사항을 생존 우선 순서대로 정리합니다.

1️⃣ 생존 (즉각 주의)

  • [질문 5] 첫 번째 구체적 단서 요약
  • [질문 7] 첫 번째 구체적 단서 요약
  • [질문 6] 데이터 누출 단서 요약 (있는 경우)

2️⃣ 성장 (다음 우선순위)

  • [질문 1] ...
  • [질문 2] ...
  • [질문 3] ...
  • [질문 4] ...
  • [질문 6] (공개 자산 캐싱 관련 단서가 남아 있는 경우)

이 감사는 정적 코드 분석 도구로서 7가지 핵심 영역에서 확인해야 할 단서를 찾아냅니다. 이것은 프로덕션 트래픽 부하 테스트나 보안 침투 테스트를 대체하지 않습니다.

관련 스킬