liuyingxuvka/FlowGuard

FlowGuard은(는) 무엇을 하나요?

AI 에이전트 워크플로우, UI 흐름 및 개발 프로세스를 설계하고 검증하기 위한 실행 가능한 유한 상태 모델입니다.

상태와 전이를 기반으로 한 명확한 모델링을 통해 복잡한 작업을 구조화하고, 잠재적인 오류를 사전에 탐지할 수 있습니다. 이 스킬은 Claude Code, Cursor, Codex 등의 AI 에이전트 플랫폼에서 사용할 수 있습니다.

주요 기능

• 유한 상태 머신 정의: 시스템의 상태와 상태 간 전이를 명시적으로 정의합니다.
• 가드 조건 설정: 특정 조건이 충족될 때만 전이가 발생하도록 제어합니다.
• 실행 가능한 모델: 정의된 모델을 실제로 실행하여 워크플로우를 검증합니다.
• 오류 조기 발견: 실행 전에 모델을 검사하여 논리적 오류나 예외 상황을 발견합니다.

사용 방법

1. 상태(State)와 이벤트(Event)를 정의합니다.
2. 각 상태에서 발생할 수 있는 전이(Transition)와 가드(Guard)를 설정합니다.
3. 모델을 실행하여 의도한 대로 동작하는지 확인합니다.
4. 필요에 따라 모델을 반복적으로 수정하고 검증합니다.

예제 코드

from flowguard import StateMachine

# 상태 머신 정의
machine = StateMachine(
    states=["idle", "processing", "completed", "error"],
    initial="idle",
    transitions=[
        {"trigger": "start", "source": "idle", "dest": "processing"},
        {"trigger": "finish", "source": "processing", "dest": "completed", "guard": "is_valid"},
        {"trigger": "fail", "source": "processing", "dest": "error"},
        {"trigger": "retry", "source": "error", "dest": "processing"},
    ]
)

# 모델 실행
event_sequence = ["start", "finish"]
result = machine.run(event_sequence)
print(result)  # 성공 여부 및 최종 상태 출력

지원 환경

• Claude Code
• Cursor
• Codex
• 기타 AI 코딩 에이전트

참고

보다 자세한 내용은 공식 문서를 참조하세요.