From 4510680e96db862f480557a15c947134d5c66ae6 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Fri, 17 Jul 2026 12:06:31 +0000 Subject: [PATCH] Sync Boatstack from Intelligence Flow 9a5fd09f9649 --- CONTRIBUTING.md | 2 +- README.md | 2 +- UPSTREAM.json | 14 +++---- assets/boatstack-journey.svg | 62 ++++++++++++++++++---------- docs/evidence-engineered-coding.md | 2 +- docs/public-claims.json | 10 ++--- examples/diagram-json/plan.lock.json | 2 +- 7 files changed, 56 insertions(+), 38 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 625c54d..92195a9 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/1a67b309b53d52011909a95b291151afaf575ce7/examples/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/9a5fd09f964901236c1e2708a8087f181617e9a9/examples/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. diff --git a/README.md b/README.md index ce32c57..5d75132 100644 --- a/README.md +++ b/README.md @@ -38,7 +38,7 @@ Install Boatstack in this repository from https://github.com/operatorstack/boats Install Boatstack in its own infrastructure PR and merge that PR before starting a feature. This keeps one-time repository setup out of later product diffs.

- Boatstack journey from idea through planning, approval, building, proof, review, and pull request, with failed checks returning to revision + One feature moves from idea through planning, approval, building, tests, review, and pull request; its retained plans, decisions, gaps, evidence, and code state combine with the next idea to create the next plan

## From idea to PR diff --git a/UPSTREAM.json b/UPSTREAM.json index 65f8ccd..bb66a04 100644 --- a/UPSTREAM.json +++ b/UPSTREAM.json @@ -12,9 +12,9 @@ }, "files": { ".gitignore": "a7079e923a776f14f1bb3a6aa0a11a133a8e1dfb35af020f327623357b7e3957", - "CONTRIBUTING.md": "40a302d838cf8de949bda1c3a6823725a64860d96cdaa5ab5a0020a09b91ec62", - "README.md": "1bc55b9c3cdd78c64b9d8cec11263397fb9a1a109973c7c3093465d247d3bfac", - "assets/boatstack-journey.svg": "b5f0ad554e0e1b56f0e1c4686a5341a6cc4e83c6ca2032442306f8175ff426a4", + "CONTRIBUTING.md": "8469bb0fd7d8f8af51ea8ea414d1abad6a8163427e43338b9cf8449d701ff6d0", + "README.md": "8c8a299369720a400946fdc58d3cf404b74783f90794ecde52441030b8699677", + "assets/boatstack-journey.svg": "c1f7fe2741f5e9ca66bb3fe9b103e6364ba5acbca8b7a8054768ffd85cf325ea", "assets/boatstack-mark.svg": "c46e935f06fcfde3b37abfd579c1963b765b2337a0fa993f9538c9b652297e39", "boatstack/SKILL.md": "4d80c39521763831655df0f98224769e0bf3caf535c0751ecf96c33bc33039e5", "boatstack/agents/openai.yaml": "68a30a60859556c5a26e16d184594ca243a6043d99c8cf7d66b5dd6d50a93cd1", @@ -59,10 +59,10 @@ "docs/account-recovery-walkthrough.md": "acd3558a95f48004f18a0590670de496e1cc9f0cd1d187f924615497f57e1d6f", "docs/benchmark-corpus-audit.md": "f2d206fe8579a514f9da82b2c96c19b343ac004be67617e1bd34f0f8e0e5e6c6", "docs/benchmark-submission-audit.md": "9518abdd17690729c6423f87cab20418ed47b0915b5faa44b9ef975e9e9c3b79", - "docs/evidence-engineered-coding.md": "c4ad772f06ce5e304b838a48bcba7ea88fee1d235abe2d194203071b655e846f", + "docs/evidence-engineered-coding.md": "6e02c6ff8e5f2d3f7da84b56a32038fcdb6d2dc4337bd359bdff121f138a5f11", "docs/generated-files.md": "7f4d7cddff80d794361c26962b4c89b4e525eafb53776553be966258c6d867c6", "docs/getting-started.md": "dccb5895bfbf6ac40309c6779f2a23dcdc27355e62a8a4858bb37c043e8de442", - "docs/public-claims.json": "49b7bc2bc0774e6cdb68c025edcf481f6b1298ac9c9878e8e48240d1caea3843", + "docs/public-claims.json": "93f058ee600bd3eb4a921292e6c6465b1a0fb66dae03e510f5fc9e1202dbbbd0", "docs/public-surface.md": "53d741f04b2928a6ee8c006d647a6d675a215e863412e5862cd67d48433bff76", "docs/research-and-design.md": "d65c66e323037bda5d45aacef5d48afa6bf93da55901378891d235aca3a5684f", "docs/safety.md": "7b9b5c515d36e683767ec8d3d9d6d119ac93650b2f629d351deadd4c600ed6a6", @@ -74,7 +74,7 @@ "examples/diagram-json/compiled/evidence.md": "1ba1c989ade070a8ef9a508fbd788d100d7292f2dbacbb2bce895468019f619d", "examples/diagram-json/compiled/tasks.json": "f040696f1f8bcedc4a8ed9816a61a49edbda970ec0cc3b28175ba37b73bbc896", "examples/diagram-json/compiled/test-matrix.json": "6c6895c509271e4337f3c91d9f62ee3a2b34e768e78513784cb012506a328ecf", - "examples/diagram-json/plan.lock.json": "9b2e97f0bfbf6c0c412683f17079d41641978c6e3576971b8a839ed1b8aafae6", + "examples/diagram-json/plan.lock.json": "4c0694926165d2c5458e8ec1b7d0db7cdfbd6bbf8f7eb84fdb53e6d519149e5d", "examples/diagram-json/plan.md": "3ad35cc3cbe48306e7ee401bd9e9047d25e46c8a6fe9679aa1b3f5e96ceea292", "examples/diagram-json/questions.md": "1a0050041cac0a8d53e6ebfe04cbec4a298cdc8c50efeeb6fa15aeb663c5ec76", "examples/diagram-json/request.md": "0808fc41c36779c404f4a3a121167da6e76cac56df526e70f9ed6d3e0d4c02ed", @@ -87,7 +87,7 @@ "generator": "operatorstack/intelligence-flow:boatstack-distribution", "schema_version": 1, "source": { - "commit": "1a67b309b53d52011909a95b291151afaf575ce7", + "commit": "9a5fd09f964901236c1e2708a8087f181617e9a9", "path": "examples/12-product-engineering-loop", "repository": "operatorstack/intelligence-flow" } diff --git a/assets/boatstack-journey.svg b/assets/boatstack-journey.svg index 5de1209..92a43a9 100644 --- a/assets/boatstack-journey.svg +++ b/assets/boatstack-journey.svg @@ -1,27 +1,45 @@ - - Boatstack product journey - A continuous path from idea to plan, questions, approval, build, tests, review, and pull request. Failed tests return to build, and review changes return to the plan. + + Boatstack episode handoff + A complete feature turns an idea into a pull request. Decisions, gaps, evidence, and code state are retained, then combine with the next idea to create the next plan. - - + + - - - 01Idea - 02Plan - 03Questions - 04Approve - Build05 - Tests06 - Review07 - PR08 - - a failed check returns to the change - - a changed decision returns to the plan + + One feature improves the starting point of the next + FEATURE EPISODE 1 + + + + 01Idea 1 + 02Plan 1 + 03Approve + 04Build + 05Tests + 06Review + 07PR 1 + + failed → revise + + + + + RETAINED PROJECT CONTEXT + plans · decisions · gaps · evidence · code state + The feature ends. Its useful state does not. + + FEATURE EPISODE 2 + Next idea + + + + + + Next Plan + + …the next feature starts better informed diff --git a/docs/evidence-engineered-coding.md b/docs/evidence-engineered-coding.md index 28fe9a0..210465f 100644 --- a/docs/evidence-engineered-coding.md +++ b/docs/evidence-engineered-coding.md @@ -140,6 +140,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 [`1a67b309b53d52011909a95b291151afaf575ce7`](https://github.com/operatorstack/intelligence-flow/tree/1a67b309b53d52011909a95b291151afaf575ce7/examples/12-product-engineering-loop). +The current moves were derived from the Intelligence Flow benchmark corpus and product-repository studies. The generated source commit is [`9a5fd09f964901236c1e2708a8087f181617e9a9`](https://github.com/operatorstack/intelligence-flow/tree/9a5fd09f964901236c1e2708a8087f181617e9a9/examples/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 3388abb..9892d40 100644 --- a/docs/public-claims.json +++ b/docs/public-claims.json @@ -1,6 +1,6 @@ { "schema_version": 1, - "source_commit": "1a67b309b53d52011909a95b291151afaf575ce7", + "source_commit": "9a5fd09f964901236c1e2708a8087f181617e9a9", "statuses": ["verified", "observed", "still_being_evaluated"], "claims": [ { @@ -12,7 +12,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:1a67b309b53d52011909a95b291151afaf575ce7" + "last_verified_version": "source:9a5fd09f964901236c1e2708a8087f181617e9a9" }, { "id": "validation-provenance", @@ -23,7 +23,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:1a67b309b53d52011909a95b291151afaf575ce7" + "last_verified_version": "source:9a5fd09f964901236c1e2708a8087f181617e9a9" }, { "id": "irreversible-operations", @@ -35,7 +35,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:1a67b309b53d52011909a95b291151afaf575ce7" + "last_verified_version": "source:9a5fd09f964901236c1e2708a8087f181617e9a9" }, { "id": "reviewer-ready-pr", @@ -46,7 +46,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:1a67b309b53d52011909a95b291151afaf575ce7" + "last_verified_version": "source:9a5fd09f964901236c1e2708a8087f181617e9a9" } ] } diff --git a/examples/diagram-json/plan.lock.json b/examples/diagram-json/plan.lock.json index bd9c793..0ce8965 100644 --- a/examples/diagram-json/plan.lock.json +++ b/examples/diagram-json/plan.lock.json @@ -6,7 +6,7 @@ "plan_path": "examples/diagram-json/plan.md", "plan_sha256": "3ad35cc3cbe48306e7ee401bd9e9047d25e46c8a6fe9679aa1b3f5e96ceea292", "schema_version": 1, - "source_commit": "1a67b309b53d52011909a95b291151afaf575ce7", + "source_commit": "9a5fd09f964901236c1e2708a8087f181617e9a9", "source_plan_path": "examples/diagram-json/source-plan.md", "source_plan_sha256": "e10593ddaa7522ab80cc991d0a09399257139799e37f737794cd49d68a39985b", "spec_path": "examples/diagram-json/spec.md",