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
npx skills add borghei/Claude-Skills --skill senior-architect -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/senior-architect/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/senior-architect/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill senior-architect -a codex2Manually: put the files in place
.agents/skills/senior-architect/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill senior-architect -a cursor2Manually: put the files in place
.cursor/skills/senior-architect/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install borghei/Claude-Skills engineering/senior-architect/SKILL.md2Manually: put the files in place
.github/skills/senior-architect/SKILL.md1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill senior-architect -a gemini-cli2Platform CLI
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/senior-architectManually: put the files in place
.devin/skills/senior-architect/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill senior-architect -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.