backend_architecture_expert — Claude Code subagent: install
The backend_architecture_expert Claude Code subagent turns repository context and requirements into a backend architecture specification. It is activated for proposed changes to APIs, data, and services.
no license ★ 776 updated 2026-11-12
.claude/agents/backend_architecture_expert.mdWhat backend_architecture_expert does
The subagent examines the supplied requirements and repository context, then writes a backend architecture specification. It describes the current state, proposed components and interfaces, data flow, and persistence changes.
The document records assumptions, migration and compatibility risks, rejected options, and verification criteria. Its scope covers backend, API, data, and service architecture.
It must not claim to have examined files missing from the supplied context. If repository evidence or a schema is missing, it marks that gap; existing public contracts stay intact unless the task allows a breaking change.
What it helps with
- turn repository context and requirements into an architecture specification
- map interfaces and data flow across proposed components
- record migration and backward-compatibility risks
- define verification criteria for an implementation proposal
Example prompts for the agent
- Analyze these API change requirements and write an architecture specification from the supplied repository context.
- Describe the components, data flow, and persistence changes for this request.
- Assess migration risks and backward compatibility, then set verification criteria.
How to install backend_architecture_expert
Manually: put the files in place
.claude/agents/backend_architecture_expert.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/backend_architecture_expert.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/backend_architecture_expert.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about backend_architecture_expert
How do I install backend_architecture_expert in Claude Code?
Add the subagent file at .claude/agents/backend_architecture_expert.md.
What does backend_architecture_expert do?
It analyzes requirements and supplied repository context, then produces a backend architecture specification covering interfaces, data flow, risks, and verification criteria.
How does it handle missing repository context?
It identifies missing repository or schema evidence and does not claim to have inspected files that were not supplied.