TechniquesPhysical sky
A sky worked out from the air itself on WebGPU (the same passes on WebGL2 where it is missing).
An agent built the storm watch from the library alone, through the store’s agent feed. This is what it asked for, in order, and what we learned from watching it.
Build the storm watch for a small harbour town on an exposed coast (fictional): a weather desk where the weather itself is the background, live, and the numbers sit over it. The bay behind everything: the sky at the hour, the sea and its waves, rain or snow, fog, the harbour's lights at night; a gale looks like a gale. Over it, panels read at a glance: the weather now, the next 24 hours as small charts, warnings with when each starts, and the harbour's state and why. A 48-hour timeline that moves the charts and the scene together. One sentence at the top that says what to expect next. What the page costs, part by part, as slices of the 16.7 ms frame. Something to see within a second, under about 1.5 MB to download, about 8 ms a frame on the reference laptop, stepping down on weaker devices; keyboard, screen reader, reduced motion and phone width.
A fresh session in an empty folder on the owner's machine. Its only way into the library was the store's agent feed (MCP), with a test licence for the whole library; it was told not to open the library's own folder. Every call it made was recorded, and that record is what this page is made from. The brief described what the page must do, never which parts to use.
From the brief to a working page: rules, a kit, searches, playbooks, every pitfall read, nine parts installed, the scene and the glue written, the checks run. About 76 KB to download and about 2 ms a frame.
Warnings first and never hidden, the cost panel lined up, sharp harbour lamps with reflections on the waves, a fuller town with closed roofs, spray and breaking seas at the gale's peak, the timeline's headers, and a shadow cut square by a scrolling column.
The library shipped fixes for four things this build found; the agent updated those parts through the server, as a customer would, and removed its own workarounds. Then the far shore, the lighthouse's lamp in its lantern, a softer reflection, and chart units moved into the captions.
The agent protocol first: how to plan, read, install and check.
A kit for this kind of build, with a tone applied.
Searched by the job, not by a name.
Each part’s card and every pitfall before using it.
A kit for this kind of build, with a tone applied.
How the parts are placed, moved and made accessible, and why.
Each part’s card and every pitfall before using it.
The module files, each marked with the licence.
Versions, licences and the checklist before calling it done.
Searched by the job, not by a name.
Versions, licences and the checklist before calling it done.
Each part’s card and every pitfall before using it.
The module files, each marked with the licence.
Versions, licences and the checklist before calling it done.
Each part’s card and every pitfall before using it.
Read but not used: GPU rain and snow with a seeded weather model.
Named by its kit but not read: Office and desktop companions, Ingest that never double-counts, Layout studio.
The glue between the parts, which the rules ask to be clean modules of its own.
Where it chose differently from the library’s defaults, and why. The person’s wishes come first; only accessibility, the licence and a layout that holds still are fixed.
With a wind under about 3 m/s and a wave height given, fft-ocean's spectrum degenerated and the sea's mesh shot across the sky at 12 ms a frame. The agent found the cause and guarded it.
fft-ocean 1.1.1 normalises each cascade against the spectrum up to its own reach, with a test from calm to gale and a new pitfall.
lit-height-fog's skyFog scaled only the light the fog adds, so clear air over a long sky distance turned the low sky black.
lit-height-fog 1.2.0: skyFog scales the sky's dimming too.
kpi-tiles could only show a change in percent, which is meaningless for °C.
kpi-tiles 1.1.0: change: 'units' reads "up 2.5 °C".
day-timeline's group names were padded, not centred, so a one-row group's name fell onto the line between rows.
day-timeline 1.1.0 centres them on their first row.
The look's panel shadow reached about 40–70 px; the app's scrolling side columns cut it into a sharp rectangle round every panel over a bright sky.
Shorter shadows in Atmos and glass, a --shadow-reach token on every look with a test, and a playbook rule: pad a scrolling box of panels by it.
rain-snow and lamp-lights are three.js parts, while the sky, ocean and fog parts the agent chose are raw WebGPU, so it wrote its own rain and lamps.
Raw WebGPU forms of both, and one stated way for scene parts to share a device, depth and a frame order.
The agent built clouds, a moon, the sea's shading on its own sky and the per-part frame meter itself.
New parts for each are on the library's list.
quiet-charts keeps a fixed left margin, so a top label with its unit ("6.2 mm/h") ran past the chart's edge.
quiet-charts 1.1.0 sizes the left margin to the widest label with its unit, adds a left option for small multiples and xAxis: false for upper strips; the agent had moved the units into the captions.
| Time | Asked | With | Answer | ms |
|---|---|---|---|---|
| 21:23:44 | server/discover | | No method server/discover. | 0 |
| 21:23:44 | initialize | {"protocolVersion":"2025-11-25"} | | 0 |
| 21:23:44 | tools/list | | {"tools":11} | 0 |
| 21:23:44 | resources/list | | | 0 |
| 21:23:54 | get_brief | {} | {"rules":"79e578f49956"} | 17 |
| 21:24:13 | get_shape | {} | {"listed":9} | 0 |
| 21:24:16 | get_shape | {"id":"dashboard"} | {"id":"dashboard","name":"Dashboard"} | 2 |
| 21:24:16 | get_shape | {"id":"compose"} | {"id":"compose"} | 2 |
| 21:24:20 | get_kit | {"purpose":"a weather desk for a harbour: a live GPU scene of the bay (sky, sea, rain and snow, fog, lights) as the back | {"shapes":["dashboard"],"kit":"dashboard","tone":"refined","parts":["appearance-theme","accessible-dialog","menu-skins","tabs-tooltips","ste | 7 |
| 21:24:51 | find_parts | {"job":"sky with sun or moon by time of day and clouds, as a full-screen background","platform":"desktop","budget":3} | {"platform":"desktop","total":131,"parts":["cloud-shadows","day-timeline","probe-lighting","compile-without-stalls","gravity-lens","physical | 50 |
| 21:24:51 | find_parts | {"job":"ocean surface with waves whose height follows a forecast, whitecaps in a gale","platform":"desktop","budget":3} | {"platform":"desktop","total":84,"parts":["heightfield-chunks","fft-ocean","material-designer","clay-sheet","water-ripples","probe-lighting" | 63 |
| 21:24:51 | find_parts | {"job":"rain and snow falling, slanted by wind, at a given rate","platform":"desktop","budget":2} | {"platform":"desktop","total":56,"parts":["rain-snow","gpu-foliage","plants-burn","lamp-lights","material-designer","water-ripples","wildfir | 106 |
| 21:24:51 | find_parts | {"job":"fog and mist that hides distance when visibility drops","platform":"desktop","budget":2} | {"platform":"desktop","total":100,"parts":["metaball-liquid","lit-height-fog","volumetric-mist","gpu-page-runtime","icons-to-3d","jelly-mark | 157 |
| 21:24:51 | find_parts | {"job":"lights at night: lighthouse beam, harbour lamps, glow points","platform":"desktop","budget":2} | {"platform":"desktop","total":103,"parts":["lamp-lights","skin-seam","light-sheets","ring-effects","phosphor-beam","tilted-dom-gpu","painted | 199 |
| 21:24:51 | find_parts | {"job":"show each frame's cost part by part as slices of the 16.7 ms frame budget, a frame meter","platform":"desktop"} | {"platform":"desktop","total":156,"parts":["compile-without-stalls","dynamic-resolution","vehicle-showcase","phosphor-beam","compute-gallery | 260 |
| 21:25:04 | get_part | {"id":"physical-sky"} | {"id":"physical-sky","licensed":true,"version":"1.1.0","pitfalls":8} | 16 |
| 21:25:04 | get_part | {"id":"fft-ocean"} | {"id":"fft-ocean","licensed":true,"version":"1.1.0","pitfalls":9} | 5 |
| 21:25:14 | get_part | {"id":"rain-snow"} | {"id":"rain-snow","licensed":true,"version":"1.0.2","pitfalls":8} | 8 |
| 21:25:14 | get_part | {"id":"lit-height-fog"} | {"id":"lit-height-fog","licensed":true,"version":"1.1.0","pitfalls":10} | 5 |
| 21:26:01 | get_recipe | {"scenario":"storm watch weather desk: a live raw-WebGPU bay scene (physical-sky, fft-ocean cascades, lit-height-fog, ow | {"kit":"dashboard","tone":"refined","steps":11,"parts":["appearance-theme","accessible-dialog","menu-skins","tabs-tooltips","steady-fields", | 70 |
| 21:26:12 | get_playbook | {"id":"performance"} | {"id":"performance","title":"Performance budgets"} | 2 |
| 21:26:12 | get_playbook | {"id":"page-shapes"} | {"id":"page-shapes","title":"Page shapes"} | 4 |
| 21:26:12 | get_playbook | {"id":"placement"} | {"id":"placement","title":"Placement and layout"} | 4 |
| 21:26:12 | get_playbook | {"id":"accessibility"} | {"id":"accessibility","title":"Accessibility baseline"} | 4 |
| 21:26:12 | get_playbook | {"id":"motion"} | {"id":"motion","title":"Motion and feel"} | 4 |
| 21:26:12 | get_playbook | {"id":"resilient-layout"} | {"id":"resilient-layout","title":"Layouts that never break"} | 4 |
| 21:26:18 | get_part | {"id":"capability-tiers"} | {"id":"capability-tiers","licensed":true,"version":"1.0.0","pitfalls":13} | 15 |
| 21:26:18 | get_part | {"id":"day-timeline"} | {"id":"day-timeline","licensed":true,"version":"1.0.2","pitfalls":6} | 4 |
| 21:26:21 | get_part | {"id":"quiet-charts"} | {"id":"quiet-charts","licensed":true,"version":"1.0.1","pitfalls":11} | 5 |
| 21:26:21 | get_part | {"id":"kpi-tiles"} | {"id":"kpi-tiles","licensed":true,"version":"1.0.1","pitfalls":8} | 4 |
| 21:26:26 | get_part | {"id":"chart-access"} | {"id":"chart-access","licensed":true,"version":"1.1.0","pitfalls":14} | 4 |
| 21:26:26 | get_part | {"id":"effects-switchboard"} | {"id":"effects-switchboard","licensed":true,"version":"1.0.1","pitfalls":10} | 5 |
| 21:26:38 | install | {"id":"atmos"} | {"id":"atmos","version":"library-3b257a0","files":8,"left":0} | 9 |
| 21:27:14 | install | {"id":"physical-sky","version":"1.1.0"} | {"id":"physical-sky","version":"1.1.0","files":5,"left":0} | 7 |
| 21:27:14 | install | {"id":"lit-height-fog","version":"1.1.0"} | {"id":"lit-height-fog","version":"1.1.0","files":5,"left":0} | 11 |
| 21:27:14 | install | {"id":"fft-ocean","version":"1.1.0"} | {"id":"fft-ocean","version":"1.1.0","files":8,"left":0} | 11 |
| 21:27:31 | install | {"id":"capability-tiers","version":"1.0.0"} | {"id":"capability-tiers","version":"1.0.0","files":4,"left":0} | 28 |
| 21:27:31 | install | {"id":"kpi-tiles","version":"1.0.1"} | {"id":"kpi-tiles","version":"1.0.1","files":5,"left":0} | 23 |
| 21:27:31 | install | {"id":"effects-switchboard","version":"1.0.1"} | {"id":"effects-switchboard","version":"1.0.1","files":7,"left":0} | 23 |
| 21:27:31 | install | {"id":"day-timeline","version":"1.0.2"} | {"id":"day-timeline","version":"1.0.2","files":5,"left":0} | 23 |
| 21:27:31 | install | {"id":"quiet-charts","version":"1.0.1"} | {"id":"quiet-charts","version":"1.0.1","files":6,"left":0} | 24 |
| 21:27:31 | install | {"id":"chart-access","version":"1.1.0"} | {"id":"chart-access","version":"1.1.0","files":11,"left":0} | 25 |
| 21:42:48 | check_look | {"look":"atmos","level":"tuned","dials":{"liveliness":30,"fidelity":70,"density":45},"overrides":{"light":{"--accent":"# | {"look":"atmos","level":"tuned","ok":true,"label":"Atmos, tuned","problems":0,"knobs":["--accent","--on-accent","--at-eyebrow","--radius","- | 18 |
| 21:53:11 | get_check | {} | {"listed":1} | 1 |
| 21:53:13 | get_check | {"id":"layout-probe"} | {"id":"layout-probe","version":"1.3.0"} | 2 |
| 22:10:33 | check | {"clipped":true,"text":"{\"evidence\":{\"layout\":[{\"check\":\"layout\",\"width\":1920,\"scheme\":\"light\",\"states\": | {"rules":"79e578f49956","catalogue":"2026-11-17T20:28:32.581Z","licensed":true,"done":false,"mustFix":1,"worthALook":1,"decisions":[{"rule": | 14 |
| 22:10:43 | check | {"clipped":true,"text":"{\"evidence\":{\"layout\":[{\"check\":\"layout\",\"width\":1920,\"states\":19,\"boxes\":690,\"mo | {"rules":"79e578f49956","catalogue":"2026-11-17T20:28:32.581Z","licensed":true,"done":true,"mustFix":0,"worthALook":0} | 3 |
| 22:10:54 | check_look | {"look":"atmos","level":"tuned","dials":{"liveliness":30,"fidelity":70,"density":45},"overrides":{"light":{"--accent":"# | {"look":"atmos","level":"tuned","ok":true,"label":"Atmos, tuned","problems":0,"knobs":["--accent","--on-accent","--at-eyebrow","--radius","- | 7 |
| 22:19:18 | find_parts | {"job":"sea spray thrown over a breakwater and breaking waves at a harbour entrance in a gale","platform":"desktop","bud | {"platform":"desktop","total":20,"parts":["fft-ocean","mech-walkers","water-ripples","noren-banners","lamp-lights","traversal"],"fits":["mec | 50 |
| 22:19:18 | find_parts | {"job":"small sharp point lights at night with a tight halo that widens in fog, and their reflection streaking across wa | {"platform":"desktop","total":143,"parts":["ring-effects","lamp-lights","card-material","earth-globe","lit-height-fog","fireworks"],"fits":[ | 53 |
| 22:19:18 | find_parts | {"job":"a small town of houses built in code with varied roofs and lit windows at night","platform":"desktop","budget":1 | {"platform":"desktop","total":92,"parts":["lamp-lights","lit-height-fog","property-panel","skin-seam","card-material"],"fits":["lamp-lights" | 95 |
| 22:37:48 | check_look | {"look":"atmos","level":"tuned","dials":{"liveliness":30,"fidelity":70,"density":45},"overrides":{"light":{"--accent":"# | {"look":"atmos","level":"tuned","ok":true,"label":"Atmos, tuned","problems":0,"knobs":["--accent","--on-accent","--at-eyebrow","--radius","- | 11 |
| 22:39:46 | check | {"clipped":true,"text":"{\"evidence\":{\"layout\":[{\"check\":\"layout\",\"width\":1920,\"states\":19,\"boxes\":675,\"mo | {"rules":"79e578f49956","catalogue":"2026-11-17T20:28:32.581Z","licensed":true,"done":true,"mustFix":0,"worthALook":0,"decisions":[{"rule":" | 11 |
| 22:49:08 | check | {"evidence":{"layout":[{"check":"layout","width":1920,"states":19,"boxes":675,"moved":[],"movedCount":0,"ok":true},{"che | {"rules":"79e578f49956","catalogue":"2026-11-17T20:28:32.581Z","licensed":true,"done":true,"mustFix":0,"worthALook":0} | 22 |
| 22:51:32 | get_part | {"id":"fft-ocean"} | {"id":"fft-ocean","licensed":true,"version":"1.1.1","pitfalls":10} | 19 |
| 22:51:37 | get_part | {"id":"lit-height-fog"} | {"id":"lit-height-fog","licensed":true,"version":"1.2.0","pitfalls":10} | 7 |
| 22:51:43 | get_part | {"id":"kpi-tiles"} | {"id":"kpi-tiles","licensed":true,"version":"1.1.0","pitfalls":8} | 6 |
| 22:51:43 | get_part | {"id":"day-timeline"} | {"id":"day-timeline","licensed":true,"version":"1.1.0","pitfalls":6} | 5 |
| 22:51:48 | install | {"id":"fft-ocean","version":"1.1.1"} | {"id":"fft-ocean","version":"1.1.1","files":8,"left":0} | 19 |
| 22:51:48 | install | {"id":"kpi-tiles","version":"1.1.0"} | {"id":"kpi-tiles","version":"1.1.0","files":5,"left":0} | 51 |
| 22:51:48 | install | {"id":"day-timeline","version":"1.1.0"} | {"id":"day-timeline","version":"1.1.0","files":5,"left":0} | 52 |
| 22:51:48 | install | {"id":"lit-height-fog","version":"1.2.0"} | {"id":"lit-height-fog","version":"1.2.0","files":5,"left":0} | 56 |
| 22:58:29 | check_look | {"look":"atmos","level":"tuned","dials":{"liveliness":30,"fidelity":70,"density":45},"overrides":{"light":{"--accent":"# | {"look":"atmos","level":"tuned","ok":true,"label":"Atmos, tuned","problems":0,"knobs":["--accent","--on-accent","--at-eyebrow","--radius","- | 18 |
| 22:58:31 | check | {} | {"rules":"79e578f49956","catalogue":"2026-11-17T22:34:51.451Z","licensed":true} | 14 |
| 23:05:17 | check | {"clipped":true,"text":"{\"evidence\":{\"layout\":[{\"check\":\"layout\",\"width\":1920,\"states\":19,\"moved\":[],\"mov | {"rules":"79e578f49956","catalogue":"2026-11-17T22:34:51.451Z","licensed":true,"done":true,"mustFix":0,"worthALook":0,"decisions":[{"rule":" | 13 |
| 23:13:45 | get_part | {"id":"quiet-charts"} | {"id":"quiet-charts","licensed":true,"version":"1.0.1","pitfalls":11} | 15 |