pipeline/.cursor/AGENT_SKILLS_MAP.md

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