Skip to main content
skill CX Codex

senior-architect · borghei — Claude Code skill: architecture decisions and ADR

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.

LicenseRef-MIT-Commons-Clause 244 installs ★ 1,183 updated 2026-11-08

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add borghei/Claude-Skills --skill senior-architect -a claude-code
Open on GitHub

What senior-architect 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.

What it helps with

  • 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 for the agent

  • 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

How to install senior-architect

1Skills CLI (Vercel)

npx skills add borghei/Claude-Skills --skill senior-architect -a claude-code

2Manually: put the files in place

~/.claude/skills/senior-architect/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/senior-architect/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about senior-architect

How do I install senior-architect in Claude Code?

Run npx skills add borghei/Claude-Skills --skill senior-architect -a claude-code, then open ~/.claude/skills/senior-architect/SKILL.md. For Codex, Cursor, GitHub Copilot, Gemini CLI, or OpenCode, use the same command with the appropriate -a flag.

What does senior-architect do?

It helps design system architecture and record decisions as ADRs. Analyzes code coupling and cycles, detects architecture patterns and layer violations, generates diagrams, and guides selections between databases and patterns.

Which languages and package managers does the dependency analyzer support?

npm, pip, Poetry, Go modules, and Cargo. The tool scans the project, finds circular dependencies, and scores coupling (0–100); exit code 1 means cycles were found or coupling exceeds 70.

Similar skills

All skills for Backend and APIs →

senior-architect by other authors comes first.

senior-architect sickn33 senior-architect — a skill for designing and reviewing system architecture based on explicit requirements, tradeoffs and evidence. Helps you choose an approach by examining current state, alternatives and risks. CX Codex +1 2,200installs senior-architect Alireza Rezvani senior-architect — a Claude Code skill that helps make technical decisions: database selection, monolith vs microservices, architecture diagrams. It inspects project structure and returns diagrams in Mermaid, PlantUML, or ASCII. CX Codex +1 1,494installs architect-reviewer VoltAgent Community architect-reviewer evaluates system design decisions, architecture patterns, and tech stack choices at a macro level. Useful before large-scale refactoring or when designing new service boundaries. CX Codex 743installs architecture-designer https://github.com/Jeffallan architecture-designer designs distributed system architectures, creates Mermaid diagrams, and writes Architecture Decision Records. It helps balance trade-offs before writing service code. CX Codex +1 8,500installs architect-review rmyndharis architect-review — a skill for Claude Code, Codex, Cursor, and other tools. Evaluates system architecture, scalability impacts, and distributed design patterns during major refactoring. CX Codex +1 154installs Senior Cloud Architect official github Senior Cloud Architect designs system architecture, details non-functional requirements, and renders Mermaid diagrams without writing code. CX Codex +1 ★ 41,430repo stars architect josstei architect is a Claude Code subagent for system design, component boundaries, trade-off analysis, and stack evaluation before coding begins. CX Codex ★ 489repo stars systems-architect alirezarezvani The systems-architect subagent reviews system architecture, weighs design options, and helps document decisions. Use it when planning a system or reviewing an existing design. CX Codex ★ 788repo stars

From the same set120

The whole set →
agile-coach Agile coaching skill for Claude Code, Codex, and Cursor that guides framework adoption and team facilitation. Evaluates organizational maturity levels and tracks delivery metrics. CX Codex +1 270installs design-system-lead design-system-lead guides agents through building multi-tier design tokens, component architecture, and cross-platform export pipelines. CX Codex +1 262installs cmo-advisor cmo-advisor guides marketing strategy, demand generation, lead scoring, and revenue alignment. Use it when a plan needs clear inputs, channels, and metrics. CX Codex +1 261installs program-manager program-manager — a skill for Claude Code coordinates programs spanning multiple projects. It builds charters, maps dependencies, tracks benefits, and prepares steering updates. CX Codex +1 259installs self-improving-agent self-improving-agent — a skill for Claude Code, Codex, and Cursor that curates long-term agent memory. Converts repeated task outcomes into reviewed project rules. CX Codex +1 244installs seo-specialist The seo-specialist skill guides technical SEO audits, keyword research, and on-page improvements. Use it to investigate a site or review organic search performance. CX Codex +1 244installs senior-prompt-engineer senior-prompt-engineer — a skill for Claude Code that reviews prompt architecture, scores RAG quality, and diagrams agent workflows. Flags redundant instructions and missing output contracts during prompt tuning. CX Codex +1 239installs senior-qa senior-qa — a skill for Claude Code and five other platforms that structures test suites for React and Next.js apps. Scaffolds Jest unit tests, Playwright specs, and inspects coverage reports. CX Codex +1 232installs

Project sponsors

Companies that keep this analytics open