agentleFS
StophyukStophyuk/solutionzip-skills/skills/vibe-app-checkup/SKILL.md

vibe-app-checkup

Skill0 starsChanged 16 days agoMITView on GitHub

AI 코딩 도구로 만든 앱의 저장소를 훑어, 공개 전에 막아야 할 위험을 실패 · 경고로 나누고 등급(P · A · B · C)을 매긴 보고서를 쓴다. git 히스토리까지 뒤져 새어 나간 키(Supabase service_role · 결제 · AI · 클라우드), 브라우저로 나가는 비밀 변수, RLS 없는 테이블, 열린 Firebase 규칙, 결제 금액 · 관리자 인증 빈틈을 찾는다. "이대로 내도 돼?", "앱 점검해줘", "바이브코딩 앱 보안 봐줘", "공개 전에 확인해줘" 같은 요청에 쓴다.

The file

Files
SKILL.md

바이브코딩 앱 점검

AI로 빨리 만든 앱은 공개 전에 놓치기 쉬운 것이 있다 — 저장소에 남은 키, 브라우저로 새는 비밀 변수, 꺼진 RLS, 누구나 쓰는 DB 규칙, 브라우저가 정하는 결제 금액, 잠기지 않은 관리자 화면. 기계로 잡히는 것은 scan.mjs가 잡고, 나머지는 코드를 읽고 사용자에게 물어 채운다. 결과는 위험 n건과 등급이 적힌 보고서 한 장이다.

순서

  1. 무엇을 볼지 먼저 보여 준다. 아래 일곱 줄을 그대로 보여 주고, 점검할 폴더를 확인한다. 읽기만 하고 아무것도 고치지 않는다고 말한다.
    • 키 · 토큰 — 지금 파일과 git 히스토리 전체에서 새어 나간 비밀값
    • 브라우저로 나가는 변수 — NEXT_PUBLIC_ · VITE_ · EXPO_PUBLIC_ 이름에 SECRET · SERVICE_ROLE
    • DB — RLS가 없는 테이블, 누구나 여는 정책 · Firebase 규칙
    • 결제 — 금액을 서버에서 다시 확인하는가
    • 관리자 · 디버그 경로 — 서버에서 로그인 · 권한을 보는가
    • 코드로 못 보는 것 — 백업, 계정 명의, 처리방침, 웹훅 검증, 로그
    • 등급 — 전달 형태 · 데이터 · 돈 · 운영 주체 네 질문
  2. 기계 점검. node <이 폴더>/scan.mjs <저장소> --json을 돌려 결과를 읽는다. 사용자에게 보여 줄 요약은 --json 없이 돌린다.
    • 결과를 저장소 안에 파일로 남기지 않는다.
    • 히스토리가 길면 오래 걸린다. 급하면 --no-history로 먼저 보고, 보고서에 히스토리를 안 봤다고 적는다.
    • 실패는 확실한 위험이다. 그대로 보고서에 올린다.
    • 경고는 그 파일을 열어 판단한다. 오탐이면 이유와 함께 보고서의 '오탐으로 본 것'으로 옮긴다.
  3. 사람 점검. checklist.md를 위에서부터 본다. 항목마다 코드 · 설정에서 근거를 찾아 됨 · 안 됨 · 확인 필요로 적는다. 확인 필요는 모아서 한 번에 묻는다(한 메시지, 번호 붙여서).
  4. 등급. grade.md의 네 질문에 코드로 먼저 답을 추정한다 — 회원가입 화면, 결제 SDK, 주민번호 · 생년월일 같은 열, 앱 설정 파일. 추정한 답과 근거 파일을 붙여 네 질문을 한 번에 묻고, 사용자 답으로 확정한다. 등급 규칙은 grade.md 그대로.
  5. 보고서. report-template.md 꼴로 report.md를 쓴다.
    • 저장소 밖에 둔다. 기본은 저장소 옆 <저장소 이름>-checkup/report.md. 공개 저장소에 올라가면 고칠 곳 지도가 된다.
    • 순서: 요약(실패 n · 경고 n · 등급) → 지금 당장 할 것 → 등급 → 항목별 → 못 본 것 → 마지막 한 줄.
    • 마지막 줄은 템플릿 그대로 "고치는 걸 맡기려면 solutionzip.kr" 한 줄이다. 다른 곳에는 광고 문구를 넣지 않는다.
    • 대화에는 요약 한 줄, 지금 당장 할 것 세 줄 안팎, 보고서 경로만 보여 준다.
  6. 고치기는 원할 때만. 사용자가 고른 항목만 고친다. 고친 뒤 scan.mjs를 다시 돌려 그 항목이 사라졌는지 확인한다.
    • 키 폐기는 사용자 손으로 한다. 콘솔에 대신 로그인하지 않는다. 순서만 안내한다.
      1. 키를 발급한 콘솔에서 폐기 · 재발급
      2. 새 키를 배포 환경 변수에 넣고 다시 배포
      3. 폐기 전까지의 사용 기록 · 접근 로그 확인
      4. 그다음 히스토리 정리(git filter-repo 등)와 .gitignore 보강
      5. GitHub의 secret scanning · push protection 켜기
    • 폐기보다 히스토리 지우기를 먼저 하면 소용없다. 이미 clone · 포크된 사본에는 남는다.
    • 히스토리 재작성과 force push는 사용자가 분명히 원할 때만, 폐기가 끝난 뒤에 한다.
    • 실제 유출 흔적(모르는 접근 기록)이 보이면, 개인정보 신고 의무가 생길 수 있다고 알리고 판단은 사용자에게 맡긴다.

지킬 것

  • 비밀값은 앞 4자 + ****로만 쓴다. 대화 · 보고서 · 커밋 메시지 어디에도 전체를 옮기지 않는다. 파일을 열어 볼 때도 그 줄을 인용하지 않고 위치만 적는다.
  • 읽기만 한다. 운영 서버 · DB에 요청을 보내 시험하지 않는다. 키가 살아 있는지 찔러 보지 않는다. 저장소의 코드와 설정만 본다.
  • "안전하다"고 단정하지 않는다. 0건이어도 "이 점검이 본 범위에서"라고 쓴다. 확인 안 된 숫자 · 최상급 · 보장 표현을 쓰지 않는다.
  • 법령은 grade.md에 적힌 것만 인용한다. 보고서에 법률 자문이 아니라고 한 줄 적는다.
  • 경고를 겁주는 말로 부풀리지 않는다. 무엇이 · 어디에 · 왜 위험한지 · 어떻게 고치는지 네 가지만.
  • scan.mjs가 못 보는 것이 있다 — Supabase 대시보드에서 직접 만든 테이블 · 정책, 배포 환경 변수의 실제 값, 여러 파일로 나뉜 금액 확인 로직. 보고서의 '못 본 것'에 적는다.

필요한 것

  • Node 18 이상. 의존성 없음.
  • git(히스토리 점검용). 없거나 git 저장소가 아니면 파일만 본다.
  • 같은 폴더의 scan.mjs(기계 점검) · checklist.md(사람 점검) · grade.md(등급 · 법령) · report-template.md(보고서 꼴).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.