Skip to content

verification-ledger-template.md

Latest commit

 

History

History
76 lines (56 loc) · 3.24 KB

verification-ledger-template.md

File metadata and controls

76 lines (56 loc) · 3.24 KB
Raw

AI Coding Agent Verification Ledger Template

Use this free verification ledger when Codex, Claude Code, Cursor, or another AI coding agent claims a task is done.

The ledger forces each run to name the exact proof that makes the result trustworthy. It is useful for code edits, release work, UI changes, docs changes, and any agent run that touches a real project.

Minimal Ledger Fields

Field What To Record Example
Check Short name for the proof Build
Command Or Evidence Exact command, URL, screenshot, or review artifact npm run build
When Required Trigger condition Frontend or TypeScript changed
Pass Signal What proves the check passed Build completed with exit code 0
Fail Signal What blocks completion Compiler error or missing route
Owner Person or agent responsible Operator

Copy/Paste Markdown Table

| Check | Command Or Evidence | When Required | Pass Signal | Fail Signal | Owner |
| --- | --- | --- | --- | --- | --- |
| Build |  |  |  |  |  |
| Tests |  |  |  |  |  |
| Visual QA |  |  |  |  |  |
| Release Asset |  |  |  |  |  |

Copy/Paste CSV Header

Check,Command or Evidence,When Required,Pass Signal,Fail Signal,Owner

Public sample CSV:

https://ivelly42.github.io/agent-ops-command-center/sample/verification_ledger_sample.csv

Starter Checks

Check Command Or Evidence When Required Pass Signal Fail Signal Owner
Unit tests npm test Code behavior changed All tests pass Any failing test Operator
Type check npm run typecheck TypeScript changed No type errors Compiler error Operator
Build npm run build Release candidate Build complete Build failed Operator
Visual QA Screenshot before and after Frontend UI changed No broken layout Overlap or blank state Operator
Pages smoke `curl -fsSL URL rg "expected text"` Static site changed HTTP 200 plus expected text 404 or missing text
Release asset check gh release view TAG --json assets Release published Expected asset uploaded Asset missing or wrong file Operator
Payment gate Seller dashboard or checkout receipt Paid launch claimed Gross revenue visible No authenticated checkout Operator

Stop Rules

Do not mark an agent run complete when:

  • the check only proves a narrow part of a broad claim;
  • a local artifact exists but is not published where users can reach it;
  • a payment, payout, tax, legal, identity, or credential setup step is still missing;
  • the agent cannot show the exact command, URL, screenshot, digest, or issue that proves the result;
  • the result depends on user action that has not happened.

Full Template Pack

The paid Agent Ops Command Center pack expands this free ledger into a full Notion-ready workspace:

  • agent registry;
  • run log;
  • prompt library;
  • verification ledger;
  • cost tracker;
  • failure modes;
  • weekly operator review;
  • operating templates for run briefs, review briefs, RCA, release gates, and weekly reviews.

The full pack target price is $29. Early access requests are collected here:

https://github.com/ivelly42/agent-ops-command-center/issues/new?template=payment-ready.yml