Workflows

DocuTwin execution

DocuTwin Draft Note Review

Generate a reviewable synthetic draft note while preserving source traceability, draft-only status, and clinician authorship.

Statussynthetic-ready
Agentdocumentation-agent
Passed13
Failed0
Resultdraft_ready_for_clinician_review
Validationpass
Promotionapproved-for-synthetic-staging

Execution steps

Synthetic-only workflow sequence.

01load synthetic fixture
02validate documentation boundary
03attach source trace
04prepare draft-only note
05record Watchtower trace
06hold for clinician review

Agent workflow bound

pass: Workflow execution must map to an existing governed agent workflow.

Agent human review

pass: Mapped agent workflow must require human review before action.

Synthetic fixture bound

pass: Workflow execution must depend on a structured synthetic fixture.

Synthetic validation passes

pass: Synthetic validation must pass before workflow execution is considered ready.

Integration fixtures bound

pass: Workflow execution must name the integration fixtures it expects before live connector work.

Integration validation passes

pass: Every mapped integration fixture must pass validation.

Fixture reviews approved

pass: Expected-output fingerprints must have active change-review approval.

Quality gates declared

pass: Workflow execution must declare quality and fixture-review gates.

Watchtower trace

pass: Workflow execution must expose deterministic Watchtower trace steps.

No live connector dependency

pass: Workflow execution must remain synthetic-only and block production data ingestion.

Execution result fixture

pass: Workflow execution must have a deterministic synthetic result fixture.

Execution result trace

pass: Execution result fixture must preserve the workflow Watchtower trace.

Execution result outputs

pass: Execution result fixture must preserve every expected workflow output signal.

Result fixture

result-docutwin-draft-note-review-v1

held_for_clinician_review

01draft note
02source trace
03missing context prompts
04clinician review required
05no final signature

Result fixture bound

pass: Each staged workflow must have a deterministic result fixture.

Synthetic-only result

pass: Result fixtures must remain synthetic-only before live workflow automation.

Output signals preserved

pass: Result fixture must preserve every expected workflow output signal.

Watchtower trace preserved

pass: Result fixture must preserve every workflow Watchtower trace step.

Blocked actions preserved

pass: Result fixture must preserve every prohibited workflow action.

Human review state

pass: Result fixture must name a review state and reviewer role.

Quality evidence

pass: Result fixture must retain quality evidence before promotion.

Route inventory

pass: Result fixture must expose page and API routes.

Promotion review

approved-for-synthetic-staging

Workflow is approved for synthetic staging only; live automation remains blocked until connector, privacy, and production promotion gates are complete.

01result validation remains passing
02fixture fingerprints remain approved
03human review role remains explicit
04production connector boundary is reviewed
05privacy and security approval is recorded

Human review

licensed clinician review before documentation becomes part of the record

01signed note
02final medical record
03uncited diagnosis insertion
04autonomous documentation filing
05production data ingestion