Senior Architect
Run packaged Python scripts to generate architecture diagrams, analyze project structure, and map dependencies before committing to a build approach.
Overview
senior-architect is an agent skill most often used in Validate (also Build backend, Ship review) that runs three Python tools to diagram systems, architect projects, and analyze dependencies.
Install
npx skills add https://github.com/sickn33/antigravity-awesome-skills --skill senior-architectWhat is this skill?
- 3 core capabilities: Architecture Diagram Generator, Project Architect, Dependency Analyzer
- Python scripts with scaffolding templates and built-in quality checks
- Project Architect mode adds performance metrics, recommendations, and optional automated fixes
- Dependency Analyzer supports custom configurations and integration-ready output
- Community skill marked critical risk—treat script execution as privileged
- 3 automated script capabilities: diagram generator, project architect, dependency analyzer
Adoption & trust: 1.7k installs on skills.sh; 40.1k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You are about to code against a growing repo without a shared picture of components, boundaries, or dependency hotspots.
Who is it for?
Solo builders formalizing system design and dependency maps with scriptable outputs instead of one-off whiteboard explanations.
Skip if: Beginners who only need a single-file app with no integration surface, or teams that already maintain authoritative architecture docs in a governed portal.
When should I use this skill?
You need architecture diagrams, deep project structure analysis, or dependency reports from local Python scripts.
What do I get? / Deliverables
You get generated architecture diagrams, structured project analysis with recommendations, and dependency reports you can attach to scope docs before implementation.
- Architecture diagram artifacts from generator script
- Project analysis report with metrics and recommendations
- Dependency analysis output suitable for integration planning
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Architecture and dependency clarity belong on the Validate shelf first because solo builders need scope and structural decisions locked before heavy implementation spend. Scope subphase captures diagram generation, project architect analysis, and dependency analyzer runs that define boundaries and integration surfaces.
Where it fits
Run architecture_diagram_generator.py on a prototype repo before committing to service boundaries.
Use project_architect.py --verbose after adding modules to catch layering drift early.
Re-run dependency_analyzer.py before release to document coupling introduced in the last sprint.
How it compares
Use as a scripted architecture pass instead of unstructured LLM diagram chatter that is not tied to your repository paths.
Common Questions / FAQ
Who is senior-architect for?
Indie developers and small teams who want terminal-driven architecture diagrams, repo analysis, and dependency insights packaged as runnable Python scripts.
When should I use senior-architect?
At Validate scope before choosing services and modules, during Build backend when restructuring packages, and at Ship review when checking whether dependencies still match the intended design.
Is senior-architect safe to install?
The skill declares critical risk and runs local Python with analysis and possible automated fixes—review the Security Audits panel on this page and inspect scripts before executing on sensitive codebases.
SKILL.md
READMESKILL.md - Senior Architect
# 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: ```bash # 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:** ```bash 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:** ```bash 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:** ```bash 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 ```bash # Install dependencies npm install # or pip install -r requirements.txt # Configure environment cp .env.example .env ``` ### 2. Run Quality Checks ```bash # 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 ```bash # 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 documentat