Golden Flow Engine

Agent 중립 엔진으로, 프로젝트별 Golden Pack을 구축, 검증, 실행합니다. Codex, OpenClaw 및 기타 데스크톱 Agent에게 저장소 이해, 자체 골든 플로우 설계, 증거 수집, 긴 실행 재개, 제품과 함께 해당 플로우 유지 관리를 위한 결정론적 기반을 제공합니다.

Engine은 하드코딩된 HTTP 테스트 러너가 아니며 어떤 LLM도 호출하지 않습니다. 호스트 Agent는 프로젝트를 읽고 .golden-flow/를 작성하며, Engine은 팩트, 안전한 도구, 검증 및 실행을 제공합니다.

빠른 시작

python -m pip install -e ".[mcp]"
golden-flow inspect /path/to/project
golden-flow init /path/to/project
golden-flow validate /path/to/project
golden-flow plan /path/to/project
golden-flow run /path/to/project --mode strict

백그라운드 모드는 프로젝트 로컬 SQLite 큐를 사용합니다:

golden-flow job-start /path/to/project
golden-flow worker /path/to/project --once
golden-flow job-status /path/to/project JOB_ID

golden-flow-mcp를 실행하여 STDIO MCP를 통해 검사, Pack 관리, 계획 및 비동기 실행 도구를 노출하세요. 고정된 Agent 워크플로는 AGENT_GUIDE.md를 참조하세요.

Related MCP server: agent-orchestrator

기본 제공 어댑터

• file: 프로젝트 루트로 제한된 읽기, 목록, 해시, 존재 확인.

• shell: policies/safety.yaml에 명시적으로 등록된 argv 명령.

• http: Python 표준 라이브러리를 사용한 요청 및 응답 증거.

• playwright: 선택적 브라우저 탐색, 입력, 스크린샷, 콘솔 오류.

• sql-observer: 읽기 전용 SQLite 관찰; 쓰기, pragma, 다중 문은 거부됩니다.

• minium: CI를 위한 프로토콜 Mock 모드를 갖춘 선택적 WeChat 미니프로그램 기능.

• command-bridge: TypeScript, Java, Go 및 사용자 정의 도구를 위한 JSON 1개 입력/JSON 1개 출력 브리지.

어댑터 프로토콜은 기능, 사전 점검, 실행, 증거, 안전 검사, 오류 클래스 및 리소스 종료를 Engine 코어와 독립적으로 유지합니다.

중국어 설명

golden-flow-engine은 Codex, OpenClaw/龙虾 및 기타 데스크톱 Agent를 위한 "프로젝트 골든 플로우 구축 및 실행 엔진"입니다. 먼저 저장소를 결정론적 읽기 전용 스캔한 다음, 호스트 Agent가 문서, 코드, 페이지, 상태 모델 및 데이터 진실 공급원에 따라 해당 프로젝트의 .golden-flow/를 작성합니다. Engine은 디렉터리 형식, 의존성 토폴로지, 도구 안전, 증거 무결성, 포그라운드/백그라운드 실행, 체크포인트 결과 및 오류 분류를 담당하며, 실제 제품 비즈니스를 미리 구성하지 않고 모델 API도 내장하지 않습니다.

기본적으로 프로젝트 프로필, 트렁크/브랜치 목록, Python Journey, 도구 선언, 정책 및 Fixture 규칙을 커밋하고, 기본적으로 계정, Token, SQLite 실행 상태, 스크린샷, 로그, 보고서, 캐시 및 실제 비즈니스 자료는 무시합니다.

상태

v0.1.0은 알파 릴리스입니다. 프로토콜 및 스키마 이름은 버전 관리되지만, API는 v1 이전에 변경될 수 있습니다. 실제 Minium 인수 테스트는 Windows에서 WeChat DevTools를 사용하는 문서화된 수동 스모크 테스트로 유지되며, 일반 CI는 프로토콜 Mock을 사용합니다.

MIT 라이선스입니다. SECURITY.md 및 CONTRIBUTING.md를 참조하세요.