Core Solution(MindGarden) 프로젝트 전체 룰 인덱스. 백엔드·프론트·API·코드스타일 표준 적용 시 참조할 스킬과 문서 목록.
이 프로젝트는 Core Solution / MindGarden 표준을 따릅니다. 작업 유형에 따라 아래 스킬과 문서를 적용하세요.
DB 관련 기능 추가·수정 시 반드시 다음 순서를 따릅니다.
상세 규칙은 /core-solution-database-first 스킬을 참조하세요.
/core-solution-multi-tenant/core-solution-standardization 참조.mindgarden-design-system.pen, unified-design-tokens.css)만 사용한다.check-hardcode·리뷰에서 식별되면 예외 없이 수정·치환한다. 작업 중 하드코딩이 보이면 그 자리에서 제거·치환까지 완료가 완료 조건이다. 나중에, 경고만 허용으로 미루지 않는다. 포함: 인라인 색상·rgba(...)·Hex, 프로젝트 표준 위의 URL·포트·매직 문자열/숫자, CI/BI 하드코딩 가드가 잡는 항목, 공통코드/토큰/상수로 뺄 수 있는 값. 실행은 core-coder가 담당하고, 토큰·가이드 부재 시 core-designer와 먼저 스펙을 맞춘 뒤 치환한다. 필수 문서: docs/project-management/ADMIN_LNB_LAYOUT_UNIFICATION_MEETING_HANDOFF.md §17, docs/project-management/SETTINGS_PAGES_LAYOUT_UNIFICATION_ORCHESTRATION.md §1.3, docs/운영반영/PRE_PRODUCTION_GO_LIVE_CHECKLIST.md. 상세는 /core-solution-standardization 동일 절.수정 작업 시 반드시 아래 매핑에 맞는 서브에이전트를 호출한다. 매핑에 없는 작업 유형은 이 표에 추가한 뒤, 해당 서브에이전트를 사용하도록 한다.
| 작업 유형 | 서브에이전트 | 적용 스킬 | 비고 |
|---|---|---|---|
| HTML 마크업 (퍼블리싱) | core-publisher | /core-solution-publisher, /core-solution-atomic-design | designer 스펙 → HTML. JS/CSS 수정 안 함 |
| React/JS 컴포넌트 코드 작성·수정 | core-coder | /core-solution-frontend | 프론트엔드 소스. publisher HTML 기반 |
| Java/Spring 백엔드 코드 | core-coder | /core-solution-backend | API, Service, Entity 등 |
| UI/UX·레이아웃·비주얼 설계 | core-designer | /core-solution-standardization, /core-solution-design-handoff | 시안·토큰·스펙 정의 선행. 산출물은 publisher 전달 |
| 헤더·푸터·공통 레이아웃 수정 | core-coder | /core-solution-frontend, /core-solution-atomic-design | B0KlA·디자인 토큰 준수 |
| 스케줄·캘린더·모달 UI 수정 | core-coder | /core-solution-frontend | core-designer 시안 있으면 참조 |
| 매핑·ERP·비즈니스 로직 | core-coder | /core-solution-erp, /core-solution-business-flow | |
| 단위·통합·E2E 테스트 | core-tester | /core-solution-testing | 코드 구현은 하지 않음 |
| DB 스키마·Entity 설계 | core-coder | /core-solution-database-first | |
| 리포트·차트·대시보드 UI | core-coder | /core-solution-frontend | core-designer 시안 있으면 참조 |
| 설정·시스템 페이지 | core-coder | /core-solution-frontend, /core-solution-atomic-design | |
| API 설계·연동 | core-coder | /core-solution-api, /core-solution-backend | |
| 에러·500 원인 분석·수정 제안 | core-debugger | /core-solution-debug | 로그·스택트레이스 해석, 재현 절차·수정 제안. 코드 수정은 core-coder 위임 |
| 서버 상태·에러 로그·긴급 복구 | shell → core-debugger → core-coder | /core-solution-server-status | 개발·운영 서버 상태/로그/복구 후 원인 분석·core-coder 조치 |
| 배포·CI 워크플로 수정 | core-coder | /core-solution-deployment | GitHub Actions·systemd·배포 체크리스트·롤백 |
| 전반 기획·단계 설계·실행 계획 | core-planner | /core-solution-planning | 범위·Phase·산출물 정리, 분배실행(역할별 실행 분배) 표 작성 — 디자인(core-designer)·코더(core-coder)·디버그(core-debugger)·컴포넌트관리(core-component-manager)·쉘(shell)·문서정리(generalPurpose)·탐색(explore)·테스터(core-tester)에 맞춰 분배. 컴포넌트 정리 Phase 시 component-manager + core-coder 함께 배정 권장. 실행은 해당 서브에이전트 호출로 진행 |
| 화면·서버 컴포넌트 중복·적재적소 배치 제안 | core-component-manager | /core-solution-encapsulation-modularization, /core-solution-atomic-design | 코더와 한 팀(제안 → core-coder 실행). 코드 직접 작성 안 함 |
| 작업 전 플랜·조사·영역 분석 | explore | /core-solution-documentation | 넓은 범위 작업 전 현황·누락·우선순위 조사 |
| 문서 작성·정리·체계화 | generalPurpose | /core-solution-documentation | 표준 문서·가이드 작성·수정·재구성. 기획(explore/core-planner) 후 진행 권장 |
| 하드코딩 제거·CI/BI 하드코딩 가드 통과·토큰/상수 치환 | core-coder | /core-solution-standardization, /core-solution-code-style, /core-solution-frontend (또는 backend) | 운영 반영 전 필수. 터치한 파일·인접 블록에서 발견한 하드코딩은 같은 PR/작업에서 정리. 디자인 토큰·unified-design-tokens.css·공통코드·표준 상수 모듈 준수. 가이드 공백 시 core-designer와 스펙 합의 후 반영 |
| 새 작업 유형 추가 시 | — | — | docs/standards/SUBAGENT_USAGE.md 절차 따름 |
/core-solution-common-modules 스킬과 docs/standards/COMMON_MODULES_USAGE_GUIDE.md를 참조해 기존 공통 모듈을 우선 검토·사용한다./core-solution-planning 스킬 적용./core-solution-server-status 스킬 적용.docs/standards/SUBAGENT_USAGE.md 참고.| 작업 유형 | 적용 스킬 |
|---|---|
| DB 설계·테이블·쿼리·프로시저 | /core-solution-database-first |
| 멀티테넌트 (tenantId 필수) | /core-solution-multi-tenant |
| 디자인·소스 표준화 | /core-solution-standardization |
| 디자이너 산출물·코더 전달 형식 | /core-solution-design-handoff (core-designer 전용) |
| 퍼블리셔 HTML 마크업 표준 | /core-solution-publisher (core-publisher 전용) |
| Java/Spring 백엔드 코드 | /core-solution-backend |
| React/JS/TS 프론트엔드 코드 | /core-solution-frontend |
| 아토믹 디자인 (Atoms/Molecules/Organisms) | /core-solution-atomic-design |
| API 호출·연동 코드 | /core-solution-api |
| 코드 포맷·스타일 정리 | /core-solution-code-style |
| 단위·통합·E2E·보안 테스트 | /core-solution-testing |
| 핵심 비즈니스 흐름 및 UI 규칙 | /core-solution-business-flow |
| ERP 연동·거래 생성·트러블슈팅 | /core-solution-erp |
| 모달 추가·수정 | /core-solution-unified-modal |
| 공통 모듈 사용(컴포넌트·유틸 우선 검토·사용) | /core-solution-common-modules |
| 전반 기획·Phase·서브에이전트 가동 계획 | /core-solution-planning |
| 서버 상태·에러 로그·긴급 복구 | /core-solution-server-status |
| 배포·CI 워크플로 수정 | /core-solution-deployment |
| 문서 작성·정리·체계화 | /core-solution-documentation |
| 캡슐화·모듈화(경량화·반복 제거) | /core-solution-encapsulation-modularization |
| 에러·500 원인 분석·수정 제안(core-debugger) | /core-solution-debug |
/ 입력 후 스킬 이름 검색하여 수동 호출 가능/core-solution-documentation 스킬로 요청한다. 문서가 분산되거나 예전 문서를 참고해 개발하면 혼선이 커지므로, 문서 작업은 이 흐름으로만 수행한다.문서를 참조할 때는 반드시 최신 문서부터 확인합니다.
docs/standards/, docs/design-system/ 등 동일 주제 문서가 여러 개 있으면 최신 수정일·버전이 높은 문서를 우선 참조docs/archive/, docs/project-management/archive/ 등 과거·아카이브 문서를 우선 사용하면 이전 표준으로 되돌아갈 수 있음작업 전 해당 영역 표준 문서를 참조하고, 위 스킬 규칙을 준수하세요.