Architecture is about making constraints explicit and choosing boundaries that age well. In this section, I cover decision frameworks, modularity, integration patterns, and strategies for evolving complex systems over time.
Articles
API Changelogs with Docusaurus
Add versioned OpenAPI snapshots, CI-based diffs, and a practical changelog flow to Docusaurus so API consumers can understand and migrate releases safely.
Agent Skills vs MCP: Two Standards, Two Security Models
A technical analysis comparing Anthropic's Agent Skills specification and Model Context Protocol - two different approaches to extending AI agents, with fundamentally different security implications for credential management and code execution.
Building Your First Agent Skill: A Practical Guide
A hands-on tutorial for creating and using Agent Skills with Claude. Learn how to build a custom weather forecast skill from scratch, complete with Python scripts and API integration.
OpenAPI Specification 3.2 Released – What’s New?
OpenAPI 3.2 brings path templating, new HTTP methods, streaming support, and richer documentation features.