Separate the Live Document from the Saved Copy
Designing collaborative document editing with conflict-free synchronization, saved snapshots, and safeguards against overwriting content before initial sync.
system-design
Separate Authentication from What an Actor May Do
Designing API authentication and role-based authorization with actors, route permissions, and separate credentials for people and machines.
Do Not Load the Whole Past into the Model
Designing AI agent memory with retrieved context, durable task records, and evidence-based create or update decisions that tolerate search index lag.
A Transcript Is Not a Task List
Designing a meeting AI pipeline with separate transcription, summarization, and task extraction, preserving evidence and resolving deadlines from meeting time.
Keeping an Agent Resident Behind NAT
Designing a resident agent behind NAT with outbound connections, separate liveness checks, and on-demand SSH sessions for interactive access.
AI Agent Clean Architecture
Why I built an AI agent platform in Go instead of using LangChain, and how Clean Architecture made model, memory, tool, and streaming concerns independently replaceable.
Separate the Live Document from the Saved Copy
Designing collaborative document editing with conflict-free synchronization, saved snapshots, and safeguards against overwriting content before initial sync.
Separate Authentication from What an Actor May Do
Designing API authentication and role-based authorization with actors, route permissions, and separate credentials for people and machines.
Do Not Load the Whole Past into the Model
Designing AI agent memory with retrieved context, durable task records, and evidence-based create or update decisions that tolerate search index lag.
A Transcript Is Not a Task List
Designing a meeting AI pipeline with separate transcription, summarization, and task extraction, preserving evidence and resolving deadlines from meeting time.
Keeping an Agent Resident Behind NAT
Designing a resident agent behind NAT with outbound connections, separate liveness checks, and on-demand SSH sessions for interactive access.
AI Agent Clean Architecture
Why I built an AI agent platform in Go instead of using LangChain, and how Clean Architecture made model, memory, tool, and streaming concerns independently replaceable.