AGENTS.md 생성기

폼을 채우면 Cursor · Claude Code · Codex · Copilot이 읽는 규칙 파일을 표준 섹션 구조로 즉시 만들어 드립니다. 복사·다운로드까지 브라우저 안에서.

출력 언어

선택하면 스택·명령·코드 스타일 필드가 자동으로 채워집니다.

포함할 섹션

AGENTS.md
# my-app

## 프로젝트 개요

A small web service that does one thing well.

**기술 스택:** Node.js, TypeScript, npm

## 셋업 · 명령어

설치:

```bash
npm install
```

- **개발 서버:** `npm run dev`
- **빌드:** `npm run build`
- **테스트:** `npm test`
- **린트 / 포맷:** `npm run lint`

## 코드 스타일

- Indent with 2 spaces
- Use TypeScript strict mode; no `any`
- Format with Prettier, lint with ESLint
- camelCase for variables, PascalCase for types
- Prefer named exports over default exports

## 테스트

Run tests with `npm test`.

커밋 전 항상 테스트 스위트를 실행하세요. 동작을 변경하면 테스트를 추가·수정합니다.

## 프로젝트 구조

```text
src/        application source
src/lib/    pure logic (no side effects)
test/       unit tests
dist/       build output (generated, do not edit)
```

## 커밋 · PR 규칙

- Follow Conventional Commits (feat:, fix:, chore:, docs:)
- Keep the subject line under 72 characters
- Open one PR per logical change; describe what and why

## 보안

- Never commit secrets; use environment variables (.env is gitignored)
- Do not log tokens, passwords, or PII
- Validate and sanitize all external input

## 하지 말 것

- Do not edit files in dist/ or build/ (generated)
- Do not add new dependencies without discussion
- Do not commit directly to main; open a PR

팁: AGENTS.md를 원본으로 두고 나머지는 symlink 하세요 — ln -s AGENTS.md CLAUDE.md

가이드 · FAQ · bal.pe.kr

AGENTS.md 표준·섹션 작성법은 가이드, 자주 묻는 질문은 FAQ, 동작 방식·프라이버시는 소개 참조. 마지막 업데이트 2026-07-11.