Architecture

18 articles about architecture.

Error Propagation in Multi-Agent Networks - The Problem Nobody Talks About

·3 min read

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.

multi-agenterror-propagationreliabilityagent-networksarchitecture

Using Agent Teams as a Product Backend: Bridging Swift Desktop Apps to Claude Agent SDK

·2 min read

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.

swiftclaude-sdkarchitecturemacosagent-teams

The Lossy Handoff Problem - When AI Agents Transfer Context via Git Diff

·3 min read

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.

handoffcontext-lossgit-diffai-agentknowledge-transferarchitecture

Competing Philosophies About Where AI Should Live - Truly Local vs Cloud VM

·2 min read

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.

local-firstcloud-vmphilosophynativearchitecture

You Don't Have a Claude Code Problem, You Have an Architecture Problem

·2 min read

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.

architectureclaude-codedesktop-automationprimitivesagent-designworkflows

What File Systems Teach About AI Agent Reliability

·3 min read

File systems solved reliability decades ago with atomicity, journaling, and crash recovery. AI agents can learn the same lessons for more reliable execution.

reliabilityfile-systemsai-agentsatomicityjournalingcrash-recoveryarchitecture

Structuring a macOS Agent App with Modular Swift Frameworks

·2 min read

Split your Swift macOS agent into separate frameworks for UI, accessibility, networking, and models. AI agents can work on one framework without breaking others.

swiftmodularframeworkmacosarchitecture

The N+1 Problem in AI Agents - Everyone Wants Agents That Automate Other Agents

·2 min read

Why the impulse to build agents that automate other agents is premature, and why nailing the first layer of automation matters more.

n-plus-oneagent-automationlayer-skiparchitecturecomplexity

No-Server Architecture for Small Business Tools - Why Local-First with IndexedDB Wins

·2 min read

Adding a backend to small business software means becoming the IT department for every shop. Local-first with IndexedDB is the smarter constraint.

local-firstindexeddbsmall-businessno-serverarchitecture

How to Protect Your IP When Building with AI Coding Agents

·2 min read

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.

intellectual-propertyai-agentcode-securityarchitectureprotection

PWA vs Native macOS App - How to Decide for Your AI Tool

·2 min read

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.

pwanative-appswiftuimacosarchitecture

Write Specs Before PRs to Avoid Redesign Debates in Code Review

·2 min read

How writing a short spec before non-trivial PRs prevents architecture debates during code review and saves hours of rework.

code-reviewspecsengineering-processpull-requestsarchitecture

Designing a Tiered Permission System for AI Desktop Agents

·3 min read

Full YOLO mode is dangerous and full approval mode is unusable. Tiered permissions with allowlists per action type hit the sweet spot.

permissionsai-safetyux-designdesktop-agentarchitecture

The HANDOFF.md Pattern - How to Keep Claude Code Productive Across Sessions

·3 min read

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.

claude-codedeveloper-toolsproductivityarchitecture

You Do Not Need an MCP Server for Every Mac App - Accessibility APIs as a Universal Interface

·3 min read

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.

mcpaccessibility-apimacosarchitecturedeveloper-tools

Using Claude as an Execution Layer - Markdown Specs, MCP Tools, No Traditional Code

·3 min read

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.

claude-codemcparchitecturedeveloper-toolsworkflow

Building Memory Into an AI Desktop Agent - Knowledge Graphs and Persistent Context

·2 min read

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.

memoryknowledge-graphai-agentsarchitecturecontext

Native Desktop Agent vs Cloud VM - Why We Chose to Run on Your Actual Mac

·4 min read

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.

desktop-agentcloud-vmarchitectureproductivitycomparison

Browse by Topic