Architecture
18 articles about architecture.
Error Propagation in Multi-Agent Networks - The Problem Nobody Talks About
When one AI agent makes a bad decision, every downstream agent inherits that error. Multi-agent systems amplify mistakes instead of catching them. Here is why error propagation is the real challenge.
Using Agent Teams as a Product Backend: Bridging Swift Desktop Apps to Claude Agent SDK
We built a Swift desktop app that bridges to the Claude Agent SDK via a local Node.js process. Here is how agent teams can serve as a product backend.
The Lossy Handoff Problem - When AI Agents Transfer Context via Git Diff
Git diffs capture what changed but not why. When AI agents hand off work to humans, architectural decisions and rejected alternatives are lost. How to preserve context.
Competing Philosophies About Where AI Should Live - Truly Local vs Cloud VM
Some tools claim local-first but run in cloud VMs. True local means native code on your machine with direct OS access and no virtualization layer.
You Don't Have a Claude Code Problem, You Have an Architecture Problem
When AI agents struggle with desktop automation, the issue is usually architecture - not the LLM. Thin action primitives that the model composes into workflows scale far better than monolithic scripts.
What File Systems Teach About AI Agent Reliability
File systems solved reliability decades ago with atomicity, journaling, and crash recovery. AI agents can learn the same lessons for more reliable execution.
Structuring a macOS Agent App with Modular Swift Frameworks
Split your Swift macOS agent into separate frameworks for UI, accessibility, networking, and models. AI agents can work on one framework without breaking others.
The N+1 Problem in AI Agents - Everyone Wants Agents That Automate Other Agents
Why the impulse to build agents that automate other agents is premature, and why nailing the first layer of automation matters more.
No-Server Architecture for Small Business Tools - Why Local-First with IndexedDB Wins
Adding a backend to small business software means becoming the IT department for every shop. Local-first with IndexedDB is the smarter constraint.
How to Protect Your IP When Building with AI Coding Agents
Practical strategies for protecting intellectual property when using AI coding agents like Claude Code - isolate secret sauce, use modular architecture, and control what the AI sees.
PWA vs Native macOS App - How to Decide for Your AI Tool
PWA is fastest to ship but feels like a wrapper. Native SwiftUI gives you proper notifications, menu bar integration, and system-level shortcuts. For AI agents that need OS access, native wins.
Write Specs Before PRs to Avoid Redesign Debates in Code Review
How writing a short spec before non-trivial PRs prevents architecture debates during code review and saves hours of rework.
Designing a Tiered Permission System for AI Desktop Agents
Full YOLO mode is dangerous and full approval mode is unusable. Tiered permissions with allowlists per action type hit the sweet spot.
The HANDOFF.md Pattern - How to Keep Claude Code Productive Across Sessions
Context window management matters more than prompt quality once your project grows. How the HANDOFF.md pattern and post-edit hooks keep AI coding agents productive.
You Do Not Need an MCP Server for Every Mac App - Accessibility APIs as a Universal Interface
Instead of building a separate MCP server for each macOS app, use the accessibility API as a single universal interface. One integration controls every app on your Mac.
Using Claude as an Execution Layer - Markdown Specs, MCP Tools, No Traditional Code
What happens when your entire app is markdown specs that Claude executes, with MCP servers as the only real code. A year of building this way.
Building Memory Into an AI Desktop Agent - Knowledge Graphs and Persistent Context
The hardest problem in AI agents is not planning - it is remembering. How knowledge graphs and local file indexing give desktop agents persistent memory across sessions.
Native Desktop Agent vs Cloud VM - Why We Chose to Run on Your Actual Mac
Cloud VM agents like Claude Cowork run in isolated environments. Native agents like Fazm control your actual apps. Here is why the native approach wins for personal productivity.