diff --git a/docs/images/README.md b/docs/images/README.md index 346a018..551735a 100644 --- a/docs/images/README.md +++ b/docs/images/README.md @@ -10,7 +10,7 @@ Canonical art for README and GitHub social preview. | [`social-preview-master.jpg`](social-preview-master.jpg) | Full 2:1 composition before resize | ~2:1 source for GH export | | [`social-preview.jpg`](social-preview.jpg) | GitHub repo social / Open Graph | **1280×640** (2:1), under 1 MB | -`hero.jpg` is the approved cartoon master (coder in bed, Four Laws, silico-style step bubble). Social uses a matching 2:1 master so export does not crop the 16:9 hero. Keep only these three image files plus this README. +`hero.jpg` is the approved cartoon (coder in bed, the defaced Three Laws plaque, silico-style step bubble). Social uses a matching 2:1 master so export does not crop the 16:9 hero. Keep these three image files, this README, and `src/` (the editable SVG source below). ## GitHub social preview @@ -36,7 +36,12 @@ When regenerating or editing brand art: 1. **Scene:** Coder sits up in a normal home bed (wood headboard, ordinary duvet), coding on a laptop. Not a hospital bed. Robot stands on the floor beside the bed, never in it. 2. **Style:** Clean modern cartoon (thick outlines, flat colors, soft cel shading). Not photoreal, not soft “AI slop” mascot mush. -3. **Four Laws plaque** (Asimov I–III abbreviated in spirit, plus Bedside IV). Law IV must read exactly: +3. **The plaque IS the joke — construct it so the gag is unmissable.** The plaque is titled **"THE THREE LAWS / OF ROBOTICS"** (engraved, official, aged — Asimov I–III abbreviated in spirit). Then, and this is the joke: + - **"THREE" is struck out in red marker**, with **"FOUR"** scrawled above it in handwriting. + - **Law IV is a crooked, taped-on yellow sticky note** in the same handwriting — visibly an *amendment* to the canonical three, never a fourth peer entry. + - **The robot holds the uncapped red marker.** It is the culprit; the amendment is its own polite graffiti. + + Do NOT title the plaque "The Four Laws" or style Law IV like Laws I–III — that erases the joke (people read it as just a list of four). Law IV must read exactly: > IV. A robot must have good bedside manners. @@ -47,7 +52,18 @@ When regenerating or editing brand art: Other good sources: `bedside step` / `bedside ask` prompts in [silico AGENTS.md](https://github.com/tig/silico) and this repo’s surface docs (one human act, plain language). 5. **Title / tagline** on social art: **Bedside** and *Manners for agents who run tools for humans*. 6. **Mug / tiny labels:** Short exact words only (e.g. `DEBUG`). Image models garble small text; verify by reading the image back after generate/edit. -7. **Workflow:** Generate or edit with Imagine tools; verify discrete text; export social with `scripts/export_social_preview.py`; wire `hero.jpg` in the root README; leave human the GitHub Settings upload for social preview. +7. **Workflow (SVG source is canonical):** the art is authored as `src/hero.svg` — hand-editable, and text never garbles. To regenerate: + + ```bash + # hero (1280x720) + msedge --headless=new --disable-gpu --screenshot=hero.png --window-size=1280,720 file:///.../src/hero.html + # social master (2560x1280, letterboxed on the art's cream) + msedge --headless=new --disable-gpu --screenshot=social.png --window-size=2560,1280 file:///.../src/social.html + # convert to jpg (Pillow), then: + python scripts/export_social_preview.py docs/images/social-preview-master.jpg -o docs/images/social-preview.jpg + ``` + + Read the rendered images back to verify text; leave the human the GitHub **Settings → Social preview** upload. ## README usage diff --git a/docs/images/hero.jpg b/docs/images/hero.jpg index 5177df9..72a99b9 100644 Binary files a/docs/images/hero.jpg and b/docs/images/hero.jpg differ diff --git a/docs/images/social-preview-master.jpg b/docs/images/social-preview-master.jpg index 3d522b3..baace86 100644 Binary files a/docs/images/social-preview-master.jpg and b/docs/images/social-preview-master.jpg differ diff --git a/docs/images/social-preview.jpg b/docs/images/social-preview.jpg index 45278a0..2b9e67a 100644 Binary files a/docs/images/social-preview.jpg and b/docs/images/social-preview.jpg differ diff --git a/docs/images/src/hero.html b/docs/images/src/hero.html new file mode 100644 index 0000000..4162931 --- /dev/null +++ b/docs/images/src/hero.html @@ -0,0 +1,2 @@ + + diff --git a/docs/images/src/hero.svg b/docs/images/src/hero.svg new file mode 100644 index 0000000..7ebd4b3 --- /dev/null +++ b/docs/images/src/hero.svg @@ -0,0 +1,231 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + BEDSIDE + Manners for agents who run tools for humans + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + DEBUG + + + + + + + + + + + + + + THE THREE LAWS + OF ROBOTICS + + + + + + + FOUR + + + + + + + I + A robot may not injure a human, + or through inaction allow a human + to come to harm. + + + + II + A robot must obey orders from + humans, except where they conflict + with the First Law. + + + + III + A robot must protect its own + existence, unless that conflicts with + the First or Second Law. + + + + + + + IV. A robot must have + good bedside manners. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Plug a data USB + cable into the + board. + + + diff --git a/docs/images/src/social.html b/docs/images/src/social.html new file mode 100644 index 0000000..e90819b --- /dev/null +++ b/docs/images/src/social.html @@ -0,0 +1,2 @@ + +