Verification and Promotion Lifecycle
Principle
Section titled “Principle”Agent output is not complete when the runtime says it is done. It is complete only when required checks pass, review gates are satisfied, and approved artifacts are promoted.
Lifecycle
Section titled “Lifecycle”Runtime result -> collect artifacts/diff/logs -> run automated checks -> perform spec compliance review -> perform code/docs quality review -> perform sandbox/security review -> human approval decision -> promote selected changes -> write audit eventVerification result draft
Section titled “Verification result draft”schema_version: uh.verification-result.v0mission_id: mission-2026-05-13-docs-spinestatus: passed # passed | failed | blocked | waivedchecks: - name: docs-tree-exists type: command command: find docs -type f | sort status: passed - name: spec-compliance type: review reviewer: qa-agent status: passed notes: All required docs exist and map to handoff criteria.findings: - severity: info message: AgentFS backend remains interface-level for MVP.approvals: - gate: human-promotion status: pendingReview gates
Section titled “Review gates”- Spec compliance — does output satisfy the mission and linked issue/spec?
- Quality — is the implementation/docs clear, maintainable, and minimal?
- Verification — did required checks run and pass?
- Security/sandbox — did the runtime stay within permitted boundaries?
- Human promotion — should changes become canonical?
Promotion record draft
Section titled “Promotion record draft”schema_version: uh.promotion.v0mission_id: mission-2026-05-13-docs-spinesandbox_id: sandbox-abc123decision: promotedapproved_by: reviewerpromoted_at: 2026-05-13T00:00:00Zchanges: - docs/README.md - docs/glossary.mdaudit_event_id: audit-...Promotion policies
Section titled “Promotion policies”human-approved: default. Requires explicit human approval and a manualuh promote.auto-on-verify: a passeduh verifyinvokes promotion without a human step by design of this policy.- Any other value, including a typo, behaves as
human-approvedand does not auto-promote.
approved_by is a free-text name today. The harness requires a non-empty value but does not validate an identity.