Spark
Sign In
Skill

Architect and Optimize Software Projects

Senior Architect skill provides three Python scripts-Architecture Diagram Generator, Project Architect analyzer, and Dependency Analyzer-plus reference docs

Get skill
Works with githubdockerkubernetesterraformreact
Antigravity
Maintainer?
46
Spark score
out of 100
Updated yesterday
Version 13.1.0
Add to Favorites

Why it matters

Automate the creation, analysis, and optimization of software architecture using modern tools and best practices. This skill provides scripts for generating diagrams, analyzing projects, and managing dependencies.

Outcomes

What it gets done

01

Generate architecture diagrams with configurable templates and quality checks.

02

Perform deep analysis of projects, providing performance metrics and automated fixes.

03

Analyze project dependencies with expert-level automation and custom configurations.

04

Implement best practices for code quality, performance, security, and maintainability.

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/ag-senior-architect | bash

Capabilities

What this skill does

Generate code

Writes source code or scripts from a description.

Review code

Analyzes code for bugs, style issues, and improvements.

Debug

Traces errors to their root cause and suggests fixes.

Deploy / CI

Runs build pipelines, tests, and deploys to environments.

Overview

Senior Architect

What it does

Three Python automation scripts for architecture diagram generation, project analysis with performance metrics and recommendations, and dependency analysis. Includes reference documentation files covering architecture patterns, system design workflows, and technical decision guides. Supports modern tech stacks including frontend frameworks, backend services, databases, DevOps tools, and cloud platforms.

How it connects

Use this skill when you need to generate architecture diagrams, analyze project structure and dependencies, or consult reference documentation for architecture patterns and system design workflows. Applicable when working with projects that use the supported tech stack and require automated quality checks, performance analysis, or best practice recommendations.

Source README

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

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.
  • Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.