Skills · SkillBackend & APIsEveryday codingPlanning & specsReviewed

architecture

Creates or evaluates an architecture decision record: technology choices, trade-offs and consequences, or review of a design proposal.

View on GitHub

Kind: Skill
Works with: Claude Code
Source: Claude knowledge-work plugins @ 2574e29377c7
Path: engineering/skills/architecture/SKILL.md
Jobs: Planning, Documentation
Topics: Planning & specs

Credit

Made by: anthropics
Original: github.com/anthropics/knowledge-work-plugins/blob/2574e29377c…
License: Apache-2.0

Listed by Skill Manifest; not made by us.

InstallInstall it from a plugin marketplace.

claude plugin install engineering@knowledge-work-plugins

Install factsScanned 2 Nov 2026

Adds: .claude/skills/architecture/ (the skill folder)
1 file(s) the skill refers to
Runs scripts: None found
Uses the network: None found
Needs secrets: None found
Source revision: 2574e29377c7
Licence: Apache-2.0
Last activity: 1 Nov 2026
Review: Reviewed

Found by a static scan of the stored text; nothing is run. “None found” is not a guarantee, so read what you install before you run it.

Only the main file is read; other files in the folder are not scanned

# /architecture

> If you see unfamiliar placeholders or need to check which tools are connected, see [CONNECTORS.md](../../CONNECTORS.md).

Create an Architecture Decision Record (ADR) or evaluate a system design.

## Usage

```
/architecture $ARGUMENTS
```

## Modes

**Create an ADR**: "Should we use Kafka or SQS for our event bus?"
**Evaluate a design**: "Review this microservices proposal"
**System design**: "Design the notification system for our app"

See the **system-design** skill for detailed frameworks on requirements gathering, scalability analysis, and trade-off evaluation.

## Output — ADR Format

```markdown
# ADR-[number]: [Title]

**Status:** Proposed | Accepted | Deprecated | Superseded
**Date:** [Date]
**Deciders:** [Who needs to sign off]

## Context
[What is the situation? What forces are at play?]

## Decision
[What is the change we're proposing?]

## Options Considered

### Option A: [Name]
| Dimension | Assessment |
|-----------|------------|
| Complexity | [Low/Med/High] |
| Cost | [Assessment] |
| Scalability | [Assessment] |
| Team familiarity | [Assessment] |

**Pros:** [List]
**Cons:** [List]

### Option B: [Name]
[Same format]

## Trade-off Analysis
…