architecture-design

Translate requirements into scalable system designs with ADRs and governance.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/edlovesjava/horse-sense --skill architecture-design-edlovesjava
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-design
Source: https://github.com/edlovesjava/horse-sense/tree/main/horse/skills/architecture-design
Command: npx skills add https://github.com/edlovesjava/horse-sense --skill architecture-design-edlovesjava

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translate requirements into a coherent, scalable system design that reduces technical debt and enables independent teams to evolve systems efficiently.

Core Features & Use Cases

  • Understand context and constraints to propose architecture options.
  • Define components, data ownership, and interface design for clear boundaries.
  • Document ADRs and governance to guide implementation and future changes.

Quick Start

Provide a high-level architecture plan for a new service by following the architecture design process described above.

Frequently Asked Questions about architecture-design

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

FAQPage Schema
How do I translate requirements into a scalable system design?

To translate requirements into a scalable system design, define components, data ownership, and interface boundaries. This establishes clear architectural constraints that guide implementation and enable independent teams to evolve systems efficiently.

What is architectural governance and when do I need it in the SDLC?

Architectural governance applies rules and ADRs across the SDLC to manage system evolution. You need it to enforce security, observability, and technology selection standards, ensuring independent teams reduce technical debt and maintain coherent boundaries.

How do I document architecture decisions using ADRs?

Document architecture decisions using ADRs by recording technology selections, component interfaces, and security considerations. This governance practice captures the context and constraints behind choices, guiding implementation and future system changes.

What is the best way to define component interfaces and data ownership?

The best way to define component interfaces and data ownership is to map them during system design. Establishing clear boundaries for components and data reduces technical debt and enables independent teams to evolve their services efficiently.

Can I propose technology selection options for a new service architecture?

Yes, you can propose technology selection options by analyzing context and constraints. Evaluating options for a new service architecture ensures the chosen components and interfaces align with security, observability, and scalability requirements.

Why do I need to document security and observability considerations in system design?

You need to document security and observability considerations in system design to establish architectural governance. Capturing these constraints in ADRs ensures implementation teams build scalable systems that maintain operational visibility and data protection.