1 min read
Automation Proof Contract
A scheduled thread is not a completed automation until it leaves output, state, log, and any promoted wiki changes behind.
Schedulers can create activity without durable memory. The proof contract prevents that. A run matters only when future agents can inspect what happened and when freshness can see the result. Source: Scheduling Operating Model; automations/_schema.md
Required Artifacts
| Artifact | Purpose |
|---|---|
outputs/<date>/<slug>/<agent>.md |
Ephemeral evidence, findings, blockers, and no-op decision. |
| Wiki targets | Durable knowledge only when promotion criteria pass. |
state.json |
Machine-readable freshness and sync state. |
wiki/log.md |
Human operation ledger. |
| Generated surfaces | Search, backlinks, packs, registries, and qmd updated when durable files changed. |
Completion Checklist
- Read the canonical automation markdown.
- Gather only permitted sources.
- Write the output artifact before or alongside durable edits.
- Decide promotion vs no durable update.
- Update the correct
state.jsonkeys. - Append
wiki/log.md. - Rebuild index/qmd and run targeted checks when pages, skills, routing, or config changed.
State Discipline
For sub-daily jobs, use ISO timestamps. Date-only values hide hour-level drift. For integration syncs, update syncs.* only after successful collection. A blocker report may update automations.<slug>, but it must not pretend the external source synced.
Timeline
- 2026-07-01 | Created as the explicit durable proof contract for scheduled automation runs. Source: User request, 2026-07-01; automations/_schema.md; scheduling-operating-model
Related Pages
13 pages link here
Automation OverdueHEARTBEATAutomation ReadinessMetaAutomation SchemaMetaCursor Automations SetupMetaDaily CadenceHEARTBEATLLM Wiki Agent HarnessArchitectureOperational HeartbeatHEARTBEATOperational Heartbeat HubHEARTBEATScheduling Operating ModelMetaSession Startup ProtocolMetaState JSON ContractAgent DocsWeekly CadenceHEARTBEATWorkflow Run ContractWorkflows