Software Architecture & AI Insights
Field notes on software architecture, machine learning, and AI engineering — the decisions, trade-offs, and lessons behind systems that run in production. Written for CTOs, principal architects, and technical leaders.
To explore by subject, browse the reading paths.
Newest article
An Architecture for Vendor-Neutral AI Context Configuration
AI context configuration with AGENTS.md. Learn a vendor-neutral, monorepo-ready architecture that reduces lock-in compared to CLAUDE.md.
7 min read
Context EngineeringAGENTS.mdCLAUDE.mdEnterprise Architecture
Writing Agent Skills: Lessons Learned and Best Practices from Production Use
Learn how to design Agent Skills. Best practices from production covering maintainability, context efficiency, determinism, and reliability.
11 min read
Agent SkillsAI AgentsAI EngineeringSoftware Architecture
Why AI Agents Should Use Database MCP Servers
Discover how database MCP servers reduce schema discovery effort, protect credentials, and improve observability for enterprise databases.
9 min read
AI AgentsMCPOracle MCP ServerEnterprise Security
A Future-Proof Enterprise AI Strategy: Avoid Vendor Lock-In with Agent Plugins
Package Agent Skills and MCP servers once — then use them across ChatGPT, Codex, GitHub Copilot, Cursor and more with Agent Plugins 1.0.
9 min read
Agent Plugins 1.0Agent SkillsAI AgentsEnterprise Architecture
Rethink How AI Reads Your Online Documentation. Here's a Retrieval-Optimized Architecture
Vector-database RAG struggles with raw online documentation. Explore an llms.txt-inspired approach using LLM-optimized Markdown artifacts.
13 min read
RAGAI AgentsEnterprise Knowledge BasesInformation Retrieval (IR)
