Workflows (워크플로우) - AIRGAP Studio 문서

개요

Workflows는 반복적인 작업 단계를 하나의 자동화 체인으로 묶어 실행하는 기능입니다. 여러 작업을 순서대로 정의해 두면 한 번의 실행으로 전체 과정을 자동으로 처리할 수 있습니다.

워크플로우 파일 형식

워크플로우는 .clinerules 파일 내에 ## Workflows 섹션으로 정의하거나, 별도의 .clineworkflows 파일로 작성합니다.

# .clineworkflows

## 코드 리뷰 워크플로우
1. 변경된 파일 목록을 확인한다.
2. 각 파일의 변경 사항을 분석한다.
3. 코딩 컨벤션 위반 사항을 보고한다.
4. 잠재적 버그나 성능 이슈를 식별한다.
5. 개선 제안 사항을 정리한다.

## 테스트 후 커밋 워크플로우
1. 현재 변경 사항에 대한 단위 테스트를 실행한다.
2. 테스트가 모두 통과하면 변경 사항을 스테이징한다.
3. 변경 내용을 요약하여 커밋 메시지를 작성한다.
4. 커밋을 생성한다.

워크플로우 실행

AIRGAP Assistant 대화창에서 워크플로우 이름을 언급하여 실행합니다.

"코드 리뷰 워크플로우를 실행해줘"
"테스트 후 커밋 워크플로우로 현재 변경사항을 처리해줘"

AI가 워크플로우의 각 단계를 순서대로 수행하며, 필요한 경우 사용자에게 승인을 요청합니다.

트리거 조건 설정

워크플로우에 트리거 조건을 추가하면 특정 상황에서 자동으로 실행을 제안합니다.

## 빌드 검증 워크플로우
트리거: 사용자가 "빌드" 또는 "배포"를 언급할 때

1. TypeScript 컴파일을 실행한다.
2. 린트 검사를 수행한다.
3. 단위 테스트를 실행한다.
4. 빌드 결과를 요약 보고한다.

참고: 트리거 조건이 설정되어 있어도 AI가 자동으로 워크플로우를 실행하지는 않습니다. 조건이 감지되면 실행 여부를 사용자에게 먼저 확인합니다.

커스텀 워크플로우 작성

효과적인 워크플로우를 작성하기 위한 지침입니다.

작성 원칙

단계를 구체적으로 작성합니다. "코드를 검토한다"보다 "변수 명명 규칙, 에러 처리, 타입 안전성을 검토한다"가 정확한 결과를 얻습니다.
순서가 중요한 작업은 번호 목록으로 작성합니다.
조건 분기가 필요하면 "만약 ~이면"으로 명시합니다.

실용적인 워크플로우 예시

## 컴포넌트 생성 워크플로우
1. 컴포넌트 이름과 props 타입을 정의한다.
2. React 함수형 컴포넌트를 생성한다.
3. 기본 스타일을 Tailwind CSS로 적용한다.
4. 컴포넌트 스토리(Storybook)를 생성한다.
5. 단위 테스트 파일을 생성한다.