3장: CLAUDE.md와 AGENTS.md 고급 전략

# 프로젝트 개요
 
Next.js 16 App Router + TypeScript strict 프로젝트
 
## 핵심 명령어
 
- pnpm dev: 개발 서버 (port 3020)
- pnpm build: 프로덕션 빌드 (반드시 통과해야 함)
- pnpm lint: ESLint 검사
 
## 절대 규칙
 
1. any 타입 사용 금지
2. 컴포넌트는 function 선언 사용 (화살표 함수 아님)
3. className은 cn() 함수로 결합
4. 이모지 사용 금지
 
## 프로젝트 구조
 
src/app/       - App Router 페이지
src/components/ - UI 컴포넌트
src/lib/       - 유틸리티
content/       - MDX 콘텐츠

# 프로젝트 개요
 
## 회사 소개
우리 회사는 2019년에 설립되어...
 
## 팀 구조
프론트엔드 팀 5명, 백엔드 팀 3명...
 
## 전체 아키텍처 설명 (500줄)
마이크로서비스 아키텍처를 채택하고 있으며,
서비스 A는 서비스 B와 gRPC로 통신하고...
(... 계속 ...)
 
## 모든 API 엔드포인트 목록 (200줄)
GET /api/v1/users
POST /api/v1/users
...

project/
  CLAUDE.md              # 전역 규칙 (빌드, 린트, 공통 컨벤션)
  src/
    CLAUDE.md            # 소스 코드 컨벤션
    components/
      CLAUDE.md          # 컴포넌트 작성 규칙
    lib/
      CLAUDE.md          # 유틸리티 작성 규칙
  content/
    CLAUDE.md            # 콘텐츠 작성 규칙
  tests/
    CLAUDE.md            # 테스트 작성 규칙

# AGENTS.md
 
## Project Overview
Brief description of the project and its purpose.
 
## Architecture
High-level architecture description.
 
## Development Setup
How to set up and run the project.
 
## Code Conventions
Coding standards and patterns used.
 
## Testing
How to write and run tests.
 
## Common Pitfalls
Things that AI agents commonly get wrong.

You are working on a Next.js 16 project with TypeScript strict mode.
 
Rules:
- Use function declarations for components, not arrow functions
- Use cn() for className composition
- Follow the existing patterns in src/components/
- Always add proper TypeScript types
- Never use 'any' type

<!-- 자동 생성된 규칙 - 비효과적 -->
## Rules
 
1. Always write clean code
2. Follow best practices
3. Write meaningful variable names
4. Add comments where necessary
5. Handle errors properly
6. Write unit tests
7. Use proper indentation
8. Follow DRY principle
9. Keep functions small
10. Use meaningful commit messages
... (100줄 더)

# Project Name
 
## Quick Start
pnpm dev          # 개발 서버 (port 3020)
pnpm build        # 빌드 (변경 후 반드시 통과 확인)
 
## Must-Know Rules
1. TypeScript strict, no 'any'
2. Components: function declarations only
3. Styling: Tailwind + cn() only, no inline styles
4. No emojis anywhere
 
## Project Structure
src/app/        - Pages (App Router)
src/components/ - UI components
src/lib/        - Utilities
content/        - MDX content
 
## When You Need More Context
- Architecture details: docs/architecture.md
- Design system: docs/design-system.md
- Content writing: docs/content-guide.md
- Coding conventions: docs/conventions.md