architecture

Create or evaluate Architecture Decision Records with trade-off analysis.

Updated Apr 29, 2026
One-click install
npx skills add https://github.com/pgm1980/stryker-netx --skill architecture-pgm1980
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/pgm1980/stryker-netx/tree/main/.claude/skills/architecture
Command: npx skills add https://github.com/pgm1980/stryker-netx --skill architecture-pgm1980

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you capture important architecture decisions in a consistent, reviewable format so teams can align on trade-offs and avoid repeating past debates.

Core Features & Use Cases

  • Create ADRs that document whether to adopt or reject a specific technology or design direction, including context, options considered, and consequences.
  • Evaluate proposals by structuring trade-off analysis and highlighting risks, costs, scalability concerns, and team fit.
  • Support system design discussions by prompting requirement/constraint-driven analysis that produces an actionable decision record.

Quick Start

Ask for an ADR by requesting: "Create an ADR deciding between Kafka and SQS for our event bus, including context, options, trade-offs, consequences, and action items."

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I document system design decisions and trade-offs in a structured format?

Architecture Decision Records document system design decisions by capturing context, options considered, and consequences. They help teams align on technology trade-offs and avoid repeating past architecture debates in a consistent, reviewable format.

When should I create an ADR for a technology or design choice?

Create an ADR when choosing between competing architectures, reviewing design proposals, or drafting new components from requirements. ADRs are needed to explicitly document trade-offs, risks, costs, scalability concerns, and team fit for important technology adoption decisions.

What is the best way to structure trade-off analysis for architecture proposals?

Structure trade-off analysis by evaluating competing architecture options with explicit assessments of risks, costs, and scalability concerns. Produce a structured record covering context, decision, options, trade-offs, consequences, and action items to review design proposals.

Can I evaluate design proposals and highlight risks using an ADR format?

Yes, evaluating design proposals with an ADR highlights risks, costs, scalability concerns, and team fit. The structured format prompts requirement and constraint-driven analysis that produces an actionable decision record for system design discussions.

What sections should be included in an Architecture Decision Record?

An Architecture Decision Record should include context, decision, options with assessments, trade-off analysis, consequences, and action items. It optionally guides follow-ups based on connected connectors to support system design discussions.