Convex 베스트 프랙티스

무엇을 해주나

Convex(실시간 백엔드 플랫폼)로 앱을 만들 때 Claude가 따라야 할 코딩 규칙을 정리한 스킬입니다.

• 함수 구성: 도메인별 파일 분리(users.ts, tasks.ts), public 함수와 internal 함수 구분
• 검증자(validator): args뿐 아니라 returns까지 항상 정의하는 패턴
• 쿼리 최적화: filter 대신 withIndex를 쓰도록 스키마 인덱스 설계 예시 제공
• 에러 처리: ConvexError로 사용자용 에러 코드/메시지 반환
• 쓰기 충돌(OCC) 회피: 멱등성 있는 mutation, 읽지 않고 바로 patch, Promise.all 병렬 업데이트
• 안전 가드: 명시적 지시 없이는 npx convex deploy나 git 명령을 실행하지 않음
• @convex-dev/eslint-plugin 설치와 4가지 규칙(구식 문법 금지, 인자 검증자 필수 등) 안내

이런 분께 추천

• Convex + TypeScript로 서비스를 운영하거나 시작하는 개발자
• AI가 생성한 Convex 코드가 검증자 누락·filter 남용으로 리뷰에서 자주 걸리는 팀
• 실시간 동기화 앱에서 write conflict 에러(#1)를 줄이고 싶은 개발자

활용 예시

1. "tasks 테이블 CRUD 함수 만들어줘" → 반환 검증자와 by_user 인덱스를 갖춘 list/create/update/remove 세트를 생성
2. "이 mutation에서 write conflict가 계속 나" → 멱등성 체크와 직접 patch 패턴으로 리팩터링
3. "쿼리가 느려" → filter 호출을 스키마 인덱스 + withIndex로 교체 제안

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/waynesutton/convexskills/HEAD/skills/convex-best-practices/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 waynesutton/convexskills 의 skills/convex-best-practices 폴더를 내 ~/.claude/skills/convex-best-practices/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.