정적 유틸리티 · 백엔드 없음 · AI 호출 없음

AI 에이전트용 저장소 문서를 빠르게 만드세요

프리셋을 고르고 항목을 채운 뒤, lint 경고를 확인하세요. 저장소를 스캔하거나 데이터를 외부로 보낼 필요 없이 깔끔한 AGENTS.md를 복사하거나 다운로드할 수 있습니다.

프리셋 선택

탄탄한 출발점을 고른 뒤, 저장소에 필요한 부분만 수정하세요.

구조화된 빌더 폼

필수 항목을 먼저 채우고, 스택 규칙·워크플로 규칙·선택 메모를 순서대로 입력하세요.

코드 규칙

코드 작성 방식을 짧고 명령형으로 적습니다.

테스트 지침

에이전트가 작업을 끝내기 전에 반드시 검증할 내용을 적습니다.

안전 규칙

민감한 변경, 저장소, 위험한 동작에 대한 규칙을 적습니다.

금지 사항

에이전트가 절대 해서는 안 되는 행동을 적습니다.

커밋 규칙

언제, 어떤 방식으로 커밋해야 하는지 적습니다.

브랜치 규칙

언제 브랜치를 만들고 어떻게 범위를 좁힐지 적습니다.

풀 리퀘스트 규칙

리뷰 가능한 요약에 반드시 들어가야 할 내용을 적습니다.

추가 프로젝트 메모

실제로 의미가 있을 때만 넣을 추가 메모를 적습니다.

내보내기

마지막 저장: draft를 불러오는 중...

Lint 패널

정상

현재 lint 경고가 없습니다. draft가 깔끔하고 스캔하기 좋은 상태입니다.

실시간 AGENTS.md 미리보기

일반 텍스트
AGENTS.md
# 프로젝트 목적
- 프로젝트 이름: Next.js 정적 export
- 목적: 명시적인 에이전트 규칙을 갖춘 집중형 Next.js 정적 코드베이스를 생성하고 유지합니다.
- 프리셋: nextjs-static
- 주요 런타임: TypeScript + Next.js App Router
- 패키지 매니저: npm

# 핵심 제약 사항
- API routes, server actions, middleware를 추가하지 않습니다.
- 원격 AI 호출이나 저장소 자동 스캔을 추가하지 않습니다.
- 편의 기능 때문에 static export 제약을 완화하지 않습니다.

# 설정 및 검증 명령어
- 설치: `npm install`
- 개발: `npm run dev`
- 린트: `npm run lint`
- 타입체크: `npm run typecheck`
- 빌드: `npm run build`
- 테스트: `npm run test`

## 테스트 지침
- Markdown 섹션 순서와 생략 동작은 Vitest로 검증합니다.
- 누락된 규칙, 중복 명령, placeholder 텍스트 같은 lint 휴리스틱은 테스트로 덮습니다.

# 코드 규칙
- TypeScript strict mode를 유지하고 export되는 타입은 명시적으로 작성합니다.
- 생성 및 린트 로직은 결정적이고 부작용 없이 유지합니다.
- 무거운 추상화보다 작은 컴포넌트와 plain CSS를 우선합니다.

# 안전 규칙
- 모든 draft 데이터는 브라우저 메모리와 localStorage에만 보관합니다.
- 런타임 원격 fetch, cookies, auth, analytics SDK를 추가하지 않습니다.

# Git 워크플로 규칙
## 커밋 규칙
- Conventional Commits를 사용합니다.
- lint, typecheck, test, build가 모두 통과한 뒤에만 커밋합니다.

## 브랜치 규칙
- 기본 브랜치에서 파생한 feature 또는 fix 브랜치에서 비사소한 작업을 진행합니다.
- 브랜치 하나에는 논리적 작업 단위 하나만 담습니다.

## 풀 리퀘스트 규칙
- 변경된 프리셋 또는 라우트 동작을 요약하고 검증 명령을 함께 적습니다.
- SEO, localStorage, static export 영향이 있으면 명시합니다.

# 디렉터리 및 아키텍처 메모
- 라우트는 /app, 재사용 UI는 /components, 정적 프리셋 및 템플릿 텍스트는 /content, 순수 생성 및 린트 헬퍼는 /lib에 둡니다. 모든 라우트에서 static export 호환성을 유지하세요.

# 선택 프로젝트 메모
- 랜딩 페이지 CTA는 `/?preset=nextjs-static` 같은 query-param 진입점을 우선 사용합니다.

이 빌더가 필요한 이유

대부분의 AGENTS 파일은 너무 모호하거나, 명령이 빠져 있거나, 관련 없는 정책이 과하게 섞여 있어 실패합니다. 이 빌더는 에이전트가 안전하게 행동하는 데 꼭 필요한 섹션만 남기도록 출력 범위를 좁혀 줍니다.

lint 패널이 확인하는 항목

검증 명령 누락, 금지 사항 누락, 모호한 표현, 중복 명령, 스택과 맞지 않는 명령, 지나치게 긴 섹션을 찾아냅니다.

빌더 FAQ

AGENTS.md Builder가 AI로 파일을 생성하나요?

아니요. 파일은 로컬 프리셋 데이터, 폼 입력, 브라우저 안의 결정적 문자열 조립 로직으로 만들어집니다. AI가 관여하지 않습니다.

제 저장소를 자동으로 스캐하나요?

아니요. 프로젝트 정보는 직접 입력하며, 뺌더가 저장소를 자동으로 읽지는 않습니다.

새로고침해도 draft가 유지되나요?

네. 현재 draft는 localStorage에 자동 저장되고, 브라우저 데이터를 지우기 전까지 같은 브라우저에서 복원됩니다.

결과를 바로 AGENTS.md로 다운로드할 수 있나요?

네. 다운로드 버튼을 누르면 항상 `AGENTS.md` 파일명으로 저장됩니다.