architecture

Diagnose software architecture problems and produce actionable recommendations or ADRs.

46|2|Updated Mar 23, 2025
One-click install
npx skills add https://github.com/gracefullight/krds --skill architecture-gracefullight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/gracefullight/krds/tree/main/.claude/skills/architecture
Command: npx skills add https://github.com/gracefullight/krds --skill architecture-gracefullight

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you systematically diagnose software architecture problems, compare analysis approaches, synthesize stakeholder input, and produce a clear recommendation or ADR instead of relying on guesswork.

Core Features & Use Cases

  • Architecture problem diagnosis: Identify likely causes of architecture issues and constraints driving them.
  • Method selection and comparison: Choose the right analysis method for the problem and weigh alternatives.
  • Stakeholder synthesis: Consolidate input into actionable architectural guidance for decision-making.
  • Recommendation or ADR output: Produce a recommendation, review artifact, or ADR that is ready to share.

Quick Start

Use the architecture skill to read .agents/workflows/architecture.md step by step for your current architecture issue and generate a recommendation or ADR.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I diagnose software architecture issues and identify what is driving them?

You diagnose software architecture issues by following a guided workflow that identifies likely causes and constraints driving them. It then helps select appropriate analysis methods to compare alternatives and synthesize stakeholder input into a structured recommendation.

What's the best way to write an Architecture Decision Record (ADR) from multiple stakeholder inputs?

Writing an ADR from stakeholder input requires synthesizing multiple perspectives into actionable architectural guidance. This skill consolidates diverse stakeholder input and produces a structured ADR ready for review and decision-making.

How do I choose the right architecture analysis method for my current software problem?

Choosing an architecture analysis method involves comparing available approaches against your specific problem constraints. This skill guides method selection by weighing alternatives and incorporating stakeholder input to ensure the chosen method fits the issue.

Can I use this skill for an architecture review without prior analysis experience?

You can use this skill for an architecture review without prior analysis experience. It guides you step by step through diagnosing problems, selecting methods, and synthesizing input to generate a review artifact suitable for stakeholders.

When should I not use a generic software architecture recommendation workflow?

You should avoid a generic software architecture recommendation workflow when your problem requires highly specialized domain analysis outside standard architectural patterns. This skill focuses on diagnosing common architecture issues and comparing established approaches to produce actionable guidance.