Pontifex

Quien entrega trabajo a clientes necesita documentos que describan ese trabajo: hoja de horas, informe de avance, registro de decisiones, propuesta comercial. Armarlos a mano, después del hecho, obliga a detener el trabajo para reconstruirlo. Pontifex parte del principio opuesto: el registro del trabajo ya existe en las sesiones y en los commits, y los documentos deben salir de ahí.

Pontifex es el conjunto de herramientas de operaciones e informes de la propia Sigil Labs. Es el tercero de tres conjuntos que Sigil Labs mantiene, después de una biblioteca de habilidades para agentes (superpowers) y de Hadur, la disciplina de revisión. Entrega:

• hojas de horas para cuatro públicos (cliente, gestor, interno y contabilidad), en Markdown, PDF, JSON o CSV, siendo el CSV, con valor por hora, exclusivo de contabilidad;
• informes de cliente con resumen ejecutivo y fases del proyecto, a los que las versiones de gestor y equipo interno añaden el registro de decisiones y los cambios de alcance;
• propuestas comerciales en portugués, en tres modos de trabajo (automático, asistente y esqueleto), con precio calculado por la metodología de Sigil Labs;
• un informe de calidad armado a partir de los hallazgos de Hadur, con una versión completa para el equipo y una versión de garantía para el cliente;
• informes programados, generados y guardados sin que nadie tenga que acordarse de pedirlos;
• una evaluación automática de las respuestas de IA durante la sesión, con nota de 1 a 5 y un comentario corto, que se puede desactivar en cada proyecto;
• un historial de tokens gastados por proyecto, en el que el valor medido y el valor estimado aparecen siempre identificados.

Los hooks de Claude Code graban cada sesión (cuándo empezó, qué archivos cambiaron, qué se decidió) en una bóveda de la agencia. Cada sesión pertenece a un proyecto, y el identificador de ese proyecto se declara en un registro, no se deduce del nombre de la carpeta. El motivo: si cada lado dedujera el identificador por su cuenta, bastaría una tilde de diferencia para que las horas de un proyecto nunca encontraran sus commits, y el informe saldría parcial, pero con apariencia de correcto.

Un recolector en el servidor busca los commits y los une a las horas por el mismo identificador. Cuando se creó el registro, la carpeta de trabajo de Sigil Labs tenía cerca de 40 proyectos y solo uno de ellos tenía configuración local de Pontifex; los demás perdían la telemetría sin ningún error. Los hooks nunca bloquean una sesión: si el proyecto no está en el registro, la sesión se graba de todos modos, con un identificador provisorio que el panel señala. En cambio, los informes fallan de forma explícita cuando un proyecto no consta en el registro, porque un informe armado sin el registro parecería, a primera vista, un informe correcto.

Pontifex se puede usar de cuatro maneras:

• por la línea de comandos;
• por una interfaz web, con un panel de tarjetas verdes, ámbar o rojas que indican, entre otros puntos, el estado de la sincronización, de la recolección de commits, del registro de proyectos y de la calidad de las respuestas;
• por un portal de entrega con inicio de sesión, en el que cada persona ve solo los clientes y el nivel de detalle (cliente, gestor o interno) que se le concedieron;
• por un servidor MCP con siete herramientas de informe (cinco que generan documentos, más la lista de clientes y el estado de la bóveda) y herramientas de consulta de solo lectura. Una de las consultas ejecuta SQL, mediante DuckDB, sobre las tablas de commits, sesiones, horas, tokens y proyectos, con un límite de 1000 filas y 20 segundos por consulta.

El programador de tareas del sistema operativo despierta a Pontifex cada 15 minutos, por defecto, para verificar qué informes están vencidos.

Pontifex es una herramienta interna de Sigil Labs, de código propietario, y no es un producto a la venta. Existe para que el equipo de Sigil Labs produzca horas, informes y propuestas a partir de lo que realmente ocurrió. La versión actual es la 1.0.0 y requiere Python 3.11 o superior.

Las propuestas con participación societaria o cesión de derechos con reparto de ingresos generan solo un borrador interno y no vinculante, marcado como pendiente de revisión jurídica. El documento final para el cliente depende de contratos revisados por un abogado, que quedan fuera de Pontifex.

Pontifex hereda de Hadur la metodología de revisión y lee el árbol de hallazgos que Hadur produce para armar el informe de calidad.