이 빌더가 필요한 이유
대부분의 AGENTS 파일은 너무 모호하거나, 명령이 빠져 있거나, 관련 없는 정책이 과하게 섞여 있어 실패합니다. 이 빌더는 에이전트가 안전하게 행동하는 데 꼭 필요한 섹션만 남기도록 출력 범위를 좁혀 줍니다.
프리셋을 고르고 항목을 채운 뒤, lint 경고를 확인하세요. 저장소를 스캔하거나 데이터를 외부로 보낼 필요 없이 깔끔한 AGENTS.md를 복사하거나 다운로드할 수 있습니다.
탄탄한 출발점을 고른 뒤, 저장소에 필요한 부분만 수정하세요.
필수 항목을 먼저 채우고, 스택 규칙·워크플로 규칙·선택 메모를 순서대로 입력하세요.
현재 lint 경고가 없습니다. draft가 깔끔하고 스캔하기 좋은 상태입니다.
# 프로젝트 목적 - 프로젝트 이름: 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 파일은 너무 모호하거나, 명령이 빠져 있거나, 관련 없는 정책이 과하게 섞여 있어 실패합니다. 이 빌더는 에이전트가 안전하게 행동하는 데 꼭 필요한 섹션만 남기도록 출력 범위를 좁혀 줍니다.
검증 명령 누락, 금지 사항 누락, 모호한 표현, 중복 명령, 스택과 맞지 않는 명령, 지나치게 긴 섹션을 찾아냅니다.
아니요. 파일은 로컬 프리셋 데이터, 폼 입력, 브라우저 안의 결정적 문자열 조립 로직으로 만들어집니다. AI가 관여하지 않습니다.
아니요. 프로젝트 정보는 직접 입력하며, 뺌더가 저장소를 자동으로 읽지는 않습니다.
네. 현재 draft는 localStorage에 자동 저장되고, 브라우저 데이터를 지우기 전까지 같은 브라우저에서 복원됩니다.
네. 다운로드 버튼을 누르면 항상 `AGENTS.md` 파일명으로 저장됩니다.