Files
sam-docs/guides/common-workflow-framework.md
kent 96d59b7d36 docs: 공통 작업 프레임워크 가이드 추가
- 세션 지속성, 작업 프로세스, TC 기반 검증 가이드

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-21 15:14:54 +09:00

1.5 KiB

공통 작업 프레임워크

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

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. 완료 확인 → 상태 업데이트

역할 분리