Produto
Pontifex
O Pontifex é o conjunto de ferramentas interno da Sigil Labs que transforma sessões de trabalho capturadas em folhas de horas, relatórios de cliente, registros de decisão e propostas.
- Tecnologias utilizadas
- Status
- Ferramenta interna
O problema
Quem entrega trabalho a clientes precisa de documentos que descrevam esse trabalho: folha de horas, relatório de andamento, registro de decisões, proposta comercial. Montá-los à mão, depois do fato, obriga a parar o trabalho para reconstruí-lo. O Pontifex parte do princípio oposto: o registro do trabalho já existe nas sessões e nos commits, e os documentos devem sair dele.
O que foi construído
O Pontifex é o conjunto de ferramentas de operações e relatórios da própria Sigil Labs. É o terceiro de três conjuntos que a Sigil Labs mantém, depois de uma biblioteca de habilidades para agentes (superpowers) e do Hadur, a disciplina de revisão. Ele entrega:
- folhas de horas para quatro públicos (cliente, gestor, interno e contabilidade), em Markdown, PDF, JSON ou CSV, sendo o CSV, com valor por hora, exclusivo da contabilidade;
- relatórios de cliente com resumo executivo e fases do projeto, aos quais as versões de gestor e equipe interna acrescentam o registro de decisões e as mudanças de escopo;
- propostas comerciais em português, em três modos de trabalho (automático, assistente e esqueleto), com preço calculado pela metodologia da Sigil Labs;
- um relatório de qualidade montado a partir dos achados do Hadur, com uma versão completa para a equipe e uma versão de garantia para o cliente;
- relatórios agendados, gerados e salvos sem que alguém precise lembrar de pedir;
- uma avaliação automática das respostas de IA durante a sessão, com nota de 1 a 5 e um comentário curto, que pode ser desligada em cada projeto;
- um histórico de tokens gastos por projeto, em que o valor medido e o valor estimado aparecem sempre identificados.
Como funciona
Os hooks do Claude Code gravam cada sessão (quando começou, quais arquivos mudaram, o que foi decidido) em um cofre da agência. Cada sessão pertence a um projeto, e o identificador desse projeto é declarado em um registro, não deduzido do nome da pasta. O motivo: se cada lado deduzisse o identificador por conta própria, bastaria um acento de diferença para que as horas de um projeto nunca encontrassem os commits dele, e o relatório sairia parcial, mas com aparência de correto.
Um coletor no servidor busca os commits e os liga às horas pelo mesmo identificador. Quando o registro foi criado, a pasta de trabalho da Sigil Labs tinha cerca de 40 projetos e só um deles tinha configuração local do Pontifex; os outros perdiam a telemetria sem erro algum. Os hooks nunca bloqueiam uma sessão: se o projeto não está no registro, a sessão é gravada assim mesmo, com um identificador provisório que o painel aponta. Já os relatórios falham de forma explícita quando um projeto não consta no registro, porque um relatório montado sem o registro pareceria, à primeira vista, um relatório correto.
O Pontifex pode ser usado de quatro maneiras:
- pela linha de comando;
- por uma interface web, com um painel de cartões verdes, âmbar ou vermelhos que indicam, entre outros pontos, o estado da sincronização, da coleta de commits, do registro de projetos e da qualidade das respostas;
- por um portal de entrega com login, em que cada pessoa vê apenas os clientes e o nível de detalhe (cliente, gestor ou interno) que lhe foram concedidos;
- por um servidor MCP com sete ferramentas de relatório (cinco que geram documentos, mais a lista de clientes e o estado do cofre) e ferramentas de consulta somente leitura. Uma das consultas executa SQL, via DuckDB, sobre as tabelas de commits, sessões, horas, tokens e projetos, com limite de 1.000 linhas e 20 segundos por consulta.
O agendador do sistema operacional acorda o Pontifex a cada 15 minutos, por padrão, para verificar quais relatórios estão vencidos.
Em que estágio está e para quem é
O Pontifex é uma ferramenta interna da Sigil Labs, de código proprietário, e não é um produto à venda. Ele existe para que a equipe da Sigil Labs produza horas, relatórios e propostas a partir do que realmente aconteceu. A versão atual é a 1.0.0 e requer Python 3.11 ou superior.
As propostas com participação societária ou cessão de direitos com divisão de receita geram apenas um rascunho interno e não vinculante, marcado como pendente de revisão jurídica. O documento final para o cliente depende de contratos revisados por advogado, que ficam fora do Pontifex.
Onde se conecta ao restante da Sigil Labs
O Pontifex herda do Hadur a metodologia de revisão e lê a árvore de achados que o Hadur produz para montar o relatório de qualidade.
Perguntas frequentes
O que é o Pontifex?
O Pontifex é o conjunto de ferramentas de operações e relatórios da Sigil Labs. Ele captura as sessões de trabalho e as transforma em folhas de horas, relatórios de cliente, registros de decisão e propostas comerciais em português.
O Pontifex está à venda?
Não. O Pontifex é uma ferramenta interna e de código proprietário da Sigil Labs, feita para a operação da própria empresa e sem oferta comercial.
De onde vêm os números de uma folha de horas do Pontifex?
Vêm das sessões de trabalho que os hooks do Claude Code gravam automaticamente, e não de lançamentos digitados depois. Cada projeto tem um identificador declarado em um registro, e é por ele que horas e commits do mesmo projeto se encontram.
O cliente vê detalhes técnicos das revisões de código?
Não. O relatório de qualidade para o cliente é uma versão de garantia, que informa quantas rodadas de revisão independente o trabalho teve e quantos pontos críticos foram resolvidos. Localizações de código e o detalhe de cada achado aparecem só na versão interna, da equipe.
Um assistente de IA pode consultar o Pontifex?
Pode. O Pontifex oferece um servidor MCP com sete ferramentas de relatório (cinco que geram documentos, mais a lista de clientes e o estado do cofre) e ferramentas de consulta somente leitura. As ferramentas de geração devolvem os documentos sem gravar nada no cofre da agência, onde ficam as sessões e as horas, de modo que um agente pode perguntar e gerar, mas não alterar registros.