gmickel/flow-next

Flow‑Next – AI 기반 코딩 에이전트 워크플로

정의 – Flow‑Next는 코드 생성 LLM(Claude Code, OpenAI Codex, Cursor, Grok Build 등)과 저장소 사이에 위치하는 플러그인입니다. 에이전트에 버그, 기능, 티켓 또는 성능 문제에 대한 설명을 제공하면 Flow‑Next가 전체 개발 주기를 오케스트레이션합니다. 실패하는 테스트나 승인 사양을 만들고, 모델이 수정 사항을 작성하도록 요청하며, diff를 다른 모델 패밀리로 라우팅하여 검토하고, 테스트/벤치마크를 실행한 다음, 각 변경 사항을 원래 기준에 매핑하는 pull request를 엽니다. 모든 산출물(사양, 결정, 영수증)은 .flow/ 디렉토리에 저장되어 작업이 감사 가능하게 유지됩니다.

중요성 – 순수 LLM 생성 코드는 종종 주변 스캐폴딩(명확한 사양, 자동화된 검증, 독립적인 검토)이 부족합니다. Flow‑Next는 이러한 누락된 단계를 자동으로 추가하며, README에 따르면 에이전트 단독 실행과 비교하여 전달 속도가 최대 2배, 품질이 10‑50% 향상됩니다(숨은 테스트 실패 감소).

주요 기능

• 경로 선택 – 입력(버그, 기능, 성능 요청, 티켓)에 따라 Flow‑Next는 최소 워크플로(예: 테스트 우선, 사양 우선, 측정 우선)를 선택합니다. 계획된 경로는 flow --explain으로 확인할 수 있습니다.
• 사양 및 테스트 생성 – 스택 트레이스를 실패하는 테스트로 변환하고, 기능에 대한 번호가 매겨진 승인 기준을 작성하며, 리팩토링 전에 특성화 테스트를 만듭니다.
• 모델 패밀리 검토 – diff는 작성한 모델과 다른 패밀리의 모델이 검토하여 맹점 편향을 줄입니다.
• 증거 및 영수증 – 각 단계는 ran, skipped(reason) 또는 failed(reason)을 기록합니다. 결과, 측정 및 검토 결정은 .flow/에 보관됩니다.
• 자율 모드 – flow --auto(또는 --until=merge)는 사람의 프롬프트 없이 실행되며, PR이 승인될 때까지 검토, CI 및 병합을 반복합니다.
• 멀티 호스트 지원 – Claude Code, OpenAI Codex, Factory Droid, Cursor, xAI Grok Build, OpenCode 및 Meta Muse Code용 플러그인으로 설치할 수 있으며, 호스트별 설치 명령이 제공됩니다.
• CLI 및 문서 – flowctl은 CLI를 제공합니다. 광범위한 문서, Discord 커뮤니티 및 공개 증거 페이지가 성능 주장을 뒷받침합니다.

일반적인 워크플로

1. 설정 – 호스트용 플러그인을 설치하고 /flow-next:setup을 실행하여 지침 스니펫을 작성하고 검토 모델을 선택합니다.
2. 호출 – /flow-next:flow <description>(또는 flow --auto). Flow‑Next는 경로를 결정하고, 테스트/사양을 만들고, 코드를 생성하고, 검증을 실행하고, 첫 번째 인간 결정 지점에서 멈춥니다.
3. 검토 및 PR – “PR을 열어”라고 말하면 각 변경 사항을 해당 승인 기준에 매핑하는 pull request를 엽니다.
4. 랜딩 – /flow-next:land <PR>은 남은 검토/CI 피드백을 해결하고 승인 후 squash‑merge합니다.

증거 – README는 Flow‑Next와 일반 Claude Code를 비교한 170회의 엔드투엔드 실행 벤치마크를 인용하며, 버그 수정, 소형/대형 기능 및 Rust 사례에서 속도 1.1‑1.9배, 품질 8‑48% 향상을 보여줍니다.

대상 – 이미 LLM 코딩 어시스턴트를 사용하고 있으며 사양, 테스트, 독립 검토 및 자동 PR 처리를 추가하는 반복 가능하고 감사 가능한 파이프라인을 원하는 팀. 모노레포, 마이크로서비스 환경 및 레거시 코드베이스에서 작동하며 GitHub, GitLab 및 Jira와 통합됩니다.

라이선스 및 커뮤니티 – MIT 라이선스, 오픈소스. 프로젝트는 활발하며(3개 OS에서 CI, Discord, 스폰서 링크) “awesome‑Claude‑Code‑workflows” 컬렉션에 등재되어 있습니다.