$npx skillfedfor your agent

architecture-designer

Architecture Designer guides you through system design from requirements to documented decisions. It creates architecture diagrams, evaluates technology trade-offs, and produces Architecture Decision Records for key choices. Use it to structure microservices, plan scalability, and validate designs with stakeholders.

Architecture Designer helps you design new system architecture by creating diagrams and documenting decisions with ADRs.

AI-generated summary based on this skill's SKILL.md

★ 10,759  984 MITupdated by Jeffallan

Decision gist · record as of 2026-05-20

Architecture Designer helps you design new system architecture by creating diagrams and documenting decisions with ADRs. Architecture Designer guides you through system design from requirements to documented decisions. It creates architecture diagrams, evaluates technology trade-offs, and produces Architecture Decision Records for key choices. Use it to structure microservices, plan scalability, and validate designs with stakeholders.

manual: git clone https://github.com/Jeffallan/claude-skills → cp -r claude-skills/skills/architecture-designer ~/.claude/skills/architecture-designer
skills/architecture-designer/SKILL.md · version a01de6c1

Use it when

  • Architecture Designer supports creating Architecture Decision Records (ADRs) to document your architectural choices.
  • Yes.

Verify before relying

Read SKILL.md below before installing (6 files). Open directory: indexed for reading, not audited.

Same gist for agents: .md · .json

Install

Jeffallan/claude-skills/architecture-designer · repository language: Python

Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.

Frequently asked questions

AI-generated answers based on this skill's SKILL.md and metadata

What can Architecture Designer help me design system architecture for?

Architecture Designer guides you through comprehensive system design from initial requirements to fully documented decisions. It helps you create high-level architecture diagrams, evaluate technology trade-offs between approaches like microservices versus monolith, structure component interactions, and plan system scalability. The skill produces Architecture Decision Records (ADRs) for key choices and validates designs with stakeholders.

How do I write an ADR for a technical decision using this skill?

Architecture Designer supports creating Architecture Decision Records (ADRs) to document your architectural choices. The skill provides templates and guidance for structuring ADRs that capture the context, decision rationale, and consequences of major technical choices. This ensures your architectural decisions are recorded systematically and can be reviewed by team members.

Can Architecture Designer help evaluate microservices vs monolith approaches?

Yes. Architecture Designer specializes in evaluating technology trade-offs and architectural pattern alternatives. It helps you analyze microservices versus monolith architectures by examining trade-offs in scalability, complexity, deployment, and team structure. The skill guides you through systematic comparison to select the pattern best suited to your system requirements.

How does Architecture Designer support system scalability planning?

Architecture Designer assists with planning system scalability by helping you design component interactions and infrastructure patterns that support growth. It guides you through identifying bottlenecks, planning load distribution, and selecting architectural patterns that enable your system to scale effectively as demands increase.

What does Architecture Designer provide for reviewing existing systems?

Architecture Designer can review your existing architecture and identify improvements. It analyzes current system design, evaluates whether architectural patterns remain appropriate, and suggests enhancements to address scalability, maintainability, or performance concerns. This helps you evolve systems incrementally with documented rationale.

Is Architecture Designer open source and what license does it use?

Architecture Designer is released under the MIT license, making it open source and freely available for commercial and personal use with minimal restrictions.

SKILL.md

Rendered from the published skill. Quoted content, verbatim.

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,

(truncated - see the full file via the links below)

File tree — 6 files
skills/architecture-designer/SKILL.md
skills/architecture-designer/references/adr-template.md
skills/architecture-designer/references/architecture-patterns.md
skills/architecture-designer/references/database-selection.md
skills/architecture-designer/references/nfr-checklist.md
skills/architecture-designer/references/system-design.md

Let your AI agent find skills like this

Example. Real query, live index.

You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.

wish › “Design new high-level system architecture with diagrams and documented decisions”

Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →

Related skills

senior-architect
by Pixel-Process-UG · Pixel-Process-UG/superkit-agents

Senior Architect guides system design through structured phases: requirements analysis, architecture evaluation, and decision documentation. It produces Architecture Decision Records, trade-off analyses, and scalability blueprints grounded in proven patterns.

MITupdated Mar 2026
★ 1repo stars
architecture
by josavicentevw · josavicentevw/ai-agent-skills

Architecture guides you through designing complete system architectures—from monolithic and microservices to event-driven and serverless approaches. It covers design patterns, quality attributes like performance and security, technology selection, and provides frameworks for documenting architectural decisions. Use it to evaluate trade-offs, plan scalability, and ensure your systems are maintainable and resilient.

MITupdated Feb 2026
★ 1repo stars
microservices-architect
by Jeffallan · Jeffallan/claude-skills

This skill guides architects through building cloud-native microservices systems from the ground up. It covers domain-driven service decomposition, communication pattern selection, data ownership strategies, resilience implementation, and observability setup—with concrete code examples for correlation IDs, circuit breakers, sagas, and Kubernetes probes.

MITupdated May 2026
★ 10,759repo stars
Adr Architecture
by lyndonkl · lyndonkl/claude

Adr Architecture guides you through capturing significant technical decisions with full reasoning. It structures documentation around context, chosen solution, alternatives weighed, and consequences understood—creating a searchable record of why decisions were made.

no license declared → metadata onlyupdated Jul 2026
★ 135repo stars
Architecture Decision
by jwynia · jwynia/agent-skills

Architecture Decision helps you systematically evaluate design choices, document trade-offs, and select appropriate patterns for your context. It provides frameworks for creating Architecture Decision Records, assessing technical debt, and balancing quality attributes like performance, scalability, and maintainability.

no license declared → metadata onlyupdated Feb 2026
★ 124repo stars
architecture-decision
by softspark · softspark/ai-toolkit

This skill structures architecture decisions by enforcing a rigorous trade-off analysis: context, constraints, at least three viable options, and explicit consequences. It produces formal decision records (ADR/RFC/RFD) that capture both positive and negative outcomes, ensuring decisions remain auditable and reversible.

Apache-2.0updated Jul 2026
★ 161repo stars

More skills architecture-decision-record (MIT) · architecture-selection (MIT) · software-architecture-design (MIT) · architecting-security (MIT) · documentation-and-adrs (MIT) · documentation-criteria (MIT) · write-adr (Apache-2.0)

Tags
system-designarchitectural-patternsdecision-documentationtechnology-evaluationdistributed-systemsscalability-planninginfrastructure-designtrade-off-analysisdesign-reviewenterprise-architecture