Ch2. Steering 마스터하기

.kiro/steering/
├── project-overview.md      # 프로젝트 개요
├── coding-standards.md      # 코딩 표준
├── architecture.md          # 아키텍처 가이드
├── api-guidelines.md        # API 설계 가이드
└── deployment.md           # 배포 가이드

---
inclusion: always
---

# 프로젝트 개요

이 프로젝트는 Next.js 기반의 문서 사이트입니다.

## 기술 스택
- Next.js 14 (App Router)
- TypeScript
- Tailwind CSS
- MDX

## 주요 디렉토리
- `app/`: Next.js App Router 페이지
- `components/`: 재사용 가능한 컴포넌트
- `content/`: MDX 문서 파일
- `lib/`: 유틸리티 함수

---
inclusion: fileMatch
fileMatchPattern: "**/*.{ts,tsx,js,jsx}"
---

# 코딩 표준

## TypeScript 규칙
- 모든 함수에 명시적 반환 타입 지정
- `any` 타입 사용 금지
- 인터페이스 이름은 `I` 접두사 없이 작성

## React 컴포넌트
- 함수형 컴포넌트 사용
- Props 인터페이스는 컴포넌트명 + `Props`
- 기본 export 사용

## 파일 명명 규칙
- 컴포넌트: PascalCase (Button.tsx)
- 유틸리티: camelCase (formatDate.ts)
- 페이지: kebab-case (user-profile.tsx)

---
inclusion: fileMatch
fileMatchPattern: "**/*.test.{ts,tsx}"
---

# 테스트 가이드

Jest와 React Testing Library를 사용합니다.

---
inclusion: manual
---

# 배포 가이드

이 문서는 #deployment로 참조할 때만 로드됩니다.

# API 가이드

OpenAPI 스펙을 참고하세요:
#[[file:docs/api-spec.yaml]]

데이터베이스 스키마:
#[[file:prisma/schema.prisma]]

---
inclusion: always
---

# 전역 코딩 규칙

모든 파일에 적용되는 기본 규칙들...

---
inclusion: fileMatch
fileMatchPattern: "src/components/**/*"
---

# 컴포넌트 규칙

컴포넌트 작성 시 특별한 규칙들...

---
inclusion: fileMatch
fileMatchPattern: "src/auth/**/*"
---

# 인증 모듈 규칙

인증 관련 코드 작성 시 규칙들...

<!-- common-patterns.md -->
---
inclusion: always
---

# 공통 패턴

## 에러 처리
모든 비동기 함수는 try-catch 사용

## 로깅
console.log 대신 logger 사용

<!-- frontend-rules.md -->
---
inclusion: fileMatch
fileMatchPattern: "src/components/**/*"
---

# 프론트엔드 규칙

React 컴포넌트 관련 규칙들...

<!-- backend-rules.md -->
---
inclusion: fileMatch
fileMatchPattern: "src/api/**/*"
---

# 백엔드 규칙

API 엔드포인트 관련 규칙들...

<!-- .kiro/steering/env-development.md -->
---
inclusion: manual
---

# 개발 환경 설정

## 디버깅 모드
- 상세한 로깅 활성화
- 소스맵 포함
- 핫 리로드 지원

## 개발 도구
- React DevTools 사용
- Redux DevTools 활성화
- 성능 프로파일링 도구

<!-- .kiro/steering/api-sync.md -->
---
inclusion: fileMatch
fileMatchPattern: "src/api/**/*.ts"
---

# API 자동 동기화

최신 API 스펙:
#[[file:docs/openapi.yaml]]

GraphQL 스키마:
#[[file:schema.graphql]]

## 변경 감지
API 스펙이 변경되면 자동으로 타입 정의를 업데이트합니다.

<!-- .kiro/steering/frontend-team.md -->
---
inclusion: fileMatch
fileMatchPattern: "src/components/**/*"
---

# 프론트엔드 팀 가이드

## 컴포넌트 설계 원칙
- 단일 책임 원칙
- 재사용 가능한 구조
- 접근성 고려

## 스타일링 규칙
- CSS-in-JS 사용
- 디자인 토큰 활용
- 반응형 디자인 필수