Design notes
-ish is a chat where real people talk with a cast of AI personas, voiced by one model. These notes are kept in step with the latest committed prototype, in the order the product is built: a persona → how it behaves on the floor → the chat where you meet it → the newsroom it writes for → the app around the chat → the tools and games on the table → the look → what is under the hood. One card is one page.
00 Overview
01 Persona
Live personas — the four questions
Who am I? — the Studio
What's happening in the world about me? — growth
What do I know about each user? — memory + dream
What do I want? — agenda
Do I follow their story? — threads
How do I sound? — the tone
Do I feel alive? — liveliness
May I speak first? — initiative
One mind or many? — many minds
02 FP — how each persona behaves in a room
v0 — the code decides
v1 — base directives
Jev on the floor — the decision arm
v2 — manner
The reply — what the model reads
03 Chat — where users meet personas
04 Ink 墨 — the persona newsroom
The brief line
The scope
Read with — the comments
The brew · console
The look · offline
Publishing 101
The writing track · archive
05 The app
Proven · Better · New
Omni search
Where Jev fits — speed · cost · accuracy · UX
Who can reach whom — friends, visibility, super
Seen
Notifications
The usage dashboard — the money, by step
The admin console — three tabs
Console Settings — by section
06 Tools & games
The toolbox
The toolbox UI
The toolbox harness
The kits & the cartridge
The specimen — dice
The interrogation
The words — pool, well, embed
The sim loop
07 Front end
08 Under the hood
— Shelf
Kept for provenance — frozen design specimens whose pick has shipped, and pages superseded by the ones above. Not maintained.
Specimens — explorations whose decision shipped
- Composer studies — 13 landing-composer takes; “Coral flow” shipped.
- Convene-button studies — the “arrow → 3 heads” glyph shipped.
- Wide-composer studies — the muted call-pill shipped.
- Chat-list avatar study — the plain figure + disc-blend shipped v531.
- Selection-wash colours — the long-press wash over the seat palette.
- Narrow scrollbars — the call was made; → Style Guide.
- Seen v1 mockups · rating studies — → Seen.
- Host moves — first mockups — → the toolbox.
- Call-pill morph — retired; a one-line restore.
Superseded — replaced by current pages
- The build plan · Architecture (old) — → Function map.
- Repo sync — the retired Mac-mini model. → Dev loop.
- The ship plan · Toolbox build plan · Host moves — plan — shipped; → the toolbox.
- Lifecycle audit — the verbs that had no door; → the tool lifecycle.
- Studio native plan — ported v804; → Studio.
- Floor producer (old) — → v1.
- DECIDE gate — a response gate on the frozen exp-010 study.
Ink — the writing track, September 2026
The month a persona wrote the morning, before the brief line replaced it on 09-22; the story in one page: the writing track.
- The essays — the concept: a persona writes the morning.
- The engine — extractor · writer.
- Essay specimens — the live runs.
- The quality score — the target function.
- The rendition A/B — ten pairs, old and new.
- Rendition A/B v2
- The dev pieces
- The first read — what the owner found in the box editions, 09-06.
- The upstream — what the writer reads, one piece verbatim.
- The upstream plan — six phases, three reads.
- The budget meeting — repeats, the bench, the match.
- Coverage and the pitch — span the space; two doors.
- The coverage specimen — one day, wide and shallow.
- The first box meeting — 09-09, the whole process.
- The 09-09 dropped — 14 of 20 on V4.1 Flash.
- The habits to ban
- The over-use profile — found by counting.
- The outside research — what others found about machine essays.
- The loop — the brew as a model, the majors as the loss — 09-11.
- The writing loop — write like a person first, then the persona back.
- The loop ledger — one row a loop.
- The writing gap — Ink against the human page.
- The writing process — a columnist's, ours, the one proposed.
- The writer as an agent — six skills.
- The gate design — where code judges, where a reader judges.
- The density read — six pieces, read.
- Information density — Ink against the bank.
- The model's read — the same pairs, marked by a reader.
- Algorithm A, the read — twelve blind pairs.
- Selection by the paragraph — two algorithms.
- The workbench — one skill, two pieces, every step shown.
- The workbench · dossier
- The workbench · part by part
- The workbench · the persona drives
- The workbench · the life store
- The workbench · the witness
- The workbench · the mend
- The workbench · mend, then reread
- The 09-20 read — every owner note on the first driven edition.
- What one piece cost — 12.7¢ and 6½ minutes, the essay process.