automagik-dev/genie

해결하는 문제

Genie은 AI 에이전트가 단순히 코드를 작성하는 것을 넘어 브레인스토밍, 계획, 독립적 검토라는 엄격한 프로세스를 따르도록 보장하는 구조화된 에이전트 기반 소프트웨어 개발 워크플로우를 제공합니다. 각 단계(검토)를 해당 작업을 수행하지 않은 에이전트가 수행하도록 강제함으로써 진행 상황의 '환각'을 방지하고, 모든 설계와 계획을 리포지토리 내의 버전 관리되는 markdown 파일로 유지하여 장기적인 컨텍스트를 보존합니다.

작동 방식

Genie은 AI 코딩 에이전트(Claude Code 또는 Codex 등)와 통합되는 일련의 기술 및 저장된 워크플로우로 작동합니다. 작업을 처리하기 위해 특정 루프를 사용합니다:

• 브레인스토밍: 아이디어는 DESIGN.md 파일에 정리됩니다.
• 위시 (Wishing): 단일 작업은 /wish 명령어를 통해 처리되며, 이는 별도의 워크트리에서 변경 사항을 빌드하고 리포지토리 자체 검사를 실행한 후 풀 리퀘스트를 엽니다.
• 워킹 (Working): 더 큰 작업은 WISH.md 파일 내의 실행 그룹으로 분할되어 범위가 지정된 워커에 의해 의존성 순서대로 실행됩니다.
• 리뷰 (Reviewing): 모든 단계는 작업을 진행하기 전에 판정(예: SHIP, FIX-FIRST)을 반환해야 하는 독립적인 리뷰 에이전트에 의해 게이트됩니다.

작업 상태는 로컬 SQLite 데이터베이스(.genie/genie.db)에서 추적되며 CLI를 통해 칸반 보드로 볼 수 있습니다.

대상 사용자

단순한 코드 생성이 아닌 설계 검토, 독립적 검증, git 기반 컨텍스트를 포함한 전문적인 소프트웨어 엔지니어링 프로세스를 원하는 AI 코딩 에이전트 사용자.

주요 특징

• 독립적 검토 게이트: 자체 승인을 방지하기 위해 별도의 에이전트가 검토를 수행하도록 보장합니다.
• Git 기반 컨텍스트: 설계와 계획이 리포지토리에 markdown으로 저장되어 모든 에이전트에게 진실의 원천(source of truth)이 됩니다.
• 워크트리 격리: 작업은 자체 워크트리에서 빌드 및 테스트되므로 로컬 환경을 오염시키지 않습니다.
• 통합 기술 카탈로그: 18가지 전문 기술(예: research, docs-audit, council)과 12가지 저장된 워크플로우가 포함되어 있습니다.
• 에이전트 비종속성: Claude Code 및 Codex와 같은 다양한 에이전트 하네스에서 작동합니다.