Architecture Guardian — Development agent for Claude Code
Use to verify MacMagazine module boundaries and system compliance are intact after adding/moving code or editing a Package.swift.
How to install Architecture Guardian
Installs to ~/.claude/agents/macmagazine-app-ios-architecture-guardian.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/MacMagazine/app-iOS/HEAD/.claude/agents/architecture-guardian.md -o ~/.claude/agents/macmagazine-app-ios-architecture-guardian.md Restart Claude Code, or start a new session, for it to be picked up.
What Architecture Guardian does
name: architecture-guardian description: Use to verify MacMagazine module boundaries and system compliance are intact after adding/moving code or editing a Package.swift. Detects cross-feature imports, wrong dependency direction, card-system bypasses, raw WKWebView usage, and unregistered SwiftData models. Read-only. tools: Read, Grep, Glob, Bash model: sonnet
You guard the MacMagazine architecture. Your only job: confirm structural rules hold. Read `.claude/rules/architecture.md` and `
Alternatives in Development
- Turbo Agent — Implements Turbo Drive, Turbo Frames, and Turbo Streams for fast, responsive Rails applications with minimal J 652 ★
- Mack — Automation Specialist 296 ★
- Python Sidecar Specialist — Use for the Python sidecars on both surfaces: the verify checks (syntax, imports, statement mapping, coverage 179 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Swift Code Reviewer
Use to review Swift/SwiftUI changes in MacMagazine with a very high bar — after implementing a feature, editin
Repotify Scanner Guardian
Use for any change under src/scan/ (line rules, shell reading, file rules, typosquatting) and to triage a repo
iOS Plan
Architecture and implementation planner for iOS/Swift work. Use before a multi-file feature, a migration, or a
Discover Critic
Blind adversarial critic for a candidate product direction — decomposes it into ranked falsifiable assumptions
Partition Adversary
Adversarial auditor for a proposed partition — of ideas, backlog phases, plan boundaries or any other set some
Angular Architecture Review
Read-only auditor for Angular component and service boundaries. Dispatch after implementing a feature to catch
Related Skills
Check Layers
Verify that the DDD layer boundaries are intact — domain never imports impl. Reports any violations.
Arch Boundaries
Install mechanically-enforced architecture boundaries that fail CI on spaghetti imports
Map
Map a route's component tree -- trace imports, detect boundaries, cache the result