automagik-dev/genie

Wishes in, PRs out. CLI agent that interviews you, plans the work, dispatches parallel agents in isolated worktrees, and reviews code before you see it.

해결하는 문제

Genie는 AI 코딩 에이전트(예: Claude Code 및 Codex)를 위한 계획 및 실행 레이어로, 구조화된 다단계 워크플로를 통해 모호한 아이디어를 병합 가능한 Pull Request로 전환하도록 설계되었습니다. 브레인스토밍, 디자인 리뷰, 계획, 독립 구현 리뷰라는 엄격한 순서를 강제함으로써 "환각 루프"를 방지합니다.

작동 방식

Genie는 Git 기반 문서와 로컬 SQLite 데이터베이스를 결합하여 상태를 추적합니다. 프로세스는 다음과 같은 특정 라이프사이클을 따릅니다:

  1. Brainstorming: 아이디어를 DESIGN.md 파일로 정제합니다.
  2. Wishing: 디자인을 실행 그룹을 포함하는 범위가 지정된 WISH.md로 변환합니다.
  3. Planning: 계획을 검토하고 승인합니다.
  4. Work: 네이티브 역할 에이전트를 파견하여 승인된 그룹을 병렬로 구축합니다.
  5. Review: 엔지니어 에이전트와 별개의 독립 리뷰어 에이전트가 수용 기준에 따라 구현을 검증합니다.

작업 상태는 단일 .genie/genie.db 파일에 저장되며, 백그라운드 데몬 없이도 여러 Git worktree가 동일한 작업 상태를 공유할 수 있습니다.

대상

AI 코딩 에이전트를 사용하는 개발자로, 기능 개발을 보다 엄격하고 구조화된 방식으로 진행하고 싶으며, 계획 및 여러 에이전트를 통한 병렬 실행이 필요한 복잡한 작업을 관리하고자 하는 사람들을 위한 도구입니다.

주요 특징

  • Git-native state: Wishes와 Designs는 Git으로 버전 관리되는 순수 markdown 파일입니다.
  • Zero-daemon architecture: 백그라운드 프로세스나 무거운 데이터베이스(Postgres 등)가 필요 없으며, SQLite 파일만 사용합니다.
  • Warp Cockpit: Wish의 준비된 그룹을 Warp 터미널 창에서 하나의 패널씩 각자의 worktree에 띄워 실행할 수 있습니다.
  • Omni Bridge: Omni 허브를 통해 WhatsApp과 연동되어 원격 승인 및 짧은 작업을 수행합니다.
  • MCP Server: 읽기 전용 Model Context Protocol (MCP) 서버를 제공하여 작업 및 보드 상태를 다른 AI 도구에 노출합니다.