SKILL.md
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/