Architecture Brief
Write concise executive summaries of architecture. Communicate decisions and tradeoffs to non-technical stakeholders. Use when presenting to leadership or documenting decisions.
Install
/plugin marketplace add sethdford/claude-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add sethdford/claude-skills --skill architecture-briefgit clone --depth 1 https://github.com/sethdford/claude-skills.git /tmp/claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills/architect/communication/skills/architecture-brief ~/.claude/skills/architecture-briefPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Architecture Brief Create concise, executive-friendly summaries of architecture decisions and tradeoffs. ## Context You are writing architecture briefs for diverse audiences (executives, product, non-technical stakeholders). Explain decisions in business terms, not technical jargon. Emphasize impact on cost, speed, reliability. ## Domain Context Based on effective technical communication: - **Business Impact**: How does architecture choice affect time-to-market, cost, reliability? Quantify where possible. - **Trade-offs**: Every architecture choice sacrifices something. Explicitly state: "We chose X over Y because Z matters more." - **Risk Acknowledgment**: What could go wrong? Residual risks accepted. Mitigation plans for critical risks. - **Assumptions**: What's true about our context that makes this choice right? Different context, different choice. ## Instructions 1. **One-Pager Structure**: - Title: "API Gateway Architecture for Microservices" - Problem: "Multiple services exposing APIs; no unified interface, inconsistent auth, no rate limiting" - Decision: "Implement API Gateway (Kong/AWS API Gateway)" - Rationale: "Centralizes auth, rate limiting, routing; 2-week implementation" - Trade-off: "Extra hop in request path (5ms latency); operational overhead of new service" - Success Metrics: "Consistent error responses, 99.9% uptime, < 50ms latency" - Risks: "Gateway becomes bottleneck (mitigation: auto-scaling, load testing)"
Details
- Skill name
architecture-brief- Repository
- sethdford/claude-skills
- Path
architect/communication/skills/architecture-brief/SKILL.md- License
- MIT
- Repo updated
- 11 March 2026
FAQ
What does the Architecture Brief skill do?
Write concise executive summaries of architecture. Communicate decisions and tradeoffs to non-technical stakeholders. Use when presenting to leadership or documenting decisions.
How do I install the Architecture Brief skill?
Claude Code plugin: /plugin marketplace add sethdford/claude-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Architecture Brief popular?
It lives in sethdford/claude-skills, which has 48 GitHub stars and 10 forks.
Related skills
A B Test Design
48sethdford/claude-skills
Design rigorous A/B tests with hypotheses, variants, metrics, and sample size calculations.
A B Test Design Pm
48sethdford/claude-skills
Analytics and experimentation skill for product managers.
Abuse Case Design
48sethdford/claude-skills
Design abuse cases (negative use cases) showing how attackers misuse system features. Use when identifying attacks that exploit intended functionality or business logic flaws.
Architecture Decision Record
48sethdford/claude-skills
Document architectural decisions using ADR format. Use when making significant architectural choices that affect future development.
Architecture Anti Patterns
48sethdford/claude-skills
Identify and avoid common architectural mistakes. Recognize patterns of failure. Use when reviewing designs or learning from mistakes.
Architecture Kata
48sethdford/claude-skills
Practice architectural design with structured problems. Time-limited design challenges. Use for skill development, interviews, team exercises.
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.