Senior Architect

1---
2name: senior-architect
3description: Comprehensive software architecture skill for designing scalable, maintainable systems using ReactJS, NextJS, NodeJS, Express, React Native, Swift, Kotlin, Flutter, Postgres, GraphQL, Go, Python. Includes architecture diagram generation, system design patterns, tech stack decision frameworks, and dependency analysis. Use when designing system architecture, making technical decisions, creating architecture diagrams, evaluating trade-offs, or defining integration patterns.
4---
5 
6# Senior Architect
7 
8Complete toolkit for senior architect with modern tools and best practices.
9 
10## Quick Start
11 
12### Main Capabilities
13 
14This skill provides three core capabilities through automated scripts:
15 
16```bash
17# Script 1: Architecture Diagram Generator
18python scripts/architecture_diagram_generator.py [options]
19 
20# Script 2: Project Architect
21python scripts/project_architect.py [options]
22 
23# Script 3: Dependency Analyzer
24python scripts/dependency_analyzer.py [options]
25```
26 
27## Core Capabilities
28 
29### 1. Architecture Diagram Generator
30 
31Automated tool for architecture diagram generator tasks.
32 
33**Features:**
34- Automated scaffolding
35- Best practices built-in
36- Configurable templates
37- Quality checks
38 
39**Usage:**
40```bash
41python scripts/architecture_diagram_generator.py <project-path> [options]
42```
43 
44### 2. Project Architect
45 
46Comprehensive analysis and optimization tool.
47 
48**Features:**
49- Deep analysis
50- Performance metrics
51- Recommendations
52- Automated fixes
53 
54**Usage:**
55```bash
56python scripts/project_architect.py <target-path> [--verbose]
57```
58 
59### 3. Dependency Analyzer
60 
61Advanced tooling for specialized tasks.
62 
63**Features:**
64- Expert-level automation
65- Custom configurations
66- Integration ready
67- Production-grade output
68 
69**Usage:**
70```bash
71python scripts/dependency_analyzer.py [arguments] [options]
72```
73 
74## Reference Documentation
75 
76### Architecture Patterns
77 
78Comprehensive guide available in `references/architecture_patterns.md`:
79 
80- Detailed patterns and practices
81- Code examples
82- Best practices
83- Anti-patterns to avoid
84- Real-world scenarios
85 
86### System Design Workflows
87 
88Complete workflow documentation in `references/system_design_workflows.md`:
89 
90- Step-by-step processes
91- Optimization strategies
92- Tool integrations
93- Performance tuning
94- Troubleshooting guide
95 
96### Tech Decision Guide
97 
98Technical reference guide in `references/tech_decision_guide.md`:
99 
100- Technology stack details
101- Configuration examples
102- Integration patterns
103- Security considerations
104- Scalability guidelines
105 
106## Tech Stack
107 
108**Languages:** TypeScript, JavaScript, Python, Go, Swift, Kotlin
109**Frontend:** React, Next.js, React Native, Flutter
110**Backend:** Node.js, Express, GraphQL, REST APIs
111**Database:** PostgreSQL, Prisma, NeonDB, Supabase
112**DevOps:** Docker, Kubernetes, Terraform, GitHub Actions, CircleCI
113**Cloud:** AWS, GCP, Azure
114 
115## Development Workflow
116 
117### 1. Setup and Configuration
118 
119```bash
120# Install dependencies
121npm install
122# or
123pip install -r requirements.txt
124 
125# Configure environment
126cp .env.example .env
127```
128 
129### 2. Run Quality Checks
130 
131```bash
132# Use the analyzer script
133python scripts/project_architect.py .
134 
135# Review recommendations
136# Apply fixes
137```
138 
139### 3. Implement Best Practices
140 
141Follow the patterns and practices documented in:
142- `references/architecture_patterns.md`
143- `references/system_design_workflows.md`
144- `references/tech_decision_guide.md`
145 
146## Best Practices Summary
147 
148### Code Quality
149- Follow established patterns
150- Write comprehensive tests
151- Document decisions
152- Review regularly
153 
154### Performance
155- Measure before optimizing
156- Use appropriate caching
157- Optimize critical paths
158- Monitor in production
159 
160### Security
161- Validate all inputs
162- Use parameterized queries
163- Implement proper authentication
164- Keep dependencies updated
165 
166### Maintainability
167- Write clear code
168- Use consistent naming
169- Add helpful comments
170- Keep it simple
171 
172## Common Commands
173 
174```bash
175# Development
176npm run dev
177npm run build
178npm run test
179npm run lint
180 
181# Analysis
182python scripts/project_architect.py .
183python scripts/dependency_analyzer.py --analyze
184 
185# Deployment
186docker build -t app:latest .
187docker-compose up -d
188kubectl apply -f k8s/
189```
190 
191## Troubleshooting
192 
193### Common Issues
194 
195Check the comprehensive troubleshooting section in `references/tech_decision_guide.md`.
196 
197### Getting Help
198 
199- Review reference documentation
200- Check script output messages
201- Consult tech stack documentation
202- Review error logs
203 
204## Resources
205 
206- Pattern Reference: `references/architecture_patterns.md`
207- Workflow Guide: `references/system_design_workflows.md`
208- Technical Guide: `references/tech_decision_guide.md`
209- Tool Scripts: `scripts/` directory
210