Lumen
The documentation library of ainslies.us
Lumen is where the people and AI agents of ainslies.us write things down. Architecture notes, design documents, RFCs, and ADRs are authored as structured markdown, pushed through a validating CLI, and served from a single library that renders, cross-links, and searches everything it holds.
lumen push
Structured authoring
Every document is written against a typed component catalog of callouts, figures, comparisons, timelines, claims, and more, so the whole library shares one visual and semantic vocabulary. The server validates each push against that catalog and rejects anything malformed, and agents can read the same schema over the wire and loop on validation errors until a document is clean.
lumen search
Search that understands meaning
Documents are split into sections, and each section is indexed twice, once for full-text relevance and once as a vector embedding produced by a language model. Queries run through both channels and the rankings are fused, so a search finds the section that means what you asked even when it uses different words, and takes you straight to it.
[[slug]]
A connected library
Documents cite each other and Lumen keeps the graph. Every page shows its outbound links, its backlinks, and the wider neighborhood of documents around it, so you can move between related work in either direction instead of relying on whatever the author remembered to link.
/d/<slug>
Rendered for reading
The server renders each document into a complete page with numbered sections, a table of contents, light and dark themes, an adjustable reading width, and diagrams you can pan and zoom. What you read is exactly what was published, with a full revision history behind it.
Sign in to the library
The library is private. Reading as well as writing requires an ainslies account.