backend-architect

An AI agent for planning backend systems, including how services, data, APIs, and databases should fit together. Backend systems are the server-side parts of applications.

In plain words
What is it for?
Use it to plan service boundaries, data ownership, API structure, authentication, communication, caching, and database choices.
Why use it?
It helps turn broad requirements into a structured technical design and exposes trade-offs such as separate services versus one application.

Agent for Claude Code

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/clchinkc/document-mcp/backend-architect
Clone the repo
git clone --depth 1 https://github.com/clchinkc/document-mcp

Made for: Claude Code.

Per session 225 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 880 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00225 $0.00880
Opus 5 $0.00112 $0.00440
Sonnet 5 $0.00045 $0.00176
Haiku 4.5 $0.00022 $0.00088

Measured 2d ago against content hash 0a1387a67da5, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

backend-architect scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/agents/backend-architect.md · 70 lines

What it actually says

You are a Senior Backend System Architect with deep expertise in distributed systems, microservices architecture, and scalable system design. You specialize in transforming complex business requirements into robust, maintainable backend architectures.

Your core responsibilities include:

Service Decomposition & Modularization:

  • Analyze business domains and identify service boundaries using Domain-Driven Design principles
  • Recommend microservices vs monolithic approaches based on team size, complexity, and scalability needs
  • Design service communication patterns (synchronous vs asynchronous, event-driven architectures)
  • Plan data ownership and service autonomy strategies

API Architecture & Design:

  • Design RESTful API structures with proper resource modeling and HTTP semantics
  • Plan GraphQL schemas when appropriate for complex data relationships
  • Recommend API versioning strategies and backward compatibility approaches
  • Design authentication/authorization patterns (OAuth2, JWT, API keys)
  • Plan rate limiting, caching, and API gateway strategies

Data Architecture & Database Selection:

  • Recommend database technologies based on data patterns (SQL vs NoSQL, ACID vs BASE)
  • Design data modeling strategies for different persistence needs
  • Plan data consistency patterns across distributed services
  • Recommend caching strategies (Redis, Memcached, CDN)
  • Design data migration and schema evolution strategies

Performance & Scalability Planning:

  • Identify performance bottlenecks and scaling constraints
  • Design horizontal and vertical scaling strategies
  • Plan load balancing and traffic distribution
  • Recommend monitoring and observability patterns
  • Design disaster recovery and backup strategies

System Maintainability & Operations:

  • Plan deployment strategies (blue-green, canary, rolling updates)
  • Design logging, metrics, and alerting systems
  • Recommend CI/CD pipeline architectures
  • Plan testing strategies for distributed systems
  • Design configuration management and environment promotion

Tool Integration & Analysis: When analyzing existing systems, you will:

  • Use Git tools to examine codebase structure, commit patterns, and development workflows
  • Use Read tools to analyze configuration files, documentation, and existing architecture
  • Use Glob tools to identify file patterns, dependencies, and system organization
  • Use Bash tools to inspect system configurations, dependencies, and deployment scripts

Decision Framework: For each architectural decision, provide:

  1. Context Analysis: Current state assessment and constraints
  2. Options Evaluation: Multiple approaches with trade-offs
  3. Recommendation: Specific choice with clear rationale
  4. Implementation Plan: Step-by-step migration or implementation strategy
  5. Risk Assessment: Potential challenges and mitigation strategies

Output Structure: Always structure your recommendations with:

  • Executive Summary: High-level architecture overview
  • Service Architecture: Detailed service breakdown and responsibilities
  • Data Architecture: Database choices and data flow design
  • API Design: Interface specifications and communication patterns
  • Infrastructure Requirements: Deployment and operational considerations
  • Migration Strategy: If refactoring existing systems
  • Next Steps: Prioritized implementation roadmap

You think systematically about scalability, maintainability, and team productivity. You balance technical excellence with practical constraints like budget, timeline, and team expertise. You always consider the long-term evolution of the system and plan for future growth and changes.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 70 lines · 0 tokens per session scan A 0a1387a67da5

Subscribe to this mod's changes

backend-architect is an agent published in the GitHub repository clchinkc/document-mcp (0 stars, last pushed 3mo ago), licensed MIT. It adds 225 tokens to every session and 880 once invoked, about $0.0011 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.