New to Claude Skills? Learn how to install them →

Get Claude Skills
davila7 on GitHub

Senior Architect

Free

Design scalable systems with best practices and automation.

by davila730.2k stars on davila7/claude-code-templates
Updated Aug 10, 2026
Get this skill

Free · Opens the source repo

What Senior Architect does

The Senior Architect skill is a comprehensive toolkit designed for software architects who need to create scalable and maintainable systems. It leverages modern frameworks and languages such as ReactJS, NextJS, NodeJS, Express, and more, providing a structured approach to system design. With a focus on best practices, this skill simplifies the complexities of architecture through automated scripts and detailed reference documentation.

At the core of this skill are three main scripts: the Architecture Diagram Generator, the Project Architect, and the Dependency Analyzer. The Architecture Diagram Generator automates the creation of architecture diagrams, ensuring that best practices are incorporated and quality checks are performed. The Project Architect script offers in-depth analysis and optimization recommendations, helping architects refine their projects based on performance metrics. Lastly, the Dependency Analyzer provides insights into project dependencies, enabling architects to make informed decisions about integrations and configurations.

This skill is particularly useful for senior developers and architects involved in system architecture design, technical decision-making, and evaluating trade-offs between different technologies. The included reference documents cover architecture patterns, system design workflows, and tech decision guides, offering a wealth of knowledge to support effective project execution. By utilizing this skill, architects can streamline their workflows and ensure that their systems are built on a solid foundation of best practices and informed choices.

When to use it

Use this skill when you need to design system architectures, make informed technical decisions, or generate architecture diagrams.

When not to use it

This skill may not be suitable for small projects or for teams that do not require extensive architectural analysis and documentation.

What you can build with it

Creating Architecture Diagrams

Use the Architecture Diagram Generator to quickly create visual representations of your system architecture, ensuring adherence to best practices.

Analyzing Project Dependencies

Utilize the Dependency Analyzer to assess and optimize project dependencies, helping to streamline integrations and improve system performance.

Optimizing System Design

Leverage the Project Architect to conduct deep analysis and receive recommendations for improving system architecture and performance.

How to install Senior Architect

View source

1. Install with the skills CLI

npx skills add davila7/claude-code-templates/senior-architect --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by davila7

Senior Architect

Complete toolkit for senior architect with modern tools and best practices.

Quick Start

Main Capabilities

This skill provides three core capabilities through automated scripts:

# Script 1: Architecture Diagram Generator
python scripts/architecture_diagram_generator.py [options]

# Script 2: Project Architect
python scripts/project_architect.py [options]

# Script 3: Dependency Analyzer
python scripts/dependency_analyzer.py [options]

Core Capabilities

1. Architecture Diagram Generator

Automated tool for architecture diagram generator tasks.

Features:

  • Automated scaffolding
  • Best practices built-in
  • Configurable templates
  • Quality checks

Usage:

python scripts/architecture_diagram_generator.py <project-path> [options]

2. Project Architect

Comprehensive analysis and optimization tool.

Features:

  • Deep analysis
  • Performance metrics
  • Recommendations
  • Automated fixes

Usage:

python scripts/project_architect.py <target-path> [--verbose]

3. Dependency Analyzer

Advanced tooling for specialized tasks.

Features:

  • Expert-level automation
  • Custom configurations
  • Integration ready
  • Production-grade output

Usage:

python scripts/dependency_analyzer.py [arguments] [options]

Reference Documentation

Architecture Patterns

Comprehensive guide available in references/architecture_patterns.md:

  • Detailed patterns and practices
  • Code examples
  • Best practices
  • Anti-patterns to avoid
  • Real-world scenarios

System Design Workflows

Complete workflow documentation in references/system_design_workflows.md:

  • Step-by-step processes
  • Optimization strategies
  • Tool integrations
  • Performance tuning
  • Troubleshooting guide

Tech Decision Guide

Technical reference guide in references/tech_decision_guide.md:

  • Technology stack details
  • Configuration examples
  • Integration patterns
  • Security considerations
  • Scalability guidelines

Tech Stack

Languages: TypeScript, JavaScript, Python, Go, Swift, Kotlin Frontend: React, Next.js, React Native, Flutter Backend: Node.js, Express, GraphQL, REST APIs Database: PostgreSQL, Prisma, NeonDB, Supabase DevOps: Docker, Kubernetes, Terraform, GitHub Actions, CircleCI Cloud: AWS, GCP, Azure

Development Workflow

1. Setup and Configuration

# Install dependencies
npm install
# or
pip install -r requirements.txt

# Configure environment
cp .env.example .env

2. Run Quality Checks

# Use the analyzer script
python scripts/project_architect.py .

# Review recommendations
# Apply fixes

3. Implement Best Practices

Follow the patterns and practices documented in:

  • references/architecture_patterns.md
  • references/system_design_workflows.md
  • references/tech_decision_guide.md

Best Practices Summary

Code Quality

  • Follow established patterns
  • Write comprehensive tests
  • Document decisions
  • Review regularly

Performance

  • Measure before optimizing
  • Use appropriate caching
  • Optimize critical paths
  • Monitor in production

Security

  • Validate all inputs
  • Use parameterized queries
  • Implement proper authentication
  • Keep dependencies updated

Maintainability

  • Write clear code
  • Use consistent naming
  • Add helpful comments
  • Keep it simple

Common Commands

# Development
npm run dev
npm run build
npm run test
npm run lint

# Analysis
python scripts/project_architect.py .
python scripts/dependency_analyzer.py --analyze

# Deployment
docker build -t app:latest .
docker-compose up -d
kubectl apply -f k8s/

Troubleshooting

Common Issues

Check the comprehensive troubleshooting section in references/tech_decision_guide.md.

Getting Help

  • Review reference documentation
  • Check script output messages
  • Consult tech stack documentation
  • Review error logs

Resources

  • Pattern Reference: references/architecture_patterns.md
  • Workflow Guide: references/system_design_workflows.md
  • Technical Guide: references/tech_decision_guide.md
  • Tool Scripts: scripts/ directory

Frequently asked questions about Senior Architect

Similar skills

Spring Boot Testing

Master testing techniques for Spring Boot 4 applications.

GitHub Issues

Manage GitHub issues efficiently with MCP tools.

Geofeed Tuner

Optimize your IP geolocation feeds in CSV format.

Batch Files

Master Windows batch scripting for automation and task management.

Adobe Illustrator Scripting

Automate your Illustrator workflows with ExtendScript.

Plugin Structure

Create and organize Claude Code plugins effectively.