# 공통 작업 프레임워크

> 대량 작업 및 세션 간 지속성을 위한 표준 절차

## 1. 세션 지속성

### Serena 메모리 구조
```
{project}-context  → 결정사항, 분석결과, 참조파일
{project}-state    → 현재 상태, 진행률, 다음 액션
```

### 업데이트 시점
| 시점 | 행동 |
|------|------|
| 세션 시작 | `read_memory(state)` → 이어서 진행 |
| 단위 작업 완료 | `write_memory(state)` |
| 중요 결정 | `write_memory(context)` |
| 세션 종료 | 양쪽 최종 저장 + PROGRESS.md 업데이트 |

### 파일 백업
- `PROGRESS.md`: 체크리스트 (메모리 유실 대비)

---

## 2. 작업 프로세스

### 기본
- **code-workflow** 스킬 사용

### 대량 작업 시 간소화
| 유형 | 프로세스 | 커밋 |
|------|----------|------|
| **반복 작업** | 첫 번째만 전체, 이후 수정→검증 | 배치 (N개) |
| **분석 작업** | 분석→문서화 | 문서만 |
| **연동 작업** | 분석→수정→검증 | 기능 단위 |
| **API 개발/검증** | TC 설계→JSON→flow-tester→완료 | 완료 후 |

---

## 3. TC 기반 검증 (API 개발/검증 시에만)

### 프로세스
1. 기능 단위 선정 (예: 단가관리)
2. 선행 조건 파악 (단가 → 품목 필요)
3. TC 설계 (선행 데이터 등록부터 전체 플로우)
4. JSON 변환
5. flow-tester 검증 (사용자)
6. 완료 확인 → 상태 업데이트

### 역할 분리
- **Claude**: TC 설계 + JSON 생성 + 완료 처리
- **사용자**: flow-tester 실행 (https://mng.sam.kr/dev-tools/flow-tester)