# Cursor Agent & Skills 체계 매핑

## 최우선 제약: 리포트 기능 외 수정 금지

**모든 Agent와 Skill은 리포트 관련 파일만 수정한다.**

### 허용 범위

```
frontend/
├── components/report/**                          # 리포트 컴포넌트
├── app/(main)/admin/screenMng/reportList/**       # 리포트 라우트
├── contexts/ReportDesignerContext.tsx              # 디자이너 상태
├── hooks/useReportList.ts                         # 리포트 훅
├── lib/api/reportApi.ts                           # 리포트 API
├── types/report.ts                                # 리포트 타입
└── lib/registry/components/v2-report-viewer/**    # 리포트 뷰어 V2

backend-node/src/
├── routes/reportRoutes.ts
├── controllers/reportController.ts
├── services/reportService.ts
└── types/report.ts
```

### 범위 밖 파일에서 문제 발견 시

수정하지 말고 **보고만** 한다. 사용자 확인 후 진행.

---

## 아키텍처

```
.cursor/
├── rules/          # 항상 적용 규칙 (8개, 자동 로드)
├── agents/         # 전문가 역할 (4개, 자동 위임)
├── skills/         # 워크플로우/지식 (12개, 필요 시 로드)
└── mcp.json
```

## Layer 1: Rules (항상 적용)

| 파일 | 용도 |
|------|------|
| `api-client-usage.mdc` | fetch 금지, API 클라이언트 강제 |
| `database-guide.mdc` | PostgreSQL 쿼리 패턴 |
| `project-overview.mdc` | 기술 스택 개요 |
| `security-guide.mdc` | 인증/인가 |
| `multi-tenancy-guide.mdc` | company_code 필터링 |
| `admin-page-style-guide.mdc` | 관리자 페이지 스타일 (glob) |
| `modal-design.mdc` | 모달 디자인 (glob) |
| `component-development-guide.mdc` | V2 컴포넌트 상세 (요청 시) |

## Layer 2: Agents (전문가, 격리 컨텍스트)

| 에이전트 | 역할 | 자동 위임 |
|---------|------|----------|
| `code-reviewer` | 리포트 코드 품질/보안 검수 | Yes |
| `debugger` | 리포트 에러 진단/수정 | Yes |
| `pm` | 리포트 요구사항/명세서 | No |
| `web-verifier` | 리포트 UI 스크린샷 검증 | No |

## Layer 3: Skills (워크플로우, 메인 컨텍스트)

| Skill | 용도 | 자동 호출 |
|-------|------|----------|
| `implement` | 리포트 4단계 구현 워크플로우 | Yes |
| `plan` | 리포트 구현 계획서 + reportdocs 갱신 | Yes |
| `react-component` | 리포트 컴포넌트 클린코드 | Yes |
| `next-feature` | 리포트 Next.js 페이지/라우트 | Yes |
| `code-review` | 리포트 코드 검수 절차 | No |
| `code-fix` | 리포트 버그 수정 절차 | No |
| `github` | 리포트 변경 커밋 | No |
| `web-verify` | 리포트 UI 검증 절차 | No |
| `ui-debugging` | 리포트 UI 레이아웃/스크롤/스타일 | Yes |
| `component-registry` | 리포트 디자이너 컴포넌트 구조 | Yes |
| `table-sql` | 리포트 테이블 DDL/메타데이터 | Yes |
| `component-dev` | 리포트 V2 컴포넌트 개발 | Yes |
| `notion-writing` | Notion MCP 작성 규칙 (블록 제약, 서식, 사용자 스타일 가이드) | Yes |

## 백업

- `cursor-rules-backup-20260309.tar.gz` (프로젝트 루트)
- 복원: `tar xzf cursor-rules-backup-20260309.tar.gz`
