From 96d59b7d360033b2d6b4dc00a6bce45bf039d529 Mon Sep 17 00:00:00 2001
From: kent <shine1324@gmail.com>
Date: Sun, 21 Dec 2025 15:14:54 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20=EA=B3=B5=ED=86=B5=20=EC=9E=91=EC=97=85?=
 =?UTF-8?q?=20=ED=94=84=EB=A0=88=EC=9E=84=EC=9B=8C=ED=81=AC=20=EA=B0=80?=
 =?UTF-8?q?=EC=9D=B4=EB=93=9C=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 세션 지속성, 작업 프로세스, TC 기반 검증 가이드

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 guides/common-workflow-framework.md | 53 +++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 guides/common-workflow-framework.md

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