In a world of soulless, hyper-efficient matrix multiplication, we asked ourselves a simple question: what happened to the human touch?
At Heritage Codeworks, we believe software shouldn’t be predicted by an algorithm. It should be suffered over. That’s why every repository we release is one hundred percent Hand-Built™. Every function is typed one key at a time, by people who are visibly tired.
A Short Documentary
The Film
Shot by hand. Edited by hand. Watched, we assume, by a human.
Three time-honoured practices, unchanged since the invention of the semicolon.
No. I
Farm-to-Terminal Sourcing
Every variable name, locally foraged. Each character is grown on a small, family-run keyboard and carried to the terminal by hand. We know the name of the finger that typed each line. Most of them are Gerald's right index.
// sourced locally
// from a cherry MX blue
// harvested at dawn
No. II
Artisanal Memory Leaks
Every segfault, bespoke. Ours are non-deterministic and crafted with pride. Each allocation is made by hand and never freed. Like a cast-iron pan, a good program should hold on to everything it has ever touched.
char *heirloom = malloc(4096);
/* TODO: free() this
(left by grandfather, 1987) */
No. III
Authentic Sweatshop Provenance
Every commit is written by a real developer, in a real basement, under a real fluorescent tube, at hours we are contractually unable to disclose. You can taste the overtime.
$ git log --format="%ad"
Sun 03:47 · Sun 04:12
Sun 04:13 · Mon 02:58
“When I hand-carve a regex at three-fourteen in the morning, I leave a little piece of myself inside it. Usually an unhandled edge case that crashes production on leap years.”
Chapter the Second
The Workshop
Photographed by available light. The available light is a single window, and it faces the wrong way.
A mechanical keyboard on a cedar bench. Each keycap is broken in by a single artisan over eleven years. The sawdust is from the debugging.
Inventory of the Workshop
Keyboards, beige, 198714
CRT monitors, warm to the touch22
Floppy diskettes, held to the light3,104
Candles1
Rubber ducks, retired6
Debuggers0
Unread emailsUncounted
Taken by hand, S. Fenwick
Chapter the Third
Meet the Artisans
They have been at the bench a long time. You can see it in their eyes, and beneath them.
Ezekiel Thorne
Master Compiler · 41 years at the bench
Hand-carves every regular expression at 3:14 a.m. and inspects it through a jeweller's loupe. Has never used a debugger. Considers printf a family recipe.
Hours slept
3
Tests written
Declined
Silas Fenwick
Journeyman · Keeper of the Floppies
Personally reads every byte before it ships. Holds opinions on tabs versus spaces that he will not share in mixed company.
Hours slept
4
Disks rejected
All but one
Old Tom
Senior Legacy Maintainer
Wrote the billing system in 1987 and is the only living person who knows how it works. Has been asked to retire four times. Simply did not.
Hours slept
Unknown
Documentation
Oral tradition
Abner Quill
Apprentice · Year Nine
Not yet trusted with production. Writes the comments, which is to say he writes the apologies.
Hours slept
2
Merge rights
Pending, 2031
Chapter the Fourth
The Hand-Built™ Seal
Only software that meets our exacting standards may carry the Seal. Each one is inspected by an elderly man who squints at it and makes a small noise.
Every line typed by a human hand, at a human pace
Every bug introduced in person, never by a machine
No suggestions accepted from any tool, colleague or spouse
Compiled overnight, with a candle left burning for luck
Ships with at least one comment reading // don't touch this
The Hand-Built™ Seal certifies only that a human being was present at the time of writing. Heritage Codeworks makes no warranty, express or implied, as to correctness, performance, security, fitness for a particular purpose, or whether it will run on your machine. It ran on ours, once, in 2004.
Chapter the Fifth
Provenance
Every repository ships in a hand-nailed cedar crate, packed in straw, with a card recording where it came from and who is to blame.
FRAGILECONTAINS RAW C++THIS SIDE UP ↑ · DO NOT REFACTOR
Felled
Requirements are gathered in a single meeting and written on the back of an envelope. The envelope is then lost.
Seasoned
The code is left in a feature branch for eighteen months, where it develops character and merge conflicts.
Planed
Conflicts are resolved by feel. Whatever does not compile is sanded down until it does, or until morning.
Crated
The finished repository is copied onto a single drive, bedded in wood shavings from the bench, and shipped by freight with its own crowbar. Opening it is part of the experience.
Certificate of Provenance · Lot 0x2F1A
Artisan
E. Thorne
Bench
No. 3 (the one by the drafty window)
Weather
Overcast, as was his mood
Lines
11,204 (9,880 commented out)
Coffee
Fourteen cups, black
Known defects
Treasured
Sure, it takes six months longer to compile. But when your system panics at midnight, you’ll sleep soundly knowing it failed the old-fashioned way: because a real, flesh-and-blood human forgot a semicolon.
Order a Repository
Each repository is made to order and takes between six and eight years to deliver. Prices are available on request, and the request costs extra.
The waiting list is currently closed. It has been closed since 2011. You may join it anyway.