Files
sam-docs/dev/guides/common-workflow-framework.md
권혁성 db63fcff85 refactor: [docs] 팀별 폴더 구조 재편 (공유/개발/프론트/기획)
- 개발팀 전용 폴더 dev/ 생성 (standards, guides, quickstart, changes, deploys, data, history, dev_plans 이동)
- 프론트엔드 전용 폴더 frontend/ 생성 (api/ → frontend/api-specs/)
- 기획팀 폴더 requests/ 생성
- plans/ → dev/dev_plans/ 이름 변경
- README.md 신규 (사람용 안내), INDEX.md 재작성 (Claude Code용)
- resources.md 신규 (노션 링크용, assets/brochure 이관 예정)
- CURRENT_WORKS.md 삭제, TODO.md → dev/ 이동
- 전체 참조 경로 업데이트

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-05 16:46:03 +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. 완료 확인 → 상태 업데이트

역할 분리