Breaking Down Our Pipeline: From a Symlink Hack to Five Independent Deployments
How we untangled a five-project monorepo in one go, and the hard lesson a single Cloudflare token taught us.
Tag: architecture
Typed Models: How we stopped silently losing data
The old universal model stored data as shapeless strings, leading to silent information loss. We rewrote the core with strict types, replacing silent degradation with loud validation errors.
Developer Guides: We didn't abandon the guides, just Flude—and then changed our minds
Dead cross-references between handwritten guides and auto-generated API pages quickly explained why managing guides away from Flude, as plain Markdown, was a mistake.
The Markdown Singularity: Why Generating HTML is a Dead End
How a single question from our Infrastructure Lead forced us to rewrite our documentation pipeline, abandon HTML, and accidentally create Flude.
TDD as a Leash for AI: Writing Tests Without Knowing the Language
Why it's easier to rewrite AI code from scratch, how tests became our contract, and how to force the neural network to write its own checks.
Programming Without Knowing the Language: How AI Fired Doxygen
How we tried to parse XML, why AI suddenly pulled in tree-sitter, and why control is more important than genius code.
How Not to Build Documentation: The Tale of an HTML Parser
How we tried to outsmart Doxygen, adapt its markup to our standards, and why it led us to build our own engine.
Flude: From Source Code to Quality Documentation
Why stacks like Doxygen+DoxyBook2+Hugo fall short on large projects, and how Flude solves the problem.