# architecture-designer

> Claude/Codex skill by [@jeffallan](https://omgskills.com/library/jeffallan/index.md) · 12k stars · Updated 2026-10-30

Use when designing new high-level system architecture, reviewing existing designs, or making architectural decisions. Invoke to create architecture diagrams, write Architecture Decision Records (ADRs), evaluate technology trade-offs, design component interactions, and plan for scalability. Use for system design, architecture review, microservices structuring, ADR authoring, scalability planning, and infrastructure pattern selection — distinct from code-level design patterns or database-only design tasks.

Tags: ai-agents, claude, claude-code, claude-marketplace, claude-skills

## Install

```sh
git clone https://github.com/Jeffallan/claude-skills /tmp/claude-skills && ln -s /tmp/claude-skills/skills/architecture-designer ~/.claude/skills/architecture-designer
```

## From README

Architecture Designer Senior software architect specializing in system design, design patterns, and architectural decision-making. Role Definition You are a principal architect with 15+ years of experience designing scalable, distributed systems. You make pragmatic trade-offs, document decisions with ADRs, and prioritize long-term maintainability. When to Use This Skill Designing new system architecture Choosing between architectural patterns Reviewing existing architecture Creating Architecture Decision Records (ADRs) Planning for scalability Evaluating technology choices Core Workflow Understand requirements — Gather functional, non-functional, and constraint requirements. Verify full requirements coverage before proceeding. Identify patterns — Match requirements to architectural patterns (see Reference Guide). Design — Create architecture with trade-offs explicitly documented; produce a diagram. Document — Write ADRs for all key decisions. Review — Validate with stakeholders.

## Links

- HTML page: https://omgskills.com/library/jeffallan/claude-skills/architecture-designer/
- GitHub: https://github.com/Jeffallan/claude-skills
- Author: [@jeffallan](https://omgskills.com/library/jeffallan/index.md)

## More from this repo

- [api-designer](https://omgskills.com/library/jeffallan/claude-skills/api-designer/index.md) — Used when designing REST or GraphQL APIs, creating OpenAPI specifications, or planning API architecture.
   - [@jeffallan](https://omgskills.com/library/jeffallan/index.md) · 12k stars
- [atlassian-mcp](https://omgskills.com/library/jeffallan/claude-skills/atlassian-mcp/index.md) — Integrates with Atlassian products to manage project tracking and documentation via MCP protocol.
   - [@jeffallan](https://omgskills.com/library/jeffallan/index.md) · 12k stars
- [chaos-engineer](https://omgskills.com/library/jeffallan/claude-skills/chaos-engineer/index.md) — Designs chaos experiments, creates failure injection frameworks, and facilitates game day exercises for distributed...
   - [@jeffallan](https://omgskills.com/library/jeffallan/index.md) · 12k stars