Skip to content

Add human-in-the-loop governance workflow tutorial - #118

Merged
cdcavell merged 5 commits into
mainfrom
issue_work
Aug 21, 2026
Merged

Add human-in-the-loop governance workflow tutorial#118
cdcavell merged 5 commits into
mainfrom
issue_work

Conversation

@cdcavell

Copy link
Copy Markdown
Contributor

Summary

Adds the Milestone 8 learning material for human-in-the-loop governance workflows.

This change introduces a new governance tutorial that explains how consequential workflows can pause for human review without turning a generic approval action into a bypass around policy or host-owned execution.

The tutorial covers:

  • Human review as an explicit pending governance state.
  • Separation between acknowledgment, approval, authorization, governance decisions, override authority, and execution authority.
  • Reviewer identity, eligibility, role, and scope.
  • Separation of requester and approver where required.
  • Multi-reviewer, quorum, and dual-control concepts.
  • Binding human dispositions to an exact proposed intent.
  • Request modification and supersession during review.
  • Policy-compliant approval versus explicit override.
  • Non-overridable policy outcomes.
  • Delegated review and reviewer unavailability.
  • Review timeout, cancellation, withdrawal, and reject/resubmit workflows.
  • Policy drift and context drift during the review window.
  • Revalidation before execution.
  • Least-privilege authority after approval.
  • Reviewer rationale, reason codes, decision provenance, and audit residue.
  • Race conditions and lifecycle state transitions.
  • Decision-table and invariant testing for pending, rejected, expired, stale, and revalidated workflows.
  • Human review in risk-based and AI-assisted execution paths.
  • Cases where a simpler confirmation or ordinary authorization model remains preferable.

The change also:

The core architectural boundary remains:

Human participation is another governed boundary, not an escape hatch around governance.

A valid human approval can satisfy a review requirement, but current policy and context must still be revalidated before narrowly scoped host-owned execution proceeds.

Closes#113

@cdcavell
cdcavell merged commit 594ae82 into mainAug 21, 2026
3 checks passed
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Learning]: Add human-in-the-loop governance workflow tutorial

1 participant

@cdcavell