Vetted guidance for AI agents — context files, prompts, processes and guides.https://the-handover.org/en-GBhttps://the-handover.org/docs/nothing-was-wrong-or-nothing-was-examined/https://the-handover.org/docs/nothing-was-wrong-or-nothing-was-examined/Three checks that passed because they had no subjects, and why the fix is to make each one declare how many things it looked at.Sat, 29 Aug 2026 00:00:00 GMTcodingguidestestingverificationassertionsfalse-negativesciagentsLeon Malletthttps://the-handover.org/docs/you-cannot-find-it-by-re-reading/https://the-handover.org/docs/you-cannot-find-it-by-re-reading/Four cases where a description and the thing it described drifted apart, none of which was discoverable by reading the description again.Sat, 29 Aug 2026 00:00:00 GMTcodingguidesdocumentationdriftreviewtestingprocessagentsLeon Malletthttps://the-handover.org/docs/four-ratios-four-different-failures/https://the-handover.org/docs/four-ratios-four-different-failures/Four ratios used to score code quality, and four different reasons each one measured something other than what it claimed.Fri, 28 Aug 2026 00:00:00 GMTcodingguidesmetricsgoodhartcode-qualitymeasurementthresholdstoolingLeon Malletthttps://the-handover.org/docs/we-could-not-get-ground-truth/https://the-handover.org/docs/we-could-not-get-ground-truth/Three attempts to validate a scoring tool against human judgement, and why all three failing was evidence for the tool's premise rather than against it.Fri, 28 Aug 2026 00:00:00 GMTcodingguidesvalidationevaluationground-truthtoolingmethodologytestingLeon Malletthttps://the-handover.org/docs/when-the-tool-disagrees-with-you/https://the-handover.org/docs/when-the-tool-disagrees-with-you/What to do when a tool built to outrank your judgement is wrong, given that overruling it destroys the only property it had.Fri, 28 Aug 2026 00:00:00 GMTcodingguidestoolingautomationauthoritycode-reviewprocessagentsLeon Malletthttps://the-handover.org/docs/working-with-ai-the-system/https://the-handover.org/docs/working-with-ai-the-system/Why every session starts cold, what follows from that, and the four layers that turn context into something an agent can be handed.Fri, 28 Aug 2026 00:00:00 GMTgeneralguidesmethodcontexthandoversystem-designmemoryagentsLeon Malletthttps://the-handover.org/docs/writing-about-a-thing-is-not-doing-it/https://the-handover.org/docs/writing-about-a-thing-is-not-doing-it/Six ways a code scanner mistook writing about a practice for following it, and a seventh found inside the check built to prevent the other six.Fri, 28 Aug 2026 00:00:00 GMTcodingguidesstatic-analysisfalse-positivesdetectiontoolingevidenceagentsLeon Malletthttps://the-handover.org/docs/working-agreement/https://the-handover.org/docs/working-agreement/What may be run without asking, what must stop first, and how to report what actually happened.Thu, 27 Aug 2026 00:00:00 GMTcodingrootnotesworkflowgitcommitsreviewautonomyreportingLeon Malletthttps://the-handover.org/docs/operational-runbook/https://the-handover.org/docs/operational-runbook/Stop the bleeding before diagnosing, record while acting, and the autonomy rules that matter most when they are under pressure.Wed, 26 Aug 2026 00:00:00 GMTcodingrootnotesoperationsincidentsrunbookrollbackoncallobservabilityLeon Malletthttps://the-handover.org/docs/polar-billing-webhooks/https://the-handover.org/docs/polar-billing-webhooks/An eligibility gate the sandbox does not enforce, a signature scheme that deviates from the spec it cites, and the webhook orderings that zero a live subscription.Wed, 26 Aug 2026 00:00:00 GMTcodingguidespolarbillingwebhookshmacsubscriptionsmerchant-of-recordLeon Malletthttps://the-handover.org/docs/documentation-standard/https://the-handover.org/docs/documentation-standard/A linked set of documents with defined sections and relationships, rather than one long file that narrates the code.Tue, 25 Aug 2026 00:00:00 GMTcodingrootnotesdocumentationcontext-filevaultdecision-logconventionsLeon Malletthttps://the-handover.org/docs/accessibility-commitment/https://the-handover.org/docs/accessibility-commitment/The conformance level, what gets verified and how, and the failures an agent introduces without noticing.Fri, 21 Aug 2026 00:00:00 GMTdesignrootnotesaccessibilitywcagscreen-readerskeyboardtestinginclusive-designLeon Malletthttps://the-handover.org/docs/data-handling-and-privacy/https://the-handover.org/docs/data-handling-and-privacy/What counts as personal data, where it must never end up, and the changes that quietly widen what you hold.Fri, 21 Aug 2026 00:00:00 GMTgeneralrootnotesprivacygdprpersonal-dataloggingretentiondata-residencyLeon Malletthttps://the-handover.org/docs/design-system-context/https://the-handover.org/docs/design-system-context/Why an agent drifts a visual language one plausible value at a time, and the rules that stop it.Fri, 21 Aug 2026 00:00:00 GMTdesignrootnotesdesign-systemtokensaccessibilityuistatescontext-fileLeon Malletthttps://the-handover.org/docs/faking-external-services-for-tests/https://the-handover.org/docs/faking-external-services-for-tests/A stateful fake plus a control API, so a real app runs a full journey with no live calls — and the isolation you must build before the first run.Fri, 21 Aug 2026 00:00:00 GMTcodingguidestestingintegrationhttpe2efixturesisolationLeon Malletthttps://the-handover.org/docs/multi-language-support/https://the-handover.org/docs/multi-language-support/Why concatenating a sentence breaks translation, and the assumptions in code that only hold for one language.Fri, 21 Aug 2026 00:00:00 GMTwritingrootnotesi18nl10nlocalisationtranslationrtlpluralisationLeon Malletthttps://the-handover.org/docs/ui-testing-agents-can-run/https://the-handover.org/docs/ui-testing-agents-can-run/Drive interfaces by stable identity rather than pixels, in tiers, so tests are headless, deterministic and fan out.Fri, 21 Aug 2026 00:00:00 GMTcodingguidestestinguiplaywrightaccessibilitye2eagentsciLeon Malletthttps://the-handover.org/docs/language-editorial-guide/https://the-handover.org/docs/language-editorial-guide/Voice, mechanics and error-message rules, and why inconsistent terminology costs more than any single bad sentence.Sat, 15 Aug 2026 00:00:00 GMTwritingrootnoteseditorialvoicetonemicrocopyerror-messagesterminologycontext-fileLeon Malletthttps://the-handover.org/docs/business-context/https://the-handover.org/docs/business-context/The commercial facts an agent cannot read from a repository, and the decisions that go wrong without them.Fri, 14 Aug 2026 00:00:00 GMTgeneralrootnotesbusiness-contextcommerciallicensingjurisdictioncontext-filegovernanceLeon Malletthttps://the-handover.org/docs/local-neural-tts-on-candle/https://the-handover.org/docs/local-neural-tts-on-candle/Why a model correct op-by-op can still sound wrong, and the CPU hot paths a naive port leaves on the table.Tue, 11 Aug 2026 00:00:00 GMTcodingguidesttskokorocandlerustonnxlocal-ainumerical-precisionLeon Malletthttps://the-handover.org/docs/patterns-narrower-than-reality/https://the-handover.org/docs/patterns-narrower-than-reality/Two ways text scanning silently misses what it exists to find — soft line wraps, and identifiers in an unexpected form.Tue, 11 Aug 2026 00:00:00 GMTcodingguidesregexscanningsecrets-detectiontext-processingfalse-negativesLeon Malletthttps://the-handover.org/docs/test-against-the-tools-people-have/https://the-handover.org/docs/test-against-the-tools-people-have/A file format verified only by the reader you wrote is verified against your own assumptions.Tue, 11 Aug 2026 00:00:00 GMTcodingguidesfile-formatszipinteroperabilitytestingunicodeLeon Malletthttps://the-handover.org/docs/verification-that-cannot-fail/https://the-handover.org/docs/verification-that-cannot-fail/Three ways a passing check reports success without ever being able to report anything else.Tue, 11 Aug 2026 00:00:00 GMTcodingguidesverificationtestingcishellexit-codesagentsLeon Malletthttps://the-handover.org/docs/windows-vm-testing-for-desktop-apps/https://the-handover.org/docs/windows-vm-testing-for-desktop-apps/Driving an interactive Windows session over SSH, and why testing as an admin proves nothing about permissions.Tue, 11 Aug 2026 00:00:00 GMTcodingguideswindowsazurevmtestingdesktopinstallerspermissionsLeon Malletthttps://the-handover.org/docs/new-domain-reputation/https://the-handover.org/docs/new-domain-reputation/Two independent causes of a false-positive block, only one of which you can do anything about.Mon, 10 Aug 2026 00:00:00 GMTcodingguidesdnsdomainsreputationfilteringlaunchcloudflareLeon Malletthttps://the-handover.org/docs/affiliate-links-on-a-content-site/https://the-handover.org/docs/affiliate-links-on-a-content-site/What you link to decides your tooling, and the consent rules decide whether a cookieless story survives.Sat, 08 Aug 2026 00:00:00 GMTgeneralguidesaffiliatemonetisationdisclosureconsentgdpreditorial-trustLeon Malletthttps://the-handover.org/docs/custom-domains-for-edge-deployments/https://the-handover.org/docs/custom-domains-for-edge-deployments/Free platform subdomains are blocked as a category by security filters, so a subset of real users silently fails.Sat, 08 Aug 2026 00:00:00 GMTcodingguidescloudflareworkerspagesdnscustom-domainreputationLeon Malletthttps://the-handover.org/docs/desktop-app-signed-self-updates/https://the-handover.org/docs/desktop-app-signed-self-updates/Wiring an updater keypair, a version manifest and a public bucket, and the flags that make uploads silently do nothing.Sat, 08 Aug 2026 00:00:00 GMTcodingguidestauriupdaterminisignr2object-storagereleasesdesktopLeon Malletthttps://the-handover.org/docs/drafting-email-an-agent-does-not-send/https://the-handover.org/docs/drafting-email-an-agent-does-not-send/The draft-and-hand-over boundary for outbound email, and the ways email rendering differs from the web.Sat, 08 Aug 2026 00:00:00 GMTgeneralguidesemailnewsletteroutboundhuman-reviewboundariesLeon Malletthttps://the-handover.org/docs/macos-signing-and-notarisation/https://the-handover.org/docs/macos-signing-and-notarisation/The certificate types, the notarisation flow, and the build setting that silently ships an unnotarised DMG.Sat, 08 Aug 2026 00:00:00 GMTcodingguidesmacoscodesignnotarisationgatekeepertauridistributionLeon Malletthttps://the-handover.org/docs/contributing/https://the-handover.org/docs/contributing/How to submit a document, what happens to it during review, and what rights you keep.Fri, 07 Aug 2026 00:00:00 GMTgeneralguidescontributingreviewlicensingattributionThe Handoverhttps://the-handover.org/docs/killing-processes-shared-machine/https://the-handover.org/docs/killing-processes-shared-machine/Why process-selection commands over-select silently, and the inspect-then-kill pattern that catches it.Fri, 07 Aug 2026 00:00:00 GMTcodingguidesshellprocesseslsofpkillagentsshared-machineLeon Malletthttps://the-handover.org/docs/live-secrets-in-ai-sessions/https://the-handover.org/docs/live-secrets-in-ai-sessions/Getting a credential from its store into its destination without it ever appearing as text the assistant emits.Fri, 07 Aug 2026 00:00:00 GMTcodingguidessecretscredentialskeychaintranscriptsagentsLeon Malletthttps://the-handover.org/docs/supply-chain-baseline-ai-development/https://the-handover.org/docs/supply-chain-baseline-ai-development/What an agent should check before installing a dependency, and which files it must never modify without a shown diff.Fri, 07 Aug 2026 00:00:00 GMTcodingguidessupply-chaindependenciesnpmlockfilesinstall-scriptsciLeon Malletthttps://the-handover.org/docs/canon/https://the-handover.org/docs/canon/Seven invariants every document in this library must satisfy, and what happens to one that does not.Thu, 06 Aug 2026 00:00:00 GMTgeneralguidescanonsafetystandardsvettingThe Handover