# senior-architect

senior-architect — a skill for designing systems and documenting architecture decisions as ADRs. Analyzes code coupling, generates diagrams, and guides choices between patterns, databases, and monolith versus microservices.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 244 installs · ★ 1183 repo stars
- Author: borghei
- License: LicenseRef-MIT-Commons-Clause · policy=link-only · description only; the file stays with the author
- Source: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/senior-architect/SKILL.md
- Updated: 2026-11-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/borghei-senior-architect

## What it does

Available on Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. Three built-in tools: a dependency analyzer detects cycles and scores coupling (0–100) across npm, pip, Poetry, Go, and Cargo; pattern detection identifies the current architecture from folder names and finds layer violations; a diagram generator produces component, layer, or deployment diagrams in Mermaid, PlantUML, or ASCII.

Follows one workflow: frame the decision (question, constraints, decision-maker), gather evidence from code using the tools, select an option from a matching workflow, and write an ADR from the template. Each workflow covers database selection, architecture pattern choice, or microservices migration. Tools emit data that the ADR then cites.

Does not replace cloud architecture (AWS, Azure, GCP skills do that), framework selection, or backend implementation.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill senior-architect -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/senior-architect/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/senior-architect/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill senior-architect -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/senior-architect/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill senior-architect -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/senior-architect/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install borghei/Claude-Skills engineering/senior-architect/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/senior-architect/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill senior-architect -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/senior-architect
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/senior-architect/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill senior-architect -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/senior-architect/SKILL.md

## When to use it
- Write an ADR for an architecture decision backed by code evidence
- Measure coupling and find circular dependencies in a codebase
- Choose between monolith and microservices based on team and data
- Detect the current architecture pattern and layer violations
- Generate a system diagram for documentation or team review

## Example prompts
- Analyze coupling in the project and identify circular dependencies
- Help me choose between SQL and NoSQL for this service
- Generate a component diagram of our system in Mermaid format

## Similar
- [architect-reviewer](https://affpapa.org/en/nevibecode/agents/architect-reviewer.md) — subagent · 743 installs
- [architecture-designer](https://affpapa.org/en/nevibecode/skills/architecture-designer.md) — skill · 8500 installs
- [architect-review](https://affpapa.org/en/nevibecode/skills/rmyndharis-architect-review.md) — skill · 154 installs
- [Senior Cloud Architect](https://affpapa.org/en/nevibecode/agents/senior-cloud-architect.md) — subagent · ★ 41430 repo stars
- [architect](https://affpapa.org/en/nevibecode/agents/josstei-architect.md) — subagent · ★ 489 repo stars
- [systems-architect](https://affpapa.org/en/nevibecode/agents/systems-architect.md) — subagent · ★ 788 repo stars

## Other versions with the same name
- [senior-architect · sickn33](https://affpapa.org/en/nevibecode/skills/sickn33-senior-architect.md) — 2200 installs
- [senior-architect · alirezarezvani](https://affpapa.org/en/nevibecode/skills/senior-architect.md) — 1494 installs

From the same set: [borghei/claude-skills](https://affpapa.org/en/nevibecode/by/borghei/claude-skills.md) — 120 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
