القائمة
ICJC Docker 서비스 관리 및 Make 명령어. Use when: (1) docker, make, 컨테이너, 서비스, 재시작, 로그 관련 요청, (2) 백엔드/프론트엔드/에이전트 재시작, (3) 빌드, 컨테이너 접속, 로그 확인, 서비스 상태 확인 필요시.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | docker-commands |
| description | ICJC Docker 서비스 관리 및 Make 명령어. Use when: (1) docker, make, 컨테이너, 서비스, 재시작, 로그 관련 요청, (2) 백엔드/프론트엔드/에이전트 재시작, (3) 빌드, 컨테이너 접속, 로그 확인, 서비스 상태 확인 필요시. |
ICJC 프로젝트의 Docker 서비스 관리를 위한 스킬입니다.
<trigger_conditions>
다음 키워드나 상황에서 이 스킬을 사용하세요:
<service_architecture>
의존성 순서: MongoDB (27017) → Redis (6379) → Backend (8000) → Agent Gateway (8100→8080) → Frontend (3000)
| 서비스 | 컨테이너명 | 외부포트 | 내부포트 | 설명 |
|---|---|---|---|---|
| mongodb-primary | mongodb-primary-dev | 27017 | 27017 | MongoDB Atlas Local |
| redis | redis-dev | 6379 | 6379 | Redis 캐시 |
| backend | backend-dev | 8000 | 8000 | FastAPI 백엔드 |
| agent-multi-gateway | agent-multi-gateway-dev | 8100 | 8080 | AI Agent Gateway |
| frontend | frontend-dev | 3000 | 3000 | Next.js 프론트엔드 |
| </service_architecture> |
| 명령어 | 설명 | 사용 시점 |
|---|---|---|
make build | 전체 빌드 및 실행 | 첫 실행, 의존성 변경 |
make all | 빌드 없이 실행 | 이미 빌드된 상태 |
make dev | Docker Watch 개발 모드 | 개발 중 |
| 명령어 | 설명 | 영향 범위 |
|---|---|---|
make backend | 백엔드 + Agent 재시작 | DB/Frontend 유지 |
make frontend | 프론트엔드 재시작 (dev) | Frontend만 |
make frontend-prod | 프론트엔드 (prod) | Frontend만 |
make agent | Agent Gateway만 실행 | Agent만 |
make agents | 모든 Agent 재빌드 | Agent 전체 |
make agents-light | 모든 Agent 재시작 (빌드X) | Agent 전체 |
make re-app | 앱 컨테이너만 재시작 | DB 유지 |
| 명령어 | 대상 |
|---|---|
make logs | 전체 |
make logs-backend | 백엔드 |
make logs-frontend | 프론트엔드 |
make logs-agent | Agent Gateway |
make logs-mongo | MongoDB 초기화 |
docker logs -f backend-dev | 백엔드 (직접) |
docker logs -f --tail 100 frontend-dev | 프론트엔드 최근 100줄 |
| 명령어 | 대상 |
|---|---|
docker exec -it backend-dev bash | 백엔드 |
docker exec -it frontend-dev sh | 프론트엔드 |
docker exec -it mongodb-primary-dev mongosh | MongoDB |
docker exec -it agent-multi-gateway-dev bash | Agent |
| 명령어 | 설명 | 주의 |
|---|---|---|
make down | 컨테이너 중지 + 볼륨 삭제 | 데이터 유지됨 |
make fclean | down + 이미지/네트워크 정리 | |
make purge | 모든 Docker 리소스 제거 | 매우 주의 |
| 명령어 | 설명 |
|---|---|
make mongo | MongoDB 레플리카셋 테스트 |
make mongo-reset | MongoDB 완전 초기화 (데이터 삭제!) |
make mongo-backup-dev | Dev DB 백업 |
make mongo-restore | 백업 복원 |
make mongo-sync-dev | 백업 → 복원 |
make mongo-rebuild | 초기화 + 재시작 + 복원 |
| 명령어 | 설명 |
|---|---|
make fix-permissions | 파일 권한 문제 해결 |
make frontend-fix-next-perms | .next 볼륨 권한 수정 |
make mem-watch | 메모리 모니터링 |
<environment_variables>
| 변수 | 기본값 | 설명 |
|---|---|---|
| FRONTEND_MODE | development | 프론트엔드 모드 |
| USER_ID | $(id -u) | 컨테이너 사용자 ID |
| GROUP_ID | $(id -g) | 컨테이너 그룹 ID |
# 프로덕션 모드로 빌드
make build FRONTEND_MODE=production
</environment_variables>
## 일반적인 워크플로우make backend (빠른 재시작)make agents-light (빌드 없이 재시작)make build (전체 재빌드)make logs-backend 또는 make logs-frontenddocker psmake re-appmake down && make buildmake fclean && make build
make backend, make re-app)를 먼저 시도하세요.make purge는 모든 Docker 리소스를 삭제합니다. 사용자에게 경고하세요.
This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
Frontend development guidelines for React/TypeScript applications. Modern patterns including Suspense, lazy loading, useSuspenseQuery, file organization with features directory, MUI v7 styling, TanStack Router, performance optimization, and TypeScript best practices. Use when creating components, pages, features, fetching data, styling, routing, or working with frontend code.
Build user interfaces using Redpanda UI Registry components with React, TypeScript, and Vitest testing. Use when user requests UI components, pages, forms, or mentions 'build UI', 'create component', 'design system', 'frontend', or 'registry'.
ICJC MongoDB 데이터베이스 접근 및 쿼리. Use when: (1) mongodb, mongo, DB, 데이터베이스, 쿼리 관련 요청, (2) collection, document 조회/업데이트/삭제, (3) 데이터 확인이나 디버깅을 위한 DB 조회 필요시. IN7DB(메인앱), AgentDB(에이전트) 데이터베이스 지원.
Master Next.js 14+ App Router with Server Components, streaming, parallel routes, and advanced data fetching. Use when building Next.js applications, implementing SSR/SSG, or optimizing React Server Components.