AgwaB/pi-workflow

해결하는 문제

pi-workflow는 반복 가능하고 구조화된 복잡한 다단계 AI 에이전트 워크플로우를 실행할 수 있는 방법을 제공합니다. 단일 프롬프트에 의존하는 것이 아니라, 깊은 연구나 코드 리뷰와 같은 결정론적 프로세스를 정의할 수 있으며, 여러 하위 에이전트가 병렬 또는 순차적으로 작업하여 고품질 결과를 달성할 수 있습니다.

작동 방식

시스템은 자연어로 작성된 작업을 정의된 단계의 연속으로 처리하는 '스테이지 그래프'로 작업을 정리합니다. @agwab/pi-subagent를 사용하여 워커를 조율하며, 다음과 같은 실행 패턴을 지원합니다:

• Single: 하나의 하위 에이전트를 위한 집중형 프롬프트.
• Foreach: 동적 팬아웃. 하나의 에이전트가 항목 목록을 생성하고, 별도의 에이전트가 각 항목을 처리합니다.
• Reduce: 팬인 합성. 여러 상류 단계의 결과를 통합하여 최종 보고서를 생성합니다.
• Loop: 종료 조건이 충족될 때까지 제한된 반복.
• DAG: 복잡한 조직 구조를 위한 중첩된 그래프.
• Dynamic: 컨트롤러 코드를 사용해 태스크를 실시간으로 생성하는 적응형 오케스트레이션.

대상 사용자

아키텍처 리뷰, 사양 준수 검사, 프로젝트별 팀 루틴과 같은 반복적이고 고위험 작업을 자동화해야 하는 Pi 생태계를 사용하는 개발자 및 팀.

주요 기능

• 사전 구축된 워크플로우: deep-research, deep-review, spec-review, impact-review를 위한 사전 정의된 템플릿 포함.
• 시각적 모니터링: 실행 진행 상황 확인, 스테이지 탐색, 작업 아티팩트 보기 가능한 내장 TUI 워크플로우 보드 (/workflow).
• 사용자 정의 가능: workflow-guide 스킬을 사용해 워크플로우를 생성하거나 수정 가능.
• 실행 프로필: low, medium, high와 같은 사용자 정의 이름의 프로필을 지원하여 워크플로우 실행 방식을 제어.
• 적응형 라우팅: execution-router 스킬은 태스크가 단일 에이전트, 특정 워크플로우, 또는 타겟 검증자 필요 여부를 판단하는 데 도움을 줍니다.