설치기와 옵션

실행하기

bash <pro-kit>/templates/prokit-next-neon/install.sh my-app       # supabase면 prokit-next-supabase

• AGENTS.md, CLAUDE.md가 이미 있으면 템플릿 블록을 끝에 한 번만 덧붙여요.

• --with-global은 전역 설정과 훅을 바꾸므로 사용자가 전역 도구 설치를 요청할 때만 붙여요. gstack은 bun이 필요하고, 설치하면서 ~/.claude/settings.json에 전역 훅을 등록해요. --with-global은 Supabase CLI를 Homebrew로만 설치해요.

• Windows의 PowerShell이나 Git Bash에서 실행하면 WSL2를 안내하고 멈춰요.

설치한 뒤 할 일

에이전트가 따르는 규칙의 원문은 AGENTS.md의 "템플릿으로 새 프로젝트 만들기"(새 탭)이고, 명령은 템플릿 README "새 프로젝트 시작"의 "설치한 뒤"(neon(새 탭), supabase(새 탭))가 정본이에요.

1. 1.

   첫 마이그레이션: 로컬 DB를 띄우고 db:generate로 인증 테이블 마이그레이션을 만든 뒤 db:migrate로 적용해요. supabase는 적용 전에 enable_rls_auth 커스텀 마이그레이션(인증 테이블의 RLS 켜기)을 더하고, 적용 뒤 supabase db advisors --local --type security가 No issues found인지 확인해요. BTS가 만든 프로젝트 README.md의 db:push 단계는 따르지 않아요. 화면만 프로젝트는 건너뛰어요.

2. 2.

   포맷 정리와 커밋: pnpm check로 BTS가 만든 코드의 포맷과 정렬을 한 번 정리하고 pnpm exec biome check .가 exit 0인지 봐요. 설치 결과, 포맷 정리, 첫 마이그레이션을 기본 브랜치에 커밋해요.

3. 3.

   새 세션 열기: 스킬과 에이전트는 새 세션부터 보여요. 첫 실행 때 묻는 신뢰 질문에 동의해야 프로젝트 설정이 켜져요. Claude Code는 플러그인, Codex는 에이전트, Grok Build는 규칙과 스킬이에요(grok --trust로 열면 묻지 않고 신뢰해요). Antigravity는 AGENTS.md, .agents/skills, .agents/agents를 그대로 읽어요(지원하는 에이전트).

4. 4.

   화면 디자인 검사 켜기: 개발자마다 한 번, 프로젝트 루트에서 .agents/skills/impeccable/scripts/impeccable hooks on을 실행해요. 켠 뒤 .claude/settings.local.json의 훅 명령이 …/scripts/impeccable" hook인지 확인해요.

5. 5.

   프로젝트 소개 채우기: GLOSSARY.md와 docs/domain/project.md를 채워요.

6. 6.

   첫 요청: "…을 만들어줘"처럼 요청하면 prokit-dev-cycle이 라운드를 열어요(dev-cycle 라운드).

자세히

설치기가 하는 일

• templates/<템플릿>/files/ 아래 파일(스킬, 에이전트, dev-cycle, 문서 골격, 스크립트)을 프로젝트에 복사해요.

• package.json에 스크립트(dev-cycle, skills:*, agents:*, export:html, vercel:deploy 등)를 더해요.

• 다시 생성되는 파일(마이그레이션, schema/auth.ts, varlock의 src/env.ts)과 pnpm export:html이 만든 html/을 biome.json 검사 대상에서 빼요.

• 설치된 turbo가 2.11.5 이상이면 turbo.json에 "agentGuidance": false를 넣어요. turbo가 AI 에이전트를 감지하면 루트 AGENTS.md에 규칙 블록을 쓰고 커밋하라고 지시하기 때문이에요.

• scripts/skills-setup.mjs로 skills.manifest.json의 스킬과 플러그인을 이 프로젝트에 설치해요(설치와 업데이트 구조).

첫 커밋이 중요한 이유

커밋하지 않고 첫 라운드를 열면 설치한 파일 전체가 라운드 diff에 섞여 audit이 더 무거운 케이스(템플릿 README의 예는 F)로 올리라고 요구해요. 라운드 기준이 기본 브랜치와의 merge-base라서 기능 브랜치에 커밋해도 마찬가지예요.

화면 디자인 검사를 스킬로 켜지 않는 이유

개인(전역) impeccable 스킬이 있을 때 스킬 호출($impeccable hooks on, Claude Code의 impeccable 스킬 인자)로 켜면 Claude Code가 그쪽을 불러와 이 프로젝트에 없는 scripts/hook.mjs를 훅 명령으로 적어요. 그러면 Stop 훅이 매번 MODULE_NOT_FOUND로 실패해요.

팀원이 클론했을 때

pnpm install 뒤 pnpm skills:setup을 한 번 실행해요. 스킬 파일은 이미 커밋돼 있어서 빠진 것만 받아요. 전역 도구까지 맞추려면 pnpm skills:setup --with-global, 상태만 보려면 pnpm skills:check예요.

관련 문서

• 빠른 시작: 서비스 만들기

• 기존 프로젝트에 갱신 반영

• 설치와 업데이트 구조

• 명령 모음