Decision Log
Un sistema de registro de decisiones de solo añadidura para humanos y agentes de IA, con procedencia, sustitución, recuperación y acciones MCP auditadas.
Documentación
Registro de Decisiones
Haz que cada decisión sea recuperable.
Decision Log es el sistema de registro duradero para las decisiones tomadas por personas y agentes de IA. Mantiene la decisión, la justificación, el Actor, la procedencia de la fuente, el historial de sustitución y el estado actual juntos para que los equipos y las herramientas puedan recuperar qué se decidió y por qué.
Lo que registra Decision Log
Significado y procedencia de la decisión
- Decisiones inmutables con claves estables, justificación y atribución al Actor.
- Procedencia de DecisionSource y SourceContent como evidencia de respaldo.
Cambio y revisión
- Relaciones explícitas de DecisionSupersession en lugar de ediciones silenciosas de significado.
- DecisionCandidates revisables para pipelines de extracción e ingesta de IA.
Auditabilidad
- AuditEvents de solo anexión para acciones significativas y decisiones de autorización.
Decision Log se mantiene deliberadamente limitado. No es un gestor de proyectos, rastreador de tickets, wiki, producto de chat, servicio de transcripción de reuniones ni base de conocimiento genérica.
Un registro, cuatro superficies de primera clase
Superficie humana
- Aplicación web para personas que crean, revisan, sustituyen, buscan y auditan decisiones.
Superficies de agentes y desarrolladores
- API GraphQL como esquema programático canónico.
- Fachada REST OpenAPI, generada a partir del esquema GraphQL y delegada a él.
- Endpoint MCP autenticado para herramientas y recursos de agentes con permisos limitados.
- Repositorio público para desarrolladores para el SDK oficial, CLI, Agent Skills y Agent Plugin.
El CLI y el SDK públicos utilizan la misma fachada REST, capa de servicio GraphQL y modelo de autorización.
Flujo de trabajo seguro para agentes
- Recupera la Decisión actual antes de actuar.
- Inspecciona la procedencia y la cadena de sustitución cuando el motivo del cambio sea relevante.
- Envía el significado extraído o incierto como DecisionCandidate para revisión.
- Crea una nueva Decisión y una sustitución explícita cuando el significado aprobado cambie.
- Preserva el alcance de Organization y Workspace, el principio de privilegio mínimo, la atribución al Actor y el contexto de auditoría.