# AGENTS.md 프로젝트 규칙 템플릿

아래 내용을 저장소 루트의 `AGENTS.md`에 맞게 편집하세요. 대괄호 항목은 실제 저장소 정보로 바꾸고, 존재하지 않는 명령은 삭제합니다.

```md
# AGENTS.md

## Project overview

- 목적: [프로젝트가 해결하는 문제]
- 기술 스택: [언어, 프레임워크, 런타임]
- 주요 디렉터리: [apps, packages, services 등]
- 패키지 관리자: [pnpm, npm, yarn, Gradle, Maven 등]

## Working rules

- 변경하기 전에 관련 구현과 테스트를 먼저 읽습니다.
- 요청한 기능과 직접 관련된 파일만 수정합니다.
- 기존 공개 API와 데이터 형식은 승인 없이 변경하지 않습니다.
- 새 프로덕션 의존성은 추가하기 전에 이유와 대안을 설명합니다.
- 사용자가 만든 관련 없는 변경을 덮어쓰지 않습니다.

## Code conventions

- [현재 저장소의 타입·오류 처리·모듈 경계 규칙]
- [프론트엔드 접근성·반응형 기준 또는 백엔드 계층 규칙]
- [문서와 테스트를 함께 갱신해야 하는 조건]

## Validation

- Lint: `[실제 lint 명령]`
- Type check: `[실제 타입 검사 명령]`
- Unit test: `[실제 단위 테스트 명령]`
- Build: `[실제 빌드 명령]`
- 실행하지 못한 검사는 이유와 함께 보고합니다.

## Security

- `.env`, 토큰, 인증서와 고객 데이터를 읽거나 출력하지 않습니다.
- 삭제, 배포, 데이터베이스 변경과 외부 전송은 별도 승인을 받습니다.
- 보안 검증을 끄거나 우회하지 않습니다.

## Completion report

- 변경한 파일과 핵심 동작을 요약합니다.
- 실행한 명령과 결과를 구분합니다.
- 미검증 항목, 호환성 영향과 남은 위험을 기록합니다.

## Code Review Rules

- [CI가 찾기 어려운 도메인 위험]
- Safe path: [권장 구현 또는 확인 방법]
```

## 적용 확인

```bash
codex --ask-for-approval never "Summarize the current instructions."
```

출처를 확인해 작성한 IT 매거진 독자용 템플릿입니다. README, 빌드 파일과 CI 설정을 대조한 뒤 사용하세요.