Architecture

Best practices that hold

Patterns, trade-offs, and operational lessons collected from systems that stayed up.

29 August 20265 min readArchitecture
Operable agents: schemas, traces, and the 3 a.m. test
An agent that can plan, call tools, and loop is easy to demo. An agent you can operate is a different artefact. Operable means: when it fails, you know which tool, which state, which prompt version, and whether a human should have been in…
- ai
- agents
- langgraph
29 August 20265 min readArchitecture
Agentic RAG that stays current when the corpus never stops moving
The demo is easy: chunk a folder, embed it, ask a question, get a cited answer. The production problem is different. Enterprise knowledge is not a snapshot. Contracts get revised, runbooks drift, tickets close, wikis fork. If retrieval is…
- ai
- rag
- agents