architecture-design

Generate system architecture, API contracts, and deployment templates for full-stack projects.

34|21|Updated Feb 1, 2026
One-click install
npx skills add https://github.com/kumaran-is/claude-code-onboarding --skill architecture-design-kumaran-is
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-design
Source: https://github.com/kumaran-is/claude-code-onboarding/tree/main/.claude/skills/architecture-design
Command: npx skills add https://github.com/kumaran-is/claude-code-onboarding --skill architecture-design-kumaran-is

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams designing modern software systems struggle to define scalable architectures, robust API contracts, and clear deployment strategies under evolving tech stacks.

Core Features & Use Cases

  • Architecture diagrams and context models (C4, Mermaid) for system comprehension
  • API contracts (OpenAPI 3.x) for cross-team integration
  • Deployment topology templates (Docker Compose and Kubernetes scaffolds)
  • ADR guidance and architectural decision workflows aligned with CLAUDE.md conventions
  • Template-driven artifact generation to match project tech stacks (Spring Boot, Node.js, Angular, etc.)

Quick Start

Generate a design plan for a new microservices project including architecture diagrams, API contracts, and a deployment plan.

Frequently Asked Questions about architecture-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design system architecture and API contracts for a full-stack application?

To design system architecture and API contracts, you can generate architecture diagrams, OpenAPI 3.x definitions, and deployment topology templates tailored to tech stacks like Spring Boot, Node.js, and Angular using reference templates.

Can I generate C4 architecture diagrams and deployment topologies for containerized applications?

Yes, you can generate C4 architecture diagrams using Mermaid and create deployment topology templates, including Docker Compose and Kubernetes scaffolds, specifically for containerized application deployments.

What is the best way to document architectural decisions for a new microservices project?

The best way to document architectural decisions is to use ADR guidance and architectural decision workflows aligned with CLAUDE.md conventions to ensure consistent project standards.

Does this system design approach work with Spring Boot, Node.js, and Angular tech stacks?

Yes, the system design approach uses template-driven artifact generation to match specific project tech stacks, explicitly supporting Spring Boot, Node.js, and Angular applications.

How do I create OpenAPI 3.x contracts for cross-team integration?

You create OpenAPI 3.x contracts for cross-team integration by generating standardized API definitions from the system architecture design, ensuring robust communication between separate teams.

Why do I need ADR guidance when defining deployment strategies under evolving tech stacks?

You need ADR guidance because teams struggle to define scalable architectures and clear deployment strategies under evolving tech stacks, and architectural decision workflows provide the necessary structured alignment.