프로젝트 규칙 문서

규칙 문서 있음 -> 프로젝트 맥락 이해 -> 올바른 파일 탐색 -> 검증까지 수행
규칙 문서 없음 -> 일반적 추측 -> 컨벤션 위반 -> 리뷰/수정 비용 증가

repo/
├── AGENTS.md                  # 전체 저장소 공통 규칙
├── apps/
│   └── web/
│       └── AGENTS.md          # 웹 앱 전용 규칙
└── services/
    └── payments/
        └── AGENTS.override.md # 결제 서비스 override

# AGENTS.md

## Project
[프로젝트 한 줄 설명. 기술 스택과 실행 환경.]

## Commands
\`\`\`bash
[설치 명령]
[개발 서버 명령]
[타입체크/린트/테스트/빌드 명령]
\`\`\`

## Where to look
| Task | Location | Notes |
|---|---|---|
| [작업] | [경로] | [주의점] |

## Conventions
- [프로젝트 고유 규칙 1]
- [프로젝트 고유 규칙 2]

## Validation
- [변경 후 반드시 실행할 명령]
- [수동 확인이 필요한 항목]

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

# CLAUDE.md

@AGENTS.md

## Claude Code

- 큰 변경은 먼저 계획을 제안한다.
- `src/billing/**` 변경은 담당자 리뷰 없이는 커밋하지 않는다.

repo/
├── CLAUDE.md
└── .claude/
    └── rules/
        ├── testing.md
        ├── security.md
        └── frontend.md

---
paths:
  - "src/api/**/*.ts"
  - "app/api/**/*.ts"
---

# API rules

- 모든 API 입력은 스키마로 검증한다.
- 오류 응답은 표준 `{ code, message }` 형식을 사용한다.
- 변경 후 `pnpm test api`와 `pnpm openapi:check`를 실행한다.

# My Project

TypeScript REST API입니다.
테스트는 jest를 사용합니다.
가능하면 타입을 명시해주세요.
any는 쓰지 마세요.
PR 전에 테스트를 돌려주세요.

# AGENTS.md

## Project
TypeScript REST API. Yarn Workspaces monorepo.

## Commands
\`\`\`bash
yarn install
yarn dev
yarn test
yarn lint
yarn build
\`\`\`

## Where to look
| Task | Location | Notes |
|---|---|---|
| Route handlers | `src/api/` | Add validation tests |
| Business logic | `src/services/` | Keep DB access out of routes |
| Prisma models | `prisma/schema.prisma` | Run migration check |

## Conventions
- Commit: `<type>: <description>` (`feat`, `fix`, `docs`, `refactor`)
- Types: explicit public types required. Do not use `any`.
- Errors: return `{ code, message }`.

## Validation
- Run `yarn test` after code changes.
- Run `yarn lint` before final response.

## Do not
- Do not commit or push unless the user asks.
- Do not leave `console.log` in production code.
- Do not edit generated files under `dist/`.

이 저장소의 package.json, 디렉토리 구조, 기존 CI, 테스트 명령을 분석해서
AGENTS.md 초안을 작성해줘.

포함할 것:
1. Project: 5줄 이내
2. Commands: 실제 실행 가능한 명령만 코드 블록으로
3. Where to look: 작업별 위치 표
4. Conventions: 이 저장소에서 발견한 고유 규칙
5. Validation: 변경 유형별 검증 명령
6. Do not: 생성 파일, 커밋/푸시, 보안 관련 금지사항

제외할 것:
- TypeScript, React 같은 범용 개념 설명
- README에 이미 충분한 사용자용 설명
- 추측으로 만든 명령어