https://archdocs.io/blog Writing on architecture documentation, diagrams-as-code, and cloud visibility. https://archdocs.io/blog/building-a-hosted-mcp-server https://archdocs.io/blog/building-a-hosted-mcp-server Fri, 23 Oct 2026 00:00:00 GMT A request-bound MCP server, OAuth with PKCE, and YAML compilation through the existing document services, including the limits of validation. https://archdocs.io/blog/c4-model-in-practice https://archdocs.io/blog/c4-model-in-practice Fri, 23 Oct 2026 00:00:00 GMT Separate system context from container detail, use a copyable YAML example, and review the diagram for responsibilities the schema cannot check. https://archdocs.io/blog/erd-and-sequence-diagrams-as-code https://archdocs.io/blog/erd-and-sequence-diagrams-as-code Fri, 23 Oct 2026 00:00:00 GMT Copy valid YAML for typed entities and an ordered login exchange, then review the schema and failure paths that syntax alone cannot verify. https://archdocs.io/blog/forking-excalidraw-for-structured-diagrams https://archdocs.io/blog/forking-excalidraw-for-structured-diagrams Fri, 23 Oct 2026 00:00:00 GMT How structured ERD and API cards share geometry across editing and export, and why sequence diagrams use a separate element. https://archdocs.io/blog/why-i-built-archdocs https://archdocs.io/blog/why-i-built-archdocs Fri, 23 Oct 2026 00:00:00 GMT I wanted shared services to keep their identity across architecture diagrams, with YAML and a canvas editing the same document. https://archdocs.io/blog/the-real-cost-of-stale-documentation https://archdocs.io/blog/the-real-cost-of-stale-documentation Tue, 16 Jun 2026 00:00:00 GMT Stale architecture docs never show up as a line item, but they tax onboarding, incidents, design, and audits. Here is a framework for naming those hidden costs so you can justify fixing them. https://archdocs.io/blog/architecture-decision-records-practical-guide https://archdocs.io/blog/architecture-decision-records-practical-guide Tue, 09 Jun 2026 00:00:00 GMT How to write architecture decision records your team will actually maintain, including a copyable template and a worked example you can paste into your repo today. https://archdocs.io/blog/your-architecture-diagrams-are-lying-to-you https://archdocs.io/blog/your-architecture-diagrams-are-lying-to-you Tue, 02 Jun 2026 00:00:00 GMT Architecture diagrams go stale the moment they are drawn. Here is why they drift, the three ways they fail, and what actually keeps them honest.