Inspect before you rebuild
The idea behind Nehemvix is older than software, and it is the way we think good engineering should begin.
The name comes from an old story about a city in ruins. In chapter 2 of the book of Nehemiah, Nehemiah arrives in Jerusalem to find its walls broken down and its gates burned. He doesn't begin by gathering builders. He goes out at night with a few companions and looks at the walls himself, and only when he knows their real condition does he make a plan.
Whatever your own beliefs, the lesson travels well: good rebuilding starts with understanding what is already there.
The same problem in a codebase
Anyone joining an unfamiliar codebase stands where Nehemiah stood. Where does it begin? How do the parts talk to each other? Which service owns which workflow? And can you trust what you think you've understood?
Nehemvix is built to answer those questions before anyone changes a line. It reads the repository at one exact commit, draws its structure and writes a guide for a beginner, a senior engineer or an architect. How each stage works
What the name says
Say it ne-HEM-viks. It has three parts.
- NEHEM is for Nehemiah, who looked before he built.
- V is for verifiable: citations open the exact lines at that commit, every file, function and class it names is looked up there, and names it can't find are listed. How we check
- IX is for interconnected architecture, because a codebase is a set of relationships, not a pile of files.
What we believe
A claim about a system should have a witness in the source code. And software shouldn't stay understandable only to the people who wrote it: a newcomer deserves a clear way in.
Nehemvix doesn't replace an engineer's judgement. It gives that judgement evidence to follow: citations to exact lines, a list of names that couldn't be found, and a grounding score for how much of the guide checks out. The checks show that the named files and symbols exist. Reading the code is still yours to do.
Inspect the structure. Connect the relationships. Check the evidence. Then rebuild. Start with a repository of your own
The same belief guides the AI agents built by AELSHA™, the company behind Nehemvix.