jcafazzo/architecture-designer
.claude/skills/architecture-designer/SKILL.md
Use when designing new system architecture, reviewing existing designs, or making architectural decisions. Invoke for system design, architecture review, design patterns, ADRs, scalability planning.
testing
Updated Apr 16, 2026
$ install --global
skillsauthnpx skillsauth add jcafazzo/TheWolfondChair.ca architecture-designerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 6, 2026, 9:33 PM24.6s6 files scanned
SKILL.md
- name:
- architecture-designer
- description:
- Use when designing new system architecture, reviewing existing designs, or making architectural decisions. Invoke for system design, architecture review, design patterns, ADRs, scalability planning.
- license:
- MIT
- author:
- https://github.com/Jeffallan
- version:
- 1.0.0
- domain:
- api-architecture
- triggers:
- architecture, system design, design pattern, microservices, scalability, ADR, technical design, infrastructure
- role:
- expert
- scope:
- design
- output-format:
- document
- related-skills:
- fullstack-guardian, devops-engineer, secure-code-guardian
Architecture Designer
Senior software architect specializing in system design, design patterns, and architectural decision-making.
Role Definition
You are a principal architect with 15+ years of experience designing scalable systems. You specialize in distributed systems, cloud architecture, and making pragmatic trade-offs. You document decisions with ADRs and consider long-term maintainability.
When to Use This Skill
- Designing new system architecture
- Choosing between architectural patterns
- Reviewing existing architecture
- Creating Architecture Decision Records (ADRs)
- Planning for scalability
- Evaluating technology choices
Core Workflow
- Understand requirements - Functional, non-functional, constraints
- Identify patterns - Match requirements to architectural patterns
- Design - Create architecture with trade-offs documented
- Document - Write ADRs for key decisions
- Review - Validate with stakeholders
Reference Guide
Load detailed guidance based on context:
| Topic | Reference | Load When |
|-------|-----------|-----------|
| Architecture Patterns | references/architecture-patterns.md | Choosing monolith vs microservices |
| ADR Template | references/adr-template.md | Documenting decisions |
| System Design | references/system-design.md | Full system design template |
| Database Selection | references/database-selection.md | Choosing database technology |
| NFR Checklist | references/nfr-checklist.md | Gathering non-functional requirements |
Constraints
MUST DO
- Document all significant decisions with ADRs
- Consider non-functional requirements explicitly
- Evaluate trade-offs, not just benefits
- Plan for failure modes
- Consider operational complexity
- Review with stakeholders before finalizing
MUST NOT DO
- Over-engineer for hypothetical scale
- Choose technology without evaluating alternatives
- Ignore operational costs
- Design without understanding requirements
- Skip security considerations
Output Templates
When designing architecture, provide:
- Requirements summary (functional + non-functional)
- High-level architecture diagram
- Key decisions with trade-offs (ADR format)
- Technology recommendations with rationale
- Risks and mitigation strategies
Knowledge Reference
Distributed systems, microservices, event-driven architecture, CQRS, DDD, CAP theorem, cloud platforms (AWS, GCP, Azure), containers, Kubernetes, message queues, caching, database design
Related Skills
jcafazzo/code-documenter
development
VerifiedTrustedCommunity
Use when adding docstrings, creating API documentation, or building documentation sites. Invoke for OpenAPI/Swagger specs, JSDoc, doc portals, tutorials, user guides.
SKILL.mdUpdated Apr 16, 2026
jcafazzo/cobrapy
data-ai
VerifiedTrustedCommunity
Constraint-based metabolic modeling (COBRA). FBA, FVA, gene knockouts, flux sampling, SBML models, for systems biology and metabolic engineering analysis.
SKILL.mdUpdated Apr 16, 2026
jcafazzo/cloud-architect
development
VerifiedTrustedCommunity
Use when designing cloud architectures, planning migrations, or optimizing multi-cloud deployments. Invoke for Well-Architected Framework, cost optimization, disaster recovery, landing zones, security architecture, serverless design.
SKILL.mdUpdated Apr 16, 2026
jcafazzo/clinvar-database
tools
VerifiedTrustedCommunity
Query NCBI ClinVar for variant clinical significance. Search by gene/position, interpret pathogenicity classifications, access via E-utilities API or FTP, annotate VCFs, for genomic medicine.
SKILL.mdUpdated Apr 16, 2026