← ClaudeAtlas

state-reconciliationlisted

Enforces Law 4 (Verify Before Reporting) of the 7 Laws of AI Agent Discipline. Pre-dispatch invariant: reconcile DB-vs-disk-vs-memory state before any unit runs, so a stale flag, missing artifact, or out-of-sync row never re-dispatches a unit that already completed or never started.
naimkatiman/continuous-improvement · ★ 6 · AI & Automation · score 75
Install: claude install-skill naimkatiman/continuous-improvement
# State Reconciliation Skill A pre-dispatch invariant. Before the verification ladder runs (or any auto-loop unit dispatches), reconcile the three state sources — DB / disk / in-memory — and surface any divergence as a blocker, not a silent re-dispatch. ## When to Use - Before Phase 1 of `verification-loop` if the project tracks runtime state outside source control (sqlite, KV, redis, `completed-units.json`, milestone JSON, lockfiles). - Before any auto-loop iteration in long-running sessions. - After a crash, pause/resume, or context compaction — the in-memory loop state is gone but DB and disk persist. - When a flag like `is_sketch`, `in_progress`, or a stale lock keeps re-firing the same unit. ## Why This Skill Exists GSD-2's [CONTEXT.md](https://github.com/gsd-build/gsd-2/blob/main/CONTEXT.md) names "State Reconciliation" as one of four runtime invariant modules. Common failure modes it catches: - **Stale flags re-dispatch completed units** — `is_sketch`, stale worker rows, stale sequence/dependency rows that no one cleared. - **Disk artifacts present, DB status lags** — `PROJECT.md` milestone registration, completion timestamps, roadmap divergence. - **Recovery helpers exist but aren't wired into dispatch** — divergence accrues silently between iterations. A verification ladder that runs against unreconciled state reports green on the wrong inputs. ## The Reconciliation Contract For every state class the project tracks, define and run before dispatch: 1. **Auth