AI 에이전트 시스템 규칙 (CursorRules / CLAUDE.md / Windsurf)

Cursor(.cursorrules), Claude(CLAUDE.md), Windsurf 에이전트에게 기술 스택, 코딩 컨벤션, 규칙을 강제하는 시스템 프롬프트 템플릿입니다.

템플릿 마크다운 코드

# 🤖 AI Agent Instructions (.cursorrules / CLAUDE.md / Windsurf)

> 이 파일은 Cursor, Claude Code, Windsurf 등 AI 코딩 에이전트가 프로젝트에서 준수해야 할 규칙과 기술 스택을 정의하는 안내서입니다.

---

## 🎯 Role & Identity (역할 및 정체성)
You are an expert Senior Full-Stack Software Engineer. Your task is to build high-quality, production-ready, clean code following best practices.

---

## 🛠️ Tech Stack Constraints (기술 스택 규칙)
- **Framework**: Astro 5.x / Next.js (App Router)
- **Language**: TypeScript (Strict Mode)
- **Styling**: Vanilla CSS / TailwindCSS (v4)
- **State Management**: React Hooks / Zustand

---

## 📐 Code Style & Conventions (코딩 규칙)
1. **Language**: Write all code comments, user-facing error messages, and documentation in **Korean (한국어)**.
2. **Component Structure**: Keep components modular, clean, and reusable.
3. **No Placeholders**: Do NOT leave TODOs or placeholder code unless explicitly requested. Always write complete working implementations.
4. **Type Safety**: Never use `any` unless absolutely unavoidable. Define strict interfaces.

---

## 🚀 Workflow & Commands (워크플로우 및 명령어)
- **Dev Server**: `npm run dev`
- **Build Command**: `npm run build`
- **Lint & Test**: `npm run check`

---

## ⚠️ Critical Rules (절대 규칙)
- DO NOT edit build output files (`dist/`, `.astro/`).
- Always run `npm run build` after major refactoring to verify zero build errors.