Architecture Designer
Turns Claude into a senior architect that designs systems, weighs technology trade-offs, and writes ADRs.
Dev & CodingIntermediate★ 11,102⑂ 1,053AI score 9/10Last updated: Aug 7, 2026
What it does
Gives Claude a principal-architect persona plus a disciplined process for high-level system design.
- 5-step workflow: gather requirements → identify patterns → design with explicit trade-offs → document ADRs → stakeholder review (loop back on failure)
- Output template: requirements summary, Mermaid architecture diagram, ADR-formatted decisions, technology recommendations with rationale, risks and mitigations
- Context-loaded references: architecture patterns, ADR template, system design template, database selection, NFR checklist
- Guardrails: no over-engineering for hypothetical scale, no technology picks without evaluating alternatives, never skip security
Who it's for
- Backend/platform engineers designing a new service from scratch
- Tech leads evaluating a monolith-to-microservices move
- Teams that need decisions captured as ADRs
- Senior engineers preparing an architecture review
Examples
- "Design the backend architecture for an e-commerce system with order, payment, and notification services" → Mermaid diagram plus service boundaries and trade-offs
- "Write an ADR comparing PostgreSQL and DynamoDB for order storage" → full ADR with context, alternatives, consequences
- "Review our current monolith and flag scalability bottlenecks" → failure modes and mitigations mapped against the NFR checklist
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/Jeffallan/claude-skills/HEAD/skills/architecture-designer/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/architecture-designer folder from the GitHub repo Jeffallan/claude-skills into my ~/.claude/skills/architecture-designer/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/Jeffallan/claude-skills.git /tmp/claude-skills && mkdir -p ~/.claude/skills && cp -r /tmp/claude-skills/skills/architecture-designer ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repo:
git clone https://github.com/Jeffallan/claude-skills.git - Create the skills directory:
mkdir -p ~/.claude/skills - Copy the whole skill folder so the
references/files come along:cp -r claude-skills/skills/architecture-designer ~/.claude/skills/ - Restart Claude Code and confirm
architecture-designerappears in your skill list. - Try a prompt like "Design the architecture for a new payments system" to trigger it.
View source on GitHub ↗License: MIT