The Build

How this site was built, honestly.

The strongest evidence for an operating system is watching it operate. This site was scoped, designed, governed and built by the same system it describes, using the same discipline it preaches.

A wireframe blueprint of page skeletons on a dark drafting field, half rendered and half amber wireframe

The honest caveat, first. The subject and the builder are the same person, so an account written by the builder will read favourably. What matters more than this narrative is the checkable evidence behind it: the decision records, the registers, the logs, and the site you are reading.

The argument

A personal AI operating system, five plugins and thirty-one skills with a knowledge layer and a standards-graded assessment, was turned into a public website. The build ran a real software-delivery method end to end: an interview produced confirmed requirements, an architecture step produced the system shape and its decisions, an experience step produced the design brief and was re-run every time the design changed, and a standing quality gate guards the finish. Around that sat a thinking layer: a decision tool for the hard calls, a fact-checker as the standing verifier, and a calibration habit applied to the project's own health.

Four disciplines held throughout, and they are the actual story. Every consequential step was played back and confirmed before anything was built, usually as a concrete choice or a visual mockup rather than a wall of prose. The content lived in one source document, maintained continuously, with a versioned corpus and two registers so any fresh session could find what was current. Because the site is public, a banned-identifier register drives every word into a sanitised twin, and a mechanical gate fails any build that still contains a flagged term. And the logs, a changelog, an audit log, a task list and a status file, were kept current as the work happened, not written up afterwards.

The result is not what it started as, and the changes are the interesting part.

The evolution

offlinesingle fileone publicsitesanitisationthe gateaudiencespectrumone decisionper screenevidence-gradeddesignnamed onthe profilelive on itsown domain

It began as an offline, emailable single file. Then it became a public site on its own domain, which collapsed the two-deliverable idea into one and made sanitisation the gate for everything; the offline original was retired and frozen rather than maintained in parallel.

The audience widened from "technical readers" to a spectrum, from a chief executive sizing up the person in thirty seconds to an engineer wanting atomic detail. That forced a structural answer: one person-led narrative with optional guided journeys, not separate audience doors, which are a documented anti-pattern. The landing was rebuilt twice; the first version was too busy, with about ten competing choices for a reader who had thirty seconds, and the fix was one decision per screen. An evidence-graded design playbook, supplied and separately fact-checked, sharpened it further: lead with proof placed high, because attention concentrates above the fold and a technical audience judges on verifiable substance, and treat performance and accessibility as acceptance criteria rather than aspirations.

The deep content was split into chapters, and a genuinely new pillar appeared: how the whole system is actually used to decide, verify, calibrate and specify, rather than only what it can do. The owner then chose to be named on the profile page, a scoped relaxation of an otherwise strict anonymisation rule, and the profile was rebuilt from a story into something a recruiter could act on, on one rule: claim the function, never the adjective, and let the assessed system, gaps and all, carry the praise.

The method, and the honest moments

The clearest piece of reasoning was a "no"

the stackquestionthe fashionable answera component framework, looks modernslower first painta fragile dependency chainthree standing decisions brokenthe evidence answerhand-built, finished to the style specloads instantly, breaks nothing

A question about reaching for a modern component framework produced the sharpest moment in the project. The fashionable answer, a React component kit, was declined on the evidence: it would cost load speed and resilience for nothing a visitor sees, and it broke three standing decisions. The site stayed hand-built, finished to the style spec, with a static-site generator named as the only sanctioned future migration if maintenance ever hurt. Making it feel modern was finishing it, the diagrams drawing themselves and the workflow chains lighting node by node, not switching stacks. The system challenging its owner rather than serving him is the whole point.

The honest moments

A journal that only records wins is a brochure. The content source was once found truncated mid-document by a background file sync landing in the middle of an edit; the build halted, the loss was scoped, the file was repaired, and the incident became a standing habit, verify a large file still ends where it should after a batch of edits. The same failure returned days later on two page writes, one of them dropping layout rules that would have broken the page on a phone, and the standing check caught both before sign-off. The navigation for the deep section took three tries, because the first two honestly were not good enough and the owner said so; the right answer only arrived by building the wrong ones and reacting to them.

The engineering deep-dives

Each is a real problem with a real, checkable resolution. Open the ones you care about; skip the rest.

Backing the estate up, around a restriction not through itfind the one atomic operation
per-file writes, racinghead movesover 150 silent failuresblobs, one tree, one commitone atomic commit, idempotent re-run

The assessment against published guidance names "no true version control" as the system's headline gap: the canonical sources relied on manual change logs, and git is blocked on the work machine, so the obvious fix was unavailable rather than merely unadopted. The skills estate is now backed up to a private repository, pushed daily over a REST API so it needs no command-line git on either machine, which gives a real, diffable, immutable commit history.

Getting there took three rewrites. The first used a one-write-per-file API: parallelised across workers it looked fast, but each worker commits against a head that a previous worker has already moved, so with twelve workers and a few hundred files it produced over a hundred and fifty silent failures, all hidden under an earlier bug that counted any response as success. Fixing the status-code bug was the useful moment, because it made the failures visible. The third version used the API built for batch work: create every file as an immutable content blob in parallel with no shared state to race over, build one tree, create one commit, move the branch in a single update. A few hundred files land as exactly one commit in about thirty seconds, and the immediate re-run reports nothing changed, which is the idempotency proof a sync tool needs. The reusable line: for batch writes to anything that tracks history, find the API that accepts a single atomic operation, not the one that looks simpler but commits state incrementally.

A script that ran cleanly and did nothingverify long scripts in the shell
ran cleanlydid nothingthe standing check: verify line count and last lines before you run

The second rewrite of that sync was written by a file tool that silently truncated it at a few thousand characters, leaving a script that ran, exited cleanly, and did nothing. The lesson banked, and now standing: any script of real length that will be run from a shell is written complete through the shell and verified there, by line count and last lines, before it is run.

The hero: let the model do the in-between, code the landingcode the exact landing
photoreal · lockedmodel in-betweencode crossfadewireframe · lockedthe beats live in code, not in the model

The site's signature visual is a photoreal Cape Town scene that scans into a wireframe twin of itself. The method that emerged is the reusable part: do not generate the morph in one go. Make the photoreal frame right and lock it; generate the wireframe twin from that exact frame so the two share a composition; raise resolution by working off the approved frame rather than re-rolling. When the artificial motion drifted at the end, settling on a glowing mass rather than the locked wireframe, the answer was not to re-roll the dice at cost. A hand-written code layer carries the precise beats and crossfades off the artificial clip onto the real, locked frame, so the shot lands exactly every time. A cheap pass confirmed the motion read before the expensive master was committed, and the whole thing was proven in a throwaway prototype in a real browser before it touched the live page.

The portrait: anchor generated motion on real frameslet the model invent only the gaps
real frame, fixedgenerated between

The profile page needed a short turn of the person in the same wireframe treatment. Real quarter-positions were used as fixed anchors with short segments generated between them, which left almost nothing to invent, and that is what finally kept it clear of the platform content filters that earlier single-frame full spins kept tripping. A useful accident: the wireframe abstraction chosen for the brand was also what made a filtered real-person subject shippable at all. The faithful, cheap work was done first and locally, the cut-out and colour standardisation with ordinary tooling and no credits, and only the genuinely generative step was paid for. When a later regeneration came back worse, the discipline was to revert cleanly to the kept earlier version rather than keep spending.

Codifying the hosting knowledge onceinterview-first, benchmarked
0255075100with the skill100%without75%

Putting the site on a domain surfaced a question the system had no settled answer for. Rather than re-derive the host-specific knowledge every session, it was codified once as a new skill, built with the same evaluation-driven method as everything else: four modes, each opening with an interview rather than assuming context, backed by reference files loaded only when needed. It is path-agnostic so it works on either machine, and a benchmark showed it passing every assertion with the skill against a clear majority without, which is evidence that it adds measurable value on the tasks it was built for.

What this demonstrates, honestly

It demonstrates the system's claims operating under change: interview-first elicitation, playback gates, decision records that survive their own supersession, logs kept in stride, verification treated as part of done, and a public artefact produced from a single sanitised source through an automated gate. The caveats are stated rather than hidden: the discipline on display is self-administered, the same person is subject and auditor, and this account is written by the builder. Which is exactly why the checkable artefacts matter more than the words, and why the simplest test is the best one: whether the thing described here exists, works, and contains no identifier it should not.