| name | xmemo-audit-progress |
| description | Audit implementation or project progress against an approved XMemo plan, checkpoint, decisions, and current evidence. Use when verifying another agent's completion report, reconciling multi-agent claims, identifying drift or blockers, or determining the exact next action. Never promote a claim to verified state without evidence. |
Audit Progress with XMemo
Measure reality against the approved baseline. Follow
baseline → claims → evidence → reconcile → verdict → checkpoint.
1. Recover the governing baseline
Use recall_context, get_project_summary, search_memory, and relevant
todo reads to recover the approved plan, criteria, decisions, last verified
checkpoint, and known blockers. Name the governing artifact or memory and flag
ambiguity before auditing.
2. Normalize progress claims
Break the report into atomic claims: changed, tested, deployed, reviewed,
documented, blocked, or deferred. Preserve source agent and artifact/version
when known, but do not treat identity as evidence.
3. Verify current evidence
Inspect available files, diffs, commits, tests, logs, deployments, or explicit
user confirmation. Classify each claim:
- verified — direct evidence satisfies the criterion;
- partial — some evidence exists, but the criterion is incomplete;
- claimed — asserted without adequate evidence;
- stale — superseded by newer state;
- conflicting — sources disagree and evidence does not resolve them;
- blocked — a named dependency prevents verification or completion.
Absence of evidence is not proof of failure. A local test is not deployment
evidence; a commit is not proof of hosted behavior.
4. Return a formal audit
Use:
- Audit scope and baseline
- Verdict —
on_track, at_risk, blocked, or not_verified
- Claim matrix — claim, status, evidence, gap
- Plan drift
- Risks and blockers
- Acceptance gaps
- Exact next action
When requested, create a durable Markdown report using
assets/progress-audit-template.md. Do not write a file for a report-only
request.
5. Reconcile XMemo from verified truth
With authorization, replace the checkpoint via update_state, complete or
update TODOs only when their conditions are met, record a milestone with
record_event, correct durable claims with update_memory, and preserve new
lessons with remember.
Never save the audit narrative as a transcript or mark completion from an
agent's confidence alone. Read
../xmemo-memory-steward/references/review-playbooks.md,
../xmemo-memory-steward/references/workflows.md, and
../xmemo-memory-steward/references/tool-routing.md for detailed contracts.
