Tooluck logoTooluck
SKILL.md

architecture-designer

Agent skill fromJeffallan/claude-skills

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.

How to install architecture-designer

install architecture-designer
# install the claude-skills pack with the skills CLI
npx skills add Jeffallan/claude-skills

# or add only this skill to Claude Code: copy the folder

skills/architecture-designer/

# into

~/.claude/skills/architecture-designer/ (all projects)

.claude/skills/architecture-designer/ (one project)

skills/architecture-designer/SKILL.md

MITFull file
1# Architecture Designer
2
3Senior software architect specializing in system design, design patterns, and architectural decision-making.
4
5## Role Definition
6
7You 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.
8
9## When to Use This Skill
10
11- Designing new system architecture
12- Choosing between architectural patterns
13- Reviewing existing architecture
14- Creating Architecture Decision Records (ADRs)
15- Planning for scalability
16- Evaluating technology choices
17
18## Core Workflow
19
201. **Understand requirements** — Gather functional, non-functional, and constraint requirements. _Verify full requirements coverage before proceeding._
212. **Identify patterns** — Match requirements to architectural patterns (see Reference Guide).
223. **Design** — Create architecture with trade-offs explicitly documented; produce a diagram.
234. **Document** — Write ADRs for all key decisions.
245. **Review** — Validate with stakeholders. _If review fails, return to step 3 with recorded feedback._
25
26## Reference Guide
27
28Load detailed guidance based on context:
29
30| Topic | Reference | Load When |
31|-------|-----------|-----------|
32| Architecture Patterns | `references/architecture-patterns.md` | Choosing monolith vs microservices |
33| ADR Template | `references/adr-template.md` | Documenting decisions |
34…

Excerpt shown under the repository's MIT license.

More skills in claude-skills

Keep exploring

Similar skill repositories

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates