Skip to content

Customer concept graphics: How-it-works grid, render transform, pilot journey - #954

Merged
blove merged 19 commits into
mainfrom
blove/customer-concept-graphics
Sep 2, 2026
Merged

Customer concept graphics: How-it-works grid, render transform, pilot journey#954
blove merged 19 commits into
mainfrom
blove/customer-concept-graphics

Conversation

@blove

@blove blove commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Compact diagram scale for the SVG kit (~320 viewBox, larger type ramp, 420px render cap, no scroll chrome) plus metaStyle="mono" on nodes and a tone="neutral" pill variant — all attribute-gated, so existing docs diagrams are untouched by construction.
  • Homepage "How it works" section (HomeConceptGrid): a 2×2 grid of four uniform 320×240 concept cards — Stream, Render, Ship, Approve — each with exactly one accent (the customer payoff node), neutral event pills, an honest one-sentence claim, and a "See it live" anchor into its FeatureBlock. Placed between the Architecture section and the demo, so the page reads where things sit → what happens at runtime → see it.
  • /render: RenderTransform (640×96) — the docs' real spec fragment → @threadplane/render (registry · state · handlers) → accent "your components" — under the headline "Schema on the wire, your design system on screen".
  • /pilot-to-prod: PilotJourney — Discover → roadmap → Build → working agent → Harden → handoff, every one of its 9 labels quoting the page's own copy (enforced by plan tripwires).
  • Generic DiagramSection extracted; StackDiagramSection is now a thin wrapper (verified DOM no-op on /, /langgraph, /ag-ui).
  • Communication audit (spec §5) passed row-by-row: no zero-setup, validation, durable-pause, or runtime-specific durability claims; thread durability is attributed to "a persistent backend" and locked by a test.

Test Plan

  • nx test website green (new load-bearing, mutation-tested specs for all six compositions + grid + section)
  • nx lint website 0 errors; style contracts pin the compact min/max-width overrides
  • nx build website --configuration=production green (re-run after rebase onto main)
  • Docs Playwright suite 8/8 (kit-CSS regression gate)
  • Browser-verified at desktop + 375px: grid 2×2 → 1-col, no card scroll, no page h-scroll, text-fit measured via getBBox on real fonts

🤖 Generated with Claude Code

blove and others added 19 commits September 2, 2026 08:36
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Adds compact-scale StreamConcept and RenderConcept homepage cards, plus
Task 2 carry-overs: a stronger DiagramSection test, a corrected
component-name code comment in landing.css, and a JSDoc note on why
DiagramSection is always tinted.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Row 3 content bottom is 224 (y180+h44); with the kit's 16px bottom
margin viewHeight must be 240, matching the 16px top margin. Was 232,
leaving only an 8px bottom margin.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…st slack

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…op routing

Fixes review findings on the four compact concept diagrams: the
ApproveConcept resume loop butt-ended into the pill's border instead of
dropping into its face, row 1 wasn't right-aligned with the outcome node,
and "resumes exactly there" soft-claimed checkpoint durability the
runtime-neutral card doesn't earn. ShipConcept's end nodes never named
their subject (missing eyebrow). StreamConcept accented the signals
source instead of the payoff. Pills are event labels, not payoffs, so
DiagramPill gains a neutral tone (default accent unchanged) and every
pill in the concept cards now renders neutral, leaving exactly one
accented node per card.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
… job

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…hip claim

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Add RenderTransform, a horizontal spec-to-components diagram (UI spec
-> @threadplane/render -> your components) at custom 760x96 geometry
so both real edge-break pill labels fit at docs-scale text metrics.
Wire it into a new DiagramSection on /render, distinct in copy from
the existing #schemas FeatureBlock right below it.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The 760 canvas made this the smallest-typed diagram on the site and
dropped phone rendering below the 600px legibility floor. Re-tiled at
viewWidth 640 using real getBBox() glyph-width reads (not character
estimates) so every node keeps genuine slack at this width. Also swaps
the vague headline/body for concrete mechanism copy and gives the
payoff node's meta a descriptive line instead of a negation.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…ithful copy

Rebalance margins from 16/36 to 16/14 by shortening Harden's meta to the
page's own "on-call runbook" phrase, freeing enough room for a terminal
"handoff" gate pill (grounded in the page's week-8 roadmap item, "Train
your team · handoff") so all three phase transitions get a named gate,
matching the section headline. Replace the synthesized "a production-ready
system" in the section body with the page's own "an on-call runbook".

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Correct PilotJourney's traceability JSDoc: the "handoff" pill quotes the
W8 row of the Discover block's "Roadmap draft" panel, not a Harden row.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@vercel

vercel Bot commented Sep 2, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
threadplane Ready Ready Preview Sep 2, 2026 3:42pm UTC

Request Review

@blove
blove enabled auto-merge (squash) September 2, 2026 15:37
@github-actions

github-actions Bot commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Claude finished @blove's task in 0s —— View job


I'll analyze this and get back to you.

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Automated approval: this PR received an intelligent (AI) code review. See the review comments on this PR.

@blove
blove merged commit 7788202 into main Sep 2, 2026
32 checks passed
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