docs:공동 개발 워크플로우 가이드 추가

- 로컬(Docker) 환경 업데이트 절차
- 서버 환경 업데이트 절차
- 환경별 명령어 요약 표
- pull 후 체크리스트

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

CLAUDE.md

@@ -2,6 +2,26 @@
 
 > 이 파일은 모든 프로젝트에 적용되는 전역 규칙입니다.
 
+## 메모리
+
+### sam설명
+SAM 프로젝트의 기술적 개요 문서입니다. 이 문서를 참조하면 SAM 프로젝트가 무엇인지 이해할 수 있습니다.
+
+**파일 경로**: `/home/aweso/sam/docs/SAM_PROJECT_OVERVIEW_FOR_AI.md`
+
+**핵심 요약**:
+- **회사**: 주일/경동 (블라인드/스크린 제조업체)
+- **프로젝트**: SAM (Smart Automation Management) - 차세대 ERP/MES 통합 시스템
+- **기술 스택**: Laravel 11 + HTMX + Tailwind CSS + MySQL 8.0
+- **아키텍처**: Multi-tenant (tenant_id 기반 데이터 격리)
+- **레거시**: 5130.co.kr (PHP 기반) → SAM으로 마이그레이션 중
+
+**사용자가 'sam설명'이라고 말하면**:
+1. 위 경로의 `SAM_PROJECT_OVERVIEW_FOR_AI.md` 파일을 읽어서 전체 내용을 파악하세요
+2. SAM 프로젝트의 비즈니스 도메인, 기술 스택, 현재 작업 현황을 이해한 상태로 작업하세요
+
+---
+
 ## Git 커밋 규칙 (최우선 필수 규칙)
 
 > **경고: 이 규칙은 절대 누락되어서는 안 됩니다!**
@@ -145,3 +165,95 @@ docker exec sam-mng-1 php artisan cache:clear
 - [ ] `composer` 명령 → `docker exec sam-mng-1 composer` 또는 `sam-api-1` 사용
 - [ ] DB 시더 실행 필요 시 → Docker를 통해 실행
 - [ ] **마이그레이션은 반드시 API에서 실행** → `docker exec sam-api-1 php artisan migrate`
+
+---
+
+## 공동 개발 워크플로우 (필수)
+
+> **중요: 코드를 pull 받은 후 반드시 필요한 명령을 실행하세요!**
+
+### 로컬 환경 (Docker) 업데이트
+
+```bash
+# 1. 코드 받기 (WSL에서 실행)
+cd /home/aweso/sam/api
+git pull
+
+cd /home/aweso/sam/mng
+git pull
+
+# 2. 의존성 업데이트 (composer.json 변경 시)
+docker exec sam-api-1 composer install
+docker exec sam-mng-1 composer install
+
+# 3. DB 마이그레이션 (API에서만!)
+docker exec sam-api-1 php artisan migrate
+
+# 4. 캐시 클리어 (설정 변경 시)
+docker exec sam-api-1 php artisan config:clear
+docker exec sam-mng-1 php artisan config:clear
+```
+
+### 서버 환경 업데이트
+
+```bash
+# API 프로젝트
+cd /home/webservice/api
+git pull
+composer install
+php artisan migrate
+php artisan config:clear
+
+# MNG 프로젝트 (마이그레이션 없음)
+cd /home/webservice/mng
+git pull
+composer install
+php artisan config:clear
+```
+
+### 요약 표
+
+| 작업 | 로컬 (Docker) | 서버 |
+|------|--------------|------|
+| git pull | WSL에서 직접 | 서버에서 직접 |
+| composer install | `docker exec sam-api-1 composer install` | `composer install` |
+| migrate | `docker exec sam-api-1 php artisan migrate` | `php artisan migrate` |
+| config:clear | `docker exec sam-api-1 php artisan config:clear` | `php artisan config:clear` |
+
+### 체크리스트 (pull 후)
+
+- [ ] API: `git pull` → `composer install` → `php artisan migrate` → `config:clear`
+- [ ] MNG: `git pull` → `composer install` → `config:clear` (마이그레이션 없음)
+
+---
+
+## 사용 가능한 Agents
+
+`~/.claude/agents/` 폴더에 있는 에이전트들:
+
+| Agent | 설명 |
+|-------|------|
+| `organizer-agent` | 프로젝트 구조화 및 정리 |
+| `proposal-agent` | 제안서 작성 |
+| `research-agent` | 리서치 및 조사 |
+
+---
+
+## 사용 가능한 Skills
+
+`~/.claude/skills/` 폴더에 있는 스킬들 (슬래시 명령어로 사용):
+
+| Skill | 설명 |
+|-------|------|
+| `pptx-skill` | PowerPoint 생성 |
+| `pdf-template-skill` | PDF 템플릿 분석/생성 |
+| `proposal-skill` | 제안서 생성 |
+| `storyboard-generator` | 스토리보드 생성 |
+| `code-flow-web-report` | 코드 플로우 웹 리포트 |
+| `codebase-analysis-web-report` | 코드베이스 분석 리포트 |
+| `code-bug-finder` | 버그 탐지 |
+| `code-refactoring` | 코드 리팩토링 |
+| `uml-generator` | UML 다이어그램 생성 |
+| `design-skill` | 디자인 작업 |
+
+**사용 방법**: `/skill-name` 형식으로 호출 (예: `/pptx-skill`)