# Atlas documentation audit trail

> The Atlas Docs Ledger treats a document's declared status as a claim and the codebase as reality, grading each doc as forgotten intent, orphaned, or stale.

The Atlas Docs Ledger reconciles each document against the codebase and grades it into 1 of 4 verdicts: looks shipped, forgotten intent, orphaned, or stale. It nudges you when a spec you wrote was never built, when a shipped doc points at code that no longer exists, or when documentation has drifted from what it describes. The routine pass contains no LLM calls, so it costs nothing to run. The engine ships today behind the paid tier, and Atlas Pro is not yet on sale.

## Key takeaways

- Built and running in Atlas. Included in the paid tier, which is not yet on sale.
- Grades every doc into 4 verdicts: looks shipped, forgotten intent, orphaned, or stale.
- The routine pass contains zero LLM calls. Deeper judgement is opt-in via --deep.
- Creation dates come from git history, cached so an unchanged doc is not re-read.
- It surfaces and suggests. It never rewrites a document on its own.

## Documentation that holds itself accountable

Most documentation rots quietly, in 1 of 2 directions: a spec written early is forgotten, or a shipped doc keeps describing behaviour that changed.

The Docs Ledger treats the status you declare in a document as a claim and the actual code as reality. When the two disagree, that gap becomes a verdict rather than a vague worry: a planned feature never built is forgotten intent, a doc describing deleted code is orphaned, and a shipped doc whose code has churned is stale.

## Zero tokens for the routine pass

The everyday reconcile runs with 0 LLM calls, using a 2-tier deterministic cascade.

Tier 1 is an explicit-target check: does the code this document names actually exist. Tier 2 is a convention-by-location and keyword match. Both are deterministic, so Atlas can run the check on every session without metering you. A deeper LLM judgement exists for prose-only cases, and it runs only when you ask with --deep.

## An audit trail under every file

Knowing when a document first appeared is the basis for any staleness signal, so Atlas reads it from git rather than guessing.

Creation dates come from git history for committed files, with a first-seen fallback for drafts that are not committed yet. Those dates are cached against the file's modification time, so an unchanged document is never re-read. That trail is what lets Atlas tell you how long a planned spec has been sitting unbuilt and rank what actually needs attention.

## Availability

Docs Ledger is 1 of the 8 record engines in Atlas, and it sits behind the paid tier.

The engine is built and running in the product, gated to Atlas Pro. Pro has no checkout yet, so it is not something you can buy today. Unlike most of the record engines it needs no meeting transcripts, since it reads only your docs and your code. Shipped, the automated work log, is the one record engine available free right now.

## FAQ

### Is the Atlas documentation audit trail available now?

The engine is built and running in Atlas, but it sits behind the paid tier and Atlas Pro is not yet on sale, so you cannot purchase access today.

### Where do the creation dates come from?

From git history for committed files, with a first-seen fallback for drafts that have not been committed yet. Dates are cached by file path and modification time.

### What kinds of documentation problems does it catch?

Four: docs that look shipped, planned specs never built (forgotten intent), docs whose code was deleted (orphaned), and docs that have drifted from the code they describe (stale).

### Does it use an LLM?

Not for the routine pass, which is fully deterministic and spends no tokens. A deeper LLM judgement runs only when you pass --deep.

### Will it change my files automatically?

No. It surfaces and suggests. You confirm before any document is updated.

---

Canonical HTML: https://runatlas.sh/resources/features/documentation-audit-trail
Source of truth: aeo_pages row `/resources/features/documentation-audit-trail` (segment: Platform) (this file is generated from it, never hand-edited).
Licence: Atlas is proprietary with a free core. It is not open source and there is no public source repository.
