diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index a4ff9f6..b0e3bf9 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/c6770c227ed9c7b4e3063663c014447c3b3c081e/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/a854eed90b15a57e3923ffcc4365dbc4d1ab755f/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 b65979c..e7d72ca 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
-
+
Boatstack
diff --git a/UPSTREAM.json b/UPSTREAM.json
index a5f56ff..feff5a8 100644
--- a/UPSTREAM.json
+++ b/UPSTREAM.json
@@ -12,11 +12,11 @@
},
"files": {
".gitignore": "a7079e923a776f14f1bb3a6aa0a11a133a8e1dfb35af020f327623357b7e3957",
- "CONTRIBUTING.md": "71bf34b51561d2e1af39cf8bbeaabb86dd9b20646b90858b68b2ef9e1a324542",
- "README.md": "a7a74bbf280912043c93e1e59f47866c10275520a256c59747c68d678fef0af5",
+ "CONTRIBUTING.md": "05e474b0512b03545620fe479b8f40ddb48bd328d61629048361debcfbd6ec45",
+ "README.md": "83ea436685782c5c2d2d375ceae21cb95c72a5f6608eb8187a5efc817350e081",
"assets/boatstack-journey.svg": "c1f7fe2741f5e9ca66bb3fe9b103e6364ba5acbca8b7a8054768ffd85cf325ea",
- "assets/boatstack-mark.svg": "c46e935f06fcfde3b37abfd579c1963b765b2337a0fa993f9538c9b652297e39",
- "assets/boatstack-portability.svg": "888b51cda1a72af0323a744dee89cc62f5d3f412f2a86f893db7c147f96b2f53",
+ "assets/boatstack-mark.svg": "ec96165583b15cfd446c27049d49217973f3e9b1defa5771cc08eec0c9542ce4",
+ "assets/boatstack-portability.svg": "ce648f5581d16586d25824d3a8132ef1b3d88b73329179173120129d4f74fd24",
"boatstack/SKILL.md": "2c4547c504ebac01b14fe6cbed97b5ea114b685cb9b43b68ffa053ebe0aeb0c4",
"boatstack/agents/openai.yaml": "68a30a60859556c5a26e16d184594ca243a6043d99c8cf7d66b5dd6d50a93cd1",
"boatstack/assets/templates/adr.md": "c577a3c1c1319061f61deb053597e6e853657022185fe28b8f733327e2a78565",
@@ -66,11 +66,11 @@
"docs/account-recovery-walkthrough.md": "acd3558a95f48004f18a0590670de496e1cc9f0cd1d187f924615497f57e1d6f",
"docs/benchmark-corpus-audit.md": "f2d206fe8579a514f9da82b2c96c19b343ac004be67617e1bd34f0f8e0e5e6c6",
"docs/benchmark-submission-audit.md": "9518abdd17690729c6423f87cab20418ed47b0915b5faa44b9ef975e9e9c3b79",
- "docs/evidence-engineered-coding.md": "2dfc75cc85b5250e2810bdeeffd03404e5545ab221365115c539202dbc9e8981",
+ "docs/evidence-engineered-coding.md": "1c74d9a8d222c3260e972938d475a3878ad341c5a911124954a7868af6979f29",
"docs/generated-files.md": "7b2e8c10a35aa351fb87753492ed3cadb05011002d2fd6ffeb1951c356f6b286",
"docs/getting-started.md": "9ecd9e543862e4bcf139be52de113c548708a2a5707c3c09233fd1605eda86d0",
- "docs/public-claims.json": "f51061537b76bb7f76219dd5b63b6ad88cadf84092f742ba5fec290f444f1ee9",
- "docs/public-surface.md": "43232ab36e8d62a31b2bb37b6800df77d8b4e2e22ef4779f0c7f836fb9125f14",
+ "docs/public-claims.json": "e3d228e5d78434e10ec21788c41c9451d69f3dce1f00c5a371bb40924fb18924",
+ "docs/public-surface.md": "713f7a050b5f339cf948299103ef3800417dccfecf2cc1a4166397ea6f978907",
"docs/research-and-design.md": "d65c66e323037bda5d45aacef5d48afa6bf93da55901378891d235aca3a5684f",
"docs/safety.md": "7b9b5c515d36e683767ec8d3d9d6d119ac93650b2f629d351deadd4c600ed6a6",
"docs/troubleshooting.md": "a3314d0eb97643534415f3c19f1763fd80ff6bb5e98c53b646e447e0b31c4829",
@@ -81,7 +81,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": "4bf3b716db39d0503fca784ea2c0eabd873d26d71e4569cf2ff5c175c88459db",
+ "examples/diagram-json/plan.lock.json": "97386aea5c532218552a6097dbc2075254bb618e5383b04c0872b38cd4d3c811",
"examples/diagram-json/plan.md": "3ad35cc3cbe48306e7ee401bd9e9047d25e46c8a6fe9679aa1b3f5e96ceea292",
"examples/diagram-json/questions.md": "1a0050041cac0a8d53e6ebfe04cbec4a298cdc8c50efeeb6fa15aeb663c5ec76",
"examples/diagram-json/request.md": "0808fc41c36779c404f4a3a121167da6e76cac56df526e70f9ed6d3e0d4c02ed",
@@ -92,12 +92,13 @@
"project.example.json": "d1f7aa3cff0b55ede79500bd2ca710bb99cb2ae579f0a058dc00934accf03d33",
"release-notes/2026-07-17-delivery-harness-framing.md": "6fccbe7efdb288f5eca7e824ee5e44ad6b30a34f312eb997dca6aa44c55b26cb",
"release-notes/2026-07-17-phase-scoped-delivery.md": "bfc8edd30a67daf5940ad4ceceebf81d01d62914ebeabb7073985c53f13df2ff",
- "release-notes/2026-07-17-visible-release-messages.md": "c93e8c812528a983502263e35d66c86a265d6ccba8203f393788c069b3fa6606"
+ "release-notes/2026-07-17-visible-release-messages.md": "c93e8c812528a983502263e35d66c86a265d6ccba8203f393788c069b3fa6606",
+ "release-notes/2026-07-18-stacked-bar-mark.md": "c4d5bd5fb89c280d7fba015384fd795fcb8c31ffe501078aa55a90cbcf66ba7b"
},
"generator": "operatorstack/intelligence-flow:boatstack-distribution",
"schema_version": 1,
"source": {
- "commit": "c6770c227ed9c7b4e3063663c014447c3b3c081e",
+ "commit": "a854eed90b15a57e3923ffcc4365dbc4d1ab755f",
"path": "examples/12-product-engineering-loop",
"repository": "operatorstack/intelligence-flow"
}
diff --git a/assets/boatstack-mark.svg b/assets/boatstack-mark.svg
index 6ccbd04..0b6a27e 100644
--- a/assets/boatstack-mark.svg
+++ b/assets/boatstack-mark.svg
@@ -1,9 +1,17 @@
diff --git a/assets/boatstack-portability.svg b/assets/boatstack-portability.svg
index 6adca22..0542c8e 100644
--- a/assets/boatstack-portability.svg
+++ b/assets/boatstack-portability.svg
@@ -34,9 +34,9 @@
-
+
-
+ YOUR REPOSITORYBOATSTACK
@@ -49,8 +49,8 @@
The saved state stays with the project.
-
-
+
+ WHAT LEAVES THE FLOWReviewed PR
diff --git a/docs/evidence-engineered-coding.md b/docs/evidence-engineered-coding.md
index befa557..feb2991 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 [`c6770c227ed9c7b4e3063663c014447c3b3c081e`](https://github.com/operatorstack/intelligence-flow/tree/c6770c227ed9c7b4e3063663c014447c3b3c081e/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 [`a854eed90b15a57e3923ffcc4365dbc4d1ab755f`](https://github.com/operatorstack/intelligence-flow/tree/a854eed90b15a57e3923ffcc4365dbc4d1ab755f/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 be2c08c..4be7163 100644
--- a/docs/public-claims.json
+++ b/docs/public-claims.json
@@ -1,6 +1,6 @@
{
"schema_version": 1,
- "source_commit": "c6770c227ed9c7b4e3063663c014447c3b3c081e",
+ "source_commit": "a854eed90b15a57e3923ffcc4365dbc4d1ab755f",
"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:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+ "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
},
{
"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:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+ "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
},
{
"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:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+ "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
},
{
"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:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+ "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
},
{
"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:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+ "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
},
{
"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:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+ "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
},
{
"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:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+ "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
},
{
"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:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+ "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
},
{
"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:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+ "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
},
{
"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:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+ "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
},
{
"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:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+ "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
}
]
}
diff --git a/docs/public-surface.md b/docs/public-surface.md
index 28db331..4f52a5f 100644
--- a/docs/public-surface.md
+++ b/docs/public-surface.md
@@ -31,7 +31,7 @@ Do not use “proven,” “optimal,” performance uplift, cost reduction, or s
When Huashu Design is installed, use it to review a public-surface change. The review must still satisfy this portable fallback:
-- preserve the stacked-node mark, ink `#0F172A`, and electric blue `#2563EB`;
+- preserve the stacked-bar mark (ink field with blue/cutout stack), ink `#0F172A`, and electric blue `#2563EB`;
- name the delivery-harness category before asking readers to adopt its philosophy;
- design from real Boatstack content rather than a generic AI landing-page pattern;
- use one dominant product journey and progressive disclosure;
diff --git a/examples/diagram-json/plan.lock.json b/examples/diagram-json/plan.lock.json
index d378cee..876fd09 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": "c6770c227ed9c7b4e3063663c014447c3b3c081e",
+ "source_commit": "a854eed90b15a57e3923ffcc4365dbc4d1ab755f",
"source_plan_path": "examples/diagram-json/source-plan.md",
"source_plan_sha256": "e10593ddaa7522ab80cc991d0a09399257139799e37f737794cd49d68a39985b",
"spec_path": "examples/diagram-json/spec.md",
diff --git a/release-notes/2026-07-18-stacked-bar-mark.md b/release-notes/2026-07-18-stacked-bar-mark.md
new file mode 100644
index 0000000..fc983be
--- /dev/null
+++ b/release-notes/2026-07-18-stacked-bar-mark.md
@@ -0,0 +1,3 @@
+### Boatstack adopts a stacked-bar mark
+
+The homepage logo is now a negative-space stack inside an ink field — clearer at favicon size and closer to the repository-owned delivery stack metaphor. The portability diagram also aligns the flow arrows with the model connector.