https://webdex.co.uk/blog/Notes on software delivery, architecture and AI-augmented engineering.en-GBThu, 05 Nov 2026 00:00:00 +0000https://webdex.co.uk/blog/librechat-front-door/https://webdex.co.uk/blog/librechat-front-door/Thu, 05 Nov 2026 00:00:00 +0000AI-Augmented EngineeringArchitectureSystem Design Introduction A chat application is the smallest part of a chat deployment. I have written that sentence in notes three times since September, and each time it arrived from a different side. This time it was the model list. The picker offers two models, and both are named combos the router serves. The list is typed by hand into a configuration file because discovery is switched off for that endpoint. Switch it on and the app asks the router what it has; the router answers with 56 model ids — the two combos, and 54 provider models sitting behind them — and the picker stops being a short list of things this deployment is for and becomes a catalogue of everything the estate could reach. So discovery stays off, the list is curated, and it will go on naming two combos after one of them is renamed, with no warning when the day comes. https://webdex.co.uk/blog/one-endpoint-many-providers/https://webdex.co.uk/blog/one-endpoint-many-providers/Thu, 29 Oct 2026 00:00:00 +0000AI-Augmented EngineeringArchitectureSystem Design Introduction At about 11:00 PM an editor agent declined a directory. Not the repository: a subtree, a few hundred thousand tokens of code it had already read once that day, in a session that had been going for an hour. It said the model’s context was 128,000 tokens, so it would summarise first and work from the summary. https://webdex.co.uk/blog/shared-opencode-config/https://webdex.co.uk/blog/shared-opencode-config/Wed, 28 Oct 2026 00:00:00 +0000AI-Augmented EngineeringMCP ServersArchitecture Introduction A working agent setup is easy to build and hard to hand over. It accumulates in one person’s home directory: an agent prompt here, a permission rule there, a skill that encodes what the team agreed about tests. The second machine gets a copy that is already a week old, the second person gets a screenshot and a list of things to paste, and six weeks later nobody can say which version is current. https://webdex.co.uk/blog/evaluating-rag-systems/https://webdex.co.uk/blog/evaluating-rag-systems/Tue, 27 Oct 2026 00:00:00 +0000RAGEvaluationAI-Augmented Engineering Introduction A retrieval-augmented generation system is the easiest AI feature to demo and one of the harder ones to keep honest. You point it at a corpus, ask a question the corpus answers plainly, and it answers; whoever is watching nods. The next question, from somebody who actually works with the material, comes back wrong in a way nobody notices until it matters: a fluent paragraph citing a page that says something else, an answer silently missing the one document that mattered, a confident figure assembled from two versions of the same record. https://webdex.co.uk/blog/mcp-servers-in-production/https://webdex.co.uk/blog/mcp-servers-in-production/Mon, 26 Oct 2026 00:00:00 +0000MCP ServersAI-Augmented EngineeringArchitecture Introduction The first MCP server I wrote took an afternoon: one file, a handful of functions, a client configuration pointing at a local path, and a model that could suddenly reach something real. As a demo it convinced, because the argument that a language model can call a well-described function is not a hard one to win any more. https://webdex.co.uk/blog/micro-mono-modu/https://webdex.co.uk/blog/micro-mono-modu/Sun, 25 Oct 2026 00:00:00 +0000MicroserviceMonolithArchitectureRepositorySystem DesignIntroduction Software engineering is hard and volatile. As software craftspeople we adapt constantly to changing business needs and strategy. On top of that, we have our own technical needs to cater for. Beyond choosing a tech stack — which languages, frameworks, infrastructure and open-source tools to lean on — pinning down the right architecture from the get-go can be an absolute conundrum. In this post we look at the different scenarios a system passes through and how to make the best of each, as well as the decisions that might paint us into a corner too early.