React Native용 AGENTS.md 패턴: Claude Code가 더 나은 프로젝트 인식 코드를 생성합니다

Reddit 사용자 julia_ships가 React Native/Expo 프로젝트용 AGENTS.md 파일을 실험 중입니다. 이 파일은 Claude Code 및 Cursor와 같은 AI 코딩 에이전트가 프로젝트별 규칙을 알 수 있도록 하는 구조화된 문서 역할을 합니다. 그 차이는 상당합니다. 파일을 사용하기 전에는 Claude가 일반적인 React Native 코드를 생성했지만, 사용 후에는 프로젝트의 정확한 테마 토큰, 훅, 패턴을 사용한 컴포넌트를 생성합니다.

AGENTS.md 파일에 포함되는 내용

사용자는 AGENTS.md에 다음 섹션을 포함합니다:

• 폴더 구조 및 파일 명명 규칙 — 예: 컴포넌트 위치, 파일 명명 방식 (PascalCase, kebab-case 등)
• 테마 시스템 및 색상 토큰 — 정확한 토큰 이름 및 적용 방법
• 커스텀 훅 및 사용 패턴 — 프로젝트별 훅을 가져오고 사용하는 방법
• 컴포넌트 패턴 — 타입이 지정된 props를 가진 함수형 컴포넌트 (TypeScript), 구조, 내보내기 스타일

결과

AGENTS.md를 적용하면 Claude Code가 첫 시도에 프로젝트 규칙에 맞는 코드를 생성합니다. 예를 들어, 하드코딩된 '#6200ee' 대신 올바른 테마 colors.primary를 사용하고, 인라인 로직 대신 useAuth()와 같은 커스텀 훅을 가져오며, 정해진 컴포넌트 패턴(함수형, 타입이 지정된 props, 적절한 내보내기)을 따릅니다.

대상

수동 코드 리뷰를 줄이고 AI가 프로젝트 규칙을 따르도록 강제하려는, Claude Code, Cursor 또는 유사한 AI 코딩 에이전트를 사용하는 React Native / Expo 개발자.