프로젝트 소개

Commitarium은 코딩 에이전트가 함께 소프트웨어를 계획, 구현, 검토할 수 있는 로컬 우선 환경을 제공합니다. 이 시스템은 프로젝트, 기능, 워크플로우 전환, 에이전트 세션을 관리하고 운영 상태를 SQLite에 저장하는 코디네이터를 중심으로 구축되었습니다. 테스트를 위한 결정론적 시뮬레이션 모드와 실제 AI 에이전트(Codex 또는 Claude)를 사용하는 선택적 모드를 모두 지원합니다. 실제 에이전트 모드에서 코디네이터는 선택된 리드 및 리뷰어 에이전트와의 지속적인 대화에 연결됩니다. 워크플로우는 목표 명확화, 계획, 구현, 검토 주기를 포함합니다. 이 시스템은 계획, 검토, 풀 리퀘스트의 진실 원천으로 자체 호스팅 Git 포지인 Forgejo와 통합됩니다. 각 에이전트는 자체 범위가 지정된 Forgejo ID로 운영되어 커밋 및 구조화된 PR 작업의 감사 추적을 보장합니다. 코디네이터는 워크플로우를 진행하기 전에 커밋 해시 및 PR 헤드와 같은 에이전트 출력을 검증합니다. 아키텍처는 일반적으로 코디네이터, Forgejo, 워커 에이전트를 위한 서비스와 함께 Docker Compose를 통해 실행됩니다. Codex 및 Claude에 대한 독립적인 공급자 프로필을 지원하여 독립적인 인증 및 구성을 가능하게 합니다. 이 시스템은 코디네이터 재시작 후 활성 세션을 재개할 수 있는 재시작 복구 기능을 포함합니다. 또한 사용자가 기존 Git 저장소를 작업 공간과 연결할 수 있는 프로젝트 가져오기 기능을 제공합니다. 설계는 자동 또는 수동 승인 옵션을 통해 사용자가 머지 및 워크플로우 단계를 제어할 수 있도록 강조합니다.