architecture-skill_skill

Overview

This skill delivers an end-to-end system architecture design and implementation workflow that maps business goals to implementation-ready technical specifications. It coordinates multiple architectural perspectives—system, backend, frontend, DevOps, and security—to produce scalable, secure, and maintainable designs. Outputs include architecture packages, diagrams, decision logs, and phased implementation roadmaps.

How this skill works

The skill runs a phased workflow from requirements analysis through implementation planning, orchestrating specialist analysis and automated checks. It selects architectural patterns, defines service boundaries, designs APIs and data models, and embeds security and observability into the design. Final deliverables include diagrams, spec documents, trade-off analysis, and migration and deployment plans.

When to use it

• Design a new system architecture or greenfield platform
• Modernize or decompose an existing monolith into microservices
• Define API-first integration and service contracts
• Plan DevOps, CI/CD, and deployment architecture for reliability
• Assess security posture and ensure regulatory compliance

Best practices

• Begin with clear business requirements and measurable success criteria
• Define system boundaries and explicit data contracts early
• Design for failure: fault isolation, retries, and graceful degradation
• Embed observability, logging, and metrics from day one
• Document decisions with rationale and trade-offs for future review

Example use cases

• Architect a microservices e-commerce platform with payment and inventory domains
• Create a phased migration plan for a 10-year-old monolith using the Strangler Fig pattern
• Design a high-throughput API platform with caching, sharding, and autoscaling
• Develop a cloud-native deployment with IaC, CI/CD pipelines, and disaster recovery
• Produce a security-first architecture for sensitive data handling and compliance