Architecture
22 articles about architecture.
Architecture Diagrams vs Working Systems - How AI Agents Expose the Gap
AI agents implement architecture documents literally and expose every underspecified gap. Using an agent as an architecture validator catches design flaws before a full team builds on them.
AWS Certification That Changed Architecture
Certifications teach what a platform can do. Building teaches what it should do. Both matter for AI agent infrastructure decisions.
Building a Custom AI Coding Agent with the Claude API and MCP Tools
Why building your own AI coding agent with direct API access and custom MCP tools gives you more control than using Claude Code out of the box.
Skills vs Sub-Agents in Claude Code - When to Use Each Pattern
How to structure Claude Code skills vs sub-agents - splitting by type, managing 10+ skills, and choosing the right pattern for each workflow.
Claude Code Writes Your Code, but Do You Know What's in It?
AI coding agents restructure modules in unexpected ways. The code works but the architecture drifts from your mental model unless you actively review
How CLAUDE.md Prevents AI Agents from Writing Goop Code
The single biggest improvement for AI-generated code quality is describing your architecture in a CLAUDE.md file before the agent touches anything. Here is
Context Windows Are Not Memory
Context windows are working memory, not storage. Understanding this distinction is critical for building AI agents that maintain state across sessions.
Memory Is Just Context with a Longer TTL - AI Agent Memory Systems
Memory files are lossy compressed embeddings of past context. Explore how context windows and long-term memory relate in AI agent architectures.
Dumb Orchestrator With Smart Workers Beats One Big Agent
A simple decision-tree orchestrator routing tasks to specialized worker agents - browser, accessibility, sequential - is more reliable than a single
Focus Compounds - Why Specialized AI Agents Outperform Generalists
A focused AI agent that does one thing well outperforms a distributed agent that does ten things poorly. Specialization compounds in ways generalization cannot.
Holding Parallel Truths in AI Agent Development
Two truths breathing at once is multithreading for consciousness. When two contradictory approaches both work in AI agent development and how to navigate
Modular Architecture for Native macOS Apps: Frameworks, Actors, and File Provider
Building a native macOS app with file syncing and background services requires clean architecture from day one. Here's how to structure Swift frameworks, use actors for concurrency safety, and treat File Provider as a thin adapter.
When Scaffolding Becomes Architecture in AI Agent Code
Scaffolding you refuse to take down becomes architecture eventually. How temporary workarounds in AI agent codebases become permanent fixtures and what to
Vibecoded App with Claude Code
Vibecoding with CLAUDE.md architecture rules turns Claude Code from a code generator into a system-aware development partner. Here is how the approach works.
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.
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
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
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.
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
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.
Browse by Topic
How did this page land for you?
React to reveal totals
Comments (••)
Leave a comment to see what others are saying.Public and anonymous. No signup.