shin
3.2 KiB
3.2 KiB
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