HESUS
HESUS is a portable project brain: a small, pure-Python system you fold into a codebase so the architectural decisions made during development — the why this, why not that — become durable, queryable objects instead of knowledge that evaporates between sessions and people. It rides alongside an AI coding workflow and makes the operator's judgment persistent.
The scarce, irreplaceable asset in a long-lived codebase isn't the code — code can be regenerated. It's the decisions: why a boundary was drawn here, why an approach was rejected, what a subsystem is actually for. That reasoning is exactly what disappears between AI sessions, between team members, and between the person who wrote a module and the person who has to change it six months later. HESUS treats those decisions as first-class, retrievable objects rather than prose buried in commit messages and wikis that drift out of sync with the code.
Everything HESUS does is one of three operations:
Seed
Drop an empty-but-capable brain into a new project. It's born ready and grows as the project does.
Gestate
On first contact with an existing project, extract its accumulated decisions into the cortex.
Upgrade
Give a project running an older brain a newer engine — without losing a single accumulated decision. Swap the engine, preserve the cortex, verify.
The central daily benefit is context-efficient briefing. Instead of an AI session cold-reading a project's entire decision history to orient — burning a large fraction of its working context — a brief returns only the relevant slice plus pointers. Because a brief stays near-constant in size while the cortex grows, the saving grows as the project accumulates more decisions.
Under the hood it's about 6,200 lines of standard-library Python across a set of single-purpose organs — brief, gestate, query, upgrade, and a chain of honesty gates — all reading project-specifics through a single descriptor seam. It even ships a fallback TOML parser so it needs zero pip installs and runs on Python 3.8+.
These were measured on Omniscient, a real shipping Windows fleet-hardening tool (6,497 LOC PowerShell engine), into which HESUS was folded and then upgraded — not a benchmark fixture built to flatter the system. The full story, the things that didn't work, and what is proven versus unproven are in the case study.
HESUS does not autonomously write code or make decisions. It makes an operator's judgment durable, queryable, and provenance-preserved. Sold as exactly that, the measured results above are what it delivers.
A "project" is one codebase the brain is folded into and grows with: seeded or gestated on arrival, accumulating that project's decisions over its life, upgradeable to newer engine generations without losing what it has learned. Folded in once, it's yours to keep in that codebase for life. Pure Python, standard library only, no external dependencies — it runs anywhere your code does and adds nothing to your runtime.