프로젝트 규칙 문서

AI 에이전트 진입 → 규칙 문서 있음 → 프로젝트 맥락 이해 → 올바른 코드/문서 생성
AI 에이전트 진입 → 규칙 문서 없음 → 일반적 추측 → 컨벤션 위반 → 수정 비용 발생

# My Project

이 프로젝트는 TypeScript로 작성된 REST API입니다.
설치하려면 npm install을 실행하세요.
테스트는 jest를 사용합니다.

## 개발 가이드

코드를 작성할 때는 ESLint 규칙을 따라주세요.
커밋 메시지는 Conventional Commits를 사용합니다.
PR을 올리기 전에 테스트를 돌려주세요.
가능하면 타입을 명시해주세요.
any는 쓰지 마세요.

# CLAUDE.md

## Project Overview
TypeScript REST API. Yarn Workspaces monorepo.

## Commands
\`\`\`bash
yarn dev          # 개발 서버 (http://localhost:3000)
yarn build        # 프로덕션 빌드
yarn test         # Jest 테스트
yarn lint         # ESLint 검사
\`\`\`

## Architecture
\`\`\`
src/
├── api/          # Route handlers
├── services/     # Business logic
├── models/       # DB models (Prisma)
└── utils/        # Shared utilities
\`\`\`

## Conventions
- Commit: `<type>: <description>` (feat, fix, docs, refactor)
- Branch: `feature/<name>`, `fix/<name>`
- Types: 명시적 타입 선언 필수, `any` 금지

## Do NOT
- 테스트 없이 PR 생성하지 않는다
- `console.log`를 프로덕션 코드에 남기지 않는다
- 사용자가 요청하기 전에 커밋/푸시하지 않는다

# CLAUDE.md

## Project Overview
[프로젝트 한 줄 설명. 기술 스택.]

## Commands
\`\`\`bash
[빌드 명령]
[테스트 명령]
[린트 명령]
[개발 서버 명령]
\`\`\`

## Architecture
\`\`\`
[디렉토리 구조 — 핵심만]
\`\`\`

| 작업 | 위치 | 비고 |
|---|---|---|
| [작업1] | [경로] | [참고] |

## Conventions
- Commit: [형식]
- Branch: [형식]
- [추가 컨벤션]

## Do NOT
- [금지사항 1]
- [금지사항 2]

## Language
[응답 언어 규칙]

# AGENTS.md

## OVERVIEW
[프로젝트 한 줄 설명]

## STRUCTURE
\`\`\`text
[디렉토리 구조]
\`\`\`

## WHERE TO LOOK
| Task | Location | Notes |
|---|---|---|
| [작업] | [경로] | [참고] |

## CONVENTIONS
- [규칙 1]
- [규칙 2]

## ANTI-PATTERNS
- [하지 말아야 할 것 1]
- [하지 말아야 할 것 2]

## COMMANDS
\`\`\`bash
[명령어들]
\`\`\`

## VALIDATION
[검증 명령어: lint, typecheck, build, test]

이 프로젝트의 코드 구조, package.json, 설정 파일들을 분석해서
CLAUDE.md를 작성해줘.

포함할 섹션:
1. Project Overview (한 문단)
2. Commands (코드 블록)
3. Architecture (디렉토리 트리 + WHERE TO LOOK 표)
4. Conventions (커밋, 브랜치, 네이밍)
5. Do NOT (금지사항)

원칙:
- 기본지식 설명 생략 (TypeScript가 뭔지 등)
- 선언적 규칙으로 작성
- 이 프로젝트에만 해당하는 고유 규칙에 집중