r/promptengineering•4개월 전•2•5
zero-ratchet: AI 코딩 에이전트를 위한 게이트형 워크플로우
zero-ratchet: a gated workflow for AI coding agents
핵심 요약
AI 코딩 에이전트의 다단계 작업을 안정화하기 위해 단계별 경계와 검토 과정을 강제하는 오픈소스 워크플로우입니다.
- 구조화된 워크플로우 — 아이디어부터 PR까지 단계별 프로세스를 분리하여 에이전트의 신뢰성을 높임
- 명시적 게이트 — 에이전트가 스스로 결과물을 평가하지 않도록 별도의 검토 단계를 도입함
- 호스트 독립성 — Claude Code, Cursor, Hermes 등 디렉토리에서 스킬을 로드할 수 있는 환경이라면 어디서든 작동함
- 피드백 요청 — 게이트 모델의 복잡성, 제품 단계 산출물의 가치, 간소화 필요 부분에 대한 의견을 구함
더 긴 호흡의 AI 코딩 워크플로우를 실험해 오다가, 드디어 제가 사용하던 설정을 오픈소스로 공개합니다:
https://github.com/zero-click/zero-ratchet
Zero-ratchet은 AI 코딩 에이전트를 위한 워크플로우이자 스킬 모음입니다. 목표는 단계별 경계, 역할 분리, 명시적 게이트를 강제하여 다단계 소프트웨어 작업의 신뢰성을 높이는 것입니다.
하나의 거대한 프롬프트에 의존하는 대신, 프로세스를 구조화된 단계로 나눕니다. 포함된 내용은 다음과 같습니다:
- 제품 흐름: 아이디어 -> 발견 -> PRD -> 로드맵 -> UI 브리프
- 엔지니어링 흐름: 설계 -> 스토리 계획 -> TDD 루프 -> 검토 -> 추적성 -> PR
- 신선한 컨텍스트의 검토자: 동일한 에이전트가 스스로의 숙제를 채점하지 않도록 함
- 호스트 독립적 설정: 디렉토리에서 스킬을 로드할 수 있는 곳이라면 어디서든 작동 (Claude Code, Cursor, Hermes 등)
제가 해결하려던 문제는 다음과 같습니다:
- 에이전트는 작은 프롬프트-응답 작업은 잘 수행함
- 다단계, 다중 아티팩트 작업에서는 신뢰도가 떨어짐
- 워크플로우가 분리와 체크포인트를 강제하지 않으면 검토가 얕아짐
아주 작은 변경 사항에는 과할 수 있지만, 더 자동화되거나 반자동화된 에이전트 워크플로우를 실험하는 사람들에게는 유용할 것이라 생각합니다.
특히 다음 사항에 대한 피드백을 환영합니다:
- 게이트 모델이 너무 무겁게 느껴지는지, 아니면 적당한지
- 제품 단계의 아티팩트가 코딩 에이전트에게 오버헤드를 감수할 가치가 있는지
- 이런 것을 시도하기 전에 무엇을 간소화하고 싶은지
