.claude/rules/
├── AGENTS.md              # 전체 인덱스 + 카테고리 목차
├── CLAUDE.md              # "AGENTS.md"
│
│   # 카테고리별 그룹화 (기본)
├── core/                  # 핵심 규칙
│   ├── AGENTS.md          # 그룹 인덱스
│   ├── typescript.md
│   └── architecture.md
│
├── frontend/              # 프론트엔드 규칙
│   ├── AGENTS.md
│   ├── react.md
│   ├── state-management.md
│   └── components.md
│
├── testing/               # 테스트 규칙
│   ├── AGENTS.md
│   ├── unit.md
│   └── e2e.md
│
└── docs/                  # 문서 기반 규칙
    ├── AGENTS.md
    └── prd/
        ├── AGENTS.md
        └── overview.md

# {프로젝트명} Rules

> 프로젝트 규칙 인덱스

## 목차

- [핵심 규칙 (Core)](#핵심-규칙)
- [프론트엔드 (Frontend)](#프론트엔드)
- [백엔드 (Backend)](#백엔드)
- [테스트 (Testing)](#테스트)
- [문서 (Docs)](#문서)

---

## 핵심 규칙

> 모든 코드에 적용되는 기본 규칙

| 규칙 | 적용 대상 | 설명 |
|------|----------|------|
| [typescript](core/typescript.md) | `**/*.ts{,x}` | TypeScript 컨벤션 |
| [architecture](core/architecture.md) | 전역 | 프로젝트 구조 원칙 |

→ 상세: [core/AGENTS.md](core/AGENTS.md)

---

## 프론트엔드

> UI 및 컴포넌트 관련 규칙

| 규칙 | 적용 대상 | 설명 |
|------|----------|------|
| [react](frontend/react.md) | `**/*.tsx` | React 패턴 |
| [components](frontend/components.md) | `**/components/**` | 컴포넌트 구조 |

→ 상세: [frontend/AGENTS.md](frontend/AGENTS.md)

---

## 테스트

> 테스트 작성 관련 규칙

| 규칙 | 적용 대상 | 설명 |
|------|----------|------|
| [unit](testing/unit.md) | `**/*.test.*` | 단위 테스트 |
| [e2e](testing/e2e.md) | `e2e/**` | E2E 테스트 |

→ 상세: [testing/AGENTS.md](testing/AGENTS.md)

# {카테고리명} Rules

> {카테고리 설명}

## 규칙 목록

| 규칙 | 설명 | 트리거 |
|------|------|--------|
| [rule-a](rule-a.md) | 설명 | `**/*.tsx` |
| [rule-b](rule-b.md) | 설명 | 컴포넌트 작성 시 |

## 빠른 참조

### {주요 개념 1}
- 핵심 포인트 1
- 핵심 포인트 2

### {주요 개념 2}
- 핵심 포인트 1

.claude/rules/
├── AGENTS.md
├── CLAUDE.md
├── typescript.md
└── architecture.md

package.json → JavaScript/TypeScript 기술 스택
requirements.txt / pyproject.toml → Python 기술 스택
Cargo.toml → Rust 기술 스택
go.mod → Go 기술 스택

docs/PRD*.md, README.md, ARCHITECTURE.md, docs/*.md

src/ 또는 app/ 구조 → 아키텍처 패턴 파악

[분석 결과]
    │
    ├─── 필수 규칙 (Essential)
    │    ├── 기술 스택 규칙 (typescript.md, react.md)
    │    ├── 프로젝트 구조 규칙 (architecture.md)
    │    └── 코딩 컨벤션 (coding-style.md)
    │
    └─── 선택 규칙 (Conditional)
         ├── 도메인 규칙 - paths 또는 트리거 키워드
         ├── 테스트 규칙 - paths: ["**/*.test.*"]
         └── 특정 모듈 규칙

[분석된 규칙들]
    │
    ├─── 언어/타입/전역 규칙
    │    → core/ 카테고리
    │
    ├─── UI/컴포넌트/상태관리
    │    → frontend/ 카테고리
    │
    ├─── API/DB/서버 로직
    │    → backend/ 카테고리
    │
    ├─── 테스트 관련
    │    → testing/ 카테고리
    │
    ├─── 문서 기반 (PRD, 스펙)
    │    → docs/ 카테고리
    │
    └─── 인프라/배포
         → infra/ 카테고리

rule-structurizer 스킬 확인:
├── 존재함 → /rule-structurizer 호출
└── 없음 → 사용자에게 안내

⚠️ rule-structurizer 스킬이 필요합니다.

긴 문서(PRD, 가이드 등)를 규칙 구조로 변환하려면 
rule-structurizer 스킬을 설치하세요:

설치 방법:
1. ai-library 저장소에서 skills/rule-structurizer/ 복사
2. 프로젝트의 .claude/skills/ 또는 ~/.claude/skills/에 배치

또는 수동으로 그룹화 디렉토리를 생성하세요:
- AGENTS.md: 그룹 인덱스
- 섹션별 개별 .md 파일

.claude/rules/
├── AGENTS.md                 # 전체 인덱스 + 목차
├── CLAUDE.md
│
├── core/                     # 핵심 규칙 카테고리
│   ├── AGENTS.md             # 카테고리 인덱스
│   ├── typescript.md
│   ├── architecture.md
│   └── coding-style.md
│
├── frontend/                 # 프론트엔드 카테고리
│   ├── AGENTS.md
│   ├── react.md
│   ├── state-management.md
│   ├── components.md
│   └── styling.md
│
├── backend/                  # 백엔드 카테고리 (있는 경우)
│   ├── AGENTS.md
│   ├── api.md
│   └── database.md
│
├── testing/                  # 테스트 카테고리
│   ├── AGENTS.md
│   ├── unit.md
│   └── e2e.md
│
└── docs/                     # 문서 기반 카테고리
    ├── AGENTS.md
    └── prd/
        ├── AGENTS.md
        ├── overview.md
        ├── user-stories.md
        └── functional-specs.md

# {프로젝트명} Rules

> 프로젝트 규칙 인덱스

## 목차

- [핵심 규칙 (Core)](#핵심-규칙-core)
- [프론트엔드 (Frontend)](#프론트엔드-frontend)
- [백엔드 (Backend)](#백엔드-backend)
- [테스트 (Testing)](#테스트-testing)
- [문서 (Docs)](#문서-docs)

---

## 핵심 규칙 (Core)

> 모든 코드에 적용되는 기본 규칙

| 규칙 | 적용 대상 | 설명 |
|------|----------|------|
| [typescript](core/typescript.md) | `**/*.ts{,x}` | TypeScript 컨벤션 |
| [architecture](core/architecture.md) | 전역 | 아키텍처 원칙 |
| [coding-style](core/coding-style.md) | 전역 | 코딩 스타일 |

→ 상세: [core/AGENTS.md](core/AGENTS.md)

---

## 프론트엔드 (Frontend)

> UI, 컴포넌트, 상태관리 규칙

| 규칙 | 적용 대상 | 설명 |
|------|----------|------|
| [react](frontend/react.md) | `**/*.tsx` | React 패턴 |
| [components](frontend/components.md) | `**/components/**` | 컴포넌트 구조 |
| [styling](frontend/styling.md) | `**/*.css` | 스타일링 규칙 |

→ 상세: [frontend/AGENTS.md](frontend/AGENTS.md)

---

## 테스트 (Testing)

> 테스트 작성 규칙 (조건부 활성화)

| 규칙 | 적용 대상 | 설명 |
|------|----------|------|
| [unit](testing/unit.md) | `**/*.test.*` | 단위 테스트 |
| [e2e](testing/e2e.md) | `e2e/**` | E2E 테스트 |

→ 상세: [testing/AGENTS.md](testing/AGENTS.md)

---

## 문서 (Docs)

> PRD, API 스펙 등 문서 기반 규칙

| 문서 | 설명 | 참조 |
|------|------|------|
| [PRD](docs/prd/) | 제품 요구사항 | 기획 참조 시 |

→ 상세: [docs/AGENTS.md](docs/AGENTS.md)

구조 검증:
□ 루트 AGENTS.md에 목차가 있는가?
□ 규칙이 적절한 카테고리에 분류되었는가?
□ 각 카테고리에 AGENTS.md 인덱스가 있는가?
□ 각 규칙 파일에 frontmatter(description)가 있는가?

목차 검증:
□ 목차의 링크가 해당 섹션으로 연결되는가?
□ 각 카테고리 섹션에 "→ 상세" 링크가 있는가?
□ 카테고리별 대표 규칙이 테이블에 표시되는가?

내용 검증:
□ 규칙이 최신 베스트 프랙티스를 반영하는가?
□ 기존 린터/설정과 충돌하지 않는가?
□ deprecated 패턴이 권장되고 있지 않은가?

카테고리 검증:
□ 규칙이 적절한 카테고리에 배치되었는가?
□ 카테고리 인덱스가 하위 규칙을 명확히 안내하는가?
□ 빈 카테고리가 없는가? (최소 1개 규칙)

# 좋은 예
"이 프로젝트는 Feature 기반 구조를 사용합니다."
"React Compiler가 활성화되어 있어 수동 메모이제이션이 불필요합니다."

# 피해야 할 예
"React에서는 useMemo를 사용하세요." (← 버전/설정에 따라 다름)

# 린터 설정이 있는 경우
"상세 규칙은 eslint.config.js 참조"
"Biome 설정(biome.json)이 포맷팅을 담당"

---
description: >
  Next.js 15 App Router 규칙. 
  주의: Next.js 14 이하와 캐싱 전략이 다름.
---