워크플로우 패턴 이해하기 : 복잡한 작업을 단계별로 설계하는 법

작성자: 주아라기

목차

    워크플로우 패턴 이해하기 : 복잡한 작업을 단계별로 설계하는 법

    스킬이 복잡해지면 순서가 중요해집니다.

    "먼저 이걸 하고, 그다음 저걸 하고, 마지막에 이걸 해줘" - 이런 작업을 체계적으로 설계하는 것이 워크플로우 패턴입니다.

    이 글에서는 스킬에서 자주 사용하는 워크플로우 패턴들을 알아봅니다.

    워크플로우란?

    🎭 왜왜씨와 딱딱씨의 대화
    🤔
    왜왜씨

    워크플로우가 뭔가요?

    🎯
    딱딱씨

    조립설명서 같은 거야. "1단계: A를 끼우고, 2단계: B를 연결하고..." 이런 식으로 작업 순서를 정해놓는 거지.

    🤔
    왜왜씨

    그냥 "이거 해줘"라고 하면 알아서 안 하나요?

    🎯
    딱딱씨

    간단한 건 괜찮아. 하지만 복잡한 작업은 순서를 명확히 해야 빠짐없이, 일관되게 처리돼. 안 그러면 어떤 때는 A부터, 어떤 때는 C부터 시작해.

    워크플로우 패턴의 필요성

    ① 일관성 - 매번 같은 순서로 작업 수행
    ② 완결성 - 필요한 단계를 빠뜨리지 않음
    ③ 품질 - 각 단계에서 검증 가능

    패턴 1: 순차 실행

    가장 기본적인 패턴입니다. 단계를 순서대로 실행합니다.

    Step 1 → Step 2 → Step 3 → 완료

    SKILL.md 예시

    ## 작업 순서

### Step 1: 요구사항 분석
사용자 요청을 분석하여 핵심 요구사항을 추출합니다.

### Step 2: 구조 설계
요구사항에 맞는 코드 구조를 설계합니다.

### Step 3: 코드 작성
설계에 따라 실제 코드를 작성합니다.

### Step 4: 검증
작성한 코드가 요구사항을 충족하는지 확인합니다.

**중요**: 각 단계를 순서대로 진행하고, 이전 단계 완료 전 다음 단계로 넘어가지 마세요.
    🎯 딱딱씨의 팁

    단계마다 명확한 종료 조건을 적어두면 AI가 언제 다음 단계로 넘어갈지 판단하기 쉽습니다!

    패턴 2: 조건 분기

    상황에 따라 다른 경로로 진행합니다.

    분석 → 조건 확인 → 경로 A 또는 경로 B

    SKILL.md 예시

    ## 작업 흐름

### Step 1: 파일 유형 확인
대상 파일의 확장자를 확인합니다.

### Step 2: 유형별 처리
- **.ts/.tsx 파일인 경우**: TypeScript 린트 규칙 적용
- **.js/.jsx 파일인 경우**: JavaScript 린트 규칙 적용
- **.py 파일인 경우**: Python PEP8 규칙 적용
- **기타 파일**: "지원하지 않는 파일 형식입니다" 안내

### Step 3: 결과 출력
적용된 규칙과 발견된 이슈를 정리합니다.

    패턴 3: 반복 실행

    여러 항목에 대해 같은 작업을 반복합니다.

    목록 수집 → 각 항목에 대해 처리 반복 → 결과 종합

    SKILL.md 예시

    ## 작업 흐름

### Step 1: 대상 파일 목록 수집
프로젝트 내 모든 컴포넌트 파일을 찾습니다.

### Step 2: 각 파일 처리 (반복)
수집된 각 파일에 대해 다음을 수행:
1. 파일 읽기
2. 코드 분석
3. 개선점 기록

### Step 3: 결과 종합
모든 파일의 분석 결과를 하나의 리포트로 정리합니다.
    🎭 왜왜씨와 딱딱씨의 대화
    🤔
    왜왜씨

    파일이 100개면 100번 반복하라는 건가요?

    🎯
    딱딱씨

    그렇지! 물론 많으면 상위 10개만 같은 제한을 둘 수도 있어. 워크플로우에 "최대 N개까지 처리"라고 명시하면 돼.

    패턴 4: 검증 포함

    각 단계 후 결과를 검증하고 문제 시 재시도합니다.

    실행 → 검증 → 통과 시 다음 / 실패 시 재시도

    SKILL.md 예시

    ## 작업 흐름

### Step 1: 코드 생성
요청에 맞는 코드를 작성합니다.

### Step 2: 자체 검증
작성한 코드를 다음 기준으로 검증:
- [ ] 문법 오류 없음
- [ ] 요구사항 충족
- [ ] 예외 처리 포함

### Step 3: 검증 결과 처리
- **모두 통과**: Step 4로 진행
- **하나라도 실패**: 해당 부분 수정 후 Step 2 재실행

### Step 4: 최종 출력
검증된 코드를 사용자에게 제공합니다.
    🎯 딱딱씨의 팁

    검증 단계에 체크리스트를 넣으면 AI가 하나씩 확인하며 진행합니다. 품질이 확 올라가요!

    패턴 조합하기

    실제 스킬에서는 여러 패턴을 조합해서 사용합니다.

    💡 조합 예시: 코드 리뷰 스킬

    1. 파일 목록 수집 (순차)
2. 각 파일 분석 (반복)
   2-1. 파일 유형 확인 (조건 분기)
   2-2. 유형별 규칙 적용
   2-3. 결과 검증 (검증 포함)
3. 전체 리포트 생성 (순차)
    핵심 정리

    순차 실행 - Step 1 → 2 → 3 순서대로
    조건 분기 - 상황에 따라 다른 경로
    반복 실행 - 여러 항목에 같은 처리
    검증 포함 - 결과 확인 후 재시도 가능
    조합 - 복잡한 작업은 패턴 조합

    다음 글 예고

    👉 프로그레시브 디스클로저 : 토큰을 절약하면서 스킬 성능 높이기

    워크플로우 패턴으로 복잡한 작업도 체계적으로 처리하세요!
    일관된 품질이 보장됩니다! 📋

    댓글

    댓글 쓰기