From 6efe655642c8c8349ee3507c9bb09a7e36ffa525 Mon Sep 17 00:00:00 2001 From: Pieter Viljoen Date: Mon, 29 Jun 2026 19:30:55 -0700 Subject: [PATCH 1/2] docs(workflow): reword diagram-intro sentence for clarity Reword "the same outcomes section 4 contracts" (a garden-path phrasing Copilot flagged) to "the same outcomes the section 4 contract specifies". Applied identically across the fleet to keep the diagram sections converged. --- WORKFLOW.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/WORKFLOW.md b/WORKFLOW.md index 7b8f59a..7c580a4 100644 --- a/WORKFLOW.md +++ b/WORKFLOW.md @@ -235,7 +235,7 @@ download URL. ### Flow diagrams Three diagrams trace the architecture above: the pull-request gate, the self-publisher, and the bot -automation. They are the same outcomes section 4 contracts, drawn from the workflow YAML; if a diagram and +automation. They are the same outcomes the section 4 contract specifies, drawn from the workflow YAML; if a diagram and a guarantee disagree, one of them is a defect. Triggers are blue, gates yellow, durable/published outputs green, and stop/skip outcomes red. From aea90d4269b07efe71919848658b132e3cd502c0 Mon Sep 17 00:00:00 2001 From: Pieter Viljoen Date: Mon, 29 Jun 2026 19:37:08 -0700 Subject: [PATCH 2/2] docs(workflow): refine diagram-intro wording (depict; add 'that') --- WORKFLOW.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/WORKFLOW.md b/WORKFLOW.md index 7c580a4..ffe3d58 100644 --- a/WORKFLOW.md +++ b/WORKFLOW.md @@ -235,7 +235,7 @@ download URL. ### Flow diagrams Three diagrams trace the architecture above: the pull-request gate, the self-publisher, and the bot -automation. They are the same outcomes the section 4 contract specifies, drawn from the workflow YAML; if a diagram and +automation. They depict the same outcomes that the section 4 contract specifies, drawn from the workflow YAML; if a diagram and a guarantee disagree, one of them is a defect. Triggers are blue, gates yellow, durable/published outputs green, and stop/skip outcomes red.