Skip to content

design(boatstack): blueprint diagrams + value-first README - #80

Merged
bigboateng merged 1 commit into
mainfrom
design/boatstack-readme-blueprint
Jul 21, 2026
Merged

design(boatstack): blueprint diagrams + value-first README#80
bigboateng merged 1 commit into
mainfrom
design/boatstack-readme-blueprint

Conversation

@bigboateng

Copy link
Copy Markdown
Contributor

Why this change

The Boatstack distribution README is a public "product/website" artifact. This pass applies the Value-Translation method to it and gives the three diagrams a coherent technical-blueprint identity.

What changed

  • Diagrams (boatstack-{mark,portability,journey}.svg) reskinned into a blueprint system: ink-on-paper Draft in light mode, Cyanotype in dark mode via prefers-color-scheme, plus a construction grid, corner registration ticks, and a drawing title block. Geometry untouched.
  • README reframed to lead with the failure it removes (agent guesses a decision, calls work "done" on one green check, loses reasoning when tools change) → transformed state; feature bullets now end in observable value.
  • Added a speak-software release-note fragment.

Contract preserved

  • python3 -m unittest tests.test_product_loop18/18 pass
  • README 1652 words (≤1700); 11 claim markers unchanged; no forbidden words
  • All pinned strings, host tables, image order, and SVG viewBoxes/labels/arrow paths intact

Verify

cd labs/12-product-engineering-loop && python3 -m unittest tests.test_product_loop

Open the three SVGs in light and dark appearance to confirm both themes.

Reskin mark/portability/journey into a Draft(light)+Cyanotype(dark)
blueprint system (grid, registration ticks, drawing title block) via
prefers-color-scheme; viewBoxes, labels, arrow paths, and brand hexes
unchanged. Reframe the README to lead painful current state -> transformed
state and end features in observable value. Contract preserved: 18/18
product-loop tests pass, <=1700 words, 11 claim markers intact.
@bigboateng
bigboateng force-pushed the design/boatstack-readme-blueprint branch from 242b81a to 52dbdbb Compare July 21, 2026 12:00
@bigboateng
bigboateng merged commit 6413259 into main Jul 21, 2026
4 checks passed
@bigboateng
bigboateng deleted the design/boatstack-readme-blueprint branch July 21, 2026 12:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant