Smart Agent Hub (Codex + Claude)

한국어

Smart Agent Hub는 codex와 claude 작업을 병렬로 운영하기 위한 오케스트레이션 도구입니다.
이 저장소에는 작업 큐, 파일 락, 디스패치, 게이트, 평가, 머지 준비 자동화가 포함되어 있습니다.

핵심 기능

• 태스크 큐: 우선순위/의존성/상태 관리
• 파일 락: 동시 수정 충돌 방지
• 디스패치: 단일 실행(dispatch run) / 병렬 실행(dispatch parallel)
• 게이트: 정책 검증 + 리포트(gate check, gate report)
• 품질 평가: eval run
• 머지 준비: merge prep
• 환경 점검: doctor check

빠른 시작

npm install
npm run hub -- init
npm run hub:doctor

기본 워크플로

# 1) 태스크 등록
npm run hub -- task add --id TASK-001 --owner codex --scope "src" --acceptance "npm run build"
npm run hub -- task add --id TASK-002 --owner claude --scope "src-tauri" --acceptance "npm run build"

# 2) 병렬 실행 (드라이런)
npm run hub:dispatch:parallel -- --dry-run --json

# 3) 실제 실행
npm run hub:dispatch:parallel

# 4) 릴리즈 게이트
npm run hub:release-gate

문서

• 한글 사용 가이드: GUIDELINE.md
• 허브 상세 명령: docs/agent-hub.md

---

English

Smart Agent Hub orchestrates parallel development flows across codex and claude.
This repository includes a task queue, file locking, dispatch runners, gate checks, evaluation, and merge-prep automation.

Key Features

• Task queue: priority, dependency, and lifecycle management
• File lock registry: conflict prevention for concurrent edits
• Dispatch: single (dispatch run) and parallel (dispatch parallel)
• Gate: policy validation and markdown report (gate check, gate report)
• Evaluation: eval run
• Merge preparation bundle: merge prep
• Environment readiness checks: doctor check

Quick Start

npm install
npm run hub -- init
npm run hub:doctor

Typical Workflow

# 1) Add tasks
npm run hub -- task add --id TASK-001 --owner codex --scope "src" --acceptance "npm run build"
npm run hub -- task add --id TASK-002 --owner claude --scope "src-tauri" --acceptance "npm run build"

# 2) Parallel dispatch (dry-run first)
npm run hub:dispatch:parallel -- --dry-run --json

# 3) Execute
npm run hub:dispatch:parallel

# 4) Release gate
npm run hub:release-gate

Docs

• Korean usage guide: GUIDELINE.md
• Detailed hub command reference: docs/agent-hub.md