---
title: Decision Log
description: The durable system of record for decisions made by people and AI agents.
canonical: https://www.decisionlog.ai/
last-updated: 2026-08-23
---
# Decision Log

Make every decision retrievable.

Decision Log is the durable system of record for decisions made by people and AI agents. It keeps the decision, rationale, Actor, source provenance, supersession history, and current status together so teams and tools can recover what was decided and why.

## What Decision Log records

### Decision meaning and provenance

- Immutable Decisions with stable keys, rationale, and Actor attribution.
- DecisionSource and SourceContent provenance for supporting evidence.

### Change and review

- Explicit DecisionSupersession relationships instead of silent meaning edits.
- Reviewable DecisionCandidates for AI extraction and ingestion pipelines.

### Auditability

- Append-only AuditEvents for meaningful actions and authorization decisions.

Decision Log stays deliberately narrow. It is not a project manager, ticket tracker, wiki, chat product, meeting transcription service, or generic knowledge base.

## One record, four first-class surfaces

### Human surface

- [Web application](https://www.decisionlog.ai/sign-in) for people who create, review, supersede, search, and audit decisions.

### Agent and developer surfaces

- [GraphQL API](https://www.decisionlog.ai/api/graphql) as the canonical programmatic schema.
- [OpenAPI REST facade](https://www.decisionlog.ai/openapi.json), generated from and delegated to the GraphQL schema.
- [Authenticated MCP endpoint](https://www.decisionlog.ai/api/mcp) for permission-scoped agent tools and resources.
- [Public developer repository](https://github.com/burn2delete/decisionlog-developer) for the official SDK, CLI, Agent Skills, and Agent Plugin.

The public CLI and SDK use the same REST façade, GraphQL service layer, and authorization model.

## Safe agent workflow

1. Retrieve the current Decision before acting.
2. Inspect provenance and the supersession chain when the reason for change matters.
3. Submit extracted or uncertain meaning as a DecisionCandidate for review.
4. Create a new Decision and explicit supersession when approved meaning changes.
5. Preserve Organization and Workspace scope, least privilege, Actor attribution, and audit context.

## Start here

- [Documentation](https://www.decisionlog.ai/docs)
- [Pricing](https://www.decisionlog.ai/pricing.md)
- [Agent instructions](https://www.decisionlog.ai/llms.txt)
- [Authentication walkthrough](https://www.decisionlog.ai/auth.md)
- [RFC 9727 API catalog](https://www.decisionlog.ai/.well-known/api-catalog)
- [Agent Skills index](https://www.decisionlog.ai/.well-known/agent-skills/index.json)
- [Official SDK, CLI, skills, and plugin](https://github.com/burn2delete/decisionlog-developer)