architecture

Design system architectures and generate Architecture Decision Records.

9|5|Updated Nov 9, 2025
One-click install
npx skills add https://github.com/carlheath/ogmios --skill architecture-carlheath
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/carlheath/ogmios/tree/main/.claude/skills/architecture
Command: npx skills add https://github.com/carlheath/ogmios --skill architecture-carlheath

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and workflows (resource) components.

What problem does it solve?

This Skill provides expert guidance on designing scalable, maintainable, and resilient system architectures, helping you make informed technical decisions and document them effectively.

Core Features & Use Cases

  • System Design: Develop blueprints for new systems or refactor existing ones.
  • ADR Creation: Generate Architecture Decision Records to document key choices.
  • Technology Evaluation: Assess and select appropriate technologies for your stack.
  • Use Case: You need to design a new microservices-based e-commerce platform. This Skill can help you choose the right patterns, define service boundaries, and document your decisions.

Quick Start

Use the architecture skill to design a scalable system architecture for a new web application.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I design a scalable microservices architecture for a new web application?

To design a scalable microservices architecture, you need to define service boundaries, select appropriate integration patterns, and document technical decisions. This involves creating blueprints that ensure maintainability and resilience for your system.

What is an Architecture Decision Record and when do I need one?

An Architecture Decision Record (ADR) documents key technical choices and the reasoning behind them. You need ADRs to facilitate technology evaluation, support decision-making, and maintain a clear technical strategy for future system refactoring.

What is the best way to evaluate technologies for my system design?

Evaluating technologies for system design requires assessing options against your specific needs for scalability and maintainability. This process helps you select appropriate patterns and create a robust technical strategy for your software stack.

How do I plan integration for an e-commerce platform?

Planning integration for an e-commerce platform involves defining service boundaries and selecting established patterns. This ensures your system architecture supports resilience and maintainability across microservices as the platform scales.

Can I use this approach to refactor an existing software system?

Yes, you can refactor an existing software system by developing new architectural blueprints. This process uses established patterns and best practices to improve the scalability, maintainability, and resilience of the current system design.