Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -120,7 +120,7 @@ files are committed deliberately, not by accident.
| LOGGER | `~/Logger_app` | `public/logger/`, `public/downloads/logger.apk` |
| HANGIL | `~/Hangil_app` | `public/hangil/`, `public/downloads/hangil.apk` |

Each has its own `DEPLOY.md` with the exact copy step, and its own `CLAUDE.md` that is the
Each has its own `DEPLOY.md` with the exact copy step, and its own README that is the
authority on what that app is. HANGIL's page screenshots are captured from the shipping build
by `tools/capture-hangil.mjs` and its guide's by `tools/capture-hangil-guide.mjs`, the same
way LOGGER's guide is by `tools/capture-logger.mjs`.
Expand Down
4 changes: 2 additions & 2 deletions src/components/AppCard.astro
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,8 @@
* do?". It costs one short line.
*
* And publik's meta line ends `▲ 89% · 3,887 · Download` — a rating, an install count
* and a call to action. None of those exist here and none may be invented: CLAUDE.md
* hard rule 1. What fills the same slot is the facts the frontmatter actually holds.
* and a call to action. None of those exist here and none may be invented: the site's
* rule against invented numbers. What fills the same slot is the facts the frontmatter actually holds.
*/
import Preview from './Preview.astro';
import { platformShort } from '../labels';
Expand Down
4 changes: 2 additions & 2 deletions src/components/OneTrueThing.astro
Original file line number Diff line number Diff line change
Expand Up @@ -679,7 +679,7 @@ e
rather than shipped: the earlier figure was given as 150,000 years (the accepted
benchmark was Omo Kibish at about 195,000; Herto, at about 160,000, is the
nearest thing to 150,000) and the Jebel Irhoud paper was given as 2019 (it is
Hublin et al., Nature, June 2017). CLAUDE.md hard rule 1 applies to a paragraph
Hublin et al., Nature, June 2017). The rule against invented numbers applies to a paragraph
about honest evidence more than to anywhere else on the site.

The date sits in the Jebel Irhoud sentence rather than in an opening "Until 2017"
Expand All @@ -697,7 +697,7 @@ e

ATTEMPT ONE was "Take chapter {primerChapter}, further down." That is simply
false about the page, and it was confident about it: it sent the reader hunting
for a card that is not there. CLAUDE.md hard rule 3, in the paragraph about not
for a card that is not there. That broke the check-it-on-screen rule, in the paragraph about not
overstating evidence, written without once using the UI it described.

ATTEMPT TWO made the words a control — a <label for> checking that chapter's
Expand Down
4 changes: 2 additions & 2 deletions src/components/Showcase.astro
Original file line number Diff line number Diff line change
Expand Up @@ -366,8 +366,8 @@ const swipeCss = panels
wrong in a way worth recording: cropping to the head of the capture hid the part the
caption was describing. `08-pay.png` is captioned "the month, worked out ... shown
line by line", and the top two thirds of that screen is a prompt asking for your
기본금 — so the strip showed one thing and said another, which is CLAUDE.md hard rule 3
failing quietly. A capture is shown whole here, or it is not shown. */
기본금 — so the strip showed one thing and said another, which is the check-it-on-screen
rule failing quietly. A capture is shown whole here, or it is not shown. */
/* The 390px ceiling is on the figure above, not here — a capture is never drawn
larger than it was taken at, and the caption travels with it. */
.showcase__frame {
Expand Down
4 changes: 2 additions & 2 deletions src/content.config.ts
Original file line number Diff line number Diff line change
Expand Up @@ -79,8 +79,8 @@ const apps = defineCollection({
* It exists because that aside used to be hardcoded in src/pages/apps/[slug].astro
* in LOGGER's words — "this does not match my payslip", "a wage figure that is
* quietly wrong" — and so HANGIL, a Korean study app with no payslip and no wage
* figures in it, asked its readers to report a mismatched payslip. CLAUDE.md § How
* to add an app: nothing in src/ may name an app, and copy that only makes sense
* figures in it, asked its readers to report a mismatched payslip. The rule for
* adding an app: nothing in src/ may name an app, and copy that only makes sense
* for one app is naming it.
*
* Write the body for the thing THIS app gets wrong. The heading should name the
Expand Down
4 changes: 2 additions & 2 deletions src/pages/apps/[slug].astro
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,12 @@
* publik's app page opens on the app's own screenshot blurred into the background, a
* very large name, one line of what it does, a status pill, then the screenshot beside
* a sticky rail of every way to get it. Everything after that narrows to a reading
* column. That order is right for this site too: CLAUDE.md § What this is says a
* column. That order is right for this site too: the site is built on the idea that a
* stranger asks what it is, then whether they can have it, then whether to trust it —
* and this page now answers them in that order without being told to scroll.
*
* ── What publik puts here that this page must not ──
* · `by @mann` with an avatar. CLAUDE.md § The traps: the developer's name does not go
* · `by @mann` with an avatar. The rule against a developer name: it does not go
* on app pages. Logger deliberately keeps it off the documents it produces too.
* Contact belongs on the about page, once.
* · `✓ PUBLIK VERIFIED`. There is no verifier here. A badge implying a third party
Expand Down
4 changes: 2 additions & 2 deletions src/pages/apps/[slug]/guide.astro
Original file line number Diff line number Diff line change
Expand Up @@ -13,12 +13,12 @@
* publik's fact row, which reads `Time · Steps · Cost` — **`Steps` and `Cost` are real
* here and `Time` is not.** The step count is the length of an array and the price is
* a field; how long it takes somebody is a number nobody has measured, and inventing
* it would be CLAUDE.md hard rule 1 in a place it would never be checked. Two facts,
* it would break the rule against invented numbers in a place it would never be checked. Two facts,
* not three.
*
* The other difference is the screenshots. publik's steps are text only; every step
* here carries a real capture of the running build, taken by tools/capture-logger.mjs,
* and that is the whole point of the page. See CLAUDE.md § How to add a guide — never
* and that is the whole point of the page. The rule for guides: never
* add a step for a screen you have not seen.
*/
import { getCollection } from 'astro:content';
Expand Down
4 changes: 2 additions & 2 deletions src/pages/apps/index.astro
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,8 @@
* The route is /apps/ because the detail pages are already /apps/<slug>/ and an index
* that does not share their prefix is a broken mental model. Note that the collection
* holds every KIND of work — an entry's `type` may be writing or a novel, not only an
* app — so the folder name is historical. CLAUDE.md § How the homepage groups things
* records that renaming the lot to /works/ would be tidier and has not been asked for;
* app — so the folder name is historical. Renaming the lot to /works/ would be tidier
* and has not been asked for;
* if it ever is, this file moves with the rest.
*
* Nothing here is hardcoded to an app. Adding one is still adding one file in /apps.
Expand Down
6 changes: 3 additions & 3 deletions src/pages/index.astro
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@
* larger type is not answering a question, it is filling space.
*
* So the hero answers "what is this" and hands the reader one door. The other two
* questions CLAUDE.md says the site exists to answer — what this person makes, and
* questions the site exists to answer — what this person makes, and
* whether to trust it — are answered by the pages behind that door and by /about,
* which is the second link in the nav.
*
Expand Down Expand Up @@ -62,8 +62,8 @@ const heroScreens = apps
// The platform facts are not lost: every app page still carries them in its own rail and
// its platform notes, which is where a reader deciding whether to install something
// actually looks. If a pill ever comes back here, it is built from the content the way
// this one was, and it holds a fact you can check — never a figure. CLAUDE.md hard rule
// 1, and DESIGN.md names the reference's `>90% system performance` pill row as the
// this one was, and it holds a fact you can check — never a figure. That is the rule
// against invented numbers, and DESIGN.md names the reference's `>90% system performance` pill row as the
// specific thing not to copy.
//
// The `.pill` styles stay in global.css. They are not orphaned: apps/[slug].astro uses
Expand Down
2 changes: 1 addition & 1 deletion src/styles/global.css
Original file line number Diff line number Diff line change
Expand Up @@ -637,7 +637,7 @@ html.has-mouse [data-glow]:hover::after { opacity: 1; }
only one.

Do NOT turn this into a row of them carrying figures. The reference's pill row reads
`>90% system performance`, and CLAUDE.md hard rule 1 exists to keep that off this
`>90% system performance`, and the rule against invented numbers keeps that off this
site. A pill holds a fact you can check, or it holds nothing. */
.pill {
display: inline-flex;
Expand Down
Loading