석지인이 실제 개발에 사용하는 Claude Code(생성형 AI 코딩 에이전트) 설정의 공개용 일부입니다. 생성형 AI를 단순히 "코드 자동완성"으로 쓰는 것을 넘어, 개인 코드 스타일·작업 규칙·검증 절차를 에이전트에 규칙으로 주입해 일관된 방식으로 함께 일하는 워크플로를 보여 주려고 정리했습니다.
만든 사람: 석지인 (Jiin Seok) · 🔗 포트폴리오: usejiin.link · GitHub: @JiinSeok
| 파일/폴더 | 설명 |
|---|---|
CLAUDE.md |
모든 프로젝트에 적용되는 개인 작업 규칙 — 워크트리로 실제 검증, .tsx/.py 수정 전 스타일 규칙 먼저 읽기, 팩트체크 우선, diff 정리 등 |
settings.json |
Claude Code 설정 — 사용하는 플러그인, 권한 허용 목록, 언어/테마 |
skills/seokjiin-react-style/ |
직접 정리한 React/TypeScript 코드 스타일 가이드 — 프로젝트 구조, 컴포넌트 패턴(Compound·Variant·forwardRef), Tailwind 관례, 데이터/API·상태(React Query·Zustand), 커스텀 훅, 테스트(Vitest+MSW), 접근성, Next.js App Router 경계 (30개 규칙) |
skills/seokjiin-python-style/ |
직접 정리한 Python/FastAPI 코드 스타일 가이드 — 모듈 구조, 라우터/의존성 주입, 서비스 레이어, Pydantic/dataclass, pytest, 환경 설정 (13개 규칙) |
skills/react-best-practices/ |
Vercel Engineering의 React 성능 최적화 가이드 (45개 규칙, MIT) — 워터폴 제거·번들 최적화·리렌더 최소화. 직접 작성한 게 아니라 @shuding/Vercel 원작을 가져와 둔 것으로, seokjiin-react-style(구조·스타일)와 짝을 이뤄 성능 영역을 담당 |
react-best-practices는 Vercel의 MIT 라이선스 스킬(vercel-labs/agent-skills)을 그대로 포함한 것입니다. 출처·라이선스·원작자 표기는skills/react-best-practices/SOURCE.md에 정리돼 있습니다.
이 파일들을 ~/.claude/에 두면, Claude Code가 코드를 작성·수정할 때마다 위 규칙을 참조합니다. 예를 들어 React 컴포넌트를 새로 만들 때는 skills/seokjiin-react-style/rules/의 해당 규칙을 먼저 읽고, 그 컨벤션(Props 인터페이스, 폴더 구조, className 작성 순서 등)에 맞춰 작성합니다.
이 스타일 가이드는 실제 프로젝트(formkit-react, albaform, bodycodi 등)에서 굳어진 패턴을 규칙으로 옮긴 것이라, 코드베이스와 가이드가 서로를 검증합니다.
개인정보·인증정보·회사 비공개 설정은 모두 제외했습니다 — API 키·토큰(credentials), 대화 기록, 개인 메모리, 회사·팀 전용 리뷰 스킬과 프로젝트 설정, 로컬 전용 설정.