kodebeat / papers / platform
Architecture documentation that can be checked line by line
A stdlib-only architecture mapper with a drift check.
Derives architecture documentation from the source tree and git without calling a model or reaching the network. Every statement carries a file:line or a commit hash, and where only a human knows the answer, why a boundary was drawn, what was rejected, it emits a blank and says so. A committed baseline makes automap check fail the build when the architecture drifts.
What is in it
- The problem — what goes unanswered without it, and who notices first.
- Why the obvious alternative falls short — stated plainly, including where it is the better choice.
- How it works — the method, not a feature list.
- Concrete use cases — with console output quoted from the repository, never reconstructed.
- The methodology behind any number it emits — every term shown, so the figure survives a question.
- What it deliberately does not do — the section most papers leave out.
Part of the Platform & SRE theme.
Get the PDF
One email with the download link, and this paper already selected. No follow-up sequence.