atlas-ledger
Companion to atlas-contract. Auto-invoked by its Final Audit on caught drift; also use after Post Reviews or user requests to record a mistake. Distills drift into WHEN/DON'T/INSTEAD clauses, writes to Atlas.md after confirmation.
Profile →npx skills add sickn33/agentic-awesome-skills --skill atlas-ledger --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Atlas Ledger v2.2 Give the Atlas series a memory. ## Contents 1. [Output Language](#1-output-language) 2. [When To Run](#2-when-to-run) 3. [Distillation (the core)](#3-distillation-the-core) — Steps 1–6 4. [Atlas.md format](#4-atlasmd-format) 5. [Clause maintenance](#5-clause-maintenance-keep-the-ledger-alive-not-ossified) 6. [Integration with atlas-contract](#6-integration-with-atlas-contract-the-read-back-half) 7. [Final Principle](#7-final-principle) ## Quick reference ```text caught drift (auto handoff from Final Audit / Post Review / Phase Check / user request) → Step 1 state facts, not motive → Step 2 draft WHEN / DON'T / INSTEAD → Step 3 four gates: Actionability → Replay → Generalization → Over-reach → Step 4 first occurrence = Observation [O#]; repeat or high-severity = Clause [L#] → Step 5 propose, ATLAS_STOP, write only after user confirms → Step 6 merge-first into Atlas.md; confirmed clauses ≤ 15 ``` `atlas-contract` defends the goal **within one conversation**, but it starts from zero every time — it does not know where this project drifted before. `atlas-ledger` closes that gap: when a drift is caught, it distills the lesson into a permanent, project-local **contrac
- Contents
- Quick reference
- Core idea
- When to Use
- Step 1 — State the drift as observable facts, not motive
- Step 2 — Draft the clause: WHEN / DON'T / INSTEAD
- Step 3 — Four acceptance gates (record only if it passes ALL four)
- Step 4 — Provisional vs confirmed
- Step 5 — Propose, then write only after confirmation
- Step 6 — Write to Atlas.md, merging first
- Limitations
What does the atlas-ledger skill do?
Companion to atlas-contract. Auto-invoked by its Final Audit on caught drift; also use after Post Reviews or user requests to record a mistake. Distills drift into WHEN/DON'T/INSTEAD clauses, writes to Atlas.md after confirmation.
How do I install it?
Run `npx skills add sickn33/agentic-awesome-skills --skill atlas-ledger --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.