From 6167803491aeba47e0dc20ff2f532c2147e43cf3 Mon Sep 17 00:00:00 2001 From: "operator-stack-publisher[bot]" Date: Sat, 25 Jul 2026 15:17:36 +0000 Subject: [PATCH] Sync Boatstack from Intelligence Flow Labs @ 6117db6bccd3 --- CONTRIBUTING.md | 4 +++- UPSTREAM.json | 11 +++++---- docs/evidence-engineered-coding.md | 2 +- docs/public-claims.json | 24 +++++++++---------- labs/diagram-json/plan.lock.json | 2 +- ...ease-notes-simplified-technical-english.md | 12 ++++++++++ 6 files changed, 35 insertions(+), 20 deletions(-) create mode 100644 release-notes/2026-07-25-release-notes-simplified-technical-english.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index bce6c35..5f3e8ae 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -2,7 +2,7 @@ # Contributing -Boatstack is a generated content distribution. Propose changes to workflow semantics, templates, evidence rules, or generated presentation in [Intelligence Flow](https://github.com/operatorstack/intelligence-flow/tree/dc521a60a4a3dc03405d545ca63feaa753087b54/labs/12-product-engineering-loop). +Boatstack is a generated content distribution. Propose changes to workflow semantics, templates, evidence rules, or generated presentation in [Intelligence Flow](https://github.com/operatorstack/intelligence-flow/tree/6117db6bccd3121a1e7e132e780cd86768de17e5/labs/12-product-engineering-loop). The Boatstack repository receives product/runtime changes through a generated pull request. Review the PR's `UPSTREAM.json`, tests, adapter diff, and context-size change; do not hand-edit generated output on `main`. `.github/workflows` is the exception: it is Boatstack's executable control plane, excluded from scheduled projection and changed only through a separate manually reviewed Boatstack PR. @@ -14,4 +14,6 @@ Any user-facing upgrade must state the user problem, supporting observation or r Every Intelligence Flow change that touches the Boatstack lab must add one release-level Markdown fragment under `labs/12-product-engineering-loop/boatstack-distribution/release-notes/`. Name it `YYYY-MM-DD-.md`, begin with a level-three heading, and describe user impact rather than commits, diffs, or test commands. Fragments are append-only after merge; publish a new correction fragment instead of rewriting history. +Write each fragment in Simplified Technical English, the same standard the README follows. Keep sentences short. Use the active voice and the present tense. State one idea per sentence, put the condition first, and choose the simple, common word. Write for a reader who translates or skims the note. + Use Huashu Design for README and beginner-guide review when it is installed. The portable requirements remain in [the public-surface contract](docs/public-surface.md): plain outcomes first, one dominant product journey, progressive disclosure, accessible assets, no invented proof, and explicit separation between verified behavior and outcomes still being evaluated. diff --git a/UPSTREAM.json b/UPSTREAM.json index 4fd7145..1385bad 100644 --- a/UPSTREAM.json +++ b/UPSTREAM.json @@ -12,7 +12,7 @@ }, "files": { ".gitignore": "a7079e923a776f14f1bb3a6aa0a11a133a8e1dfb35af020f327623357b7e3957", - "CONTRIBUTING.md": "a56c0ee373be7e3491996906937cbe779092c5709c80912f171d67e6a755a12a", + "CONTRIBUTING.md": "86dc68fe44853c69905e66f1475791dda3cf0ea6902b336c2856a22b0ab50d06", "README.md": "3ce3e95e511089b44e946a44b8d5f4f81d019ece5336db65b2cab1f9dc4d4dad", "assets/boatstack-journey.svg": "e465befc50c8ce30f3e07e8fd97012931beeb053392c8fbf38ad645023b3cc63", "assets/boatstack-mark.svg": "be1f984da1bfa69fa5d1f986d8343d21f7e20921b71db888c928b4d2e54b09b5", @@ -175,10 +175,10 @@ "docs/benchmark-corpus-audit.md": "f2d206fe8579a514f9da82b2c96c19b343ac004be67617e1bd34f0f8e0e5e6c6", "docs/benchmark-submission-audit.md": "9518abdd17690729c6423f87cab20418ed47b0915b5faa44b9ef975e9e9c3b79", "docs/configuration.md": "df054f49d532c8b1b7d94184810d1b3b5bf18cdc30eb985b4b6d0639162e341a", - "docs/evidence-engineered-coding.md": "1000dd25b8f56593390aaab82e2a83d1909c3bd573c0112162aa8be3d7b9807c", + "docs/evidence-engineered-coding.md": "d01788f1c88275c17696c8206458a5a6781712bdc3876ff4955c515d65cd7217", "docs/generated-files.md": "437791765b0a4015032ae21d1a6618563cad92b7402819e4f963bf5ae16284a3", "docs/getting-started.md": "1dd4f4e2e636cc5adfc2f79939629701e171087c3d5e558cf919548b9224adfd", - "docs/public-claims.json": "5dad07bb9c9b254ea8e0e917784dbd4a0de318bf00890fbbc5f902468c78c849", + "docs/public-claims.json": "bbe63d03d7c36a90d563ab01c0a6c57add54c0b8b1d026a9c91053ed4f109bb0", "docs/public-surface.md": "713f7a050b5f339cf948299103ef3800417dccfecf2cc1a4166397ea6f978907", "docs/research-and-design.md": "8d78678108f0a6c924e1ff9b32c0f81aae9d1f779e0082843b6f99ad993ae2b6", "docs/safety.md": "7b9b5c515d36e683767ec8d3d9d6d119ac93650b2f629d351deadd4c600ed6a6", @@ -192,7 +192,7 @@ "labs/diagram-json/compiled/evidence.md": "1ba1c989ade070a8ef9a508fbd788d100d7292f2dbacbb2bce895468019f619d", "labs/diagram-json/compiled/tasks.json": "88f60851abf79d851e9fccc754ff3040034ae595306bc87d64784c19eb403e71", "labs/diagram-json/compiled/test-matrix.json": "424657ff505768e50fa113801fd8363364a18269d5297480907a993d44063a39", - "labs/diagram-json/plan.lock.json": "f1c1abc21dc10b530e05cd26055b4f329a95ea87e4552c2846c280e0aa2b2443", + "labs/diagram-json/plan.lock.json": "82e598283bcc712e0963403392a90caf3a2efb0edf93da94da12530f3e5eb3ca", "labs/diagram-json/plan.md": "3cc4f533b8d69386deff16b3a594a3ba09d4c0c3db636cccd8c4380084ce6a51", "labs/diagram-json/questions.md": "74733b015002c8a6777c558e7e997fa48c94850b9bd39054fe9366c97ecf728d", "labs/diagram-json/request.md": "0808fc41c36779c404f4a3a121167da6e76cac56df526e70f9ed6d3e0d4c02ed", @@ -289,12 +289,13 @@ "release-notes/2026-07-25-evidence-path-resolution.md": "b32cb8a6e69f397f751c3a7fb62be254a7407a28bed25ae9108d6d773c863d11", "release-notes/2026-07-25-published-slice-correction-routing.md": "129cdd62c80c8b93060726027d68ba3abdb0bca1a1ce9e64d6053271af3fd082", "release-notes/2026-07-25-readme-simplified-technical-english.md": "c362f46702c38dda6b0301d05b95a067da617d170ddfcca22fd7eb9f6e2c1881", + "release-notes/2026-07-25-release-notes-simplified-technical-english.md": "70b273cbeb5ee46c49c10541540f31e8ca67a71102acfd47ae15451856c651db", "release-notes/2026-07-25-root-cause-operation.md": "5bf1f082e9123c5a7bcc8bc01b12e97b24b5ae15958577b4ff2a358994fca891" }, "generator": "operatorstack/intelligence-flow:boatstack-distribution", "schema_version": 1, "source": { - "commit": "dc521a60a4a3dc03405d545ca63feaa753087b54", + "commit": "6117db6bccd3121a1e7e132e780cd86768de17e5", "path": "labs/12-product-engineering-loop", "repository": "operatorstack/intelligence-flow" } diff --git a/docs/evidence-engineered-coding.md b/docs/evidence-engineered-coding.md index 4efd768..30e3b03 100644 --- a/docs/evidence-engineered-coding.md +++ b/docs/evidence-engineered-coding.md @@ -146,6 +146,6 @@ Delivery and system improvement also remain separate. A failed task may suggest ## What is evidence-backed -The current moves were derived from the Intelligence Flow benchmark corpus and product-repository studies. The generated source commit is [`dc521a60a4a3dc03405d545ca63feaa753087b54`](https://github.com/operatorstack/intelligence-flow/tree/dc521a60a4a3dc03405d545ca63feaa753087b54/labs/12-product-engineering-loop). +The current moves were derived from the Intelligence Flow benchmark corpus and product-repository studies. The generated source commit is [`6117db6bccd3121a1e7e132e780cd86768de17e5`](https://github.com/operatorstack/intelligence-flow/tree/6117db6bccd3121a1e7e132e780cd86768de17e5/labs/12-product-engineering-loop). The evidence supports specific failure mechanisms and guardrails. It does not establish that Boatstack is optimal, that control-theory notation proves software quality, or that one workflow dominates every team. Those are evaluation questions, so the distribution preserves measurements, provenance, gaps, and negative results. diff --git a/docs/public-claims.json b/docs/public-claims.json index d024dfe..9512b12 100644 --- a/docs/public-claims.json +++ b/docs/public-claims.json @@ -1,6 +1,6 @@ { "schema_version": 1, - "source_commit": "dc521a60a4a3dc03405d545ca63feaa753087b54", + "source_commit": "6117db6bccd3121a1e7e132e780cd86768de17e5", "statuses": ["verified", "observed", "still_being_evaluated"], "claims": [ { @@ -12,7 +12,7 @@ "readable_evidence": "why-these-steps.md#portable-workflow-and-state", "implementation": ["../boatstack/export.go", "../boatstack/references/artifacts.md", "../boatstack/references/workflow.md"], "verification": ["../boatstack/export_test.go"], - "last_verified_version": "source:dc521a60a4a3dc03405d545ca63feaa753087b54" + "last_verified_version": "source:6117db6bccd3121a1e7e132e780cd86768de17e5" }, { "id": "human-decisions", @@ -23,7 +23,7 @@ "readable_evidence": "why-these-steps.md#human-decisions", "implementation": ["../boatstack/references/workflow.md", "../boatstack/plan.go"], "verification": ["../boatstack/plan_test.go", "../boatstack/planning_test.go"], - "last_verified_version": "source:dc521a60a4a3dc03405d545ca63feaa753087b54" + "last_verified_version": "source:6117db6bccd3121a1e7e132e780cd86768de17e5" }, { "id": "validation-provenance", @@ -34,7 +34,7 @@ "readable_evidence": "why-these-steps.md#validation-provenance", "implementation": ["validation-and-evidence.md", "../boatstack/plan.go"], "verification": ["../boatstack/plan_test.go"], - "last_verified_version": "source:dc521a60a4a3dc03405d545ca63feaa753087b54" + "last_verified_version": "source:6117db6bccd3121a1e7e132e780cd86768de17e5" }, { "id": "irreversible-operations", @@ -46,7 +46,7 @@ "readable_evidence": "why-these-steps.md#irreversible-operations", "implementation": ["safety.md", "../boatstack/safety.go", "../boatstack/hooks.go"], "verification": ["../boatstack/safety_test.go", "../boatstack/hooks_test.go"], - "last_verified_version": "source:dc521a60a4a3dc03405d545ca63feaa753087b54" + "last_verified_version": "source:6117db6bccd3121a1e7e132e780cd86768de17e5" }, { "id": "reviewer-ready-pr", @@ -57,7 +57,7 @@ "readable_evidence": "why-these-steps.md#reviewer-ready-pr", "implementation": ["../boatstack/pr.go", "getting-started.md"], "verification": ["../boatstack/pr_test.go"], - "last_verified_version": "source:dc521a60a4a3dc03405d545ca63feaa753087b54" + "last_verified_version": "source:6117db6bccd3121a1e7e132e780cd86768de17e5" }, { "id": "phase-scoped-delivery", @@ -68,7 +68,7 @@ "readable_evidence": "why-these-steps.md#phase-scoped-delivery", "implementation": ["../boatstack/delivery.go", "../boatstack/safety.go", "../boatstack/hooks.go", "../boatstack/references/workflow.md"], "verification": ["../boatstack/delivery_test.go", "../boatstack/pr_test.go"], - "last_verified_version": "source:dc521a60a4a3dc03405d545ca63feaa753087b54" + "last_verified_version": "source:6117db6bccd3121a1e7e132e780cd86768de17e5" }, { "id": "model-neutral-contract", @@ -79,7 +79,7 @@ "readable_evidence": "why-these-steps.md#model-choice-and-budget", "implementation": ["research-and-design.md", "../boatstack/references/workflow.md"], "verification": ["../boatstack/export_test.go", "../boatstack/planning_test.go"], - "last_verified_version": "source:dc521a60a4a3dc03405d545ca63feaa753087b54" + "last_verified_version": "source:6117db6bccd3121a1e7e132e780cd86768de17e5" }, { "id": "cross-model-failures", @@ -90,7 +90,7 @@ "readable_evidence": "why-these-steps.md#model-choice-and-budget", "implementation": ["research-and-design.md"], "verification": ["benchmark-corpus-audit.md", "benchmark-submission-audit.md"], - "last_verified_version": "source:dc521a60a4a3dc03405d545ca63feaa753087b54" + "last_verified_version": "source:6117db6bccd3121a1e7e132e780cd86768de17e5" }, { "id": "lower-cost-outcomes", @@ -101,7 +101,7 @@ "readable_evidence": "why-these-steps.md#model-choice-and-budget", "implementation": ["research-and-design.md"], "verification": ["benchmark-corpus-audit.md", "benchmark-submission-audit.md"], - "last_verified_version": "source:dc521a60a4a3dc03405d545ca63feaa753087b54" + "last_verified_version": "source:6117db6bccd3121a1e7e132e780cd86768de17e5" }, { "id": "git-worktree-activation", @@ -112,7 +112,7 @@ "readable_evidence": "why-these-steps.md#git-worktree-activation", "implementation": ["../boatstack/runtime_cache.go", "../boatstack/hooks.go"], "verification": ["../boatstack/runtime_cache_test.go", "../boatstack/hooks_test.go"], - "last_verified_version": "source:dc521a60a4a3dc03405d545ca63feaa753087b54" + "last_verified_version": "source:6117db6bccd3121a1e7e132e780cd86768de17e5" }, { "id": "visible-updates", @@ -123,7 +123,7 @@ "readable_evidence": "why-these-steps.md#visible-updates", "implementation": ["../boatstack/update.go", "../boatstack/init.go"], "verification": ["../boatstack/update_test.go", "../boatstack/init_test.go", "../boatstack/export_test.go"], - "last_verified_version": "source:dc521a60a4a3dc03405d545ca63feaa753087b54" + "last_verified_version": "source:6117db6bccd3121a1e7e132e780cd86768de17e5" } ] } diff --git a/labs/diagram-json/plan.lock.json b/labs/diagram-json/plan.lock.json index c798ebe..113a182 100644 --- a/labs/diagram-json/plan.lock.json +++ b/labs/diagram-json/plan.lock.json @@ -6,7 +6,7 @@ "plan_path": "labs/diagram-json/plan.md", "plan_sha256": "3cc4f533b8d69386deff16b3a594a3ba09d4c0c3db636cccd8c4380084ce6a51", "schema_version": 1, - "source_commit": "dc521a60a4a3dc03405d545ca63feaa753087b54", + "source_commit": "6117db6bccd3121a1e7e132e780cd86768de17e5", "source_plan_path": "labs/diagram-json/source-plan.md", "source_plan_sha256": "e10593ddaa7522ab80cc991d0a09399257139799e37f737794cd49d68a39985b", "spec_path": "labs/diagram-json/spec.md", diff --git a/release-notes/2026-07-25-release-notes-simplified-technical-english.md b/release-notes/2026-07-25-release-notes-simplified-technical-english.md new file mode 100644 index 0000000..d747fb2 --- /dev/null +++ b/release-notes/2026-07-25-release-notes-simplified-technical-english.md @@ -0,0 +1,12 @@ +### Release notes now use Simplified Technical English + +Contributors write each Boatstack release note by hand. The README already follows +Simplified Technical English. The release notes did not state the same rule. + +The contributor guide now requires it. Each new release-note fragment uses Simplified +Technical English: short sentences, the active voice, the present tense, one idea per +sentence, condition-first phrasing, and simple words. This keeps the notes easy to skim +and easy to translate, for both people and models. + +The rule applies to new fragments only. Published fragments stay unchanged, because the +release-note contract is append-only.