docs: 공통 작업 프레임워크 가이드 추가

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

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2025-12-21 15:14:54 +09:00
parent e217266376
commit 96d59b7d36

View File

@@ -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)