osolmaz/pi-workflows

해결하는 문제

pi-workflows는 LLM 추론, 결정론적 코드 실행, 인간의 감시가 필요로 하는 복잡한 다단계 AI 에이전트 작업을 관리하는 문제를 해결합니다. 단일한 긴 프롬프트나 예측 불가능한 에이전트 루프에 의존하는 대신, 일시 중지, 재개, 모니터링이 가능한 구조적이고 내구성 있는 워크플로우를 정의할 수 있습니다.

작동 방식

Pi 코딩 에이전트의 확장으로 작동하며, 사용자가 TypeScript 그래프로 워크플로우를 정의할 수 있게 합니다. 이러한 그래프는 agent (LLM 프롬프트), compute (TS 함수), shell (명령어), checkpoint (사람의 입력) 등의 노드와 실행 경로를 결정하는 엣지로 구성됩니다.

핵심 기술 구성 요소:

• 내구성 있는 실행: 상태는 로컬 SQLite 데이터베이스에 지속되므로, 재시작 후에도 워크플로우가 유지되며 인간의 결정을 위해 일시 중지할 수 있습니다.
• 통합: Pi 대화 내에서 /workflow 명령어로 워크플로우를 트리거하며, 현재 대화의 컨텍스트를 유지합니다.
• 가시화: 전용 터미널 뷰어 (piw)가 워크플로우의 진행 상황과 기록을 실시간으로 상자형 그래프 형태로 제공합니다.
• 리소스 매니저: 외부 상태(예: PR 모니터링)와 장시간 실행되는 자동화를 일치시키기 위한 선언적 시스템.

대상 사용자

자동 계획, 구현, 검증과 같은 고도화된 소프트웨어 엔지니어링 파이프라인을 자동화하면서도 프로세스에 대한 세밀한 제어를 유지하고자 하는 Pi 코딩 에이전트 사용자에게 적합합니다.

주요 특징

• TypeScript 그래프 정의: 타입 안전한 TS API를 사용해 복잡한 로직, 루프, 분기 구현 가능.
• 인간 중심의 워크플로우: 보호된 인간 결정과 체크포인트를 내장한 지원 기능.
• 실시간 모니터링: 단계 재실행 및 추적 검사가 가능한 인터랙티브 TUI 뷰어.
• 사전 구축된 기술: 자동 계획, 자동 구현, 정합성 검사용 사전 패키지 워크플로우 포함.
• Herdr 통합: 시ーム리스한 패널 관리를 위한 Herdr 환경과의 깊은 통합.