Shaurya Singh

Engineer — agent systems, guardrails, corrections published in place.



Colophon

How this site is built, what it costs you to load it, and what it doesn’t do.

Stack

What it doesn’t do

The one design rule

Every status on this site is measured or it does not render. That is not a promise, it is a build step: the component that draws a green stamp throws an error if it isn’t handed a measurement date, and the six numbers on the homepage are read off the built site after every build, then re-read and compared. If a number drifts from the artifact, the build fails rather than publishing the stale one.

This isn’t modesty. I have watched an agent told to fully inhabit a role invent details wholesale to stay in character — every one of them fabricated, all of them plausible. The lesson generalised: immersion instructions and accuracy instructions compete, and immersion wins unless accuracy is made explicitly superior. A portfolio is an immersion instruction. So the rule isn’t written on the wall, it’s wired into the build, where it can’t be talked out of.

The design

The site is set like a printed engineer’s journal: paper first, ink serif, typewriter mono for data, and red ink as the only accent — because red ink is the colour of corrections, and publishing corrections next to the mistake is the closest thing this site has to a thesis. Where you see a red rule in the margin, something above it was wrong and was fixed in place rather than quietly rewritten.

Status chips are set as rubber stamps, slightly off-square, the way a real stamp lands. Green remains reserved for measured-alive states only. A value the site does not know is set in a deliberately soft, low-contrast grade of the display face and reads UNKNOWN in words — three signals for one state, so it survives greyscale and a screen reader as well as it survives a glance.

Type & colour

Contrast is computed from the tokens at build time, not eyeballed and not typed here by hand: light theme — body ink 14.9:1, secondary ink 5.6:1, red ink 5.7:1, measured green 5.5:1, secondary on raised 5.2:1; dark theme — body ink 14.4:1, secondary ink 6.8:1, red ink 5.4:1, measured green 6.9:1, secondary on raised 6.4:1. Every pair clears the 4.5:1 the standard asks for, in both themes, including text on raised surfaces — and if one ever doesn’t, this page never gets built.

Known debt

Naming my own debt first is a rule I apply to myself, so it lives here rather than nowhere. Reviewed on every build; each entry carries its own date.