senior-architect
Provides a complete set of modern tools for software architects. Helps plan and build complex systems following current best practices.
What it does
This tool assists software architects in creating architecture diagrams, analyzing and optimizing projects, and understanding system dependencies. It uses automated scripts to apply best practices and improve code quality and performance.
When to use it
- ✓When starting a new software project to define its structure.
- ✓When an existing project needs optimization for better performance.
- ✓To understand how different parts of a system connect and depend on each other.
Example of what to ask your AI
“Generate an architecture diagram for a web application with a React frontend and Node.js backend.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
The tool runs scripts that automate tasks like generating diagrams, analyzing code, and checking dependencies. It follows architectural best practices and can even suggest fixes to optimize the project.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add sickn33/agentic-awesome-skills --skill senior-architectOr download just the file:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/senior-architect/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
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.mdreferences/system_design_workflows.mdreferences/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
When to Use
This skill is applicable to execute the workflow or actions described in the overview.
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
…
FAQ
What programming languages does the tool support?
It supports various languages like TypeScript, JavaScript, Python, Go, Swift, and Kotlin, along with popular frontend and backend frameworks.
Where can I find more details on architecture patterns?
You can consult the detailed guide in 'references/architecture_patterns.md', which includes code examples and recommended practices.
Can the tool fix problems automatically?
Yes, the 'Project Architect' tool can perform deep analysis and offer recommendations, including automated fixes to optimize performance.
Details
Original description by the author
Complete toolkit for senior architect with modern tools and best practices.
Popularity
- GitHub stars
- 48k
- Ranking position
- #4102
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
00-andruia-consultant
Helps your agent start or improve AI projects. It analyzes code, suggests tools, and creates action plans in Spanish.
sickn33/agentic-awesome-skills
007
Lets your agent perform security audits and threat modeling. It's useful for protecting projects against attacks and vulnerabilities.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Helps your agent create or improve AI tools. It defines how tools work, writes documentation, and validates the structure.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Lets your agent create a summary about a specific industry. It's useful for understanding the context, rules, usage patterns, and risks of a project, using reliable sources.
sickn33/agentic-awesome-skills
Similar skills
benchmark-optimization-loop
Has your agent improve something's speed in a measured way. It tests multiple versions and chooses the fastest one that still works correctly.
affaan-m/ECC
change-impact
Helps your agent analyze the impact of code changes before making them. It compares the planned vs. actual results afterward, covering paths, data, tests, and documentation. Useful for risky or system-wide changes.
affaan-m/ECC
click-path-audit
Lets your agent trace all user buttons and interactions to find bugs. It finds issues where functions seem to work alone but fail together. Useful when bugs persist even after debugging.
affaan-m/ECC