Add the licensed Joke Shop reference board

docs/screens/refs/joke-shop/README.md

@@ -0,0 +1,26 @@
+# Joke Shop / Sunset Strip reference board
+
+Licensed photographs of the real Comedy Store block at 8433 Sunset Boulevard, used as evidence for
+the game's second venue: the low black hall, the deep signature canopy, the circular blade sign, the
+red curtain bays and the dry hillside that rises directly behind the roofline.
+
+Development reference only; not shipped with the game. Provenance and licences are in
+[`SIDECAR.md`](SIDECAR.md). Folder rules: [`../README.md`](../README.md). Generated art-direction
+frames: [`../../concepts/joke_shop/`](../../concepts/joke_shop/README.md).
+
+| Photo | What it is evidence for |
+| --- | --- |
+| ![The Comedy Store from across Sunset, hillside and houses behind the roof](comedy-store-hillside-canopy-day-pd-2006-12-29.jpg) | **Block and hillside.** The hall's height against the boulevard, the canopy depth from the street, and the dry slope with houses and palms rising behind the roofline. |
+| ![The Comedy Store frontage with palms and the wall sign](comedy-store-frontage-palms-day-pd-2006-12-29.jpg) | **Frontage rhythm.** Blade sign height and diameter, the flat black wall, palm placement, kerb setback and where the entrance sits in the run. |
+| ![Canopy fascia covered in white signatures with red curtains below](comedy-store-signature-band-day-wikimedia-2020-04-09.jpg) | **Canopy and curtain detail.** Signature density on the fascia, the white band width, the red curtain bays and the warm interior spill at dusk. |
+
+## Gaps to fill
+
+- A night photograph of the canopy, blade sign and red curtain wash (the current night evidence is
+  the generated concept frame and the game capture).
+- A closer view of the entrance recess and door hardware.
+- An across-street frame showing the neighbouring frontages on the south side of Sunset.
+- A hillside detail showing the house rooflines above the club.
+
+Add new files with the naming convention in [`../README.md`](../README.md) and list them in the
+sidecar in the same commit.

docs/screens/refs/joke-shop/SIDECAR.md

@@ -0,0 +1,60 @@
+# Sidecar — The Comedy Store block, 8433 Sunset Blvd
+
+| Field | Value |
+| --- | --- |
+| Venue / block | The Comedy Store (game: The Joke Shop), Sunset Boulevard, West Hollywood |
+| Folder | `docs/screens/refs/joke-shop/` |
+| Collected by | project (agent session, 2026-11-03) |
+| Date range | 2006–2020 (original captures); downloaded 2026-11-03 |
+| Intended use | venue three-up board, canopy/frontage proportions, hillside silhouette |
+| Shipped? | no — development reference only; not bundled with the game or releases |
+
+## Photographs
+
+| File | Subject | View | Source | Author | Licence | Captured | Purpose | Shipped |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| `comedy-store-hillside-canopy-day-pd-2006-12-29.jpg` | Comedy Store and the hillside behind it | day, across Sunset | <https://commons.wikimedia.org/wiki/File:ComedyStore_01.jpg> | Gary Minnaert | Public domain | 2006-12-29 | street wall height, canopy depth, hillside houses and palms | no |
+| `comedy-store-frontage-palms-day-pd-2006-12-29.jpg` | Frontage with palms and the wall sign | day, straight on | <https://commons.wikimedia.org/wiki/File:ComedyStore_02.jpg> | Gary Minnaert | Public domain | 2006-12-29 | blade sign size/height, wall length, palm rhythm, entrance position | no |
+| `comedy-store-signature-band-day-wikimedia-2020-04-09.jpg` | Canopy signatures and red curtains | day, three-quarter | <https://commons.wikimedia.org/wiki/File:The_Comedy_Store_West_Hollywood_(51017780551).jpg> | Tony Mariotti (Los Angeles; [rubyhome.com](https://www.rubyhome.com/)) | CC BY 2.0 | 2020-04-09 | signature density, fascia band width, curtain bays, interior spill | no |
+
+Licence text: [CC BY 2.0](https://creativecommons.org/licenses/by/2.0/). The CC BY file is also
+credited in [`../../../CREDITS.md`](../../../CREDITS.md) under "Development-only reference images".
+
+Not used: `File:The Comedy Store.jpg` (CC BY-SA 3.0) from the map document's original link list.
+The two public-domain frames above cover the same evidence, so the share-alike review was not
+needed for this board.
+
+## Redactions and permissions
+
+- No identifiable faces, licence plates or interiors in the committed crops; the plate area of the
+  parked car in the first photo is already unreadable at this resolution.
+- Exterior public frontage only. The interior signature wall photo found in the Commons search was
+  **not** downloaded or committed.
+
+## What was derived from this set
+
+| Decision | Evidence | Where it landed |
+| --- | --- | --- |
+| 27 m frontage, 8.4 m street wall, 12.2 m OSM height | frontage photo measured against the door width | `docs/joke-shop-map.md`, `WorldBuilder` `comedy_store` spec |
+| 4.9 m sloped canopy with a signature fascia | block and canopy photos | canopy slab geometry and the `Label3D` signature bands |
+| 3.9 m circular blade sign on a roof pole | frontage photo | blade sign mesh and its night emissive |
+| Hillside houses and palms above the roofline | block photo | `SunsetHillside` backdrop geometry |
+| Red curtain bays between entrance and east end | signature-band photo | curtain bays and the entrance curtain |
+
+## Generated boards used with this set
+
+Generated frames are kept in [`../../concepts/joke_shop/`](../../concepts/joke_shop/README.md) and
+are used for palette and night mood only; shape follows the photographs.
+
+| Board | Path | Model | Generated | Spend |
+| --- | --- | --- | --- | --- |
+| Joke Shop entrance, day | `docs/screens/concepts/joke_shop/joke_shop_entrance_day.png` | `openai/gpt-5-image-mini` | 2026-11-02 | ~$0.01 |
+| Joke Shop entrance, night | `docs/screens/concepts/joke_shop/joke_shop_entrance_night.png` | `openai/gpt-5-image-mini` | 2026-11-02 | ~$0.01 |
+| Joke Shop across the street | `docs/screens/concepts/joke_shop/joke_shop_across_street.png` | `openai/gpt-5-image-mini` | 2026-11-02 | ~$0.01 |
+
+## Notes
+
+- Images re-encoded as JPEG q85 with EXIF removed (no GPS or camera metadata committed); the
+  untouched downloads stay outside the repository.
+- `File:The Comedy Store West Hollywood (51017780551).jpg` asks for a dofollow attribution link;
+  the link is included above and in `CREDITS.md`.