diff --git a/guides/common-workflow-framework.md b/guides/common-workflow-framework.md new file mode 100644 index 0000000..9738ff2 --- /dev/null +++ b/guides/common-workflow-framework.md @@ -0,0 +1,53 @@ +# 공통 작업 프레임워크 + +> 대량 작업 및 세션 간 지속성을 위한 표준 절차 + +## 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) \ No newline at end of file