commitarium

Commitarium fornece um ambiente local-first para orquestrar agentes de codificação que planejam, implementam e revisam software juntos. O sistema é construído em torno de um coordenador que gerencia projetos, recursos, transições de fluxo de trabalho e sessões de agentes, armazenando o estado operacional no SQLite. Ele suporta um modo de simulação determinístico para testes e um modo opt-in usando agentes de IA reais (Codex ou Claude). No modo de agente real, o coordenador se conecta a conversas persistentes com os agentes líderes e revisores selecionados. O fluxo de trabalho envolve esclarecimento de metas, planejamento, implementação e ciclos de revisão. O sistema se integra ao Forgejo, uma forja Git auto-hospedada, para servir como a fonte de verdade para planos, revisões e pull requests. Cada agente opera com sua própria identidade Forgejo com escopo, garantindo uma trilha de auditoria de commits e trabalho estruturado de PR. O coordenador verifica as saídas dos agentes, como hashes de commit e cabeças de PR, antes de avançar o fluxo de trabalho. A arquitetura geralmente é executada via Docker Compose com serviços para o coordenador, Forgejo e agentes de trabalho. Ela suporta perfis de provedor isolados para Codex e Claude, permitindo autenticação e configuração independentes. O sistema inclui recursos para recuperação de reinício, onde sessões ativas podem ser retomadas após uma reinicialização do coordenador. Ele também oferece recursos de importação de projetos, permitindo que os usuários associem repositórios Git existentes ao espaço de trabalho. O design enfatiza o controle do usuário, com opções para aprovação automática ou manual de mesclagens e etapas do fluxo de trabalho.